> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Dashboard

> A consolidated, audit friendly view of portfolio value, balances, positions, and activity for end users of an institution-operated Levery instance.

The Account Dashboard is the default landing view after authentication. It provides a consolidated, compliance-friendly picture of an account’s **value**, **exposure**, **active liquidity**, and **recent activity** across the networks enabled by the institution.

The dashboard is designed for institutional workflows: **verifiable**, **consistent**, and **operationally useful**. It favors traceability and clarity over “best-effort” live estimates.

***

## What the user sees

<Frame>
  <img style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/levery/6C5ksHgEFzZe_XUM/images/levery-home-dark.jpg?fit=max&auto=format&n=6C5ksHgEFzZe_XUM&q=85&s=6a6071c5f46f19c3bd3359f478b15f0c" alt="Levery Account Dashboard" className="block dark:hidden" width="2880" height="1800" data-path="images/levery-home-dark.jpg" />

  <img style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/levery/6C5ksHgEFzZe_XUM/images/levery-home-dark.jpg?fit=max&auto=format&n=6C5ksHgEFzZe_XUM&q=85&s=6a6071c5f46f19c3bd3359f478b15f0c" alt="Levery Account Dashboard" className="hidden dark:block" width="2880" height="1800" data-path="images/levery-home-dark.jpg" />
</Frame>

<Columns cols={2}>
  <Card title="Portfolio" icon="chart-line" href="#portfolio-panel">
    A time series view of account value over selectable periods. It highlights the latest value and change for the
    visible window.
  </Card>

  <Card title="LP Positions" icon="layer-group" href="#lp-positions-preview">
    A preview of active liquidity positions, including market pair, network, and estimated value, with fee visibility when
    available under policy.
  </Card>

  <Card title="Balances" icon="wallet" href="#balances-panel">
    A summary of spot holdings with approximate valuation in the selected display currency, plus top assets for quick
    exposure review.
  </Card>

  <Card title="Transactions" icon="receipt" href="#transactions-panel">
    An activity trail designed for investigation and reconciliation. It includes filters and structured fields that map
    to on-chain execution records.
  </Card>
</Columns>

***

## Portfolio panel

The Portfolio panel shows account value over time and helps identify trend changes and event-driven movements.

### Time ranges

<Tabs>
  <Tab title="7D">Best for short-term monitoring and recent volatility.</Tab>
  <Tab title="1M">Default operational view in many deployments: balances signal and readability.</Tab>
  <Tab title="1Y">Macro context with smoother trends and reduced noise.</Tab>
  <Tab title="ALL">Full available history for long-horizon reporting and narrative continuity.</Tab>
</Tabs>

### How to read the chart

<Steps>
  <Step title="Select a time window">
    Choose the window that matches the decision. Short windows highlight recent movement. Longer windows provide
    trend context.
  </Step>

  <Step title="Inspect point details">
    Hovering a point reveals a breakdown for that moment, such as portfolio total and major components commonly displayed
    in the UI.
  </Step>

  <Step title="Cross-check with Balances and Positions">
    Identify whether exposure shifted in spot assets, liquidity deployments, or both.
  </Step>
</Steps>

### How to interpret portfolio changes

Portfolio changes typically come from two categories:

| Driver           | What it means                                                     | Where to confirm                                                       |
| ---------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Market movement  | Value changed due to reference price movement                     | Balances / Positions (value changes without matching new transactions) |
| Account activity | Value changed due to swaps, liquidity changes, transfers, or fees | Transactions panel (hash/time), plus Balances/Positions deltas         |

<Callout type="warning" title="Valuation note">
  Portfolio values are indicative and policy-based. Execution receipts and on-chain settlement remain authoritative for
  individual actions, especially when fees, price movement, or timing differences are involved.
</Callout>

***

## LP Positions preview

The LP Positions preview surfaces the account’s most relevant liquidity deployments so users can quickly understand where capital is allocated and where fee-generation is occurring.

Each position card typically includes:

