01Sheet 01.03 · Start

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.

The XDRProof pipeline, drawn tall
Fig. 1 · The XDRProof pipeline.

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

CheckReaderTarget
Byte-for-byte round trip, every factnative rs-stellar-xdr 30.0.0; the WASM build must agree wherever it can decodemake verify
Fact values also read bystellar-core's own dump-xdr (C++) and XDRProof's schema walkermake oracle
Which union arms are reacheda Python walker over the v30.0 XDR definitionsmake coverage
Every arm reached by an entry, or classified with the core source line that decides itthe schema walker, per transactionmake coverage-report
No entry is redundantleave-one-out over each entry's arms, hazards, sightings and placementsmake novelty

4. Run it against real code

AgainstHowTarget
The SDKsJS and Go builds before and after a fix, plus rs-stellar-xdr 30.0.0, through test vectorsmake conformance
An indexerreal wallet-backend builds ingest corpus ledgers and their neighbours through a mock stellar-rpcmake 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.

On this page