01Sheet 01.01 · Start

What XDRProof is

A shared corpus of rare but valid Stellar ledger data, the facts a correct reader must find in it, and tools that replay it into indexers and test SDKs on the same shapes.

An indexer has run fine for months. Then a ledger arrives with a shape its code has never seen:

  • a signer that carries a payload;
  • a trustline created by a contract call, with no event;
  • a map whose keys all read as "1".

Ingestion halts, or worse, it keeps going and stores something wrong. The team fixes it. Next month another team, in another language, meets the same shape.

XDRProof turns each of those shapes into a test everyone can run. One team's incident becomes every team's regression test, and one SDK's fix becomes a check on all of them.

FIG. · SignerKey · signed payload · 44 bytesCAP-0040 · testnet ledger 4437357
TYPEED25519 KEY · 32 BYTESLENGTHPAYLOAD00000000034404ad47185a0830e91c24125e8b058216b191e27d2099fb40f924ff48ca0d287e1264ec32879b200036000003de40adbe00payload = de ad bethe bytes a 33-byte column loses (#716)
The signer that halted wallet-backend on testnet ledger 4437357 (#729), drawn from the corpus. Its 3-byte payload is what a 33-byte column loses (#716).

What is in it

PartWhat it isWhere
Corpus201 entries of real LedgerCloseMeta bytes, each tagged with its CAP, with the facts a correct reader must returnentries/
Hazard registry77 named ways readers break, in 8 layers, each with its evidencecaps/registry.json
Schema and manifestJSON Schema 2020-12 for an entry; a generated index of every variantschema/v1
Mined ledgers37 real mainnet and testnet ledgers from the public data lake, for shapes only a real network produces, or worth having as real network bytesmined/
RecipesTransactions for a bare standalone stellar-core that regenerate every generated variantrecipes/
ToolsVerify, oracle, coverage, generate, order scan, conformance and replay, each a make targettools/

Check every claim yourself

The numbers on these pages come from the repository's own data or from a make target you can run, and each page names which. Start with Quickstart.

Not built yet

The RFP also asks for an indexer linter and an indexer-hardening guide, and XDRProof will ship as a GitHub Action and packages. None of these exist in the repository yet. The registry already marks the hazards the linter and the guide will cover.

Early, built in public

This repository backs a proposal to the Stellar Community Fund's RFP XDR/CAP-Coverage Audit Tool and Indexer-Hardening Guide (SCF #46). The corpus grows entry by entry from here. XDRProof is an independent open-source project, not affiliated with or endorsed by the Stellar Development Foundation.

On this page