Read-only Public API

Transparency Hub for
live USDX state

This page consumes the public USDX API surface for supply, reserves, proof metadata, system status, and the canonical phase 1 domain registry. It does not embed mock reserve balances or infer healthy system state without evidence.

Fast polling: 30s for /status and /supply. Slow polling: 5m for /reserves, /proof, and /domains.

System State
Loading
Polling /status
Global Supply
Loading
Polling /supply
Total Reserves
Loading
Polling /reserves
Phase 1 Domains
Loading
Polling /domains

Status, supply, reserves, proof, and domains

Production publication requires a real --public-registry with live contract addresses. If the registry is placeholder, stale, or unreachable, this page should present a degraded state rather than synthetic certainty.

System Status

Derived operational state

Loading status signals.

loading
Last Updated
Waiting
Timestamp reported directly by /status.
Behavior Rule
Evidence-first
Mint and redeem are not labeled enabled unless pause and freshness signals support that conclusion.
Components
Component signals will appear here once /status is reachable.
Issues
No active issues are currently reported by /status.
API Surface

Read-only routes in scope

The website only consumes the public transparency routes. Internal mint, redeem, and operator endpoints remain outside this surface.

GET /domains Always public

Canonical phase 1 domain registry. Static and unambiguous.

GET /supply Registry required

Global supply plus per-domain breakout using domain_id as the canonical unit.

GET /reserves Registry required

Total reserves, liquid reserves, freshness, and report hash. Asset-class amounts appear when a matching published local attestation breakdown exists and stay visibly unpublished otherwise.

GET /proof Registry required

Latest on-chain proof hash enriched by the latest local snapshot when report hash and timestamp match.

GET /status Derived state

System health derived from live pause flags, reserve freshness, and reconciliation issues.

Endpoint failures surfaced by this page
All public endpoint groups are responding on this page load.
Supply

Global supply and domain allocation

The public supply view aggregates live EVM reads and preserves domain_id as the canonical identifier.

Global Supply
Loading
Waiting for a global supply snapshot.
Reserve Freshness
Pending
Copied from the primary live domain snapshot.
Aggregation Source
Pending
Shows onchain or onchain_partial.
Per-domain Lookup
/supply/{id}
Aliases such as ethereum, arb, base, and op resolve into canonical domain IDs 1–11.
Domain Chain Network Supply Source Available
Waiting for live supply data.
Reserves

Reserve snapshot and publication gaps

The public reserve view is anchored to the on-chain reserve oracle. Where asset-class amounts are absent, the page says so directly instead of drawing fake charts.

Total Reserves
Loading
Waiting for an on-chain reserve snapshot.
Liquid Reserves
Pending
Reported from the reserve oracle.
Freshness
Pending
Evaluated from the oracle's fresh flag and max reserve age.
Report Hash
Pending
Latest proof hash published on-chain.
Asset Class Amount Currency Source
Waiting for reserve breakdown metadata.
Proof Metadata

On-chain hash plus matched local publication metadata

/proof does not invent attestation URLs, archive links, cadence values, or named attestors. It enriches the live report hash only when a local snapshot matches both hash and timestamp.

Proof Status
Loading
Polling /proof
Publication Status
Pending
Comes from the latest matching local snapshot when available.
Report Hash
Loading
Full 32-byte hash of the latest attestation report.
Attestor
Pending
Reporter identity from the local snapshot when published.
Published At
Pending
Uses local state only when the local proof record matches the live on-chain proof hash.
Public Links
Domain Registry

Canonical phase 1 domains

A domain in USDX is a cross-chain supply identifier, not an internet domain and not a legal jurisdiction. The public registry is the source of truth for that mapping.

Domain Chain Network Family Chain Ref
Waiting for the phase 1 domain registry.
What this page shows

Only evidence-backed public data

No mock reserves

Supply comes from live on-chain reads. Reserve freshness comes from the reserve oracle. Proof metadata is enriched only on a verified local match. Issues are surfaced directly instead of being collapsed into a green badge.

  • source = onchain_partial stays visible.
  • fresh = false stays visible.
  • amount = null stays visible as unpublished.
Publication Rule

When this page is safe to call production

Registry required

A static website alone is not enough. The launch condition is a real public registry with live USDX contract addresses, working RPC paths, and a manual verification pass for degraded and stale states.