How it works
Recipes drive a bare stellar-core to emit rare shapes; the bytes become entries with facts; independent readers check them, real indexers ingest them, and SDK builds run test vectors for the same shapes.



1. Make the shapes
A recipe is a deterministic script that drives one fresh standalone stellar-core v30.0.0 over its HTTP port. The core image is pinned by digest. There is no RPC, no network, and no keys or funds: seeds and close times are fixed. Core writes every closed ledger as LedgerCloseMeta.
Some shapes only happen on a real network, or are worth having as real network bytes, so they are mined from public ledger history instead. mined/ holds 37 real mainnet and testnet ledgers; 37 entries are built from 22 of them, the testnet ledger where wallet-backend halted among them.
2. Keep the bytes, write down the truth
Each interesting ledger becomes a corpus entry, compiled from a hand-written catalog file. An entry holds:
- the raw bytes;
- the CAP and the hazard it targets;
- where in the XDR the hazard sits;
- the facts a correct reader must find, each with what backs it.
3. Check the truth independently
| Check | Reader | Target |
|---|---|---|
| Byte-for-byte round trip, every fact | native rs-stellar-xdr 30.0.0; the WASM build must agree wherever it can decode | make verify |
| Fact values also read by | stellar-core's own dump-xdr (C++) and XDRProof's schema walker | make oracle |
| Which union arms are reached | a Python walker over the v30.0 XDR definitions | make coverage |
| Every arm reached by an entry, or classified with the core source line that decides it | the schema walker, per transaction | make coverage-report |
| No entry is redundant | leave-one-out over each entry's arms, hazards, sightings and placements | make novelty |
4. Run it against real code
| Against | How | Target |
|---|---|---|
| The SDKs | JS and Go builds before and after a fix, plus rs-stellar-xdr 30.0.0, through test vectors | make conformance |
| An indexer | real wallet-backend builds ingest corpus ledgers and their neighbours through a mock stellar-rpc | make replay |
Planned, not built
The figure also shows an indexer linter, a GitHub Action and the hardening guide, all marked planned. None of these exist yet; today the checks run as make targets.
Quickstart
Clone the repository and run make verify: strkey vectors, every entry against its schema, hashes, a byte-for-byte round trip and every fact, and every mined ledger, in seconds.
Concepts
The handful of words the corpus uses: entry, variant, hazard, placement, fact, evidence, focus, change order.
