Skip to content

docs: add Stellar, Filecoin, Cronos and Klaytn, plus historical balance for five chains - #252

Merged
buddies2705 merged 2 commits into
mainfrom
docs/starter-panel-more-chains
Aug 27, 2026
Merged

docs: add Stellar, Filecoin, Cronos and Klaytn, plus historical balance for five chains#252
buddies2705 merged 2 commits into
mainfrom
docs/starter-panel-more-chains

Conversation

@buddies2705

Copy link
Copy Markdown
Contributor

Follow-on to #251. These two commits were pushed after #251 merged, so they were left behind on the old branch. Cherry-picked here onto the updated main. Same thing happened between #250 and #251 — worth a squash-and-hold before the next merge.

Four new chains — 22 queries

All V1-only, all authored from scratch, since none had a docs page carrying IDE links.

Chain Queries
Stellar 6 — ledgers, transactions, payments, DEX trades, account balances, liquidity pool trades
Klaytn 7 — the V1 EVM set including DEX trades and top DEXs
Cronos 5 — no DEX set, see below
Filecoin 4 — tipsets, messages, transfers, address balance

Every query was executed before being saved. Reaching 22/22 took four rounds, and each failure was a shape that looks right and isn't:

  • Stellar's block is a scalar ledger number, not an object. block { height } fails, and sorting must use desc: "block".
  • Filecoin messages use amount and method { name }, not value / method.
  • Cronos has no dexTrades table (ClickHouse Code 60), so it ships without the DEX queries exactly as Celo does.
  • Query memory limits differ per chain and per cube. Cronos blocks needs a date bound, and Stellar transactions and payments need a window about a day wide where a week is fine elsewhere. Every bound is a $since variable so it can be moved.

Historical balance for five chains

Balance is asked of every chain in both directions, so a chain with only the current side is half-covered. Adds the historical side for Cronos, Klaytn, Avalanche, Stellar and Filecoin, computed as everything received minus everything sent up to a date.

Balance gaps are now 6 chains, down from 16 when this work started.

The example address for each is discovered from a real recent transfer on that chain rather than guessed, so the saved query returns rows.

llms.txt

New Endpoints, chains and datasets section: which chains are on V2 versus V1, that root capitalisation marks the version (EVM( is V2, ethereum( is V1), that Ethereum, BSC, Tron and Polygon are migrating to V2, and what realtime / archive / combined mean — plus links to the dataset and retention pages. The starter query and subscription trees are now listed under "Start here".

Verification

690 query entries across 32 groups, 383 stream entries across 17. All eleven gates pass and the production build is clean.

All 87 queries authored across this work were re-executed read back out of the database: 79 run, 6 retired, 2 reported failing.

Both reported failures were checked rather than believed, and both are transient: Avalanche smart-contract-events passes on retry, Klaytn latest-blocks passes with a longer timeout. These V1 chains are slow enough under load that a single-shot audit invents failures, so the round-trip audit now retries before reporting.

Two more V1 rules learned here and now encoded in the audits:

  • Sorting by a field requires selecting it. desc: "block.height" without block { height } returns "Can't use block.height in sorting" — this silently broke an address finder on all five chains.
  • The chain-scope gate had no rule for Filecoin, so it was passing vacuously. Fixed and verified to discriminate.

Known gaps

  • 6 chains still lack one side of balance: Solana, Robinhood, BSC and Cardano have no historical, Ripple no current, Algorand neither. Solana's historical balance query exists but is filed under Transfers.
  • 432 entries would benefit from a dataset comment pointing at archive / combined; only 109 are on our account, so the rest currently carry the guidance in tooltips instead.

🤖 Generated with Claude Code

Gaurav Agarwal and others added 2 commits August 27, 2026 14:36
Four more chains, 22 queries, all V1-only and all authored from scratch since
none of them had a docs page carrying IDE links.

- Stellar (6): ledgers, transactions, payments, DEX trades, account balances,
  liquidity pool trades
- Filecoin (4): tipsets, messages, transfers, address balance
- Cronos (5) and Klaytn (7): the V1 EVM set already proven on Avalanche/Celo

Every one was executed before saving. Getting there took four rounds and the
failures are worth recording, because each is a shape a reasonable person
would guess wrong:

- On Stellar, `block` is a scalar ledger number, not an object, so
  `block { height }` fails and sorting must use `desc: "block"`.
- Filecoin messages use `amount` and `method { name }`, not `value` / `method`.
- Cronos has no dexTrades table at all (ClickHouse Code 60), so it ships
  without the DEX queries, exactly as Celo does.
- Cronos blocks, and Stellar transactions and payments, exceed the query
  memory limit without a date bound -- and Stellar's two need a window about
  a day wide where a week is enough elsewhere. The bound is a `$since`
  variable everywhere so it can be moved.

llms.txt gains an "Endpoints, chains and datasets" section: which chains are
on V2 versus V1, that root capitalisation marks the version, that Ethereum,
BSC, Tron and Polygon are migrating to V2, and what realtime/archive/combined
mean -- plus links to the dataset and retention pages. The starter query and
subscription trees are now listed under "Start here" as well.

685 query entries across 32 groups, 383 stream entries across 17.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…coin

Balance is the question every chain gets asked, current and historical, so a
chain with only one of the two is half-covered. Adds the missing historical
side for five chains, computed as everything received minus everything sent up
to a date. Balance gaps are now 6 chains, down from 16 when this started.

The example address for each is discovered from a recent transfer on that
chain rather than guessed, so the saved query returns rows.

Two things this audit round established that are worth writing down:

- Sorting by a field on V1 requires selecting it. `desc: "block.height"` with
  no `block { height }` in the selection returns
  "Can't use block.height in sorting", which is what made the address finder
  come back empty on every chain at first.
- Two round-trip failures -- Avalanche smart contract events and Klaytn latest
  blocks -- were transient, not defects. Both pass on retry and with a longer
  timeout. These V1 chains are slow enough under load that a single-shot audit
  produces false alarms; the round-trip audit now retries.

690 query entries across 32 groups, 383 stream entries across 17.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@buddies2705
buddies2705 merged commit 4dfe40b into main Aug 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant