DEXes

AMMs and the native order book — every venue we ingest from on-chain Stellar. Each card lists the integration quirk discovered during decoder development; full audit notes live in the linked discovery doc.

Source registry

Live row from /v1/sources for any of these

Every venue here has class=exchange in the source registry — meaning trades from these venues contribute to the canonical VWAP by default. See /sources for the full include-in-VWAP / backfill-safety / weight matrix.

Soroswap

live

Uniswap V2 clone (Soroban)

Primary Soroban DEX source — factory + per-pair contracts, event-based ingest verified against the upstream Rust source.

  • •SwapEvent carries only in/out deltas — post-state reserves arrive in the immediately-following SyncEvent. Correlation key is (ledger, tx_hash, op_index).
  • •Reserves are i128 — handled per ADR-0003 (no int64 truncation).
  • •Pair registry persisted in postgres so live ingest + parallel backfill chunks share one source of truth.
Discovery notesContracts source

Phoenix

live

AMM (Soroban)

Soroban AMM with a unique per-field event split — reconstructing one swap requires grouping eight events tagged ("swap", "<field>") on the same (ledger, tx_hash, op_index).

  • •Every swap fans out across 8 events, one per field of the swap state. Decoder must group them before emitting a single canonical Trade.
  • •Topic shape is a 2-tuple ("swap", "<field>") — different from the protocol-namespaced shapes Soroswap and Aquarius use.
Discovery notes

Aquarius

live

AMM with gauges (Soroban)

Curve-style AMM with bribe/gauge layer. Constant-product and stableswap pools both ingest into the same canonical Trade shape.

  • •Decoder treats stableswap and constant-product pools uniformly — VWAP is a function of in/out amounts, not the bonding curve.
Discovery notes

SDEX

Stellar native

Native order book (classic)

Stellar native on-chain order book. Trades extracted from CAP-67 unified token transfer events plus operations + effects pre-Protocol-23.

  • •Post-Protocol 23 (Whisk, mainnet 2025-09-03) every classic asset movement emits a unified transfer/mint/burn event with a 4th sep0011_asset topic.
  • •Pre-P23 path parses operations + effects directly. Decoder handles both code paths transparently.
Discovery notes

Comet

experimental

Balancer V1 fork (Soroban)

Balancer-style multi-asset pool. Shared ("POOL", <event>) topic across every Comet pool contract — narrow coverage filters downstream by Trade.Source + contract address.

  • •Topic match alone identifies any pubnet contract that deployed Balancer-V1 Comet code — operators wanting only Blend backstop pools filter at aggregator time, not dispatch time.
Discovery notes