Merge main into RFQ v2 hardening

Resolve the stacked PR branch after main advanced with the router venue binding fix, Phase 1 architecture baseline, and RFQ backend SDK documentation/code.

Constraint: PR #24 must merge after #23 and before the higher stacked PRs.

Rejected: Dropping either RFQ-002 or RFQ-SDK documentation state | both are accepted completed work on main/stack.

Confidence: high

Scope-risk: moderate

Directive: Continue stacked PR merges in order after #24 lands: #25, #26, #27, #28, #29, #30.

Tested: git diff --cached --check; scripts/check.sh

Not-tested: GitHub CI after push

Author: 0xMuang

DECISIONS.md

@@ -255,7 +255,52 @@ Router 밖 경로는 production deployment에서 다음 중 하나로 처리해
 - `ARCHITECTURE.md`
 - `docs/architecture/execution-routing.md`
 
-## D007 — RFQ v2 hardening: maker approval, full-fill, non-custodial, nonce-scoped cancel
+## D007 — PD-1~PD-7 Phase 1 architecture baseline을 확정한다
+
+Date: 2026-07-14
+
+### Context
+
+Phase 1 구현 전에 Manifest schema, Recipe evaluation, post-trade state,
+identity claim, enforcement action, governance와 lifecycle record 보존 방식에
+대한 개발팀 합의가 필요했다.
+
+이 결정들은 BUIDL-like demo나 RFQ/API 구현보다 상위의 아키텍처 baseline이다.
+
+### Decision
+
+PD-1~PD-7을 Phase 1 architecture baseline으로 확정한다.
+
+- PD-1: Manifest는 explicit core + registry-backed `RecipeBinding` 구조를 사용한다.
+- PD-2: Router/Engine은 Manifest-level multi-Recipe binding 모델을 사용한다.
+- PD-3: token transfer 기준 acquisition timestamp와 router execution context를 분리하고, post-trade commit은 idempotent하게 처리한다.
+- PD-4: investor qualification은 ERC-3643/ONCHAINID claim pipeline을 기본 인터페이스로 사용하고, Securitize/TA는 adapter boundary로 연동한다.
+- PD-5: `BLOCK`, `FLAG_ONLY`, `OPERATOR_REVIEW` 중심의 enforcement action 모델과 constrained override를 사용한다.
+- PD-6: governance authority는 외부 Safe-style multisig를 사용하고, compliance relaxation은 timelock을 요구한다.
+- PD-7: Manifest lifecycle은 semantic versioning, append-only history, central pause state와 hash-anchored record preservation을 사용한다.
+
+### Alternatives Considered
+
+- PD별 ADR을 7개로 분리: 현재 결정들이 하나의 Phase 1 구조 freeze를 구성하므로
+  단일 baseline ADR로 묶는 편이 리뷰와 추적에 더 적합해 보류한다.
+- 현행 `issuanceRecipeId + fundRecipeId` 구조 유지: BUIDL-like demo에는 충분하지만
+  future policy 조합과 path option을 표현하기 어려워 transitional 구조로만 남긴다.
+- Corner Store 전용 identity model 신설: ERC-3643/T-REX와 ONCHAINID 호환성을
+  해치고 TA/KYC provider 연동성이 떨어져 제외한다.
+
+### Consequences
+
+- PD-1~PD-7은 더 이상 열린 구조 질문이 아니며, 후속 작업은 구현 명세와 migration issue로 진행한다.
+- 현재 코드의 transitional 구조는 별도 implementation branch에서 `RecipeBinding[]`, compiled plan, lifecycle registry 등으로 이전해야 한다.
+- 실제 Securitize/TA 연동은 공식/current interface 확인 후 별도 refinement issue에서 처리한다.
+
+### Related Files
+
+- `docs/decisions/ADR-007-pd-architecture-decisions.md`
+- `docs/decisions/decision-register.md`
+- `docs/architecture/phase1-structural-decisions-proposed.md`
+
+## D008 — RFQ v2 hardening: maker approval, full-fill, non-custodial, nonce-scoped cancel
 
 Date: 2026-07-04
 

FEATURES.md

@@ -151,9 +151,60 @@ passing
 
 ### Notes
 
