{"criteria_id":"settlement-evidence/v1","criteria_family":"settlement-evidence/v1","version":"1.0.0","corpus":{"id":"chain-reconcile-corpus/v1","sha256":"0f62e010a21c0a70cacb1aa6cefe58cec9ddc8fd001bc900fd11626a4b2f9749"},"corpus_pin_definition":"The corpus pin is the SHA-256 of the corpus's canonical serialization (the corpus object excluding its sha256 field), computed and verifiable by the published harness (harness.mjs).","network":"solana-mainnet","asset":{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","decimals":6},"price":{"usdc_units_per_call":50000,"label":"$0.05","basis":"per report"},"free_tier":{"per_day":100,"min_interval_ms":5000,"on_exhaustion":"402"},"input":{"body":"One JSON request body: { parent, hops, caller? (free pre-check only) }. parent is { reference, capUnits }; hops is an array of 1 to 20 hop records in chain order.","parent":"Required. reference is a non-empty caller string naming the parent operation (echoed in the report; never graded). capUnits is the parent (ancestor) cap in USDC micro-units: a positive u64. The cumulative submitted hop amounts must not exceed it.","hop":"Required per hop, in order: hop_id (non-empty string, unique in the set), signature (the hop payment transaction signature, base58, 32-128 chars), expected { payTo (required Solana wallet), amountUnits (required, positive u64, EXACT), tokenAccount? , memo? }, capUnits (required, positive u64: this hop's own cap).","over_cap":"A request body over 262,144 bytes is a free pre-gate refusal naming the cap (413, CAP-EXCEEDED:body_bytes)."},"max_hops":20,"verdicts":["CHAIN-SETTLED","CHAIN-UNSETTLED","CHAIN-MISMATCH","CHAIN-CAP-EXCEEDED"],"engine_verdicts":["SETTLED-MATCH","SETTLED-MISMATCH","NOT-FOUND","PENDING","FAILED"],"cap_states":["WITHIN-CAP","CAP-EXACTLY-MET","CAP-EXCEEDED-HOP","CAP-EXCEEDED-PARENT"],"rules":{"chain":"Each hop, in submitted order, is chain-verified with the settlement-evidence/v1 engine (verifySettlement, build/engine.mjs imported unchanged, sha256 pinned in this config) using that hop's own expected fields: payTo, amountUnits (EXACT u64 equality, never >=), tokenAccount when supplied, memo when supplied.","propagation":"When a hop's engine verdict is NOT-FOUND, PENDING, or FAILED, that hop is unsettled: the overall verdict is CHAIN-UNSETTLED naming the first such hop, with the engine verdict propagated per hop — never upgraded to settled or to a mismatch on chain facts that were not established.","mismatch":"When a hop's engine verdict is SETTLED-MISMATCH, the overall verdict is CHAIN-MISMATCH naming the first such hop and the engine's mismatch_field (instruction_type / destination / amount / memo).","cap_arithmetic":"Ancestor-cap arithmetic runs over the SUBMITTED amounts and caps, in hop order, regardless of chain outcome, and is printed per hop: amount_units (the hop's submitted expected amount), cap_units (the hop's own cap), cumulative_units (the running sum of submitted amounts through this hop). A hop is CAP-EXCEEDED-HOP when its amount exceeds its own cap; CAP-EXCEEDED-PARENT when the cumulative sum through it exceeds the parent cap; CAP-EXACTLY-MET when its amount equals its own cap or the cumulative sum equals the parent cap exactly (exactly met is NOT exceeded); otherwise WITHIN-CAP.","precedence":"CHAIN-UNSETTLED outranks CHAIN-MISMATCH, which outranks CHAIN-CAP-EXCEEDED; CHAIN-SETTLED requires every hop SETTLED-MATCH and no cap exceeded at any hop. Per-hop factors are printed for every hop in every verdict, so a lower-ranked finding is never hidden by the overall verdict.","no_composite_score":"Factors are printed per hop; there is NO composite score.","scope_fence":"SCOPE FENCE — RECORDS LEG ONLY: the live delegation / enforcement leg is EXCLUDED-SHAPE (FIX-CANDIDATES X3). It is not built, not implied, and not graded by this service. This service never holds keys, never signs a hop payment, never enforces a cap, and never moves funds; it reconciles submitted records against the chain and reports."},"engine_interface":"verifySettlement({ signature, expected }, rpc) -> verdict object; rpc is async (signature) => getTransactionResult | null. The engine is build/engine.mjs (sha256 960bf69968eba82249a0cf44f874dea3a09f17591108db03b3fb10e446248567), copied BYTE-IDENTICAL from the M-20 build and consumed through this pinned interface only; the identical block is delimited in this worker.","engine_sha256":"960bf69968eba82249a0cf44f874dea3a09f17591108db03b3fb10e446248567","boundary_b1":"Boundary vs B1 (M-20 settlement verification): B1 verifies ONE transaction against expected fields the caller supplies, per call. B4 (this service) verifies a submitted HOP CHAIN: it runs B1's engine, imported unchanged, once per hop, and adds ancestor-cap arithmetic over the submitted caps. B1 does no cap arithmetic and no chain-of-hops verdict; B4 does not replace B1's single-lookup call.","boundary_q25":"Boundary vs Q-25 (master queue M-48): Q-25 reconciles decision-to-effect inside subset S; this service (B4) reconciles payment-to-payment across a submitted hop chain. Q-25 grades operator-asserted run figures against anchored settlements inside its subset; B4 grades each hop payment against the chain and the submitted caps, hop by hop. The two do not share deliverables.","scope_fence":"SCOPE FENCE — RECORDS LEG ONLY: the live delegation / enforcement leg is EXCLUDED-SHAPE (FIX-CANDIDATES X3). It is not built, not implied, and not graded by this service. This service never holds keys, never signs a hop payment, never enforces a cap, and never moves funds; it reconciles submitted records against the chain and reports.","custody":{"ledger_closed_fields":["payer wallet","timestamp","day","price (USDC units) with the CAD fair-market-value block (rate, rate date, basis, cad_pending, refund — null unless refunded)","payment tx id","Solana fee (lamports)","criteria version","op","verdict line","parent reference","hop count","verdict","named hop","house flag"],"ledger_note":"The ledger list above is closed: adding a field is a criteria/handling version change.","retention":"Submitted hop record sets are read once at call time and are never stored — not in KV, not in logs, not in the payments ledger, not in metrics. The payments ledger records only the closed field list published in the criteria (payer, time, price, the service's own payment tx, the parent reference, the hop count, and the verdict). Because nothing is kept, a paid retry re-sends the hop record set."},"payment_includes":"$0.05 per report. The payment includes: one multi-hop payment-chain reconciliation report — one submitted hop record set (a parent reference with its cap, plus per-hop payment references with the expected fields and the per-hop cap for each hop) — returned as per-hop chain verification via the settlement-evidence/v1 engine imported unchanged, ancestor-cap arithmetic over the submitted caps, one verdict (CHAIN-SETTLED / CHAIN-UNSETTLED with the named hop / CHAIN-MISMATCH with the named hop and the mismatching field named / CHAIN-CAP-EXCEEDED with the named hop), factors printed per hop, and an as-of timestamp. There is NO composite score. RECORDS LEG ONLY: this service reconciles submitted records against the chain; it does not delegate, enforce, sign, or move funds. Nothing about the submitted hop set is stored beyond the payments ledger's closed field list.","unsigned_statement":"Not applicable to this service: no receipt header is graded here. Each hop is verified against the chain itself via the settlement-evidence/v1 engine; the chain, not a header or a submitted record, is ground truth for settlement.","kill_line":"Kill line (M-25, under the operator's 2026-11-03 zero-demand doctrine): build, bank, and hold; judged at the fleet's periodic reviews. There is NO demand kill line for this item. Tripwires, all stop-and-review: refunds >5% of paid calls in any 30-day window; free use >10x paid use; a wrong verdict from undisclosed stale or partial data (stop-serving under the affected criteria version, per the corpus re-pinning discipline in the criteria).","service":"chain-reconcile","endpoints":{"criteria":"GET /criteria (free)","precheck":"POST /precheck (free, input-shape validation + assessability only; no chain read, no verdict)","reconcile":"POST /reconcile (paid, $0.05 per report: signed chain reconciliation report — per-hop engine verdicts and found fields, ancestor-cap arithmetic per hop, one overall verdict, as-of timestamp)","metrics":"GET /metrics"}}