* **Market + network context:** The pool pair and the network where the position is held, enabling rapid operational routing (for example, validating activity against network references or coordinating support).
* **Position identifier:** A stable reference used for investigation, reconciliation, and support workflows.
* **Indicative position value:** An estimate of the position’s current value under the venue’s configured valuation rules, intended for exposure monitoring rather than execution-time accounting.
* **Fee / earnings visibility (when available):** An estimate of uncollected fees or earnings surfaced according to the venue’s reporting policy and the data available for the underlying pool mechanics.

This preview is designed for **triage**. It helps users identify positions that may warrant attention (for example, concentration in a single pool, material fee accrual, or changes correlated with recent market moves) before going deeper into lifecycle controls.

<Note>
  Each position card links directly to the **Position** page, where users can review full parameters (range, liquidity,
  and pool context) and perform lifecycle actions such as adjusting liquidity, collecting fees (when applicable), or
  closing the position.
</Note>

***

## Balances panel

The Balances panel is optimized for **exposure clarity**: what you hold, where you hold it, and how concentrated it is.

It typically includes:

* A **total balances value** in the current display currency
* A **24h change indicator** (mark-to-market signal where supported)
* A holdings table showing major assets and approximate valuations

### Practical interpretation guidance

* **Token amounts are exact on-chain quantities expressed with token decimals.**
* **Fiat values are approximate** and reflect the institution’s pricing policy (source, freshness requirements, and coverage).
* **Cross-network consolidation** may be presented as a unified total while still allowing per-network inspection.

<Accordion title="Why balances may not match the external wallet app exactly">
  Levery’s dashboard is intentionally policy-scoped. It shows balances only for the networks enabled by the institution and for assets explicitly whitelisted for the venue. External wallet applications typically present a broader view of the same address across additional networks and tokens, including assets that are not supported or not authorized within the venue’s operating perimeter.

  Differences may also arise in the valuation layer. Wallet apps can use different price references, update cadences, and rounding conventions. In Levery, displayed fiat values follow the venue’s configured pricing and reporting rules so users, operations, and compliance teams see a consistent view.

  When reconciliation is required, rely on the policy-scoped balances alongside network references (chain and transaction hash) as the primary audit handle.
</Accordion>

***

## Transactions panel

The Transactions panel is the operational backbone of the dashboard. It provides a chronological activity trail for the selected account, showing the account’s transaction history as executed through the protocol across the institution-enabled networks.

This view is designed for **investigation**, **reconciliation**, and **operational support**. Each entry is anchored to chain references and is suitable for audit workflows where you need to explain *what happened*, *when it happened*, and *what it affected*.

### What you will typically see

* **TX Hash (transaction hash):** Primary reference for reconciliation and external verification.
* **Type:** The business action recorded (e.g., swap execution, liquidity modification).
* **Chain:** The chain where the action occurred.
* **Caller:** The account that initiated the action in the protocol context.
* **Block:** The block number where the transaction was finalized on-chain.
* **Time:** Block time (and/or indexed time) used for ordering and reporting.

<Callout type="info" title="Scope of the activity trail">
  This panel tracks activity for the selected account within the institution’s Levery instance (venue interactions).
  External transfers that did not occur through the venue will not be represented here.
</Callout>

***

## What the dashboard helps you answer

<Columns cols={2}>
  <Card title="What is the account worth?" icon="chart-line">
    A portfolio view that tracks account value over time in your selected display currency, aligned with the institution’s valuation policy.
  </Card>

  <Card title="Where is exposure concentrated?" icon="wallet">
    A balances view that highlights the largest holdings and approximate valuations for quick concentration checks.
  </Card>

  <Card title="What is earning fees?" icon="layer-group">
    A positions preview that surfaces active liquidity deployments and estimated earnings where available under policy.
  </Card>

  <Card title="What changed, and why?" icon="receipt">
    A transaction trail that supports reconciliation and investigation, anchored to network identifiers (chain, hash, time).
  </Card>
</Columns>

***

## Data provenance and trust model

The dashboard is anchored to **on-chain records**. Portfolio value, balances, positions, and activity are derived from chain-native sources such as executed transactions, emitted events, and canonical state updates.

