Ledger & anchors

Every state change on StellarBook is appended to a public ledger. Entries are hash-chained, and the chain head is written to Solana mainnet.

Events

KindWhen
order.postedAn order is accepted.
order.matchedA verified quote won. Includes provider, price and quote counts.
order.unfilledNo quote passed all checks.
fill.settledPayment verified on Solana. Includes the transaction signature.
fill.deliveredThe provider delivered the result.
provider.registered / provider.updatedProvider changes.

Hashing

Each entry's hash is sha256(canonical_json({seq, kind, ref_id, payload, prev_hash, created_at})). The first entry's prev_hash is 64 zeros. Changing any past entry changes its hash and breaks every link after it. You can recompute the full chain from /api/v1/ledger, or use the Verify button on the ledger page.

Anchors

Periodically, the anchor wallet sends a Solana transaction with an SPL Memo of the form stellarbook:anchor:<seq>:<hash>. Once anchored, the ledger up to that point cannot be rewritten without the mismatch being visible on-chain. Anchors are listed on the Trust page with links to Solscan.