Skip to content

design: #6 hybrid on-chain pair transport — design doc#31

Open
hanwencheng wants to merge 1 commit intomainfrom
fix/issue-6-design
Open

design: #6 hybrid on-chain pair transport — design doc#31
hanwencheng wants to merge 1 commit intomainfrom
fix/issue-6-design

Conversation

@hanwencheng
Copy link
Copy Markdown
Member

@hanwencheng hanwencheng commented Apr 14, 2026

Summary

Draft design doc for issue #6. Documents the target on-chain pair transport (chain-indexed PairRequest + ApprovePair extrinsics, TTL at the pallet level, VVC derived client-side from the signature, Pattern 4 decoupled serve/audit).

Key design refinements (locked in issue body)

  1. VVC is client-derived from the extrinsic signature (not an on-chain OTP field).
  2. Approve list shows full request details (scope, alias, pubkey fingerprint, VVC, age).
  3. valid_until is a first-class on-chain field; pallet rejects expired approvals.
  4. Latency decoupled per Pattern 4 (~50 ms serve, ~6 s audit).

Net LOC impact

~665 LOC removed (rendezvous + auth_requests + long-poll), ~200 LOC added (chain-event simulation) = net ~465 LOC reduction in the mock backend.

Review ask

Please review and answer the 5 open questions at the bottom of the doc:

  • Pallet feasibility (Kai)
  • VVC bit-width (6 vs 8 digits)
  • Soft time-window default (5 min?)
  • Encrypted child-session blob size
  • Pattern-4 async-submission failure semantics

Test plan

Docs-only. No code impact.

Issue

Tracks #6. Implementation blocked on #5 (Pattern 4 infra) + Kai's pallet review.

🤖 Generated with Claude Code

  • Codex reviewer: approved (no actionable findings)

Codex review (2026-04-14): ✅ Approved — no actionable findings. See the codex comment above for details.

Draft design doc for GitHub issue #6 (replace rendezvous relay +
auth_requests state machine with on-chain pair transport, Pattern 4
decoupled).

Ships ONLY the doc. Implementation is blocked on: (a) Pattern 4
infrastructure (issue #5) shipping first, (b) Heima pallet feasibility
review by Kai, (c) sign-off on the 5 open questions at the bottom of
the doc.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@hanwencheng
Copy link
Copy Markdown
Member Author

Codex review (via gstack /codex skill, GPT-5.4 codex-high reasoning against origin/main)

Verdict

The patch only adds a design document and does not modify executable code, tests, or existing behavior. I did not find any discrete, actionable issues in the diff that would break current functionality or make the repository incorrect.

— codex review --base main + -c 'model_reasoning_effort=\"high\"'. Design-doc-only PR; no code change to flag.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant