Docs

Verification and proof

Every settlement is re-read from the chain by an independent verifier. Here is every check it runs.

Independent by design

The verifier never reads Sama's database or the executor's records. It takes only the transaction hash, the contract, the approved plan and the tokens to watch, then reads everything else from the chain, through an RPC provider that differs from the one that executed the round. Its report is stored with the round and shown on your receipt.

Independent verifier

17/17 passed

  • Receipt status is success
  • Called the settlement contract
  • Chain is BNB Smart Chain
  • Calldata matches the approved plan
  • PlanSettled event emitted
  • One event per transfer
  • Only planned transfers happened
  • Approval used on-chain
  • Plan marked settled on-chain
  • Approval nonces consumed
  • Every participant approved
  • Balances moved exactly
  • Contract holds nothing
  • Settled within the valid window
  • Prices match the round snapshot
  • Prices cross-checked on-chain
  • Read through an independent provider
The checks as they appear on a receipt.

Every check

CheckWhat it confirms
tx.statusThe receipt status is success
tx.toThe transaction called the settlement contract
chain.idIt ran on BNB Smart Chain
calldata.planThe calldata decodes to settle() with the approved plan hash
event.PlanSettledThe contract emitted PlanSettled for this plan
event.CrossingLegOne CrossingLeg event per planned transfer
event.TransferNo ERC-20 transfer happened outside the plan
event.NonceConsumedEach participant's approval was used on-chain
state.planSettledThe contract marks the plan as settled
state.nonceUsedEvery approval nonce is consumed
participants.setApprovals consumed equal the plan's participants
balances.netDeltaEach balance moved exactly by the plan's net amount, block before vs receipt block
balances.noCustodyThe contract holds none of the watched tokens
plan.windowIt settled inside the plan's validity window
plan.snapshotHashThe plan's prices are the round's snapshot
prices.independentEvery stock price was cross-checked on-chain
providers.independentVerification used a different RPC provider than execution

Public proof

The Proof page lists the settlement contract, its deploy transaction and source verification on BscScan, and every settled round with its checks. Participants are never named.

bash
# Read the same data the Proof page shows
curl https://<api-host>/api/proof