Stabledesk

Stabledesk measures every stablecoin on Arc, Circle's L1 — supply, real volume, TVL and flows — read straight from the chain, with a published method and a free data API.

stabledesk.xyz · @getStabledesk · how we publish numbers

Live on Arc mainnet since launch day, 16 September 2026 (chain 5042 — check it at /v1/status). Every figure on the site is read from the chain, and every rule that turns logs into a figure is on /methodology, including the ones that turned out wrong and how they were corrected.

Not another explorer — the Arc explorer already does blocks and transactions. Stabledesk is the stablecoin-finance analytics layer: what actually moved, how much of it was real economic activity rather than routing noise, what it cost the network to move it, and which protocols hold the value.

Read-only. Zero dependencies — Node's native fetch and node:sqlite, nothing else.

What it measures

• Three volume measures, all published — raw (every Transfer event), real (one largest transfer per transaction per token, so routing hops and contract internals don't count twice), and adjusted (real, minus infrastructure talking to infrastructure). Showing all three means every filtering step is auditable rather than asserted. An address counts as infrastructure the way Visa/Allium define it — it sent more than 1,000 transfers or $10M in 30 days — and every flagged address publishes what it sent and the window it was judged over.
• Cross-chain flows, separated from issuance — USDC and EURC arriving on or leaving Arc through Circle CCTP, with the chain on the other side, and Circle Gateway's rebalancing, each attributed per mint and burn from the protocol's own events. What is left is what was actually issued or redeemed on Arc (/v1/cctp, organicNetIssuance24h).
• Network economics — gas on Arc is paid in USDC, so fees are dollars read straight from transaction receipts: no price feed, no oracle. Headline metric is cost to move $1M.
• Stablecoin supply, share and velocity per token, plus mint/burn — per currency: dollars, euros and every other denomination are totalled on their own and never added together. Assets are configured by contract, not by symbol, because a symbol can be deployed more than once on one chain (Arc testnet carried two independent USYC contracts). A wrapper whose supply is exactly the USDC it custodies is deliberately not counted as issuance.
• Per-block activity + largest transfers over a stated window, in real time.
• History past the retention window — per-day aggregates are kept indefinitely, so 30d, 90d, 1y and all ranges exist and every series says which table answered it and how far back the record actually reaches.
• Ecosystem (/ecosystem) — every protocol on Arc with its TVL, flow, status and official links, plus the contracts holding balances nobody has named yet. TVL is measured as stablecoin balances held by contracts, which needs no per-protocol adapter on a chain where value is denominated in USDC. Each protocol's contracts come from its operator's own published address list (Aave, Morpho, Uniswap, Circle); pools and vaults are attributed only when their factory confirms them, and smart-contract wallets — contracts by bytecode, wallets by function — are named but kept out of TVL.

Run

node server.js
# → http://localhost:4317

No install step (Node ≥ 22.5.0 — node:sqlite). On first run the indexer backfills recent history, then keeps indexing forward and serves:

• GET / — the terminal
• GET /api/state — live snapshot: network stats, 24h summary, top addresses, largest transfers
• GET /api/history?token=ALL|<symbol>&range=1h|24h|7d|30d|90d|1y|all — time series (volume, count, mint, burn). Past 7d the series comes from the per-day rollup; the response states which table answered (source) and how far back the record reaches (recordBegan), so a long range over a short record cannot pass for a long one
• GET /api/top?limit=N — top addresses by volume
• GET /api/health — status: indexer health and chain liveness, reported separately
• GET /api/uptime?days=30 — the availability record: uptime over observed time, plus coverage
• GET /openapi.json — OpenAPI 3.1 description of the whole /v1 surface
• GET /llms.txt — short index of the site and its data, for language models and agents
• POST /mcp — the same figures as read-only tools for AI assistants (Model Context Protocol, Streamable HTTP, no key). Each answer carries its network, its window and the /v1 request that reproduces it; the tools read /v1 in-process, so there is no second implementation of any number. Serves both the 2026-07-28 revision (no handshake, server/discover) and the earlier ones (initialize). Address lookups are deliberately not exposed.

State (SQLite) is written to arc.db (gitignored). Delete it to re-index from scratch.

npm test   # smoke tests (node:test — no network, still zero deps)

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