Skip to content

docs(uniswap): exposure-seam design note + roadmap update (PR-2 slice 1)#29

Merged
temrjan merged 1 commit into
mainfrom
docs/slice1-exposure-seam
Jun 23, 2026
Merged

docs(uniswap): exposure-seam design note + roadmap update (PR-2 slice 1)#29
temrjan merged 1 commit into
mainfrom
docs/slice1-exposure-seam

Conversation

@temrjan

@temrjan temrjan commented Jun 23, 2026

Copy link
Copy Markdown
Member

Docs companion to the PR-2 Slice 1 code (rustok-org/uniswap PR #3) — lands alongside, not later than the code (Decision #1: separate repos).

What

  • New docs/EXPOSURE-SEAM.md — the net-new "exposure-seam design note": records how an agent reaches EIP-712 signing without a bypass:
    • Q1 = (A) orchestrator + gates in the TS glue (one runtime; core stays a dumb signer).
    • Q2 = (B) transport to core signing via the gateway (single auth/audit boundary; core gRPC stays internal) — not a direct gRPC client.
    • the 3 F5 locks (sole sign-route owner · MCP exposes only request_swap · remove the dead gateway eip712 branch).
    • the Slice 1 (hermetic) / Slice 2 (live wiring) split (forced by repo boundary + hermetic form).
    • deferred invariants named for Slice 2: recover == order.swapper, trusted now, destination-token gate.
  • UNISWAP-INTEGRATION.md roadmap synced: PR-0/PR-1 ✅; PR-1 = M0 read-path prod-shipped+verified (no code; read-only demo folds into Slice 1); PR-2 split into Slice 1 ✅ + Slice 2; open fork ci: hardened CI/CD with best practices #1 (gates/transport) resolved → EXPOSURE-SEAM.md.

Docs-only; private meta. meta CI validates compose/Caddyfile (markdown untouched).

Record how the signing path is wired (the net-new exposure-seam artifact) and
sync the roadmap with reality:

- New EXPOSURE-SEAM.md: Q1=(A) orchestrator+gates in the TS glue; Q2=(B) transport
  to core signing via the gateway (core gRPC stays internal); the 3 F5 locks
  (sole sign-route owner, MCP exposes only request_swap, remove the dead eip712
  branch); the Slice 1 (hermetic) / Slice 2 (live wiring) split; deferred
  invariants (recover==order.swapper, trusted `now`, destination-token gate).
- Roadmap: PR-0/PR-1 done; PR-1 = M0 read-path is prod-shipped+verified (no code,
  read-only demo folds into Slice 1); PR-2 split into Slice 1 (done) + Slice 2
  (live wiring); open fork #1 (gates/transport) resolved -> EXPOSURE-SEAM.md.
@temrjan temrjan merged commit bcf0c99 into main Jun 23, 2026
1 check passed
@temrjan temrjan deleted the docs/slice1-exposure-seam branch June 23, 2026 09:38
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