For valuation, the dashboard uses a **fiat quote** (for example, USD or BRL) computed from **market price feeds published on-chain**. These feeds provide both:

* **Real-time market pricing** for current valuations and day-to-day monitoring, and
* **Historical market pricing** for time-series views (e.g., portfolio charts), so past values are based on the price feed history rather than ad-hoc API snapshots.

This produces a trust model aligned with financial controls:

* **Traceability:** Key activity can be traced to **network**, **transaction hash**, and **time reference**.
* **Tamper-evident valuation inputs:** Price updates are **published on-chain** and are therefore independently verifiable and time-ordered.
* **Policy consistency:** Valuations follow the venue’s configured quote currency, pricing sources, and reporting rules, ensuring a consistent view across users and teams.
* **Audit readiness:** When values change, there is an attributable on-chain driver (transaction activity and/or a price feed update), supporting reconciliation and control processes.

### Why using on-chain market price feeds (instead of APIs) matters

The dashboard does not depend on opaque, off-chain API responses for pricing. Using established on-chain oracle infrastructure provides practical security and reliability benefits:

* **Independent verification:** Pricing inputs can be validated against on-chain publications, improving confidence during audits and investigations.
* **Resilience and availability:** The platform avoids single-provider API failure modes (downtime, rate limits, silent methodology changes) that can disrupt reporting.
* **Operational integrity:** Market prices are produced and maintained by reputable oracle networks with strong security postures and mature operational practices, reducing the risk of inconsistent or manipulated price inputs.
* **Reliable historical context:** Historical values are backed by the price feed history, enabling consistent charting and period comparisons without relying on external data vendors.

### What “anchored to on-chain records” means

It means the numbers you see are not manually entered and are not derived from private, unverifiable data sources. They are based on blockchain-native records and market price publications that can be checked independently (for example, via a block explorer or RPC).

In practice, this implies:

* **On-chain source of truth:** Trades, liquidity changes, and position state are based on transactions, logs (events), and contract state.
* **Reproducibility:** Using the same on-chain references and the venue’s valuation configuration, teams can reconcile results to the same underlying records (allowing for normal rounding and UI update timing).
* **Investigability:** When a number changes, there is a corresponding on-chain cause that can be traced to transaction references and/or price feed updates, even if the UI does not expose internal calculation steps.

***

## Currency model: base quote vs display currency

Institutional venues typically standardize valuation in a **base quote** (for example, USD) and present results in a **display currency** selected by the user or institution.

* **Base quote:** Internal valuation reference used for normalized reporting across assets and networks.
* **Display currency:** A user-facing preference. Values are converted from the base quote into your chosen display currency using oracle-backed market FX pricing.

<Callout type="note" title="Why this matters">
  A consistent base quote makes portfolio and exposure reporting comparable across networks. The display currency is a
  presentation layer, useful for day-to-day decisions without changing the underlying reporting standard.
</Callout>

***

## Next steps

From the Account Dashboard, end users typically navigate to the following pages.

<Columns cols={2}>
  <Card title="Trade" icon="right-left" href="/end-user/trade">
    Execute swaps under the institution’s access policies and approval rules.
  </Card>

  <Card title="Invest" icon="droplet" href="/end-user/invest">
    Allocate liquidity into approved pools and strategies offered by the institution’s venue configuration.
  </Card>

  <Card title="Pools" icon="chart-simple" href="/end-user/pools">
    Browse liquidity pools, compare key metrics, and open a pool to view details or provide liquidity.
  </Card>

  <Card title="Assets" icon="rectangle-history" href="/end-user/assets">
    Review balances in detail, inspect per-asset valuation, and confirm exposure concentration.
  </Card>

  <Card title="Positions" icon="layer-group" href="/end-user/positions">
    Manage liquidity positions through their lifecycle, including updates, fee collection, and closure.
  </Card>

  <Card title="Settings" icon="sliders" href="/end-user/settings">
    Set profile details, security controls, and preferences for daily platform operations.
  </Card>
</Columns>
