V45 Gate 14: BTC Settlement Rights Delivery Readback

[geraldarthurdavis]

Summary

• add explicit BTC settlement readback for quote acceptance, non-custodial wallet posture, PSBT posture, broadcast/observation/finality, rights transfer, repository delivery, and compensation routing
• harden source unlock and rights transfer so prepared, signed, broadcast, and observed states remain source-safe and rights-withheld until confirmed finality and quote/payment conservation
• expand repair coverage for stale quote/payment mismatch, underpayment, compensation conservation failure, projection drift, missing finality, missing delivery, and persistence; wire the Gate 14 checker and parity readback

Verification

• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs src/tests/asset-pack-settlement-rights-delivery.test.ts --runInBand
• pnpm --filter @bitcode/pipeline-asset-pack typecheck
• pnpm run check:v45-gate14
• pnpm run check:v45-gate13
• node scripts/check-bitcode-spec-family.mjs --version V45 --mode draft --current-target V44
• node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V44 --draft-target V45
• git diff --check
• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --runInBand

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
engi-uapi	Ready	Preview, Comment	Jun 1, 2026 12:18am

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a86cd9074c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Require readback before declaring settlement finalized

When the ledger/database/storage reconciliation is blocking (for example projectionMode: 'missing_database_projection' or drifted_object_storage), the boundary state correctly becomes blocked_until_projection_repair, but this readback still reports settlement_finalized based only on BTC finality and quote/payment match. V45 settlement law requires ledger/database/storage readback and repair-free receipts before final settlement, so consumers of btcSettlementReadback can route final settlement or compensation while the boundary is still in repair.

Useful? React with 👍 / 👎.