docs: add Stellar, Filecoin, Cronos and Klaytn, plus historical balance for five chains - #252
Merged
Merged
Conversation
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>
This was referenced Aug 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.
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:
blockis a scalar ledger number, not an object.block { height }fails, and sorting must usedesc: "block".amountandmethod { name }, notvalue/method.dexTradestable (ClickHouse Code 60), so it ships without the DEX queries exactly as Celo does.blocksneeds a date bound, and Stellartransactionsandpaymentsneed a window about a day wide where a week is fine elsewhere. Every bound is a$sincevariable 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 whatrealtime/archive/combinedmean — 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:
desc: "block.height"withoutblock { height }returns "Can't use block.height in sorting" — this silently broke an address finder on all five chains.Known gaps
archive/combined; only 109 are on our account, so the rest currently carry the guidance in tooltips instead.🤖 Generated with Claude Code