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

# On-chain data

> Verify trades, balances, and market state on Solana.

Every prediction, resolution, and payout leaves an on-chain record on **Solana**. You can verify activity independently of the ezpz.fi UI.

## What is on-chain

| Data                              | On-chain? | Where                                |
| --------------------------------- | --------- | ------------------------------------ |
| USDC balances (custodial wallet)  | Yes       | SPL token account                    |
| Outcome token holdings            | Yes       | SPL token ATAs                       |
| Market state (open/resolved/void) | Yes       | `Market` account on `buukie-market`  |
| AMM pool reserves                 | Yes       | `buukie-amm` pool account            |
| Parlay stake and legs             | Yes       | `Parlay` account on `buukie-parlay`  |
| Trade prices (historical charts)  | Partially | Derived from swap events via indexer |
| Order book quotes                 | No (M1)   | Off-chain until CLOB v2              |

See [Architecture](/concepts/architecture) for the full on-chain vs off-chain map.

## How to verify

<Steps>
  <Step title="Get your wallet address">
    Open **Settings** or Portfolio — your custodial wallet pubkey is tied to your account.
  </Step>

  <Step title="Open Solana Explorer">
    Go to [explorer.solana.com](https://explorer.solana.com) (use **devnet** toggle if on devnet).
  </Step>

  <Step title="Search transactions">
    Paste your wallet address or a specific transaction signature from Activity.
  </Step>

  <Step title="Inspect program calls">
    Expand instructions to see calls to `buukie-market`, `buukie-amm`, or `buukie-parlay`.
  </Step>
</Steps>

## Program addresses

Devnet deployments are listed in [Smart contracts](/resources/contracts). Use these to filter explorer results by program ID.

## Indexer

The platform runs **buukie-indexer**, which mirrors on-chain events into Postgres for the UI (Portfolio, charts, activity feed). The indexer is a **projection** — Solana is the source of truth for balances and settlement.

| Event type  | On-chain instruction             | Indexed for UI           |
| ----------- | -------------------------------- | ------------------------ |
| Mint + swap | `mint_tokens_v2`, `swap`         | Trade history, positions |
| Resolve     | `resolve_market`                 | Market status            |
| Redeem      | `redeem`                         | Settlement, P\&L         |
| Refund      | `refund`                         | Void recovery            |
| Parlay      | `create_parlay`, `settle_parlay` | Parlay status            |

## Devnet vs mainnet

Always confirm which cluster you are on before interpreting balances. Devnet USDC is test collateral with no real value.

## Related

* [Smart contracts](/resources/contracts) — program IDs
* [Outcome tokens](/concepts/outcome-tokens) — SPL mechanics
* [Order lifecycle](/concepts/order-lifecycle) — settlement flow