Gate 3: Wallet signer BTC operations

[geraldarthurdavis]

Summary

• define BTD-owned BTC fee quote lifecycle, signer-session recovery, blocked-readiness receipts, and operation posture
• expose JSON-safe BTC fee operation posture from the BTC fee route
• add a source-safe Terminal Wallet/BTC transaction detail section and projection tests
• document Gate 3 in the V29 spec family and wire the gate checker into CI

Validation

• pnpm run check:v29-gate3
• node scripts/check-v29-gate1-objectives-and-gating.mjs --skip-branch-check
• node scripts/check-v29-gate2-terminal-transaction-read-models.mjs --skip-branch-check
• node scripts/check-bitcode-spec-family.mjs --version V29 --mode draft --current-target V28
• node scripts/check-bitcode-spec-family.mjs --version V28 --mode promoted --current-target V28
• node scripts/check-bitcode-canon-posture-drift.mjs --active-canon V28 --draft-target V29
• node scripts/check-bitcode-canonical-inputs.mjs --current-target V28
• pnpm --filter @bitcode/btd test
• pnpm --filter @bitcode/btd typecheck
• pnpm --filter @bitcode/api exec tsc --noEmit --pretty false
• pnpm --dir uapi exec tsc --noEmit --pretty false
• pnpm --dir uapi exec eslint . --ext .ts,.tsx --quiet
• pnpm --dir uapi exec jest --runTestsByPath tests/terminalTransactionQuery.test.ts tests/terminalTransactionReadModel.test.ts tests/terminalWalletBtcOperation.test.ts tests/terminalTransactionDetail.test.ts tests/terminalTransactionDetailCards.test.tsx tests/terminalTransactionDetailSnapshot.test.ts tests/terminalJournalReconciliation.test.ts --runInBand
• bash scripts/find-uppercase-raw-promptparts.sh && bash scripts/check-import-casing.sh
• pnpm --filter @bitcode/pipeline-asset-pack typecheck && pnpm --filter @bitcode/pipeline-hosts typecheck
• pnpm --filter @bitcode/pipeline-asset-pack exec jest --config jest.config.cjs --passWithNoTests --forceExit && pnpm --filter @bitcode/pipeline-hosts exec jest --config jest.config.cjs --passWithNoTests --forceExit
• pnpm test:qa:v28:pipeline-readback
• npm --prefix protocol-demonstration test && npm --prefix protocol-demonstration run test:v28-mvp-qa
• git diff --check
• node scripts/check-bitcode-pre-commit.mjs

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
engi-uapi	Ready	Preview, Comment	May 20, 2026 4:41pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d026802851

ℹ️ 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]

Preserve receipt finality when signer session is absent

buildBtcFeeOperationPosture short-circuits to blocked whenever signerRecovery.canSign is false, before it considers an existing receipt. In this commit, buildBtdBtcFeeTransactionSettlement now always emits operationPosture, but non-prepare actions (mark_signed/mark_broadcast/observe) do not require a live payerSession, so settled receipts can be reported as blocked purely because the session is missing or expired. That misclassifies already-broadcast/confirmed transactions and can hide true finality state in downstream UI/read models.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Map quoted operation phase instead of downgrading to quote_pending

The terminal projection normalizer does not accept the backend operationPosture.phase value quoted, so accepted-quote/no-receipt posture falls through and is displayed as quote_pending. In this commit, backend posture explicitly uses phase: 'quoted' for a ready-to-prepare state, so this omission causes the Wallet/BTC card summary/state to regress from “ready for PSBT preparation” to “quote still needed.”

Useful? React with 👍 / 👎.