-- 정책 결정: D007(maker approval adapter-local, full-fill, non-custodial,
+- 정책 결정: D008(maker approval adapter-local, full-fill, non-custodial,
   nonce-scoped idempotent cancel).
 - Non-goals: partial fill, dealer inventory, signer key custody, shared dealer
   registry.
 - Deferred follow-up: router-path maker-approval/cancellation integration-test
   시나리오.
+
+## DOC-002 — RFQ SDK and MVP Demo Planning
+
+### Behavior
+
+- RFQ backend 운영을 Corner Store가 제공하지 않는다는 제품 경계를 명확히 한다.
+- RFQ backend SDK, local reference example, MVP demo backend를 서로 다른 레이어로 분리한다.
+- 구현 순서는 SDK interface 정리 → local reference example → MVP demo backend로 기록한다.
+- production RFQ hardening(dealer approval, custody, cancellation, partial fill)은 별도 트랙으로 유지한다.
+- roadmap과 product spec index에서 RFQ SDK/MVP backend 후속 작업을 찾을 수 있다.
+
+### Verification
+
+- RFQ venue architecture, product-spec index, roadmap, FEATURES, PROGRESS 교차 검토
+- `git diff --check`
+
+### State
+
+passing
+
+### Notes
+
+- Product spec: `docs/product-specs/rfq-backend-sdk-and-demo.md`
+- 이 feature는 문서 계획 작업이며 `services/rfq` 구현은 후속 feature에서 진행한다.
+
+## RFQ-SDK-001 — RFQ Backend SDK Interfaces
+
+### Behavior
+
+- `services/rfq`가 RFQ backend를 만들기 위한 TypeScript SDK helper를 제공한다.
+- integrator는 `createRFQService(...).quote(...)` high-level API로 taker/token/amount/venue만 넣고 `RFQAdapter` 호환 signed quote를 받을 수 있다.
+- SDK는 EIP-712 typed-data shape, chainId/verifyingContract binding, nonce, expiry, amount validation과 signature flow를 처리한다.
+- signer, nonce store, pricing provider, inventory/risk check는 교체 가능한 interface로 제공한다.
+- local reference component는 `InMemoryNonceStore`, `FixedRatePricingProvider`, `NoopInventoryRiskCheck`로 제한한다.
+- production server, hosted backend, pricing strategy, signer custody, inventory management와 compliance final decision은 범위 밖이다.
+
+### Verification
+
+- `cd services/rfq && npm test`
+- `scripts/check.sh`
+- `git diff --check`
+
+### State
+
+passing
+
+### Notes
+
+- SDK README: `services/rfq/README.md`
+- Product spec: `docs/product-specs/rfq-backend-sdk-and-demo.md`
+- MVP demo backend는 이 SDK를 기반으로 후속 feature에서 구현한다.

PROGRESS.md

@@ -20,6 +20,8 @@ source of truth로 사용한다.
 - `FND-001 — Foundry Product Foundation`
 - `RFQ-001 — Reference RFQ Settlement`
 - `RFQ-002 — RFQ v2 Hardening`
+- `DOC-002 — RFQ SDK and MVP Demo Planning`
+- `RFQ-SDK-001 — RFQ Backend SDK Interfaces`
 - multi-venue 아키텍처와 책임 문서 작성
 - Corner Store용 Uniswap v3 최소 배포 profile 분리와 테스트
 - ExecutionRouter/VenueRegistry/VenueSelector와 AMM reference adapter skeleton
@@ -28,47 +30,59 @@ source of truth로 사용한다.
 - RFQ-002: operator-curated maker approval allowlist(`setMakerApproved`,
   `RFQMakerNotApproved`), maker-initiated nonce-scoped idempotent cancellation
   (`cancelQuoteNonce`/`cancelQuoteNonces`, `RFQQuoteCancelled`), venueType binding
-  fix, `docs/rfq-threat-model.md` 위협 모델과 D007 결정 기록
+  fix, `docs/rfq-threat-model.md` 위협 모델과 D008 결정 기록
 
 ## Blocked
 
 - 없음
 
 ## Next
 
-1. Compliance module buildout을 최우선으로 진행한다(사용자/steering 결정):
-   reference Reg D 506(c) set을 향한 Element library → Recipe 확장 → Manifest
-   lifecycle/operator approval flow.
-2. RFQ integration-test 시나리오(router-path maker-approval/cancellation coverage)를
-   추가한다 — 이번 feature에서 deferred된 follow-up.
-3. acquisition/lot data source와 holding-period Recipe 활성화 조건을 결정한다.
-4. live Anvil deployment/E2E를 추가한다.
-5. Order Book은 matching/custody/surveillance 모델 결정 후 구현한다.
-6. CI hardening(static analysis 등)을 강화한다.
+1. MVP RFQ demo backend milestone/user flow를 별도 문서·feature로 구체화한다.
+   PR #29/#30이 머지되면 기존 live-Anvil E2E/CLI 경로를 재사용한다.
+2. pending RFQ/E2E/CLI/BUIDL PR stack(#24/#28/#29/#30/#35)이 머지된 뒤
+   roadmap과 feature 상태를 재조정한다.
+3. 남은 RFQ production policy를 별도 feature로 분리한다: custody, partial fill,
+   production dealer/operator 책임.
+4. production Asset Compliance Manifest lifecycle/schema와 operator approval flow를
+   구현한다.
+5. acquisition/lot data source와 holding-period Recipe 활성화 조건을 결정한다.
+6. Order Book은 matching/custody/surveillance 모델 결정 후 구현한다.
 
 ## Last Session Summary
 
-- 변경한 파일(docs/bookkeeping only, 이번 세션):
-  - `docs/rfq-threat-model.md`(신규 위협 모델)
-  - `docs/security.md`(RFQ Safety에 위협 모델 링크)
-  - `docs/README.md`(doc index 항목)
-  - `DECISIONS.md`(D007), `FEATURES.md`(RFQ-002), `PROGRESS.md`
-- 앞선 코드 세션(RFQ-002)에서 landed:
-  - RFQAdapter maker approval gate(`setMakerApproved`, `approvedMaker`,
-    `RFQMakerNotApproved`), maker-initiated cancellation(`cancelQuoteNonce`,
-    `cancelQuoteNonces`, `RFQQuoteCancelled`), router venueType binding fix
-  - RFQAdapter/Router Foundry tests(9 RFQ + 1 router venueType)
-- 실행한 명령:
-  - `forge fmt`
-  - `forge test --offline`
+- 변경한 파일:
+  - `services/rfq/src/types.ts`
+  - `services/rfq/src/quoteService.ts`
+  - `services/rfq/src/reference.ts`
+  - `services/rfq/src/validation.ts`
+  - `services/rfq/src/index.ts`
+  - `services/rfq/test/smoke.ts`
+  - `services/rfq/README.md`
+  - `services/rfq/package.json`
+  - `README.md`
+  - `docs/architecture/venues/README.md`
+  - `docs/product-specs/rfq-backend-sdk-and-demo.md`
+  - `docs/product-specs/index.md`
+  - `docs/testing.md`
+  - `FEATURES.md`
+  - `PROGRESS.md`
+- 완료한 작업:
+  - low-level `RFQQuoteService.createSignedQuote` 호환성을 유지하면서 high-level `createRFQService(...).quote(...)` API 추가
+  - signer, nonce store, pricing provider, inventory/risk check interface 추가
+  - local/demo reference component(`InMemoryNonceStore`, `FixedRatePricingProvider`, `NoopInventoryRiskCheck`) 추가
+  - address, chainId, TTL, on-chain integer validation helper 분리
+  - SDK quick start와 production responsibility boundary 문서화
+  - smoke test를 SDK quote flow, nonce uniqueness, unsafe number, invalid request, risk reject-before-signing까지 확장
+- 실행한 검증:
   - `cd services/rfq && npm test`
-- 통과한 검증:
-  - `forge test --offline` 133/133 유지(이번 task는 코드 변경 없음)
-  - RFQ service smoke check
-  - `docs/rfq-threat-model.md` 존재와 링크 무결성
+  - `scripts/check.sh`
 - 남은 리스크:
-  - signer key custody와 operator key management(multisig/HSM/rotation)은 open
-    decision이다.
-  - partial fill, dealer inventory, shared dealer registry는 범위 밖이다.
-  - cancel-vs-fill race는 first-lander로 해소되며 cancel은 확정 전까지 best-effort다.
-  - RFQ router-path integration-test 시나리오는 deferred follow-up이다.
+  - 아직 MVP HTTP/CLI backend는 구현하지 않았다.
+  - production signer custody, persistent nonce store, pricing, inventory/risk는 integrator/operator 책임이다.
+  - pending PR #24/#28/#29/#30/#35 merge 이후 roadmap/feature 상태 재조정이 필요하다.
+
+## RFQ-002 Merge Note
+
+- RFQ-002 hardening from PR #24 is included in this branch update: maker approval, maker nonce cancellation, venueType binding, and RFQ threat-model documentation.
+- Deferred follow-up remains router-path maker-approval/cancellation integration-test coverage after stacked PRs are reconciled.

README.md

@@ -97,13 +97,14 @@ forge fmt
 anvil
 ```
 
-### RFQ Reference Service
-
-`services/rfq` is a minimal quote signer reference for RFQ v1. It builds the
-same EIP-712 typed data that `RFQAdapter` verifies, assigns expiry and nonce,
-and returns a signed quote. It is not a production dealer, pricing engine,
-inventory manager, custody service, websocket feed, orderbook, or compliance
-decision engine.
+### RFQ TypeScript SDK
+
+`services/rfq` provides TypeScript SDK helpers for RFQ quote backends. It builds
+the same EIP-712 typed data that `RFQAdapter` verifies, assigns expiry and
+nonce, signs quotes through a caller-provided signer, and exposes pricing, nonce
+and risk-check interfaces for integrators. It is not a hosted production RFQ
+server, dealer, pricing engine, inventory manager, custody service, websocket
+feed, orderbook, or compliance decision engine.
 
 ```shell
 cd services/rfq

docs/ROADMAP.md

@@ -251,6 +251,8 @@ Deliverables:
 - signature, nonce, expiry와 taker binding
 - Router-only RFQ Adapter와 latest compliance evaluation
 - 최소 TypeScript quote signer reference service
+- RFQ backend SDK interface와 local reference example 계획은 `docs/product-specs/rfq-backend-sdk-and-demo.md`를 따른다.
+- MVP demo backend는 SDK 정리 이후 별도 feature로 구현한다.
 - partial fill policy는 v1 non-goal로 유지
 
 Completion:
@@ -317,16 +319,27 @@ SDK와 reference DEX를 반복 배포하고 Manifest/권한 상태를 검증 가
 
 ## Near-Term Issues
 
+Open PR context:
+
+- #24 covers RFQ maker approval and quote cancellation hardening.
+- #28 covers protected-router RFQ integration scenarios.
+- #29 covers live-Anvil E2E/demo runner.
+- #30 covers interactive CLI over the deployed demo stack.
+- #35 covers BUIDL-like ERC-3643 compliance fixture with mock TA facts.
+
 가까운 후속 이슈:
 
-1. `design(rfq): dealer/operator approval, custody, cancellation, partial-fill policy 확정`
-2. `security(rfq): direct venue, signer, custody, replay, quote-cancellation threat model 작성`
-3. `feat(compliance): production Asset Compliance Manifest lifecycle/schema 구현`
-4. `design(compliance): acquisition/lot data source와 holding-period Recipe 활성화 조건 결정`
-5. `test(e2e): live Anvil deployment와 regulated RFQ/AMM settlement smoke 자동화`
-6. `feat(orderbook): matching/custody/surveillance 모델 결정 후 Order Book adapter 구현`
-7. `chore(ci): deploy-v3 CI, static analysis, lint/warning budget 추가`
-8. `docs(ops): Manifest activation/suspension runbook과 incident drill 문서화`
+1. `feat(rfq): add TypeScript SDK interfaces for quote backend integration`
+2. `docs(demo): define MVP RFQ backend milestone and user flow`
+3. `feat(demo): add MVP RFQ backend using the RFQ SDK` — PR #29/#30이 머지되면 해당 E2E/CLI 경로를 재사용한다.
+4. `docs(roadmap): reconcile roadmap after pending RFQ/E2E/CLI/BUIDL PR stack merges`
+5. `design(rfq): remaining production RFQ policy beyond PR #24` — custody, partial fill, production dealer/operator 책임.
+6. `security(rfq): direct venue, signer custody, replay, quote-cancellation threat model 보강`
+7. `feat(compliance): production Asset Compliance Manifest lifecycle/schema 구현`
+8. `design(compliance): acquisition/lot data source와 holding-period Recipe 활성화 조건 결정`
+9. `feat(orderbook): matching/custody/surveillance 모델 결정 후 Order Book adapter 구현`
+10. `chore(ci): static analysis, lint/warning budget 추가`
+11. `docs(ops): Manifest activation/suspension runbook과 incident drill 문서화`
 
 ## Decision Backlog