Skip to content

Latest commit

 

History

History
2974 lines (2293 loc) · 138 KB

FEATURES.md

File metadata and controls

2974 lines (2293 loc) · 138 KB

Features

State Rules

  • not-started → active: 해당 feature 작업을 시작할 때
  • active → passing: 모든 Verification이 통과했을 때
  • active → blocked: 외부 정보나 결정이 없어 진행할 수 없을 때
  • blocked → active: 차단 사유가 해소되었을 때

동시에 하나의 feature만 active 상태로 둔다.

CORE-015: Compliance Reporting and Settlement Reconstruction

Behavior

  • Issue #132 items 6, 7 and 11 are additive reference capabilities. Item 12 is operational RFQ risk disclosure only: INVENTORY_LIMIT_EXCEEDED, RISK_LIMIT_EXCEEDED and PRICING_OUTSIDE_LIMITS. Tiered compliance outcomes for qualification, holding period, jurisdiction and other Element failures remain OPEN pending a counsel-approved taxonomy; no compliance bridge is implemented.
  • Opt-in RegD506cRecipeV5 appends A-12-v2 to V3's nine blocking requirements. RedFlagKnowledgeBarV2 declares matching FLAG_ONLY metadata, fixing the wave-3 registration mismatch while preserving separate, nonblocking assessment APIs/events. Assessments do not populate Engine flags. Direct scripts and CLI accept reg-d-v5; default BUIDL-like and reg-d v3 selection are preserved. Reg D v5/A-12 v2 are reference-only and non-production-activatable pending the item 13 public-disclosure decision (D044). Production onboarding rejects them and the production registry rejects A-12-v2. Migration instructions apply only to local reference assets.
  • New Router deployments emit SettlementExecutedV2 after successful commit with execution ID, venue, token pair, fresh policy ID and measured input/output in token base units. Legacy events, return values and execution ID derivation retain their meanings. CLI decodes both versions. Indexers prefer V2 per deployment/execution, use legacy fallback and deduplicate canonical logs by chain ID, transaction hash and log index.
  • An explicitly deployed ComplianceReporter evaluates every active compiled requirement across both regulated legs with the exact bound parameters. It returns public pass/fail, undetermined and nonapplicable diagnostics separately from the authoritative Engine outcome. Diagnostic path/flag failures do not introduce new settlement restrictions; reports are snapshots, not authorization.
  • A-01, A-12 and all F-* versions share one opaque restricted outcome. Individual sensitive rows/reasons/paths/counts are omitted; decision reason, flags and relied claims are redacted whenever restricted checks are present, including when nonapplicable. Existing public-chain data remains public. Toolkit exports a typed reader requiring an explicit pinned block reference.
  • RFQ risk rejection may carry recognized operational identifiers. An optional startup-snapshotted JSON policy maps them to detailed, action_only or generic literal messages. HTTP 422/risk_rejected remains the default body; approved disclosure is additive. Missing/invalid policies and unknown, malformed, unallowlisted or sensitive reason lists suppress all disclosure. Authentication, exact taker binding, signing/reservations and replay behavior retain their existing meanings. Provider text is never interpolated.

Verification

  • npx --yes -p node@20 -p yarn@1.22.22 -c 'scripts/check.sh': passed the full gate, including Foundry 1,211/1,211 across 73 suites (0 failed, 0 skipped), all 10 service smoke suites, two generated adapter conformance runs at 4/4 each, clean packaged-consumer checks and deploy-v3 10/10.
  • npx --yes -p node@20 -c 'scripts/e2e-anvil.sh': passed BUIDL-like 7/7 scenarios and 30 additional explicit PASS checkpoints.
  • npx --yes -p node@20 -c 'scripts/e2e-anvil.sh --profile reg-d': passed Reg D 7/7 scenarios and 20 additional explicit PASS checkpoints.
  • npx --yes -p node@20 -p yarn@1.22.22 -c 'npm run test:reporter-runtime --prefix services/toolkit': passed compiled ABI/SDK parity and four Anvil cases: unknown denial, unregulated pass, public/restricted failures and historical snapshot.
  • forge build tools/deploy-wave3/DeployWave3Elements.s.sol: passed.
  • forge fmt --check and git diff --check.

State

passing

Notes

  • PR #161 review fixes preserve the existing A-04-v2 meaning of immutable Reg D v4 and move the A-12 reference composition to v5. Production deployment and bytecode verification now agree on ProductionElementRegistry; the packed 28-transaction deployment, verification, tampering and recovery suite passes. RFQ host 30/30, Toolkit 78/78 and CLI 19/19 pass under Node 20. Production activation of A-12 remains prohibited pending D044.
  • Integrated and verified on 2026-11-10 with Foundry 1.7.1 and Node 20 after frozen-lockfile deploy-v3 installation and npm ci in all nine gate services with lockfiles. The initial gate failed its stale A-12-v1 source assertion; the checker now requires A-12-v2 and explicit FLAG_ONLY registration.
  • Decisions D024 through D027 record migration, canonical event selection, restricted reporting and RFQ disclosure. Counsel questions remain open; this feature does not establish legal adequacy, retention or chain-wide secrecy. PR #161 remains draft; item 12 compliance taxonomy and item 13 are OPEN.
  • Specs: requirement reporting, settlement reconstruction, Reg D v5, A-12 v2 and RFQ disclosure.
  • Coordinated minor SDK release/package promotion and explicit deployment adoption remain follow-up work. Docker image gates, live public-network behavior and production provider/custody/retention integrations were not verified here.

DEPLOY-004: Complete and Append-Only Production Evidence

Behavior

  • Evidence version 2 binds resolved compiler inputs, the production deployer, orchestration, exact tool/dependency identities, compiler settings and bytecode templates through canonical domain-separated SHA-256 commitments.
  • Plans, unsigned exports, reviewed evidence and deployment records share one evidenceId over source/build/provenance, configuration, chain and wiring. Clean Git provenance is required for broadcast. Dirty, source-only and unavailable provenance supports diagnostics only.
  • Production artifacts and signable exports reserve destinations and publish complete validated envelopes exclusively through fsync and hard-link creation. Receipts, reconstructed runtime bytecode, owners/operators and wiring must verify before deployment publication. Reservation setup rolls back staging and reservation state on failure; typed errors expose exact paths if rollback also fails. Recovery revalidates returned operations without rebroadcast.
  • Publication requires current-uid/root-owned staging/output directories and ancestry, without group/world writes except sticky ancestors. Trust is checked before reservation and again at publication; mismatch cleanup is best effort inside verified output ancestry. Same-uid concurrency is outside this boundary.
  • Version 2 verification requires the independently trusted recordDigest and reviewed evidence identity. Legacy artifacts/review files remain readable; legacy review evidence cannot authorize new deployments. Public Monad records, contracts and demo runtime remain unchanged.

Verification

  • Toolkit/CLI source/build/provenance mutation, package/runtime equivalence, publication failure/concurrency/SIGKILL/recovery and chain tampering tests.
  • Review regressions replace staged entries/parents during linking, reject unsafe staging ownership/permissions, preserve another writer's final, and block hidden index-flag edits, submodule edits and missing HEAD blobs.
  • Trust-boundary regressions reject writable/foreign-owned ancestry and output directories before reservation, accept sticky ancestors, recheck before linking and skip mismatch cleanup in untrusted output directories.
  • Reservation fault injection covers operation/reservation/probe writes, file and directory fsync, hard-link probes, successful rollback and typed cleanup paths.
  • Packed clean Git-backed consumer: real production dry-run/fork, export, deployment and verification with one evidenceId; source-only broadcast denial.
  • Existing public artifact listing, pinned hash, CLI/Operator API reads and exact byte preservation without live-chain readiness checks.
  • scripts/check.sh, both scripts/e2e-anvil.sh profiles, scripts/e2e-context-provenance.sh, scripts/e2e-identity-evidence.sh, whitespace and protected-path comparisons.

State

passing

Notes

  • Issue #154; D037-D039 defaults adopted, team-to-confirm.
  • Publication trust-boundary recheck verified on 2026-11-11: seven new guards failed before implementation; all 20 publication cases now pass. Toolkit 74/74, CLI 19/19, legacy 2/2 and the full gate passed, including 50 packed production assertions and live Anvil deployment/recovery. See the latest PROGRESS entry.
  • Review hardening on 2026-11-17 makes reserve() transactional before return; six setup faults leave no reservation/staging state, and failed cleanup returns a typed error with exact operator cleanup paths.
  • Review fixes verified on 2026-11-11: 1,171 Foundry tests, 66 Toolkit/19 CLI named tests, 50 packed production assertions and two public compatibility cases. Legacy profiles passed 7/7 each; context 12/12; identity 40/40. An unrelated RFQ nonce-order assertion failed once; isolated RFQ and the full rerun passed. See PROGRESS for attempts and logs.
  • Plan: docs/exec-plans/completed/DEPLOY-004-append-only-production-evidence.md.
  • Main remains at 7893021 as of the step 3 sequencing check. Prerequisite PRs must merge before release; this authorized work proceeds on the supplied stack.
  • Key management, custody and multisig expansion remain deferred. No external vendor, production-chain broadcast or public deployment is part of this work.

DATA-004: Operator-Accepted Identity Evidence and Topology Guards

Behavior

  • Opt-in onboarding schema 7 declares per-recipe RFQ/TSV track and explicit DIRECT topology through required, exact A-04-v2 ManifestPolicyConfig bytes. Missing/unknown/MEMBER topology, nonblocking bindings and enforcement downgrades fail closed at registration and update. Schema 6 context checks remain required; schemas 1-6 retain their original meaning. Active RFQ support additionally requires an explicit blocking RFQ identity policy in Toolkit and its matching ManifestPolicyConfig schema 2 marker on-chain.
  • Separate A-04-v2 evidence binds identity, wallet and asset to issuer ID, issuedAt, expiry, trust basis, type and keyed commitment. Binding creates no accepted evidence. Current operator-managed issuer trust gates every trade.
  • SPI 2.0.0 requires explicit operator acceptance and strict audit. One local env/file HMAC key belongs to compliance-data, never operator-api. V2 domains, records, exports and unsigned acceptance codecs remain separate from v1. The coordinator rekeys every provider-controlled public reference before use.
  • Optional format/checksum-validated LEI stays off-chain and participates in evidence commitments; no eligibility or sanctions policy requires it.
  • Reg D v4 opts into A-04-v2 while retaining the other v3 elements and the C-01 AMM restriction. Named RFQ v2/v3 and AMM invariants prove the existing self-directed settlement binding without settlement contract changes.
  • Existing deployments, recipes, events, API responses and live public Monad RFQ v2 paths retain their meaning. Four P2 PR slots are scheduled separately.

Verification

  • Foundry topology/composition, issuer authorization/lifecycle, identity evidence, 256-run full-word parameter fuzzing, v1 compatibility and deployed-size tests.
  • Compliance-data v1/v2 provider conformance, HMAC/replay/conflict/audit/expiry and optional LEI tests; Toolkit schema 7/codec/verifier and CLI tests.
  • HTTP v2 same-case revocation, acceptance-export rejection, stale approval replay and independent per-asset materialization; shared-store conformance detects reused references while identical-reference conflicts remain rejected.
  • 42 named settlement-binding tests plus recipe, missing-evidence and size regressions; isolated scripts/e2e-identity-evidence.sh (40 live cases).
  • scripts/check.sh, both scripts/e2e-anvil.sh profiles, scripts/e2e-context-provenance.sh, whitespace and protected-path checks.

State

passing

Notes

  • Confirmed P2 assessment-reference collision fix: three regressions failed before the fix; all 25 compliance-data and 30 Toolkit tests, the full check and identity E2E (40/40) passed afterward. See PROGRESS for commands/results.
  • Final release gates passed on 2026-11-11: 1,171 Foundry tests; both legacy profiles 7/7 scenarios plus runtime flows; context 12/12; identity 40/40. The full check passed after updating the stale packed schema-6 assertion.
  • Issue #159 decisions 24-29 map to D031-D036. D036 records scheduled design, not implemented sanctions support. Reserved upstream IDs are unchanged.
  • Specs: docs/product-specs/identity-policy-topology.md, identity-evidence-v2.md, identity-settlement-binding.md and identity-p2-schedule.md in the same directory.
  • Counterparty evidence requires explicit operator enablement. Restoring the exact issuer trust basis can restore unexpired evidence; revoke individual records when reinstatement is unwanted. The reference store is in-process.
  • TokenPolicyRegistry runtime is 24,570 bytes with the pinned compiler, leaving 6 bytes below EIP-170. The size regression must remain passing; further growth requires deliberate size reduction.
  • MEMBER, pseudonyms/off-chain wallet mapping before TSV launch, asset cards, jurisdictional lists, key management/custody/multisig and external vendors remain deferred. Passing this feature does not establish TSV launch readiness.

RFQ-006: Bounded Lifetime and Pre-Pricing Product Authorization

Behavior

  • Production RFQ v2/v3 hosts authenticate and rate limit before bounded TTL and local product authorization, then perform pricing, risk, reservation and signing.
  • Authoritative product authorization and original expiry persist with the request; replay never refreshes policy or signature. Failures use bounded, redacted codes.
  • Default TTL is 60 seconds, default maximum 300 seconds, hard maximum 3600 seconds. Lightweight legacy SDK usage and protected public demo paths remain compatible.

Verification

  • RFQ/coordinator and host ordering, TTL boundary, persistence/replay and taxonomy tests
  • Typed store failures: alternate diagnostic messages preserve v2/v3 conflict 409, inventory 409 and missing-inventory configuration 500 responses
  • Both endpoint versions: auth/limiter/audit/incident ordering including audit failure; deeply nested TTL preserves auth/limiter ordering and bounded rejection; both evidence APIs: PUBLISHED/RESERVED replay after catalog policy drift; terminal SIGN_FAILED/expired reservation retries return 400, unexpected errors 500
  • Node 20 RFQ, host, Toolkit and CLI tests
  • forge fmt --check, forge test --offline, scripts/check.sh, git diff --check
  • Both scripts/e2e-anvil.sh profiles and scripts/e2e-context-provenance.sh

State

passing

Notes

  • Issue #155; D030. HACK-001 closure is owned by approved upstream PR #162.
  • Scope excludes contracts, custody/key management and the store creation flake.
  • Nested TTL follow-up: six regressions failed with 500 before the fix and passed afterward; Node 20 host/RFQ suites and scripts/check.sh passed. See PROGRESS.
  • Final verification: 1,100 Foundry tests; Node 20 RFQ/host/Toolkit/CLI smoke and 30/18/15/5 named tests; full repository gate; both legacy Anvil profiles and 12 context-provenance E2E cases passed after F1-F3 fixes. See the 2026-11-11 confirmed review fixes PROGRESS entry.
  • Production evidence callers must configure catalogs. Older records without a persisted grant require draining and a fresh request namespace/store.

HACK-001 — Monad Onchain Finance RFQ Demo

Behavior

  • 기존 public-testnet RFQ deployment와 artifact-bound browser runtime을 Monad testnet(chain ID 10143)에서 재사용하며 Core/RFQ 계약을 해커톤 전용으로 fork하지 않는다.
  • browser pre-check 거부는 raw reasonCode만 노출하지 않고, 사람이 이해할 수 있는 차단 사유, 필요한 다음 조치와 증거로 확인 가능한 해제·만료 시각을 함께 표시한다. 시간 근거가 없으면 임의 ETA 대신 operator/user action 필요를 명시한다.
  • 선택형 해커톤 fixture는 다른 투자자의 freshness를 약화하지 않고 별도 지갑에 만료된 QP 증빙을 주입해 success, qualification-required, holding-period와 claim-expiry 네 장면을 같은 배포에서 재현한다.
  • Monad 배포 artifact, 심사위원용 HTTPS live URL, fixture wallet 안내와 측정된 test transaction evidence를 제공하되 real asset, production issuer onboarding, real TA/KYC 연결 또는 규제 준수를 주장하지 않는다.
  • judge-facing copy는 fictional asset을 Demo Restricted Security (DRS)로 표시한다. Compliance, Venue, Qualified Purchaser는 제품과 A-13 정책의 canonical technical term으로 유지하되 reference/demo 한정과 비법률판정 면책을 같은 화면에 표시한다.
  • broadcast는 clean checkout의 정확한 source commit만 허용하고, 완성된 candidate artifact의 on-chain wiring 검증이 끝난 뒤 append-only record를 원자적으로 발행한다.
  • public runtime은 listen 전에 artifact schema, owner/operator, core/identity wiring, wallet identity binding, venue, maker와 inventory를 다시 검증한다. chain-reading endpoint와 quote issuance에는 proxy header에 의존하지 않는 global budget과 bounded timeout을 적용한다.
  • 공개 API는 allowlist된 request validation 오류만 400 invalid_request로 반환하고, RPC/runtime dependency 장애는 503 service_unavailable, 분류되지 않은 내부 오류는 500 internal_error로 원문을 숨긴다. 두 server failure는 PII/secret-free operator event만 남긴다.
  • 보유기간 남은 시간은 browser wall clock이 아니라 관측한 chain timestamp를 기준으로 표시한다. 검증 가능한 availability evidence를 읽지 못하면 임의 시간을 표시하지 않고 재조회 또는 operator 확인이 필요하다고 안내한다.
  • judge quick start는 공개된 Monad network metadata로 browser wallet을 추가·전환하고, scenario account 또는 chain 변경 시 stale signer/quote 상태를 폐기한다.
  • 제출 전 rehearsal gate는 HTTPS, same-origin response, security headers, chain 10143, startup verification, Maker/Manifest/inventory readiness와 필수 세 장면을 검증한다. 선택적으로 다운로드한 settlement evidence의 deployment/source/contract/participant/ token/transaction/block/측정 시간을 같은 live state에 대조한다.
  • 기존 Anvil showcase와 public testnet 흐름은 변경하지 않는다.

Verification

  • npm test --prefix services/testnet-rfq-demo
  • npm test --prefix services/cli
  • Monad RPC chain-id/readiness preflight
  • verified deployment artifact와 browser-wallet RFQ settlement
  • dirty/source-mismatch broadcast rejection과 candidate-before-publish 검증
  • artifact/on-chain wiring mismatch startup rejection
  • global API/quote budget과 chain-time countdown regression
  • request-validation 400 / internal 500 / runtime-upstream 503 classification regression
  • public-testnet/CLI stable reason catalog parity
  • wallet network add/switch 및 account/chain change reset regression
  • clean-browser live URL rehearsal
  • hosted URL/evidence fail-closed rehearsal regression
  • scripts/hackathon-monad-container-smoke.sh OCI build/metadata/runtime-module/Compose contract
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • 2026-11-10: closed HACK-001 as passing by team decision after the 2026-10-14 hackathon deadline. This records the delivered demo and the incomplete work explicitly; it does not assert that every original verification item was completed. Not completed before the hackathon ended: judge wallet guide, browser-wallet settlement with the --evidence rehearsal, and explorer source verification.

  • The public demo at https://161.33.155.224 remains an operational task, with acquisition evidence renewal every 30 days via scripts/refresh-testnet-evidence.sh. Next renewal must occur before 2026-12-08 00:00 UTC (1796688000).

  • 2026-11-10 read-only live verification: /health and /api/state returned HTTP 200, chain ID 10143, source e7345b3, startup verification true, and maker/Manifest readiness true. For 5,000,000 tokens, /api/precheck returned HTTP 200 for all four scenes: success buy allowed=true (zero reason), qualification buy allowed=false / FAIL_NOT_QP, investor B sell allowed=false / HOLDING_PERIOD_NOT_ELAPSED (availableAt 1822982925), and expired-claim buy allowed=false / FAIL_QP_CLAIM_EXPIRED (evidenceExpiredAt 1791360525). Maker approval, inventory and allowance checks passed in all four responses. No signing or settlement was performed.

  • 2026-11-10 acquisition renewal: cast call acquisitionOf confirmed all five snapshots have expiresAt=1796688000 and status VALID; investor B retains clockStart=1791446925. QP claims were intentionally untouched. Renewal transaction hashes and blocks from the operator's Foundry broadcast records:

    Subject Transaction hash Block
    maker 0xecc681892fc3c8762f4c919fef110e2a3ae906c7f2bac18d814831098b7c1190 78557916
    investor 0x8d193993f60206a8c450a4d47a627252ca31f987dc00c888e3d2892e767347f3 78557960
    eligibleInvestorB 0xaca0c93e24b06337e34f492a0251ae7017c222137dc81deb00d122b27aa4ec48 78557990
    ineligibleInvestor 0x01cf83b2e616cb10a58688f969516c244f365b4dfc4062e688fdb62611ac90e3 78558026
    expiredInvestor 0x7e57d1fb7daca265755b4b6bf5502a5980a7043bb9b08258275337e37edcdd13 78558064
  • Tracks issue #145. Decision Receipts r2/EAS/anchor/verifier work from #139 is deferred to the November accelerator round and is not part of this feature.

  • 2026-10-07: official public RPC responded with chain ID 10143 and a current block. Live deployment still requires funded disposable deployer/participant wallets and must not commit their keys or credential-bearing RPC URLs.

  • 2026-10-08: deployed to Monad testnet from source commit e7345b3 as deployments/public/monad-onchain-finance-rfq-v1-10143.json (128 transactions, all status 1, 9.29 MON) with the DRS name, the investor-B holding-period flag and the expired-claim wallet. Remaining: HTTPS judge URL, judge wallet guide, browser-wallet settlement with the --evidence rehearsal, and explorer source verification.

  • Fixture acquisition snapshots are valid for 30 days from deployment, until about 2026-11-07 17:11 KST. After that, sell-side checks that read the snapshot are expected to report stale evidence until the snapshots are refreshed or the stack is redeployed. scripts/refresh-testnet-evidence.sh provides a dry-run-first operator path limited to the artifact's existing fixture participants and existing QP/acquisition setters. Broadcast requires an artifact-operator signer and is followed by a separate exact read-only verification pass. It never changes the deployment artifact.

  • scripts/deploy-testnet-rfq.sh simulation supports macOS Bash 3.2 with set -u; its regression gate also preserves broadcast and verification flag construction.

  • An earlier 2026-10-07 Monad deployment from 3aa4af5 (hackathon-testnet-rfq, bBUIDL/tqUSD, two scenes) is superseded and its record is not published.

DATA-003: Isolated Demo and Production TA/KYC Provider Adapters

Behavior

  • services/compliance-data defines a versioned TA/KYC provider SPI (KYC_PROVIDER_SPI_VERSION 1.0.0) with normalized requests/assessments, PII-free evidence hashes, freshness metadata, provider capability/version metadata and typed UNAVAILABLE | TIMEOUT | STALE | INCOMPATIBLE provider failures. The SPI exposes no provider-native payloads, credentials or core internals.
  • The package exposes explicit module boundaries: root (coordinator, store, SPI), /spi, /demo and /conformance. The deterministic demo adapter is reachable only through /demo and declares environment: "demo".
  • KycEvidenceCoordinator requires mode: "demo" | "production". It validates adapter metadata at construction, refuses an incompatible SPI major/minor, and in production mode refuses any adapter that is not declared production.
  • Provider timeouts, unavailable providers, stale data and incompatible results (unknown providerId, undeclared schema version or undeclared fact capability) fail closed with typed reasons. Evidence hash domain and store semantics are unchanged.
  • A reusable provider-adapter conformance suite passes for both the demo adapter and a production-style HTTP example adapter. Providers are replaced by injection without core source changes.
  • SPI compatibility, SemVer and migration rules are documented in the package README.

Verification

  • npm test --prefix services/compliance-data (also on Node 20)
  • scripts/check.sh
  • scripts/e2e-anvil.sh (buidl-like)
  • git diff --check

State

passing

Notes

  • Tracks GitHub issue #128. Builds on DATA-002 without selecting a TA/KYC vendor.
  • The conformance suite checks metadata-contract, environment-guard, eligible-evidence, fail-closed-evidence and abort-signal (pre-aborted signal only).
  • Production mode still accepts InMemoryKycEvidenceStore and strictAudit: false; refusing them is a separate decision.

AMM-002 — Self-Directed Actor Consistency

Behavior

  • The current AMM request model uses one authenticated actor for initiation, payment and output receipt.
  • The adapter rejects inconsistent initiator/buyer context before pool execution.
  • Delegated AMM execution remains unavailable until a separately versioned, scope-bound delegation component is implemented and reviewed.
  • RFQ behavior is unchanged; RFQ already binds taker, initiator and buyer.

Verification

  • forge test --offline --match-path test/unit/execution/AMMAdapter.t.sol
  • forge test --offline --match-path test/integration/SwapFlow.t.sol
  • forge test --offline
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • Regression coverage confirms that an actor mismatch leaves balances unchanged.

EXEC-001 — Canonical Settlement Amount Binding

Behavior

  • ExecutionRouter independently measures the authenticated buyer's tokenIn and tokenOut balance deltas around adapter execution.
  • The current execution version accepts exact full fills only: measured input, measured output, the pre-authorized context amounts and adapter-reported output must agree before stateful compliance commit.
  • A mismatch atomically rolls back token movement, Router nonce consumption, adapter state and compliance state.
  • Canonical Uniswap integration tests obtain an exact pre-execution quote without weakening the production contract or changing the existing execution ID format.
  • Asset onboarding must prohibit fee-on-transfer/rebasing tokens; buyer-side deltas are not a universal detector for intermediate settlement balances. Partial fills and price-tolerant AMM settlement remain unsupported until a separately versioned settlement-aware compliance design is implemented.

Verification

  • forge test --offline --match-path test/unit/execution/Router.t.sol
  • forge test --offline --match-path test/unit/execution/RFQAdapter.t.sol
  • forge test --offline --match-path test/integration/RFQFlow.t.sol
  • forge test --offline --match-path test/integration/SwapFlow.t.sol
  • forge test --offline --match-path test/integration/RealUniswapV3.t.sol
  • forge test --offline
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • Implements the realized-amount scope of issue #153 without changing the active Monad deployment or its artifact.
  • Venue-authoritative seller, flowType and affiliate provenance is tracked separately and remains a production AMM activation blocker.

EXEC-002: Venue-Authoritative Execution Context

Behavior

  • Separate ExecutionRouterV2 authenticates venue/context before Engine evaluation through a view-only verifier, without replacing context. Registration evidence pins adapter/context versions, adapter/source/policy runtime hashes and final configuration, with explicit reviewed immutable implementation approval.
  • RFQAdapterV3 signs the exact RFQQuoteV3/domain version 3, binding maker/taker, token directions, exact amounts, venue, policy, flow and current A-06 aggregate. Conditional primary uses a unique active compiled Manifest parameter carrying the immutable primary-distributor schema, without coupling to one C-01 version.
  • Actual security sender is buyer on tokenIn and seller on tokenOut. A regulated leg requires current trusted A-06 evidence only when its active compiled policy contains A-06-v1, whose implementation must equal the pinned source. Applicable dual-leg statuses must agree. Refresh/revocation/expiry/decay invalidate old commitments.
  • Newly deployed AMM adapter version 2/context 1 binds seller/venue/target to the registered pool and canonical token order, secondary/self-directed only. Pool edits invalidate every venue sharing the adapter; re-registration clears evidence. The C-01-family/AMM prohibition remains in force.
  • Settlement repeats authentication, preserves independently measured exact full fill, atomic rollback, commit and existing events. Legacy Router/RFQ v2 APIs/signatures and the live public Monad deployment remain pinned.
  • Additive SDK builders/modules/conformance, schema 2 coordinator recovery, opt-in host route/bootstrap capability and explicit CLI artifacts support v3. Onboarding schema 6 verifies source/authority/Router/pool bindings and orders final evidence pinning before maker activation. Legacy parsers remain explicit.
  • Opt-in B-04-v2 checks the actual security recipient's MM claim in both directions. Schema 6 rejects active compiled B-04-v1 rules and unreadable policy evidence, verifies Engine.router() as well as RouterV2.engine(), and wires a separately deployed v3 Engine before adapter activation.

Verification

  • scripts/check.sh (Forge, service provenance suites, packed v3/schema 6 consumers)
  • scripts/e2e-anvil.sh
  • scripts/e2e-anvil.sh --profile reg-d
  • scripts/e2e-context-provenance.sh (both directions, mined mismatch and affiliate sender-only MM-claim rejection, recipient-only MM-claim settlement)
  • ContextProvenanceTest: asymmetric affiliate sells and legacy buy parity; EngineSelectionV2Test: buy parity fuzzing, exemptions and fail-closed context
  • Toolkit provenance regressions: reverse Engine binding mismatch/unavailability, active compiled B-04 direction checks and unsigned Engine wiring order
  • Policy-scoped A-06 absence/source mismatch and version-neutral primary distributor schema regressions
  • forge fmt --check
  • git diff --check
  • protected-path diff for public artifacts/runtime/container deployment

State

passing

Notes

  • All delivery gates passed on 2026-11-11; exact commands and counts are recorded in PROGRESS.md. This branch preserves HACK-001 as requested; upstream #162 owns its completion and #161 owns CORE-015/D024-D027. Only EXEC-002 is worked in this session.
  • D028/D029 and docs/product-specs/execution-context-provenance.md record all six adopted defaults as open items for team confirmation. Reference/operator code uses one local env/file key; key management, multisig and custody are deferred.
  • The new live fixture is a manual delivery/release gate alongside the two existing Anvil profiles. CI retains its repository/container checks.
  • Confirmed review fixes passed 1,100 Foundry tests, the Toolkit smoke gate plus 15 provenance tests, and 12 live v3 cases. PROGRESS.md records the exact fix commands and distinguishes prior full delivery evidence from this fix session.

SDK-007 — External User Golden Path Acceptance

Behavior

  • packed CLI/Toolkit/RFQ package만 설치한 clean project에서 sandbox와 dex-integration을 source checkout 없이 생성·설치·검증한다.
  • 생성 프로젝트는 validate, simulate, doctor, deploy, verify의 공통 명령 계약을 제공하고 sandbox만 Docker를 필수 dependency로 진단한다.
  • stale/wrong-profile deployment artifact는 actionable remediation과 함께 fail-closed하며 수정 뒤 같은 verify 명령으로 복구를 확인한다.
  • venue 정책 값 변경은 compiled config commitment와 allow/reject 설명 양쪽에 결정적으로 반영된다. Production chain/address/runtime code-hash mismatch는 기존 production onboarding verifier가 actionable remediation과 함께 거절한다.

Verification

  • Toolkit/CLI scaffold and doctor smoke
  • packed clean-project sandbox/DEX install, build and conformance
  • sandbox Docker-required and library Docker-optional diagnosis
  • stale artifact fail/repair/pass and policy-value propagation acceptance
  • production chain/address/runtime code-hash mismatch regression
  • full scripts/check.sh and git diff --check

State

passing

CORE-014 — C-01 Venue Compatibility Guard

Behavior

  • C-01-* holding-period family가 포함된 Recipe는 AMM에서 실행할 수 없으며 해당 조합은 SDK, CLI, production onboarding/Safe export, Factory와 on-chain Engine에서 동일하게 거절한다.
  • Engine은 normal Recipe binding composition보다 먼저 venue compatibility invariant를 적용해 모든 지원 mode에서 같은 결과를 보장한다.
  • Factory가 관리하는 AMM token의 delayed Manifest update도 두 schedule overload에서 pending compiled plan을 검사하고 호환되지 않는 update를 원자적으로 거절한다.
  • 검사는 특정 v1/v2 문자열이 아니라 C-01- family prefix를 사용해 이후 immutable version도 fail-closed한다.
  • bundled buidl-like/reg-d config와 CLI onboarding default는 RFQ-only다.
  • AMM adapter/conformance coverage는 명시적인 C-01-free demo-only Recipe로 유지하며 이를 Reg D/BUIDL production policy로 표시하지 않는다.

Verification

  • Toolkit/CLI compatibility and onboarding smoke pass
  • Engine current/future C-01 rejection, cross-mode compatibility regression, AMM-compatible Recipe allow and RFQ C-01 allow pass
  • Factory onboarding and both delayed Manifest update overload compatibility tests pass
  • Follow-up full Foundry 960/960 and pinned Foundry scripts/check.sh pass
  • affected AMM/RFQ integration suites and live BUIDL-like/Reg-D Anvil E2E pass
  • full scripts/check.sh: Foundry 954/954, package/service/clean-project smoke, canonical Uniswap v3 5/5 and deploy-v3 10/10 pass
  • git diff --check pass

State

passing

DEPLOY-002 — Production Service Container Contract

Behavior

  • RFQ host와 read-only Operator API는 demo Compose와 분리된 pinned OCI build target으로 제공되며 non-root/read-only runtime 계약을 가진다.
  • RFQ container는 operator-owned durable coordinator, authentication, shared rate limit, pricing/risk, external signer, policy resolver와 WORM audit를 하나의 versioned bootstrap contract로만 주입받고 reference/in-memory 기본값으로 production 기동하지 않는다.
  • liveness와 dependency readiness를 분리하고 dependency unavailable/stale 상태에서 quote issuance를 fail-closed한다.
  • 환경 변수는 versioned exact schema로 검증하고 secret-shaped 값이나 bootstrap 예외를 일반 로그·health·readiness에 노출하지 않는다.
  • example deployment는 immutable image reference, read-only filesystem, dropped capabilities, resource/shutdown contract와 external secret/config mount를 명시하며 demo key 또는 production credential을 포함하지 않는다.

Verification

  • RFQ runtime/bootstrap, readiness와 graceful shutdown smoke
  • Operator API production runtime and secret-file smoke
  • pinned OCI image build/runtime smoke with non-root/read-only filesystem and Compose validation
  • missing dependency and secret-redaction regressions
  • BUIDL-like local RFQ E2E and full scripts/check.sh (Foundry 950/950)
  • git diff --check

State

passing

SDK-006 — Reference DEX Sandbox

Behavior

  • corner-store create <target> --template sandbox는 저장소 checkout 없이 사용할 수 있는 self-contained local reference DEX scaffold를 생성한다.
  • 생성된 Compose stack은 Anvil readiness와 one-shot deployment 성공 뒤에만 RFQ, Operator API/dashboard와 Deployment Studio를 시작한다.
  • deployment artifact, scenario와 chain binding이 맞지 않으면 reference service가 fail-closed하며, image에는 private key, RPC credential 또는 PII를 포함하지 않는다.
  • buidl-like는 기본 fixture이고 CORNER_STORE_PROFILE=reg-d로 동일한 실행 계약에서 Reg D fixture를 선택할 수 있다.
  • Docker sandbox는 demo/reference 전용이며 기존 non-Docker local Anvil과 public testnet 흐름을 대체하지 않는다.

Verification

  • Toolkit/CLI/Deployment Studio scaffold smoke pass
  • packed CLI clean-project 생성·build·conformance pass
  • generated Compose config validation pass
  • BUIDL-like/Reg D live Docker deployment와 전체 service health pass
  • full scripts/check.sh: Foundry 950/950, package/service smoke와 deploy-v3 10/10
  • git diff --check pass

State

passing

SDK-005 — External DEX Adapter Starter and Conformance

Behavior

  • dex-integration template은 Router-only Solidity Adapter, TypeScript request builder, venue descriptor와 Foundry conformance test를 함께 생성한다.
  • Adapter는 등록된 외부 venue target만 호출하며 compliance policy나 특정 자산을 하드코딩하지 않는다.
  • 생성 conformance는 허용 거래의 evaluate→execute→commit 순서, compliance 거절, direct-call 우회 방지와 venue 실패의 원자적 rollback을 검증한다.
  • 외부 venue의 token transfer, callback, slippage와 audit 책임은 명시적으로 integrator 범위에 남긴다.

Verification

  • Toolkit scaffold smoke pass
  • packed clean-project TypeScript/RFQ/Solidity build and 4/4 Adapter conformance pass
  • full scripts/check.sh: Foundry 950/950 and deploy-v3 10/10
  • git diff --check pass

State

passing

SDK-004 — Purpose-driven SDK Entry Point

Behavior

  • corner-store create --template은 sandbox, dex-integration, asset-onboarding, rfq-service 목적을 먼저 선택하게 하고 기존 --mode는 compatibility alias로 유지한다.
  • 생성 프로젝트는 단일 versioned project descriptor와 Toolkit config를 공유하며, 주소를 소스 코드에 복사하지 않는다.
  • @corner-store/toolkit은 connectCornerStore()와 policy.validate/compile/simulate/explain/verify facade를 제공한다.
  • 기본 출력은 profile, venue와 사용자 설정값을 먼저 설명하고 Element/Recipe/Manifest는 advanced detail로 분리한다.
  • 검증 오류는 expected, actual과 remediation을 포함하며 생성 프로젝트는 dry-run deployment를 기본값으로 유지한다.

Verification

  • Toolkit purpose-template/facade and hostile-input smoke pass
  • CLI create/help and legacy-mode compatibility smoke pass
  • packed clean-project install/build/conformance/facade/doctor/deploy dry-run pass
  • full scripts/check.sh: Foundry 950/950, all service/package smoke and deploy-v3 10/10
  • git diff --check pass

State

passing

CORE-013 — RWA Flow Direction and Surveillance Authorization

Behavior

  • Versioned replacement Elements derive the regulated token's actual sender and recipient from ComplianceContext for both buy and sell directions.
  • Holding-period evidence is read from the RWA transfer source rather than the screened investor unconditionally.
  • Primary-distribution lockup bypass requires both the primary flow marker and an exact Manifest-owned distributor address and RWA-output direction match; the marker alone fails closed.
  • ERC-3643 live-wiring probes use the actual sender balance, recipient identity, and canTransfer(from, to, amount) direction.
  • Reference, integration and public-testnet deployments seal the live ERC-3643 Identity Registry, compliance contract and token runtime code hash.
  • Surveillance threshold mutation is restricted to the owner/operator plane.
  • Existing v1 Element contracts remain unchanged; reference deployments migrate through new immutable Element IDs and an exact new Recipe version.

Verification

  • LockupV2 9/9, Engine 45/45, direction-aware Element/Recipe suites, RFQ 9/9, canonical Uniswap v3 5/5 and affected integration suites pass
  • Full Foundry 950/950 and CLI smoke pass
  • Full scripts/check.sh, including clean SDK consumer and deploy-v3 10/10, pass
  • BUIDL-like and Reg-D Anvil E2E each pass all 7 scenarios plus dashboard, CLI and protected RFQ buy/sell flows
  • git diff --check pass

State

passing

PROFILE-002 — Generic-parameter BUIDL-like Demo Migration

Behavior

  • BUIDL-like demo는 전용 BUIDL-MIN-v1 Element 대신 asset-independent MIN-AMOUNT-v1과 versioned ManifestPolicyConfig를 사용한다.
  • QP+minimum 조합의 의미는 유지하므로 Recipe family id 3은 유지하고 immutable version 2를 등록한다. legacy version 1은 신규 profile에 연결하지 않는다.
  • 5,000,000-token 값은 local demo fixture로만 명명·고정하고 실제 BUIDL 상품 정책이나 production default로 노출하지 않는다.
  • production onboarding은 issuer/legal 근거가 결합된 schema v5 artifact 없이 activation calldata를 생성하지 않는다.
  • 기존 BUIDL-like/Reg-D local Anvil 흐름과 CLI re-onboarding을 유지한다.

Verification

  • generic recipe/Factory/BUIDL-like targeted suites 23/23 통과
  • 전체 Foundry 906/906 및 scripts/check.sh 통과
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 및 dashboard/CLI/RFQ flow 통과
  • BUIDL-like CLI re-onboarding이 registerRWATokenWithConfig를 사용하고 Reg-D는 기존 parameterless path를 유지함을 live E2E로 검증
  • clean external SDK consumer install/build/conformance 통과
  • git diff --check 통과

State

passing

TOOLKIT-003 — Parameter-aware Production Safe Export

Behavior

  • schema v5 config가 Element parameter capability와 bounded ManifestPolicyConfig를 typed validation한다.
  • REGISTER/UPDATE artifact lifecycle과 exact parameter/compiled-plan commitment가 일치할 때만 unsigned Safe/operator plan을 export한다.
  • UPDATE는 새 immutable policy object 등록과 schedule을 Safe lane으로, delayed activation과 checkpoint를 operator lane으로 분리한다.
  • activation 전 pending state와 activation 후 live policy/config/code hash를 각각 fail-closed 검증한다.
  • v1~v4 parameterless config와 기존 local Anvil demo 의미를 유지한다.

Verification

  • Toolkit/CLI targeted smoke 통과
  • clean external SDK consumer install/build/conformance 통과
  • full Foundry 902/902 및 scripts/check.sh 통과
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 및 dashboard/CLI/RFQ flow 통과
  • worst bounded config(256 entries, raw parameter 16,384 bytes)는 exact calldata 100,292 bytes, calldata-only upper bound 1,604,672 gas로 측정
  • git diff --check 통과

State

passing

CORE-012 — Safe Element Emergency Replacement

Behavior

  • 치명적 Element 결함은 영향 범위를 즉시 pause/suspend한 뒤 새 immutable Element ID, 새 exact Recipe version과 delayed Manifest update로만 교체한다.
  • 기존 Element/Recipe binding은 덮어쓰지 않고 Safe/owner schedule과 정상 timelock을 우회하지 않는다.
  • 영향 자산만 새 policy version으로 전환하며 다른 자산의 Manifest, policyId와 실행 결과는 바뀌지 않는다.
  • 미체결 RFQ는 maker revoke/nonce cancel로 containment하고, 남은 quote도 policyId 변경 후 settlement에서 fail-closed한다.
  • 교체 전후 policy checkpoint와 PII-free artifact chain으로 복구 이력을 재현한다.

Verification

  • immutable Element/Recipe overwrite, unauthorized scheduling, early update/resume와 scoped two-asset replacement integration pass
  • Factory full ManifestPolicyConfig/override forwarding 12/12 pass
  • stale policy-bound RFQ quote rejection과 RFQ integration 9/9 pass
  • Engine 44/44, ElementRegistry 11/11, RecipeRegistry 7/7, TokenPolicyRegistry 56/56 targeted pass
  • full Foundry 902/902와 scripts/check.sh 전체 pass
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ flow pass
  • runtime sizes: ComplianceEngine 19,583 bytes, TokenPolicyRegistry 24,035 bytes, CornerStoreFactory 4,740 bytes
  • git diff --check pass

State

passing

CORE-011 — Policy Audit Artifact

Behavior

  • canonical PII-free policy audit artifact와 immutable local reference store를 제공한다.
  • schema v4 production onboarding은 저장·재검증된 artifact commitment 없이는 activation proposal을 생성하지 않는다.
  • Engine checkpoint event가 policyId, policy version, artifact commitment와 manifest history를 연결한다.
  • 기존 onboarding schema v1~v3와 local demo는 그대로 유지한다.

Verification

  • Policy audit Toolkit smoke: deterministic/domain-separated hash, strict schema, relational binding validation, tamper/PII rejection, immutable store put/get/exists/reconstruct와 onboarding v4 full cross-check pass
  • CLI smoke: build/store/verify/reconstruct와 immutable output pass
  • Engine targeted 44/44, full Foundry 899/899 pass
  • full scripts/check.sh: Foundry, all services/packages, clean standalone SDK consumer와 deploy-v3 10/10 pass
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ buy/sell flow pass
  • runtime sizes: ComplianceEngine 19,583 bytes(EIP-170 margin 4,993), TokenPolicyRegistry 24,035 bytes(기존 유지)
  • git diff --check pass

State

passing

CORE-010 — Policy Execution Binding

Behavior

  • logicalPolicyHash와 executionBindingHash를 domain-separated hash로 분리하고 최종 policyId가 두 값을 모두 결합한다.
  • execution binding은 chain ID, Engine/Registry/Recipe/Element 배포 주소와 runtime code hash, exact version/metadata/schema/parameter commitment를 포함한다.
  • decisionHash는 최종 policyId를 직접 포함한다.
  • RFQ maker quote는 quote-time policyId를 서명하고 settlement의 fresh decision과 다르면 fail-closed한다.
  • CREATE2 expected address는 배포 전 검증 수단으로만 사용하고 배포 후 runtime code hash 검증을 생략하지 않는다. 기본 production 경로는 immutable 구현이다.

Verification

  • PolicyHashLib 2/2와 DecisionHashLib 2/2 deterministic/domain-separation tests pass
  • Engine 42/42: chain/Engine address binding, single-token quoteable policy ID와 Recipe runtime-code drift fail-closed pass
  • RFQAdapter 25/25와 RFQFlow 8/8: stale-policy rejection 및 Router settlement pass
  • RFQ SDK/host/CLI/demo/testnet/Toolkit targeted smoke와 clean generated-project conformance pass
  • full scripts/check.sh: Foundry 897/897, all services/packages, standalone clean SDK consumer와 deploy-v3 10/10 pass
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ buy/sell flow pass
  • runtime sizes: ComplianceEngine 18,640 bytes, ElementRegistry 4,260 bytes, RecipeRegistry 3,588 bytes, TokenPolicyRegistry 24,035 bytes(EIP-170 margin 541)
  • git diff --check pass

State

passing

CORE-009 — Bounded Predicate and Element Conformance

Behavior

  • 공통 Element ABI는 그대로 유지하고 metadata에 evidence type과 immutable default enforcement를 명시적으로 고정한다.
  • Registry는 등록자가 지정한 default enforcement와 Element metadata가 다르면 fail-closed한다.
  • BoolClaim, BoundedUint, TimestampWindow, SetMembership의 bounded decoder를 제공하되 범용 DSL/AST/interpreter는 만들지 않는다.
  • generic MinimumTradeAmount Element는 threshold를 구현에 하드코딩하지 않고 ManifestPolicyConfig parameter에서 읽는다.
  • 실제 BUIDL-like profile migration과 값 승인은 별도 #109에서 수행한다.

Verification

  • ElementRegistry 11/11, PredicateValidation 4/4, MinimumTradeAmount 2/2, Engine 40/40 targeted tests pass
  • existing Element 579/579, TokenPolicyRegistry 56/56, Factory 11/11 regressions pass
  • full forge test --offline: 891/891
  • full scripts/check.sh: Foundry, all service/package smoke, standalone clean SDK consumer와 deploy-v3 10/10 pass
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ flow pass
  • TokenPolicyRegistry runtime 24,035 bytes(EIP-170 margin 541 bytes), git diff --check pass

State

passing

CORE-008 — Exact Recipe Key and Version Resolution

Behavior

  • Recipe implementation 주소는 canonical recipeKey + version으로만 조회한다.
  • numeric recipeId는 기존 Manifest binding을 canonical key로 연결하는 immutable compatibility alias이며 latest implementation 의미를 갖지 않는다.
  • catalog/UI discovery는 주소가 아닌 latestRegisteredVersionOf(recipeKey) metadata를 사용하고, active version은 항상 Manifest RecipeBinding에서 읽는다.
  • 새 Recipe version 등록만으로 ACTIVE Manifest, compiled plan 또는 policy ID가 변경되지 않는다.

Verification

  • RecipeRegistry 7/7, TokenPolicyRegistry 56/56, Engine 39/39 targeted tests pass
  • CLI/Toolkit build + smoke pass
  • full scripts/check.sh pass: Foundry 882/882, all service/package smoke, standalone clean SDK consumer와 deploy-v3 10/10
  • BUIDL-like/Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ flow pass
  • TokenPolicyRegistry runtime 23,978 bytes(EIP-170 margin 598 bytes)
  • git diff --check pass

State

passing

CORE-007 — Versioned Manifest Policy Config

Behavior

  • 자산별 Element 정책값은 schema-versioned ManifestPolicyConfig가 소유하며 Manifest 등록 또는 semantic update와 함께만 변경된다.
  • Registry는 parameter entry 수, 전체 bytes, binding/Element membership, immutable schema ID/version, required 여부와 Element별 최대 길이를 activation 전에 fail-closed로 검증한다.
  • binding별 compiled plan은 enforcement rule과 정확히 정렬된 parameter bytes를 저장하며 config hash와 parameter bytes를 plan hash에 포함한다.
  • pending config/compiled plan hash와 compiled parameters는 read-only 검토할 수 있고, timelock activation에서 Manifest version, bindings, enforcement와 parameters가 원자적으로 교체된다.
  • Engine은 동적 config lookup 없이 compiled parameters를 해당 Element에 전달한다. 기존 parameterless Element와 local Anvil demo는 empty config 호환 경로를 유지한다.

Verification

  • TokenPolicyRegistry targeted tests: 56/56
  • ComplianceEngine targeted tests: 38/38
  • full forge test --offline: 881/881
  • full scripts/check.sh: Foundry, all services, clean SDK consumer와 deploy-v3 10/10 통과
  • forge build --sizes: TokenPolicyRegistry 23,980 bytes, EIP-170 margin 596 bytes
  • BUIDL-like와 Reg-D Anvil E2E 각각 7/7 + dashboard/CLI/RFQ flow 통과
  • git diff --check 통과

State

passing

CORE-006 — Unified Element Parameter Interface

Behavior

  • 모든 in-repo Element가 bounded parameters를 받는 하나의 IComplianceElement.check ABI를 구현한다.
  • immutable Element metadata가 schema ID/version, 최대 parameter bytes와 required 여부를 선언하며 Registry가 잘못된 capability를 등록 전에 거절한다.
  • 현재 parameterless Element는 empty bytes에서 기존 동작을 유지하고 non-empty parameter를 공통 reason code로 fail-closed한다.
  • Manifest별 parameter 저장과 compiled-plan 전달은 후속 #103 범위로 유지한다.

Verification

  • BaseElement 5/5, Registry 9/9, Engine 37/37, all-Element 577/577
  • full forge test --offline: 877/877
  • CLI, Toolkit, RFQ demo backend와 public-testnet demo package tests 통과
  • 전체 scripts/check.sh 통과
  • buidl-like와 reg-d Anvil E2E 각각 7/7 + dashboard/CLI/RFQ flow 통과
  • git diff --check 통과

State

passing

DOCS-011 — ADR-010 Production Policy Decisions

Behavior

  • Q1~Q8과 D-5의 최종 결정을 하나의 accepted ADR로 기록한다.
  • ManifestPolicyConfig, 단일 Element ABI, 주소+runtime-code binding, 온체인 lifecycle+PII-free artifact 감사, 안전우선 긴급 교체, exact Recipe version과 제한적 predicate 정규화 경계를 구분한다.
  • Q8의 단계적 구현 순서를 GitHub epic #101과 하위 이슈 #102~#110으로 추적한다.
  • 실제 BUIDL 상품값, provider/보관 운영과 Safe 구성은 외부 승인 없이 확정하지 않는다.

Verification

  • ADR/decision index/documentation links review
  • GitHub issue #101 checklist and #102~#110 existence
  • git diff --check

State

passing

CORE-005 — Compliance Core Production Hardening

Behavior

  • Element registrations are immutable per bytes32 elementId, pin implementation metadata/version hashes and store a default enforcement action for compiled manifest plans.
  • Recipe registration now supports canonical normalized aliases, domain-separated bytes32 recipeKey derivation and legacy numeric aliases without dynamic runtime alias lookup. Alias/key collisions and version overwrite attempts are rejected.
  • TokenPolicyRegistry compiles bounded per-binding Element enforcement rules at manifest registration/update time. Normal onboarding is strengthen-only: FLAG_ONLY < OPERATOR_REVIEW < BLOCK; FORCE_FLAG_ONLY is accepted only for Elements whose immutable default is already FLAG_ONLY.
  • The Engine evaluates compiled plans and propagates an Element's exact nonzero reasonCode; recipe-scoped code 1 is only the fallback when an Element returns zero.
  • Production onboarding Toolkit/CLI support v2 canonical recipe alias/key, Element default enforcement, bounded overrides, compiled plan commitments and dual-mode verification while preserving legacy v1 configs/calldata ordering.

Verification

  • npm test --prefix services/toolkit
  • npm test --prefix services/cli
  • Targeted Forge registry tests: 86 passed
  • Targeted Engine tests: 37 passed
  • Targeted RegD integration tests: 6 passed
  • Full forge test --offline: 870/870 passed
  • Isolated /tmp full scripts/check.sh: passed after formatting only the pre-existing script/DeployProductionCore.s.sol and script/DemoScenarios.s.sol drift in the copy and running fresh npm ci for copied stale node_modules; this full check was before the final Solidity-only bijection guard, and post-fix full forge test --offline 870/870 passed
  • Full Anvil E2E: buidl-like and reg-d passed with 7/7 scenarios and RFQ flows
  • Original-tree scripts/check.sh remains blocked by pre-existing formatting drift in script/DeployProductionCore.s.sol and script/DemoScenarios.s.sol. DemoScenarios has only the scoped G005 reason-contract edit here and was not broad-formatted.
  • git diff --check

State

passing

DEPLOY-003 — Production ERC-3643 Asset Onboarding

Behavior

  • Production onboarding is separated from local Anvil/demo toolkit-onboard and from core deployment. A versioned corner-store.production-onboarding.json declares the exact existing ERC-3643 token, IdentityRegistry/Compliance wiring, Corner Store registries/adapters, PII-free legal package hash, Elements, Recipes, Manifest, RecipeBinding[], governance Safe metadata, explicit operator executor, active venues, RFQ makers, signer delegates and read-only inventory requirements.
  • The Toolkit validates the onboarding file with exact-object schemas, rejects unknown fields, duplicate addresses/ids, unsupported codeHash keys, signer-secret shaped fields, raw contact PII and incoherent RFQ/inventory relationships.
  • production-onboarding-plan renders deterministic Element/Recipe/Manifest, venue, maker, signer schedule and owner-only delayed signer execution calldata plus Safe-compatible unsigned drafts. It uses collision-free stage IDs, partitions Safe-owner and operator-authority drafts, includes Safe/required approval/proposal identity on Safe drafts and explicit executor/proposal identity on operator drafts, separates governance-owner/governance-delayed/operator authority, refuses output overwrite, and never signs, broadcasts, transfers tokens or generates ERC-20 approvals. Inventory appears as a read-only verification dependency before service open.
  • production-onboarding-verify uses RPC read calls only and fails closed on unavailable or mismatched ERC-3643 wiring, Identity Registry dependencies, Element/Recipe registrations, Manifest hash/fields/bindings, ACTIVE Manifest declarer/approver, governance Safe ownership of safe-owner targets, global/asset/venue pause gates, venue config, TokenPolicyRegistry/RFQAdapter operator authorization, maker approval, signer delegate activation and inventory balance/allowance minima. Pending signer authorization is reported but is not production-ready.
  • Example onboarding JSON is syntactically valid but uses obvious placeholder non-live addresses/hashes; issuer/legal/TA evidence remains an external trust boundary and cannot be inferred from a token address.

Verification

  • npm test --prefix services/toolkit
  • npm test --prefix services/cli
  • git diff --check

State

passing

RFQ-005 — Production RFQ Host Hardening

Behavior

  • RFQ production HTTP hosting is separated into services/rfq-host instead of turning the local Anvil demo backend into a production server. The host wraps the durable RFQQuoteCoordinator and leaves pricing, risk, signer custody, transactional storage, TLS termination and WORM audit infrastructure as operator-owned replacement ports.
  • /rfq/quote validates request size, JSON and schema before authentication. An authenticator port returns a principal and exact taker claim, and the host binds that normalized taker to the body taker; missing/invalid auth returns 401 and mismatches return 403 without storing raw auth material.
  • Rate limiting is a replaceable port with a bounded in-memory reference implementation. Limiter keys use hashed principals, and 429 responses include Retry-After. Oversized requests return 413.
  • The host calls coordinator quoteWithEvidence(), so the actual pricing result and actual risk decision returned inside the durable quote call must carry snapshotId, version, observedAt, validUntil and availability. Missing, stale, future-skewed or unavailable metadata fails closed before nonce reservation or signing, and idempotent replay returns persisted evidence without provider recall or re-signing. A strict replay of an existing RESERVED record revalidates persisted evidence before signing; stale/missing/future/ unavailable evidence revokes the reservation, releases the lease and burns the nonce. Fresh risk decision: rejected returns a stable risk rejection before reserve/sign without exposing raw risk reason.
  • Signer verification failures, stale/unavailable dependencies, auth abuse, rate limits and audit sink failures trigger a bounded best-effort incident hook. Strict audit is enabled by default and quote issuance fails closed if PII-free audit persistence fails.
  • Audit events contain hashed principal/request/idempotency identifiers, persisted actual coordinator module/snapshot/version metadata, timestamps and on-chain identifiers only; raw bearer tokens, raw idempotency keys, raw request bodies, signer refs and stack traces are excluded. Metrics labels are bounded and do not include principals or addresses.
  • /health exposes only generic service status. Non-loopback public bind is refused unless the operator explicitly acknowledges external TLS/trusted-proxy termination.

Verification

  • npm test --prefix services/rfq
  • npm test --prefix services/rfq-host
  • npm test --prefix services/rfq-demo-backend
  • git diff --check

State

passing

RFQ-004 — Durable Quote Coordinator

Behavior

  • RFQ SDK는 기존 demo-friendly quote service를 유지하면서 production 서비스가 교체해 구현할 수 있는 QuoteCoordinatorStore 포트와 RFQQuoteCoordinator 경계를 제공한다.
  • coordinator는 (chainId, adapter/verifyingContract, maker) scope에서 nonce를 원자적으로 증가시키고, idempotency key hash와 request hash를 durable record에 저장한다. 같은 key+request는 재시작 후에도 같은 signed quote를 반환하며, 같은 key의 다른 request는 fail-closed conflict로 거부한다.
  • pricing/risk rejection은 nonce와 inventory reservation 전에 종료된다. 새 firm quote는 nonce, idempotency record와 maker outgoing token inventory lease를 하나의 store transaction에서 예약한다. signer 실패, 만료, revoke, finalized fill/cancel은 lease를 정확히 한 번 해제하고 nonce는 재사용하지 않는다.
  • local/single-host reference file store는 Node built-ins만 사용해 restart persistence, lock 기반 cross-instance atomicity, concurrent over-reservation 방지를 시연한다. HA production은 같은 포트를 operator transactional DB/queue/indexer로 구현해야 한다.
  • coordinator는 external signer가 반환한 EIP-712 signature를 로컬에서 검증한 뒤에만 응답하고, idempotency key와 signer key ref는 durable audit record에 raw value가 아닌 hash로 저장한다.
  • fill/cancel observation은 transaction hash, block number/hash를 기록하고 configured confirmation depth 이후 terminal 상태로 확정한다. reorg/noncanonical block은 observed 상태를 PUBLISHED로 되돌리고 lease를 유지한다. Partial fill은 계속 비지원이다.

Verification

  • npm test --prefix services/rfq
  • git diff --check

State

passing

STUDIO-002 — Localized Evidence-Gated Workflow

Behavior

  • Deployment Studio는 한국어를 기본으로 제공하고 사용자가 English로 전환한 선택을 브라우저에 유지한다.
  • 설정 저장, Doctor, 배포 계획, 배포, Artifact 검증, DEX 실행 단계는 이전 단계의 실제 evidence가 존재할 때만 완료로 표시한다.
  • 후속 단계 데이터가 남아 있더라도 선행 설정이 저장되지 않았다면 완료 표시와 실행 버튼을 fail-closed한다.

Verification

  • npm test --prefix services/deployment-studio
  • git diff --check

State

passing

DOC-004 — Product Architecture and Technical Whitepaper

Behavior

  • 외부 이해관계자가 Corner Store의 문제 정의, 제품 경계, 정책 조합 모델, Router-mediated 실행 보장과 RFQ 통합 구조를 하나의 문서에서 이해할 수 있다.
  • 백서는 현재 구현과 production 후속 과제를 분리하고, ERC-3643/ONCHAINID, issuer/TA, Corner Store와 운영자의 trust boundary를 과장 없이 설명한다.
  • 프로젝트 목적, 대상 통합자, 성공 기준, control/execution plane, 핵심 ABI, protocol invariant, adoption path와 architectural trade-off를 명시한다.
  • GitBook과 GitHub에서 직접 렌더링할 수 있는 Mermaid diagram으로 system context, policy composition, fill-time enforcement, RFQ module과 보호 경계를 시각화한다.
  • ERC-3643, EIP-712와 illustrative legal profile의 공식 1차 자료를 연결하고, 기술 구현 증거와 법률·운영·production 미검증 범위를 구분한다.
  • 루트 README와 문서 인덱스에서 백서에 바로 접근할 수 있다.

Verification

  • 백서의 내부 링크가 모두 존재한다.
  • Mermaid code fence와 diagram 종류를 정적 검증한다.
  • forge test --offline --match-path test/unit/compliance/Engine.t.sol
  • forge test --offline --match-path test/integration/RFQFlow.t.sol
  • npm test --prefix services/rfq
  • git diff --check

State

passing

DEMO-015 — RFQ Session History and Targeted Claim Expiry

Behavior

  • My RFQs는 브라우저 세션에서 요청한 firm quote를 덮어쓰지 않고 누적하며, taker, 매수/매도 방향, quote payload와 quoted | accepted | rejected | expired 상태를 개별 RFQ에 유지한다.
  • 사용자 화면은 현재 선택한 지갑이 taker인 RFQ만 표시하고, Admin만 현재 브라우저 세션의 전체 RFQ를 조회한다.
  • 과거 RFQ를 다시 선택하면 해당 quote의 방향과 정확한 amountIn으로 Pre-check와 payload review를 다시 수행한다.
  • temporal demo는 전역 freshness cap을 줄이지 않고 지정된 투자자 claim의 verifiedAt만 조정한다. Enforcement Case 준비 직후에는 대상도 적격이어야 하며, 1시간 유효 quote 발급 후 Anvil 시간을 15분 전진했을 때 대상 claim만 만료되고 다른 적격 투자자는 계속 거래할 수 있어야 한다.
  • Maker 화면은 다중 Maker 관리 기능으로 오해되지 않도록, 현재 주입된 단일 Maker의 승인 철회 후 기존 서명 quote가 거부되는 보안 시연으로 표시한다.
  • Admin의 QP 근거·look-through 기록은 operator 트랜잭션 receipt를 기다린 뒤 block number와 transaction hash를 화면에 표시한다.
  • mock pricing impact는 fill 횟수 고정값이 아니라 실제 체결 RWA 수량에 비례하고 scenario cap을 적용한다.
  • 사용자 차트는 전체 기간 하나만 제공하며, fill point의 방향·정확한 체결가· 수량·시각은 상시 label 대신 hover/focus tooltip으로 표시한다.

Verification

  • npm test --prefix services/operator-dashboard
  • npm test --prefix services/rfq-demo-backend
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

DEMO-014 — RFQ Counter-Amount Preview

Behavior

  • RFQ 생성 화면이 사용자가 입력한 지불 수량과 backend pre-check가 계산한 반대 페어의 예상 수령량을 함께 표시한다.
  • 매수는 qUSD 지불 → BUIDL-like 수령, 매도는 BUIDL-like 지불 → qUSD 수령으로 현재 선택 방향에 맞춰 단위와 자산을 전환한다.
  • 예상 단가는 하드코딩하지 않고 현재 mock pricing과 pre-check의 amountIn/amountOut으로 계산한다.
  • 입력 변경 중에는 이전 예상치를 즉시 지우고 최신 pre-check 응답 이후에만 다시 표시한다.

Verification

  • npm test --prefix services/operator-dashboard
  • git diff --check

State

passing

DEMO-013 — Deployment-to-DEX Showcase Handoff

Behavior

  • reference DEX demo가 production과 별개의 core 구현을 다시 만들지 않고 DeployProductionCore.deployCore()에서 같은 registry/engine/router/adapter stack을 배포한다.
  • production core 배포와 demo-only ERC-3643 fixture, mock TA, inventory, policy/venue activation을 명시적으로 구분한다.
  • versioned showcase config가 profile, scenario, mode와 runtime port를 주입하고, plan mode가 사전 준비값과 실행 순서를 transaction 없이 출력한다.
  • showcase runner가 core deployment → demo activation → artifact verification → asset onboarding → RFQ backend → Operator API/Dashboard 순서로 기존 demo를 재현한다.
  • Deployment Studio에서 reference stack을 배포·검증한 뒤 Start DEX demo를 누르면 두 번째 배포 없이 기존 CLI onboarding을 최초 1회 실행해 선택한 demo Manifest/venue를 같은 stack에서 활성화하고, 해당 project의 exact artifact, scenario와 배포 RPC로 RFQ backend, Operator API와 Dashboard를 시작한다. RPC/artifact가 달라지거나 RFQ venue가 비활성화된 경우 fail closed한다.
  • artifact와 UI 문서는 local rehearsal이 production deployment 또는 legal onboarding evidence가 아님을 명시한다.

Verification

  • showcase config/plan smoke test
  • forge test --offline --match-path test/unit/deployment/DeployProductionCore.t.sol
  • BUIDL-like RFQ showcase E2E
  • Studio deploy → verify → same-artifact DEX handoff integration
  • Studio first-start demo onboarding 및 restart idempotency smoke
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/DEMO-013-deployment-to-dex-showcase-handoff.md
  • production deployment script와 reference demo는 ProductionCoreDeployer.deployCore() 구현을 공유하지만, local Mock TA, deterministic account, fixture policy/inventory activation은 production evidence로 취급하지 않는다.

DEPLOY-002 — Public Testnet RFQ Reference Deployment

Behavior

  • 기존 Anvil DeployStack과 showcase 경로를 변경하지 않고 공개 EVM 테스트넷용 RFQ-only reference deployment를 별도 제공한다.
  • RPC, chain ID, deployer, governance, operator, maker와 세 investor 주소를 runtime input으로 받고 deterministic Anvil account를 사용하지 않는다.
  • Foundry keystore 또는 Ledger가 deployment transaction을 서명하며 repository config와 artifact에는 private key나 credential-bearing RPC를 기록하지 않는다.
  • 실제 T-REX ERC-3643/ONCHAINID fixture, BUIDL-like illustrative policy, Corner Store Engine/Router/RFQ adapter, mock quote token, actor claim과 양방향 inventory를 배포·활성화한다.
  • maker와 investor allowance는 각 외부 participant signer가 별도 approval script로 제출하며 deployer가 대신 승인하지 않는다.
  • read-only verifier가 chain/artifact, runtime code, governance ownership, operator authorization, Manifest, RFQ venue, maker approval, inventory와 선택적 allowance를 fail-closed로 검증한다.
  • 검증이 끝난 결과만 deployments/public/의 append-only artifact로 승격하고, named protocol/identity 주소, 전체 transaction receipt 요약과 CREATE contract index를 기록해 CLI나 후속 demo가 언제든 동일 배포물을 조회할 수 있게 한다.
  • artifact는 credential을 포함하지 않으며 이 배포가 production issuer onboarding이나 실제 BUIDL/Securitize 연동이 아니라는 경계를 명시한다.

Verification

  • forge fmt --check
  • forge build --offline
  • forge test --offline --match-path test/unit/deployment/DeployProductionCore.t.sol
  • isolated Anvil에서 external-address deployment broadcast
  • participant별 approval broadcast 후 VerifyTestnetRFQ readiness 검증
  • scripts/check.sh
  • bash -n scripts/deploy-testnet-rfq.sh
  • git diff --check

State

passing

Notes

  • 공개 테스트넷의 실제 RPC broadcast와 explorer verification은 대상 네트워크, faucet 자금과 explorer credential이 주입될 때 수행한다.
  • public-testnet artifact를 소비하는 interactive RFQ demo runtime은 기존 Anvil backend의 chain-31337 경계를 완화하지 않고 별도 feature로 구현한다.

DEMO-016 — Artifact-bound Public Testnet RFQ Demo

Behavior

  • 기존 Anvil showcase/backend를 변경하지 않고 검증된 deployments/public/*.json만 source of truth로 사용하는 별도 runtime을 제공한다.
  • 시작 시 artifact chain, contract bytecode, Manifest, Maker와 inventory를 검증하고 다른 RPC나 Maker key를 fail-closed로 거부한다.
  • backend는 RFQ SDK를 사용해 artifact Maker의 firm quote만 서명하며 investor private key나 operator 권한을 보유하지 않는다.
  • 사용자는 브라우저 지갑으로 input token allowance와 최종 Router transaction을 직접 서명한다. quote 검토값과 Router venueData는 동일 payload를 사용하고, 체결 시 ComplianceEngine이 최신 상태를 다시 평가한다.
  • UI는 deployment lineage/주소, network, token metadata, Manifest/Maker readiness, 지갑 balance/allowance/QP 상태, pre-check, quote, transaction hash와 block을 표시한다. host, port, RPC, explorer, artifact, rate와 signer는 runtime input이다.

Verification

  • npm test --prefix services/testnet-rfq-demo
  • bash -n scripts/run-testnet-rfq-demo.sh
  • isolated Anvil에서 public artifact deployment + Maker/investor approvals
  • /api/state, /api/wallet, /api/precheck, /api/quote
  • external investor signer의 Router static call + broadcast settlement
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • public testnet Maker key는 disposable fixture key이며 production custody나 HSM signer가 아니다.
  • local Anvil security showcase는 계속 scripts/showcase.sh를 사용한다.

DEPLOY-001 — Production Deployment Workflow

Behavior

  • production deployment workflow를 local/demo Deployment Studio와 분리하고, core-only Foundry script와 Toolkit/CLI operational path로 구현한다.
  • ERC-3643 token과 ONCHAINID onboarding을 외부 issuer trust boundary로 다루고, Corner Store Manifest activation 전에 token, identity registry, trusted issuer와 pilot identity evidence를 확인한다.
  • Safe address, expected owner count M, threshold N, owner list, chain ID와 payload target/calldata를 signing 전에 검증한다.
  • production signing은 external signer 또는 Safe-style multisig 경계에서 수행하며 browser mainnet broadcast와 browser private key 입력은 범위 밖으로 둔다.
  • legal-approved Element/Recipe/Asset Compliance Manifest package만 production activation 후보가 되며 illustrative demo recipe나 fixture는 production approval로 취급하지 않는다.
  • venue, maker, signer와 inventory activation은 bytecode/role/Manifest/registry 검증 이후 단계적으로 수행한다.
  • dry-run, fork simulation, multisig proposal review와 monitoring/finality evidence를 production readiness 기록으로 요구한다.
  • Deployment Studio는 production config, Safe/ERC-3643 preflight와 signer-free plan export까지만 제공하고 production signing/broadcast는 외부 CLI signer 경계에서 수행한다.
  • core deployment artifact는 schema, chain, role, venue flag와 배포 주소를 기록하며 post-deployment verify가 exact runtime code hash, release provenance, ownership, operator와 Router/Engine binding을 fail-closed로 확인한다.
  • production config는 approved RPC host, reviewed source commit과 deterministic contract bundle hash를 고정하고 deploy 직전에 실제 입력과 재대조한다.

Verification

  • docs/deployment-production.md required-content 수동 검토
  • README, ARCHITECTURE, docs index, deployment operations, decision, feature, progress 문서 간 링크와 용어 교차 검토
  • forge test --offline --match-path test/unit/deployment/DeployProductionCore.t.sol
  • Toolkit, CLI와 Deployment Studio smoke tests
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/DEPLOY-001-production-deployment-workflow.md
  • 이 feature는 production deployment tooling과 runbook을 구현한다. 실제 production transaction, Safe proposal execution, legal approval 또는 monitoring live 상태를 passing으로 주장하지 않는다.

HE-001 — Harness Baseline

Behavior

  • 새 세션이 저장소만 읽고 현재 상태와 다음 작업을 복구할 수 있다.
  • 필수 명령과 완료 조건이 한 곳에서 안내된다.
  • feature, progress, decision과 quality 상태가 저장소에 기록된다.
  • 전체 검증을 한 명령으로 실행할 수 있다.

Verification

  • scripts/check.sh
  • git diff --check
  • Harness 필수 문서와 링크 수동 검토

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/HE-001-harness-baseline.md
  • 제품 아키텍처 내용은 이 feature에서 변경하지 않는다.

DOC-001 — Imported Architecture Alignment

Behavior

  • imported 문서에서 확정된 제품 방향과 변경 요청을 구분한다.
  • 공식 제품 명세가 Compliance Core, Execution Integration Kit, reference DEX와 4-Layer 모델을 일관되게 설명한다.
  • pair 거래에서 양쪽 자산의 classification과 Manifest를 누락하지 않는다.
  • 기존 문서의 충돌하는 용어와 가정을 정리한다.
  • 열린 설계 결정은 확정된 구현처럼 표현하지 않는다.

Verification

  • 관련 문서 간 용어·책임·흐름 교차 검토
  • Markdown 링크 확인
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • 입력 분류: 완료 Exec Plan의 Input Classification
  • 완료 계획: docs/exec-plans/completed/DOC-001-imported-architecture-alignment.md
  • 확정 방향과 개발팀이 결정해야 할 change request를 구분해 반영한다.

FND-001 — Foundry Product Foundation

Behavior

  • Foundry template를 제품 개발 구조로 교체한다.
  • 제품 interface, type, error와 mock fixture를 컴파일할 수 있다.
  • 이후 compliance와 execution feature가 재사용할 테스트 기반을 제공한다.

Verification

  • forge fmt --check
  • forge build
  • forge test --offline

State

passing

Notes

  • 현재 제품 구조는 Compliance Core, Execution Integration Kit, reference adapters와 Foundry unit/integration fixture를 포함한다.
  • production Manifest lifecycle, RFQ dealer/custody, OrderBook은 별도 feature다.

RFQ-001 — Reference RFQ Settlement

Behavior

  • RFQ가 AMM과 같은 ExecutionRouter/Adapter slot에 등록·교체될 수 있다.
  • RFQ quote는 maker가 EIP-712로 서명하고 chainId, RFQAdapter, maker, taker, token, amount, venue, nonce, expiry에 바인딩된다.
  • RFQAdapter는 Router-only로 동작하고 direct adapter bypass를 거부한다.
  • 매 fill은 Router의 최신 compliance evaluation 이후 full-fill/exact-taker로만 settlement된다.
  • reference TypeScript service는 quote 생성, expiry/nonce 부여, EIP-712 signing 요청만 담당한다.

Verification

  • forge fmt
  • forge build
  • forge test --offline --match-path test/unit/execution/RFQAdapter.t.sol -vv
  • forge test --offline
  • cd services/rfq && npm test
  • git diff --check

State

passing

Notes

  • Non-goals: partial fill, orderbook, production pricing engine, dealer inventory, custody 확장, websocket/order discovery.

DEMO-001 — BUIDL-like ERC-3643 Demo Asset

Behavior

  • src/demo/BuidlLikeDemoAsset.sol이 MVP용 BUIDL-like asset profile을 제공한다.
  • 테스트 fixture가 profile의 이름/심볼로 실제 ERC-3643/T-REX 토큰을 배포한다.
  • profile Manifest는 Reg D 506(c) 발행 Recipe와 ICA 3(c)(7) fund Recipe를 동시에 바인딩한다.
  • factsPacked fund bit가 켜진 자산에서는 BUIDL-like fund Recipe가 A-13 Qualified Purchaser와 minimum investment 검사를 활성화한다.
  • BUIDL-like flow test는 실제 Securitize/TA 연결 대신 MockSecuritizeTA fixture로 investor facts를 만들고, 그 결과를 ERC-3643 registry와 Corner Store Elements에 sync한다.
  • protected Router 경로에서 QP buyer는 체결되고, accredited-only/non-QP buyer는 토큰 이동 전 거절된다.
  • sanctioned QP buyer는 token movement 전에 compliance reject된다.
  • QP buyer라도 BUIDL-like minimum investment 미만이면 token movement 전에 compliance reject된다.
  • expired TA profile은 current eligibility로 sync되지 않고 token movement 전에 compliance reject된다.
  • engine-level AI/QP flags가 통과해도 ERC-3643-unverified recipient는 settlement에서 rollback된다.
  • QP/규제 로직은 BUIDL 전용 토큰 override가 아니라 Manifest/Recipe/Element에 남긴다.
  • DS Protocol/Securitize-style Compliance Service는 profile 문서에서 adapter seam으로 매핑한다.
  • 현실 BlackRock BUIDL 연동, Securitize claim 연동, NAV/redemption/distribution rail은 범위 밖이다.

Verification

  • forge fmt --check src/demo/BuidlLikeDemoAsset.sol test/fixtures/TREXSuite.sol test/fixtures/MockSecuritizeTA.sol test/integration/IntegrationBase.sol test/integration/BUIDLLikeFlow.t.sol src/compliance/elements/BuidlMinimumInvestment.sol src/compliance/recipes/BuidlLikeFundRecipe.sol test/unit/compliance/BuidlLikeFundRecipe.t.sol
  • forge test --offline --match-path test/integration/BUIDLLikeFlow.t.sol -vv
  • forge test --offline --match-path test/unit/compliance/BuidlLikeFundRecipe.t.sol -vv
  • forge test --offline

RFQ-002 — RFQ v2 Hardening

Behavior

  • maker(dealer) approval이 operator-curated allowlist로 강제된다. 미승인 maker의 quote는 서명이 유효해도 settlement에서 거부된다(RFQMakerNotApproved).
  • setMakerApproved(address,bool)는 onlyOperator이며 MakerApprovalSet event를 emit한다.
  • maker는 자신의 nonce namespace에 대해 cancelQuoteNonce/cancelQuoteNonces로 outstanding quote를 취소할 수 있다. idempotent(used nonce는 no-op)하며 상태 전이 시에만 RFQQuoteCancelled event를 emit한다.
  • router는 context.venueType이 등록된 VenueConfig.venueType와 불일치하면 거부한다(VenueTypeMismatch).
  • venue 위협 모델이 docs/rfq-threat-model.md에 문서화된다.

Verification

  • forge test --offline(전체 133/133 유지)
  • RFQAdapter unit test: test_execute_revertsWhenMakerNotApproved, test_setMakerApproved_onlyOperator, test_setMakerApproved_setsAndEmits, test_execute_revertsAfterApprovalRevoked, test_cancelQuoteNonce_blocksSubsequentFill, test_cancelQuoteNonce_emitsOnFirstCancelOnly, test_cancelQuoteNonce_scopedToCaller, test_cancelQuoteNonces_batchCancels, test_cancelQuoteNonce_afterFillIsNoOp
  • Router unit test: test_execute_revertsWhenVenueTypeMismatchesRegistry
  • cd services/rfq && npm test(unchanged-service guard)
  • docs/rfq-threat-model.md 존재와 docs/security.md/docs/README.md 링크 무결성

State

passing

Notes

  • 정책 결정: 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 시나리오를 test/integration/RFQFlow.t.sol에서 real ERC-3643 스택 위 protected path로 커버한다.

RFQ-003 — Maker Authorizer and Regulated Amount Cap

Behavior

  • maker settlement account와 quote signer를 분리하는 versioned authorizer를 제공한다.
  • maker 직접 ECDSA, governed EOA delegate와 ERC-1271 maker 서명을 검증한다.
  • signer 권한 추가는 delay를 거치고 revoke는 즉시 적용되며, fill은 현재 권한을 다시 검사한다.
  • RFQ quote schema와 exact full-fill/replay/cancel/Router-only 불변식은 유지한다.
  • finite compliance cap은 결제 notional이 아니라 regulated asset quantity에 적용하고, cap의 대상 token이 요청 pair와 일치하지 않으면 fail-closed한다.

Verification

  • MakerAuthorizer unit tests
  • RFQAdapter direct/delegated/revoked/ERC-1271 authorization tests
  • Router finite-cap buy/sell/invalid-axis tests
  • RFQ integration and full repository checks
  • BUIDL-like RFQ E2E

State

passing

Notes

  • Completed plan: docs/exec-plans/completed/RFQ-003-maker-authorizer-cap.md
  • Non-goals: partial fill, custody, durable nonce coordinator, production hosting.

CMP-001 — Reg D 506(c) 9-element Recipe

Behavior

  • illustrative Reg D 506(c) element library가 reference 9-element set을 커버한다: A-01 sanctions, A-02 jurisdiction, A-03 accredited, A-04 identity uniqueness, A-05 US-tax-resident 제외, B-01 asset classification(REG_D), B-02 ERC-3643-native asset, C-01 Rule 144 lockup, E-01 Form D filing.
  • RegD506cRecipe는 이 9-element set을 요구한다(id 1, version 2, always-applicable). illustrative reference wiring이며 approved production policy가 아니다.
  • 새 element의 attestation setter는 operator-gated(Governed/onlyOperator)이며 production data source(OFAC/ONCHAINID/ERC-165/EDGAR)는 approval-gated seam으로 남는다.
  • C-01 Lockup은 injected mock acquisition source를 통해 test fixture에서만 활성화된다. production holding-period 활성화 default는 변경하지 않는다.
  • 완전히 attested된 buyer + asset은 real ERC-3643 router 경로로 settle되고, element family별로 하나를 깨면 그 element의 reasonCode로 거부된다.

Verification

  • forge test --offline(전체 195/195, pre-task 189 + 신규 6).
  • Recipe unit test: test_regd_ids_and_elements(9 element, version 2, id 1, always-applicable).
  • 통합 test test/integration/AmmReferenceElements.t.sol: test_happyPath_nineElements_buySucceeds, test_reject_jurisdictionDisallowed, test_reject_jurisdictionUnset, test_reject_identityUnbound, test_reject_usTaxResidentFlagged, test_reject_assetNotClassifiedRegD.
  • 기존 통합/unit fixture(MultiRecipe, Surveillance, EmergencyPause, Invariants, SwapFlow, Engine)는 shared setup helper로 9-element attestation을 추가해 유지.
  • forge fmt.

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

  • 데모 문서: docs/compliance/07-buidl-implementation.md

  • Profile spec: docs/product-specs/buidl-like-demo-profile.md

  • 현재 구현은 local BUIDL-like profile + fixture다. 실제 BUIDL 온보딩은 법률 확정, issuer/trusted-claim 연동, 1차/2차 rail 분리 후 별도 feature로 진행한다.

  • 정책 결정: D009(9-element in-place 확장, operator-gated setter, Lockup은 fixture-only mock acquisition source).

  • Deferred follow-up: ungated legacy mock element(A-01/A-03/QP)의 operator-gate 정렬, production data source 연결, acquisition/lot data source와 holding-period 활성화 조건 결정.

  • Non-goals: production legal 활성화, direction-aware element application.

E2E-001 — Live Anvil E2E & Demo Runner

Behavior

  • scripts/e2e-anvil.sh가 fresh Anvil 노드를 띄우고 전체 스택을 배포 (script/DeployStack.s.sol)한 뒤 7-scenario demo suite (script/DemoScenarios.s.sol)를 구동하고, scenario별 narrative + evidence + PASS/FAIL을 출력한 다음 노드를 teardown한다. 완전히 offline로 동작하고, 하나라도 실패하면 스크립트가 non-zero로 종료한다. --port, --keep 플래그를 지원한다(--keep은 이후 Anvil을 계속 실행해 인터랙티브 demo/UI attach 가능).
  • DeployStack은 registries(Element/Recipe/TokenPolicy/Operator), ComplianceEngine, ExecutionRouter+VenueRegistry+VenueSelector, CornerStoreFactory, 11개 element, 두 recipe(RegD 506(c) id 1, 3(c)(7) id 2) + surveillance-enabled RegD 변형(id 7), MockPool AMM venue, RFQAdapter venue, 그리고 REAL ERC-3643 token + OnchainID 스택을 live 노드에 배포하고 주소를 deployments/anvil-e2e.json(gitignore)로 기록한다. T-REX 배포 코어는 test/fixtures/TREXCore.sol로 추출해 test fixture와 script가 공유한다.
  • 7 scenario: (1) factory 1-call onboarding(propose→approve+venue), (2) compliant trade 성공, (3) live element rejection(A-02 flip → ComplianceRejected, off-chain reason-code 재계산 후 복원), (4) manifest lifecycle(suspend 차단 → resume 재거래), (5) RFQ venue(EIP-712 quote 서명 → RFQFilled, 미승인 maker RFQMakerNotApproved), (6) surveillance(threshold 초과 시 SurveillanceFlag), (7) bypass 시도(direct adapter.execute → NotAuthorized).
  • src/(제품 코드) 변경 없음. tools/deploy-v3에 의존하지 않는다(vendor isolation); AMM venue는 MockPool을 쓰고, 실제 Uniswap v3 pool 배포는 별도 follow-up으로 남는다.

Verification

  • scripts/e2e-anvil.sh(fresh + repeat) 2회 실행, 각 7/7 PASS + exit 0.
  • scripts/e2e-anvil.sh --keep 실행 후 Anvil이 계속 살아 있음을 확인.
  • forge test --offline(238/238 유지; TREXSuite→TREXCore 추출 후에도 green).
  • forge fmt --check.

State

passing

Notes

  • runbook: docs/demo.md(실행법, scenario 순서, reason-code 재계산, mock/real 구분).
  • 관련 결정: D008/D009(illustrative element library, manifest lifecycle). 실제 Uniswap v3 pool 배포와 production data source 연결은 out-of-scope.
  • Non-goals: 실 Uniswap v3 pool, production governance key management, direction-aware element application.

CMP-002 — Manifest Lifecycle & Operator Approval Flow

Behavior

  • Manifest는 validated state machine을 따른다: UNKNOWN --register--> PROPOSED --approve--> ACTIVE, ACTIVE <--resume--/--suspend--> SUSPENDED, {ACTIVE, SUSPENDED} --retire--> RETIRED(terminal), UNKNOWN --setUnregulated--> UNREGULATED --clearUnregulated--> UNKNOWN. 그 외 모든 transition은 InvalidManifestTransition으로 revert한다.
  • registerManifest는 caller-supplied status를 무시하고 항상 PROPOSED로 착지하며 declaredBy = msg.sender를 기록한다. approveManifest는 approvedBy를 기록하고 issuance recipe가 비어 있으면 revert한다. raw setStatus는 제거되었다.
  • owner가 자산을 classify(register/setUnregulated/clearUnregulated)하고 operator가 기존 manifest의 lifecycle(approve/suspend/resume/retire)을 구동한다.
  • ComplianceEngine.evaluate는 side별 positive allowlist(UNREGULATED 또는 ACTIVE만 허용)로 default-deny한다. UNKNOWN/SUSPENDED/PROPOSED/RETIRED와 미래 member는 fail-closed하며, both-UNREGULATED fast-path는 유지된다.
  • CornerStoreFactory.registerRWAToken은 register→approve를 한 governed call에서 실행하고 token은 ACTIVE로 끝난다(declaredBy/approvedBy = factory).

Verification

  • forge test --offline(전체 227/227, pre-task 212 + 신규 15).

  • Engine unit test(default-deny fail-closed): test_proposed_against_unregulated_fails_closed, test_retired_against_unregulated_fails_closed, test_proposed_against_active_fails_closed, test_retired_against_active_fails_closed_both_orderings(양방향 ordering).

  • Registry unit test(clearUnregulated + onlyOwner-vs-onlyOperator): test_clearUnregulated_from_UNREGULATED, test_clearUnregulated_then_register_ok, test_clearUnregulated_reverts_when_UNKNOWN, test_clearUnregulated_reverts_when_PROPOSED, test_clearUnregulated_reverts_when_ACTIVE, test_clearUnregulated_reverts_for_non_owner, test_clearUnregulated_reverts_for_operator, test_setUnregulated_reverts_for_operator.

  • 통합 test test/integration/EmergencyPause.t.sol(router end-to-end): test_proposedPolicy_failsClosed, test_retiredPolicy_failsClosed, test_suspendThenResume_tradesAgain.

  • 기존 registry lifecycle state-machine unit test(Task 1, 25 tests)는 유지.

  • forge fmt.

  • 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에서 구현한다.

DEMO-002 — MVP RFQ Demo Backend

Behavior

  • services/rfq-demo-backend가 RFQ SDK를 사용해 local Anvil용 signed quote HTTP API를 제공한다.
  • backend는 deployment artifact의 approved maker, RFQ adapter, venue와 QUOTE/RWA pair에 고정되며 mock fixed-rate pricing을 사용한다.
  • CLI rfq-quote --backend <url>가 backend quote를 기존 quote JSON 형식으로 저장하고 기존 buy --venue rfq protected Router flow에서 사용한다.
  • live runner와 CLI는 buidl-like | reg-d asset profile을 선택하며, issue #40의 기본값은 BUIDL-like metadata + Reg D/QP/minimum-investment Manifest다.
  • live runner가 backend quote → CLI → Router/RFQAdapter 성공과 revoked-maker 실패를 자동 실행한다.
  • scripts/e2e-anvil.sh --mode rfq는 AMM·lifecycle·surveillance 설명을 건너뛰고 mock TA profile → Toolkit/CLI → backend-signed quote → protected RFQ settlement → revoked-maker rejection만 보여주는 짧은 MVP 시연 경로를 제공한다.
  • Dashboard는 사용자 중심의 Dashboard → RFQ 거래 → My RFQs → Portfolio 흐름을 기본 navigation으로 제공하고 Security proof와 read-only Operator view는 Advanced로 분리한다. 사용자는 local backend에서 exact signed quote를 요청·비교·검토한 뒤 protected Router settlement를 실행하고 실제 session balance delta를 Portfolio에서 확인한다. Security proof는 on-chain maker revoke 상태를 명시적 restore 전까지 유지해 현재 정책 enforcement를 가시화한다. 브라우저에는 private key가 전달되지 않는다.
  • Trader의 live firm rate는 /demo/quote 금액에서 계산한다. 비교 maker, 가격 곡선, spread와 활동 통계는 multi-maker/market-data API가 생기기 전까지 명시적으로 Demo fixture data와 Preview only로 표시해 실제 실행 가능 quote와 구분한다.
  • 헤더의 ? presenter guide가 정상 거래, maker-revocation 보안 시나리오, live/fixture 경계와 각 버튼의 실제 backend/Operator API 연결을 대시보드 안에서 설명한다.
  • backend는 pricing, signing과 nonce 발급만 담당하며 compliance 최종 판단을 하지 않는다.
  • long-lived demo backend는 CLI와 동일한 Anvil 계정을 함께 사용해도 각 transaction의 pending nonce를 다시 조회하고 settlement action을 직렬화해 stale nonce와 중복 제출을 방지한다. live E2E는 UI와 동일하게 quote 요청 후 그 exact quote를 trade endpoint에 제출하고, CLI activity 이후 backend 재체결까지 검증한다.
  • dashboard는 /rfq-api same-origin proxy로 backend에 연결되어 custom launcher port에서도 frontend 수정 없이 동작한다. trade endpoint는 제출된 quote의 maker/taker/token pair/venue/domain/signature를 deployment artifact와 대조한 뒤에만 local settlement를 실행한다.
  • production pricing, signer custody, persistent nonce, inventory/risk control과 hosted operation은 명시적으로 범위 밖이다.

Verification

  • cd services/rfq-demo-backend && npm test
  • cd services/cli && npm test
  • scripts/check.sh
  • scripts/e2e-anvil.sh --profile buidl-like
  • scripts/e2e-anvil.sh --profile reg-d
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • scripts/check.sh 통과: Foundry 248/248, RFQ SDK, CLI, RFQ demo backend와 deploy-v3.
  • backend smoke가 HTTP quote, fixed pricing, maker signature, monotonic nonce와 invalid amount를 검증한다.
  • CLI smoke가 --backend request path를 검증하고 기존 RFQFlow.t.sol이 protected Router settlement의 성공/거부 경로를 검증한다.
  • Foundry v1.7.1 clean build에서 buidl-like과 reg-d 두 profile 모두 통과: 각각 7/7 scenarios, backend-signed quote settlement, revoked-maker 거부.
  • RFQ-first dashboard/runbook: services/operator-dashboard의 사용자 중심 4개 기본 화면과 2개 Advanced 화면, local HTTP server smoke, --mode rfq live E2E를 검증했다. 시연 순서는 docs/rfq-demo-guide.md를 기준으로 한다.

CLI-001 — corner-store Reference CLI

Behavior

  • services/cli/에 TypeScript CLI(corner-store)를 추가해, forge 스크립트를 직접 다루지 않고 터미널에서 live 노드 대상으로 전체 스택을 구동한다: onboarding, attestation, manifest lifecycle, AMM/RFQ 거래, reason-code 디코딩. 기대 환경은 Anvil E2E 배포(scripts/e2e-anvil.sh --keep + deployments/anvil-e2e.json).
  • 명령: status(주소/manifest/venue/per-element attestation 상태, --json), onboard(factory 1-call, ACTIVE면 retire→register→approve), manifest <status|suspend|resume|retire>, attest <element> <subject> [value...] (9개 element setter), investor-setup <addr> --profile ...(선택 profile attestation + C-01 acquisition seed + QUOTE funding), kyc <addr>(ERC-3643 identity/claim, script/KycInvestor.s.sol forge 스크립트로 위임), buy <amountIn> (--venue amm|rfq, --min, --quote), rfq-quote/rfq-cancel(services/rfq EIP-712 서명 라이브러리 재사용), maker <approve|revoke>, reason <bytes32>.
  • reason 디코딩은 (recipeId∈{1,2,7}) × (11 element) × code 1 + engine의 policy-status 거부(encode(0,"POLICY",status))를 오프라인 사전계산해 매칭한다. ComplianceRejected 를 잡는 모든 명령이 자동 디코딩하고, 실패 tx는 디코딩된 reason과 함께 non-zero 종료.
  • chain 상호작용은 ethers(services/rfq에는 web3 라이브러리가 없어 CLI가 유일하게 도입), ABI는 src/abi.ts의 hand-written fragment(out/ 비의존). src/ 제품 코드 변경 없음; 신규 Solidity는 script/KycInvestor.s.sol 하나(shared TREXCore 재사용, 이미 배포된 T-REX 스택에 re-bind).

Verification

  • npm test(services/cli): reason-table decode round-trip(cast keccak ground-truth 대조) + quote-file round-trip 스모크, 네트워크 불필요.
  • Live 노드 walkthrough(fresh account 4): status → onboard → investor-setup → kyc → buy(AMM PASS, +100 RWA) → attest jurisdiction ZZ → buy(FAIL, decoded recipe 1 / A-02-v1 / Jurisdiction) → restore → manifest suspend → buy(FAIL, POLICY / SUSPENDED) → resume → buy(PASS) → rfq-quote → buy --venue rfq (PASS) → maker revoke → buy --venue rfq(FAIL, RFQMakerNotApproved). 전 실패 경로 non-zero 종료 + 디코딩 확인.
  • forge test --offline 238/238 유지(Solidity 측 추가는 KycInvestor.s.sol뿐).

State

passing

Notes

  • runbook: services/cli/README.md("CLI demo" 레시피), docs/demo.md의 "CLI로 직접 해보기" 섹션.
  • kyc는 repo root에서 실행해야 한다(상대 fs_permissions + 스크립트 경로). CLI가 forge cwd를 repo root로 설정하고 artifact를 root-상대 경로로 전달한다.
  • Non-goals: 프로덕션 key 관리, out/ ABI 커플링, 두 번째 web3 라이브러리 도입.

CLI-002 — corner-store CLI v2 (preflight · trade surface · observability)

Behavior

  • 기존 services/cli에 명령 7개를 더한다(제품 코드/스크립트 변경 없음, services/cli/**
    • 문서만):
    • check <buyer> [--venue amm|rfq] [--amount n] [--json] — 거래 없이 per-element preflight. active manifest의 recipe id → requiredElements() → ElementRegistry.elementOf → 각 element check(buyer, seller, rwa, amount, "")를 eth_call로 실행하고, engine.evaluate(ctx)(view)로 전체 verdict를 낸다. 표(id/name/ PASS·FAIL)+verdict 라인, FAIL 행은 디코딩된 reason, verdict가 rejected면 exit 1. 엔진은 ctx.buyer만 스크리닝(비-direction-aware)하므로 subject를 무시하는 asset-side 원소(B-01/B-02/E-01)는 표에 [asset-side]로 표기해 per-buyer FAIL 오독을 막는다.
    • sell <amountIn> [--min] — AMM 매도(tokenIn=RWA, tokenOut=QUOTE). buy를 미러링하되 test/integration/SwapFlow.t.sol::test_sell_shaped_success의 컨텍스트(ctx.buyer=매도자, venueData=zeroForOne=false)를 그대로 따른다.
    • balances [addr...] [--json] — RWA/QUOTE 잔고 + amm/rfq adapter allowance(기본: 5개 well-known 역할).
    • watch [--from block] — eth_getLogs 폴링(~2s) 이벤트 tail: Executed, RFQFilled, RFQQuoteCancelled, MakerApprovalSet, ManifestRegistered, ManifestStatusChanged, SurveillanceFlag. reason/label·status·elementId 디코딩, --from은 히스토리 재생.
    • faucet <addr> <amount> — QUOTE 민팅(MockERC20.mint permissionless, demo 전용).
    • snapshot / restore <id> — anvil evm_snapshot/evm_revert(RPC 미지원 시 명확한 에러).
    • quote-inspect <file> [--json] — 서명 quote 디코딩: services/rfq 타입드데이터로 서명자 복구(==maker PASS/FAIL), 만료 카운트다운, on-chain usedQuoteNonce/approvedMaker. 실패 검사가 하나라도 있으면 exit 1.
  • 재사용 원칙 준수: reason 디코딩은 기존 reason.ts, EIP-712 복구는 services/rfq lib의 domain+types로 ethers.verifyTypedData(타입 문자열 재선언 없음). ABI fragment는 계속 hand-written(out/ 비의존)이며 실제 컨트랙트 소스와 대조해 추가했다.

Verification

  • npm test(services/cli): quote-inspect 서명자 복구 round-trip(valid + tampered) + reason-decode 회귀(check가 쓰는 recipe-aware per-element code) 스모크, 네트워크 불필요.
  • Live walkthrough(scripts/e2e-anvil.sh --keep, fresh account 4): check(미attested → A-02/A-03/A-04/C-01 FAIL + rejected, exit 1) → investor-setup+kyc → check(전 PASS, ALLOWED) → faucet → buy(+100 RWA) → sell 40(RWA -40, QUOTE +40) → balances 전/후 → snapshot(0x11) → attest jurisdiction ZZ → check(정확히 A-02 하나 FAIL, exit 1) → restore 0x11 → check(ALLOWED) → watch --from 0(세션 이벤트 디코딩 재생, 라이브 MakerApprovalSet tail) → rfq-quote → quote-inspect(전 PASS) → 파일 서명 변조 → quote-inspect(signature FAIL, exit 1).
  • forge test --offline 238/238 유지(Solidity 변경 없음).

State

passing

Notes

  • runbook: services/cli/README.md(CLI v2 명령/주의), docs/demo.md.
  • check는 엔진이 direction-aware가 아니라는 점을 도움말·표기로 명시(asset-side 라벨).
  • snapshot/restore는 anvil 전용; restore는 이후 스냅샷을 무효화(문서화).
  • Non-goals: CLI-001과 동일(프로덕션 key 관리, out/ ABI 커플링, 2차 web3 라이브러리).

TOOLKIT-001 — Versioned Config Foundation

Behavior

  • 사용자가 자산 profile과 사용할 venue를 JSON 설정에서 선택한다.
  • schemaVersion으로 설정 형식을 고정하고, 잘못된 profile·venue·operator 계정은 배포 전에 fail-closed 검증한다.
  • services/toolkit의 validator를 CLI가 재사용한다.
  • corner-store toolkit-init과 corner-store toolkit-validate로 설정 생성·검증을 같은 인터페이스에서 수행한다.
  • corner-store toolkit-simulate로 artifact/profile/venue binding과 read-only 실행 순서를 트랜잭션 전에 확인한다.
  • corner-store toolkit-preflight로 실제 deployment artifact의 주소와 선택 profile, venue 구성을 mutation 전에 검증한다.
  • corner-store toolkit-onboard가 같은 config를 preflight한 뒤에만 선택한 profile과 venue를 manifest에 반영한다.
  • corner-store toolkit-checkpoint가 config/artifact hash와 deployment state를 secret-free immutable JSON으로 기록하고 기존 checkpoint 덮어쓰기를 거부한다.
  • corner-store toolkit-proposal이 target/calldata/reason/artifact hash를 담은 draft governance proposal만 생성하며 multisig 실행은 수행하지 않는다.
  • draft proposal을 Safe-compatible transaction payload로 export할 수 있지만, Toolkit은 서명·제출·승인 상태 변경을 수행하지 않는다.
  • corner-store toolkit-deploy가 기존 DeployStack.s.sol을 config profile에 맞춰 호출하며, 기본은 dry-run이고 --broadcast를 명시해야만 mutation한다.
  • corner-store toolkit-test가 동일한 사용자 진입점에서 repository-wide scripts/check.sh를 실행한다.
  • live Anvil E2E가 실제 deployment artifact에 대해 Toolkit preflight와 immutable checkpoint를 실행한 뒤 CLI onboarding/RFQ settlement를 수행한다.
  • BUIDL-like와 Reg D profile별 Toolkit config fixture를 각각 검증한다.
  • Toolkit config는 governance multisig alias와 required approval 수를 명시하며 private key나 signer material은 포함하지 않는다.
  • Element/Recipe/Adapter/provider 템플릿과 required input/trust-boundary 검증을 제공해 확장 시 기존 compliance/router 경계를 복사하지 않도록 한다.
  • private key를 받지 않는 read-only Operator API로 config/deployment snapshot과 normalized event index를 제공한다.
  • read-only Operator dashboard가 profile/venue/event snapshot을 표시하고, 변경은 외부 multisig proposal 검토 후 실행하도록 경계를 둔다.
  • Operator API가 local/demo in-memory index와 교체 가능한 file-backed event index를 제공하며 마지막 block cursor를 보존한다.
  • finality-aware indexer가 confirmation depth 이후 block만 저장하고 finalized block hash가 바뀌면 fail-closed로 중단한다.
  • Operator API가 선택적 Bearer token 인증을 지원하며 health endpoint 외 조회를 인증 없이 노출하지 않는다.
  • /metrics가 요청 수·인증 실패·indexed event count를 Prometheus 형식으로 노출하며 주소·token 값은 포함하지 않는다.
  • Wave-2 illustrative elements는 기본 Foundry script discovery 경로 밖의 tools/deploy-wave2/DeployWave2Elements.s.sol에서 opt-in으로 등록해 기본 BUIDL-like/Reg D demo의 배포 범위와 컴파일 그래프를 보존한다.

Verification

  • cd services/toolkit && npm test (simulation/template/preflight mismatch 포함)
  • cd services/operator-api && npm test
  • cd services/operator-dashboard && npm test
  • cd services/cli && npm test
  • scripts/check.sh

State

passing

Scope

이번 단계에서 공통 설정 계약, validation/simulation, preflight/onboard/deploy/test, checkpoint와 governance handoff, operator API/indexer 및 read-only dashboard까지 구현·검증했다. production TLS/secret rotation, 실제 multisig provider, live RPC finality/recovery와 production RFQ custody는 별도 후속 feature다.

OPS-001 — High-severity Solidity Lint Gate

Behavior

  • production Solidity source에 Foundry의 high-severity lint를 실행한다.
  • high-severity warning이 하나라도 있으면 local repository check와 CI가 실패한다.
  • test fixture의 medium/low 경고는 별도 warning-budget feature로 분리한다.
  • venue bitmask는 명시적 uint256(1)을 사용해 shift operand 폭을 고정한다.

Verification

  • forge lint --severity high --deny warnings src
  • forge test --offline
  • scripts/check.sh

State

passing

Scope

새 정적 분석 의존성을 추가하지 않고 Foundry stable에 내장된 production lint만 fail-closed gate로 도입한다. Slither와 medium warning 정리는 후속 범위다.

OPS-002 — Repository-wide CI Parity

Behavior

  • GitHub Actions가 local scripts/check.sh와 동일한 repository-wide gate를 실행한다.
  • RFQ SDK, CLI, demo backend, Toolkit, Operator API/dashboard와 vendored deploy-v3가 pull request마다 검증된다.
  • npm 서비스는 각 lockfile을 cache key와 deterministic install에 사용한다.
  • vendored deploy-v3는 자체 yarn.lock과 directory boundary 안에서만 설치·검증한다.

Verification

  • scripts/check.sh
  • GitHub Actions Run repository-wide checks

State

passing

Scope

기존 local gate와 CI의 범위를 일치시킨다. live Anvil E2E는 별도 실행 비용과 환경 격리가 필요하므로 이 feature의 PR gate에는 포함하지 않는다.

DOC-003 — Goal Completion and Operations Alignment

Behavior

  • ROADMAP이 이미 구현된 Toolkit, Operator API/dashboard와 profile별 live E2E를 완료 상태로 기록하고 production 후속 범위와 구분한다.
  • incident response가 현재의 asset/venue/maker containment 경로, 외부 ERC-3643/ONCHAINID boundary와 multisig/timelock recovery gate를 따른다.
  • 미구현 central pause, production custody/hosting/finality를 구현된 기능처럼 표현하지 않는다.

Verification

  • scripts/e2e-anvil.sh --profile buidl-like
  • scripts/e2e-anvil.sh --profile reg-d
  • Markdown link와 git diff --check 검토

State

passing

Scope

문서 정합화와 운영 runbook만 추가한다. contract, API 또는 production 운영 정책은 변경하지 않는다.

PROD-001 — Production Control Plane

Behavior

  • OperatorRegistry가 global, asset, venue pause의 단일 source of truth가 된다.
  • operator는 위험을 즉시 중단할 수 있지만 unpause는 owner가 예약한 뒤 최소 timelock이 지난 후에만 실행할 수 있다.
  • ExecutionRouter는 compliance evaluation과 venue dispatch 전에 global, 양쪽 asset, venue pause를 fail-closed로 검사한다.
  • Manifest lifecycle은 현재 version, pending update, full manifest hash와 append-only history hash를 보존한다.
  • ACTIVE/SUSPENDED Manifest의 semantic update는 별도 pending proposal로 저장되고 timelock 이후 승인되며, suspended asset을 update만으로 재개할 수 없다.
  • lifecycle/pause 변경은 actor, old/new value, reasonCode/reasonHash와 effective time을 event로 남긴다.

Verification

  • forge fmt --check
  • forge lint --severity high --deny warnings src
  • forge test --offline --match-path test/unit/registry/OperatorRegistry.t.sol -vv
  • forge test --offline --match-path test/unit/registry/TokenPolicyRegistry.t.sol -vv
  • forge test --offline --match-path test/unit/execution/Router.t.sol -vv
  • forge test --offline --match-path test/integration/EmergencyPause.t.sol -vv
  • forge test --offline
  • scripts/check.sh

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/PROD-001-production-control-plane.md
  • governance owner는 외부 Safe-style multisig를 전제로 하며 컨트랙트 내부에 n-of-m signer 로직을 구현하지 않는다.
  • issuer disable, production multisig provider와 chain별 timelock 값은 후속 운영 설정이며, 현재 manifest에 issuer identity가 없으므로 asset pause로 fail-closed한다.

DATA-001 — Compliance Data Layer Foundation

Behavior

  • ADR-008의 Transfer Agent 경계를 provider-neutral TypeScript SDK로 제공한다.
  • per-lot acquisition 입력은 lineage, 완납일과 freshness를 검증하고 보수적인 holder×asset snapshot으로 컴파일한다.
  • Lockup은 operator-attested snapshot의 상태와 만료를 fail-closed로 검사한다.
  • 거절 시도와 router 밖 transfer finding은 PII 없이 hash-chain audit trail에 append할 수 있다.
  • person-group 단위 volume/holder state는 execution idempotency를 보장한다.
  • 실제 Securitize API, WORM storage와 production surveillance hosting은 adapter 교체 지점으로 남기며 구현되었다고 주장하지 않는다.

Verification

  • forge fmt --check
  • forge test --offline --match-path test/unit/compliance/AcquisitionSource.t.sol -vv
  • forge test --offline --match-path test/unit/compliance/Elements.t.sol -vv
  • cd services/compliance-data && npm test
  • scripts/check.sh

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/DATA-001-compliance-data-layer.md
  • 실제 Securitize/TA field mapping은 공식 API 계약이 제공될 때 별도 provider adapter로 구현한다.
  • 단일 holder×asset snapshot은 모든 현재 lot 중 가장 늦은 clock을 사용하므로 amount-specific lot allocation 전까지 일부 mature lot 매도를 보수적으로 막을 수 있다.

Related Files

  • services/compliance-data/
  • src/registry/AttestedAcquisitionSource.sol
  • src/compliance/elements/Lockup.sol
  • test/unit/compliance/AcquisitionSource.t.sol

DATA-002 — Provider-Neutral TA/KYC Evidence

Behavior

  • services/compliance-data exposes a provider-neutral TA/KYC evidence boundary without hardcoding Securitize or another vendor API. Operator adapters supply provider results; Corner Store core accepts only subject/identity/asset bindings and PII-free hashes.
  • KycEvidenceCoordinator validates exact taker/identity/asset binding, exact request/result/fact schemas, bounded provider IDs, schema versions, assessment/source evidence hashes, provider timeout, freshness/future skew and explicit ACTIVE | REVOKED | INELIGIBLE status before materializing evidence.
  • Canonical evidenceHash is domain-separated over normalized provider/schema, subject/identity/asset, facts, timestamps, status and source hash. Any fact, revocation or lineage change changes the hash.
  • Provider outage/timeout, malformed or missing fields, stale/future data, binding mismatch, sanctions hit, non-verified KYC, ineligible/revoked status, missing/failed strict success audit, store mismatch/conflict all fail closed and never return eligible materialization. Cached last-good evidence is not used to hide refresh outages.
  • InMemoryKycEvidenceStore is a reference/conformance store only; production deployments must replace it with transactional durable/HA storage. It enforces idempotent replay, same-assessment conflict detection and monotonic protection so older active evidence cannot overwrite newer or revoked evidence.
  • Audit and incident hooks use PII-free hashes, bounded status/reason codes and on-chain IDs only. Strict success audit runs before eligible store publish; store failure after success audit adds a fail audit/incident. Failure-audit and incident-hook errors are bounded/non-recursive.
  • ERC-3643/ONCHAINID remains an external trust boundary: the output is evidence for an issuer/TA-approved adapter, not direct claim issuance or registry writes.

Verification

  • npm test --prefix services/compliance-data
  • git diff --check

State

passing

Notes

  • Implements the D012/PD-4 provider-neutral boundary; no new vendor compatibility decision was introduced.
  • Existing mock TA and local demo flows are unchanged.

Related Files

  • services/compliance-data/src/kyc.ts
  • services/compliance-data/test/smoke.ts
  • services/compliance-data/README.md

MANIFEST-002 — RecipeBinding Manifest Migration

Behavior

  • 자산 Manifest는 고정 issuanceRecipeId + fundRecipeId 대신 bounded RecipeBinding[]를 registry에 저장한다.
  • REQUIRED_BLOCKING Recipe는 AND, 같은 pathGroupId의 PATH_OPTION은 OR, 서로 다른 path group은 AND로 평가한다.
  • FLAG_ONLY 실패는 거래를 막지 않고 ComplianceDecision.flagsBitmap과 Router event로 노출한다.
  • binding 변경은 full manifest hash 변경과 기존 timelock/version/history를 거친다.
  • binding 수, recipe/version, path group과 duplicate 입력은 등록 시 fail-closed로 검증한다.

Verification

  • RecipeBinding registry/lifecycle unit tests
  • REQUIRED/PATH/FLAG engine regression tests
  • pair-side, stateful commit와 Router event integration tests
  • scripts/check.sh
  • buidl-like / reg-d live E2E

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/MANIFEST-002-recipe-binding-migration.md
  • canonical bytes32 recipeKey alias와 per-element enforcement override compiler는 별도 versioned refinement로 남긴다.

AMM-001 — Canonical Uniswap v3 Pool E2E

Behavior

  • vendored @uniswap/v3-core artifact로 canonical factory/pool을 배포한다.
  • CREATE2 예상 주소와 factory가 생성한 pool 주소가 일치해야 한다.
  • 실제 pool을 verified ERC-3643 holder, venue와 adapter allowlist에 등록한다.
  • 초기화·유동성 공급 후 ExecutionRouter → UniswapV3Adapter → pool exact-input swap이 실제 callback과 ERC-3643 transfer를 거쳐 성공한다.
  • 미등록 pool/callback은 계속 fail-closed이고 Router/Adapter는 잔액을 보유하지 않는다.

Verification

  • canonical factory/pool deployment와 CREATE2 preflight integration test
  • protected buy/sell, compliance rejection와 callback authorization tests
  • scripts/check.sh

State

passing

Notes

  • 완료 계획: docs/exec-plans/completed/AMM-001-real-uniswap-v3-e2e.md
  • vendored Solidity source를 제품 src/로 복사하지 않는다.
  • production fee-tier 승인, LP 운영 정책과 unified deploy CLI는 별도 후속 범위다.

OPS-003 — Operator Deployment and Manifest Snapshot

Behavior

  • read-only Operator Dashboard가 배포 artifact의 execution/control-plane 주소를 표시한다.
  • Demo onboarding 직후 Manifest status, version과 RecipeBinding 수를 snapshot으로 저장한다.
  • Operator API가 snapshot을 /api/v1/manifest로 제공하고 Dashboard가 이를 표시한다.
  • Dashboard, CLI와 RFQ backend가 연결된 local BUIDL-like walkthrough를 한 번에 실행할 수 있다.

Verification

  • npm test --prefix services/operator-api
  • npm test --prefix services/operator-dashboard
  • npm test --prefix services/cli
  • forge build --offline --jobs 1
  • scripts/e2e-anvil.sh --profile buidl-like
  • git diff --check

State

passing

Notes

  • snapshot은 demo/reference checkpoint이며 production indexer나 live RPC provider가 아니다.
  • production Manifest lifecycle mutation과 governance action은 별도 범위다.

DEMO-003 — Role-aware RFQ Compliance Walkthrough

Behavior

  • 헤더에서 Admin, 적격투자자 A/B와 비적격투자자 fixture를 전환한다.
  • 사용자 RFQ 생성·수락 전에 현재 온체인 QP, maker 승인과 자산 정책을 pre-check한다.
  • quote는 선택한 taker 지갑에 EIP-712로 binding되고 다른 지갑이 재사용할 수 없다.
  • 비적격 사용자의 일반 quote 요청은 차단되며, 별도 proof action은 signed quote도 Router의 최신 ComplianceEngine 검사에서 거부됨을 보여준다.
  • Admin은 QP 결과를 직접 토글하지 않고 로컬 Anvil의 QP basis, claim 서명, trusted issuer, look-through와 fund binding 사실을 실제 트랜잭션으로 기록한다. A-13 Element가 법률-기술 변환 규칙에 따라 적격 결과를 계산하며, maker 승인과 체결·거부·정책 변경 내역도 조회한다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • forge build --offline --force
  • forge test --offline
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • 지갑 선택은 local demo persona이며 production authentication/custody가 아니다.
  • pre-check는 UX용 사전 판단이고 최종 권한은 Router fill-time evaluation에 있다.

DEMO-004 — Injectable Temporal RFQ Scenario

Behavior

  • 데모 자산 표시값, maker 이름, 지갑 persona, 초기 QP 상태, preview quote와 freshness 시간 조건을 versioned scenario JSON으로 주입한다.
  • 주소는 UI에 하드코딩하지 않고 fresh Anvil 배포 artifact와 scenario의 artifactKey mapping으로 확인한다.
  • scripts/demo.sh --scenario <path>와 E2E가 동일한 scenario를 사용한다.
  • scenario 준비는 초기 QP 상태와 freshness cap을 실제 로컬 Anvil 트랜잭션으로 기록한다.
  • quote 발급 당시 적격이던 투자자의 QP claim만 만료시키고, 아직 유효한 동일 signed quote가 Router의 fill-time 검사에서 거부되는 것을 보여준다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • scenario는 local deterministic fixture이며 실제 identity provider가 아니다.
  • 임의 주소를 UI에서 가장하지 않는다. 거래 지갑은 배포 artifact와 일치하는 funded Anvil signer여야 한다.

DEMO-005 — Bidirectional RFQ Demo

Behavior

  • 매수는 taker의 결제 자산을 maker에게 보내고 maker의 ERC-3643 RWA를 받는다.
  • 매도는 token pair를 반대로 binding해 taker의 RWA를 maker에게 보내고 maker의 결제 자산을 받는다.
  • scenario가 RWA와 결제 자산의 표시 정보/decimals를 주입하며 UI 주소나 자산 symbol에 의존하지 않는다.
  • 배포 fixture는 매수·매도를 어느 순서로 실행해도 되도록 양쪽 inventory와 RFQAdapter allowance를 준비한다.
  • Portfolio와 체결 결과는 RWA 및 결제 자산의 실제 온체인 증감량을 함께 표시한다.
  • stateful commit은 RWA가 tokenOut이면 maker→taker, tokenIn이면 taker→maker로 실제 regulated transfer 방향을 기록한다.

Verification

  • forge test --offline --match-contract RFQFlowTest
  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • RFQ 가격은 local demo trade-impact provider이며 production pricing, inventory/risk engine과 multi-maker aggregation은 후속 범위다.

DEMO-006 — Deployment-bound Injectable RFQ Fixtures

Behavior

  • versioned scenario가 데모 계정 binding, 초기 투자자/maker/pool 물량, 매수·매도 기본 수량, quote TTL과 mock pricing을 주입한다.
  • 배포 스크립트가 선택한 scenario를 읽어 실제 Anvil mint/approval 계정과 금액에 반영하며, UI 전용 하드코딩 값으로 가장하지 않는다.
  • scenario의 지갑별 초기 QP 상태를 실제 A-13 fixture에 반영하고, qUSD / RWA 가격은 backend와 Solidity demo 모두 매수 시 역산·매도 시 정방향으로 계산한다.
  • 배포 artifact가 scenario schema version과 content hash를 보존하고 backend는 다른 scenario로 시작하려는 경우 fail-closed한다.
  • 사용자와 maker 잔액은 scenario 값을 그대로 표시하지 않고 배포 후 실제 balanceOf를 조회한다.
  • CLI/E2E는 scenario에 지정된 investor 계정을 사용하므로 기본 Anvil account 1에 의존하지 않는다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • forge build --offline
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • 비기본 account, 초기 물량과 비 1:1 mock price·변경된 지갑별 QP 상태 scenario 전체 E2E
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • scenario는 local mock data provider다. production은 RFQ SDK의 pricing, nonce, signer와 inventory/risk interface에 실제 provider를 주입한다.
  • preview quote는 계속 명시적인 presentation fixture이며 executable liquidity로 취급하지 않는다.

DEMO-007 — Law-first QP and Dynamic RFQ Market Demo

Behavior

  • 사용자 화면은 내부 Element ID보다 ICA §3(c)(7)와 §2(a)(51)의 Qualified Purchaser 법적 기준을 우선 표시하고, A-13-v1은 기술 상세로만 제공한다.
  • QP basis별 통과 조건과 KE(Knowledgeable Employee)의 대상 펀드 일치 요건을 Admin 화면에서 바로 설명한다.
  • scenario가 초기 qUSD / RWA 가격과 fill당 impact bps를 주입한다.
  • 성공한 매수는 다음 mock 시장가격을 올리고 성공한 매도는 내리며, 이후 pre-check, firm quote, 포트폴리오 참고가격이 동일한 runtime 가격을 사용한다.
  • 거부된 거래는 가격을 바꾸지 않고 demo setup은 초기 가격으로 복원한다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • 이 가격 변화는 발표용 결정론적 mock market이다. 실제 RFQ 가격은 외부 시세, maker inventory, spread와 risk engine을 주입해야 한다.

DEMO-008 — RWA-aware RFQ Market Chart

Behavior

  • 사용자 Dashboard는 scenario에서 주입한 기초자산/NAV와 indicative RFQ mid 히스토리를 서로 다른 series로 표시한다.
  • indicative spread band를 표시하고 실제 Router 체결만 매수/매도 fill point와 거래량에 포함한다.
  • 성공한 체결은 다음 indicative 가격과 history API를 함께 갱신하며, 거부된 거래는 가격·체결 history를 변경하지 않는다.
  • 차트는 fixture와 live fill의 출처를 명확히 구분하고 sparse RFQ 거래를 연속 CLOB/AMM 캔들처럼 가장하지 않는다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • production에서는 mock NAV series를 실제 oracle/NAV provider로, in-memory fill history를 indexer/query service로 교체한다.

DEMO-009 — Resilient Repeated-Trade UX

Behavior

  • backend는 현재 RFQ 가격, 자산 최소수량과 scenario buffer를 사용해 다음 매수·매도의 최소 안전 입력값을 계산한다.
  • 새 RFQ와 매수/매도 전환은 이 값을 기본 입력으로 사용하되, 사용자가 더 작은 값을 직접 입력하면 기존 minimum-investment 정책이 그대로 거부한다.
  • 짧은 시간에 생성된 체결점은 실제 timestamp를 보존하면서 차트에서는 체결 순서로 분리하고, 가격축은 최소 범위를 유지해 작은 mock 변동을 과장하지 않는다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

DEMO-010 — RFQ Chart Fill Evidence

Behavior

  • 사용자 차트는 왜곡되거나 중복되는 짧은 구간 선택 없이 전체 기간을 표시한다.
  • 실제 Router fill은 매수/매도 marker로 표시하고, 체결 단가·RWA 수량· 실제 timestamp는 hover/focus tooltip에서 확인한다.
  • 최근 체결은 단가, RWA 수량, 실제 timestamp와 transaction hash를 별도 fill tape로 제공하고 fixture line과 구분한다.
  • RFQ가 sparse하거나 같은 초에 체결되어도 marker는 실행 순서로 분리한다.

Verification

  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

DEMO-011 — Interpolated History and Repeat Liquidity

Behavior

  • scenario의 가격 anchor를 주입된 sample interval로 보간해 전체 기간의 NAV와 indicative history를 안정적으로 표시한다.
  • 원본 가격 경로와 sample interval은 scenario에 남아 있고 Dashboard에 별도 가격 fixture를 하드코딩하지 않는다.
  • demo investor와 maker의 양방향 재고는 최소수량 RFQ를 연속으로 시연할 수 있도록 설정한다.
  • E2E는 동일 투자자의 연속 매수 4회와 연속 매도 4회를 실제 Router에서 체결해 재고와 nonce 경로를 검증한다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

DEMO-012 — Enforcement Case Workflow

Behavior

  • Admin은 Adapter 직접 호출, quote 이후 claim 만료, quote 이후 Maker 승인 취소를 각각 독립된 enforcement case로 연다.
  • 각 case는 기준 상태 준비, firm quote 발급, 정책 변경, 실행 제출, 증거 검토, 상태 복구를 별도 단계로 수행하며 한 버튼으로 전체 시나리오를 연출하지 않는다.
  • 차단 증거는 실제 status 0 transaction receipt, 거부 사유 또는 reasonCode, 실패 전후 RWA/결제 자산 잔액 불변과 실행 trace를 함께 제공한다.
  • UI는 Element → Recipe → Manifest → ExecutionRouter → Adapter binding과 일반 ERC-3643 token enforcement 대비 Corner Store 실행 경로 통제를 표시한다.

Verification

  • npm test --prefix services/rfq-demo-backend
  • npm test --prefix services/operator-dashboard
  • scripts/e2e-anvil.sh --profile buidl-like --mode rfq
  • git diff --check

State

passing

Notes

  • case와 evidence는 local Anvil 운영 워크스페이스다. production의 영속 case store, 인증, 감사 로그 서명과 외부 indexer를 대신하지 않는다.

SDK-001 — Modular Integration and Deployment Toolkit

Behavior

  • integrator가 Corner Store core, RFQ SDK, reference application을 구분해 필요한 모듈만 선택할 수 있다.
  • RFQ pricing, inventory/risk, signer와 nonce persistence는 versioned capability contract 뒤에서 교체할 수 있다.
  • CLI가 reference RFQ service 또는 기존 backend 연결 예제를 secret 없이 scaffold한다.
  • Docker Compose는 필수 runtime이 아니라 선택 가능한 reference deployment output으로만 생성한다.
  • reference 및 custom module이 같은 conformance suite를 통과한다.

Verification

  • cd services/rfq && npm test
  • cd services/toolkit && npm test
  • cd services/cli && npm test
  • generated scaffold build/smoke
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • completed plan: docs/exec-plans/completed/SDK-001-modular-integration-toolkit.md
  • hosted dealer, custody, production pricing/inventory와 Kubernetes는 범위 밖이다.

SDK-002 — Standalone Integration and Deployment Workflow

Behavior

  • 외부 사용자가 단일 CLI 흐름으로 프로젝트 생성, 진단, 배포 계획, 검증과 RFQ module conformance를 실행한다.
  • library-only, reference-service와 existing-backend 모드를 지원하고 Docker는 명시적으로 선택한 경우에만 생성한다.
  • contracts, Toolkit, RFQ SDK와 CLI를 repository 내부 전용이 아닌 package-ready artifact로 검증한다.
  • 생성 프로젝트는 주소나 secret을 하드코딩하지 않고 versioned config와 deployment artifact를 source of truth로 사용한다.
  • 기존 toolkit-* 명령은 compatibility alias로 유지한다.

Verification

  • clean generated-project install/build/doctor
  • custom RFQ module conformance CLI
  • package dry-run
  • repository check
  • Docker-independent deployment dry-run

State

passing

Notes

  • completed plan: docs/exec-plans/completed/SDK-002-standalone-integration-workflow.md
  • production durable nonce와 service hardening은 #66/#67 module로 유지한다.

SDK-003 — Publishable Package Release Contract

Behavior

  • CLI, Toolkit과 RFQ SDK를 각각 npm tarball로 build/pack하고 저장소 밖 clean project에서 설치한다.
  • Toolkit의 public CommonJS/types export와 기본 config simulation을 packed artifact 기준으로 검증한다.
  • package SemVer, schema/capability version 분리, release gate와 rollback 가능한 migration 절차를 문서화한다.
  • generated project의 RFQ conformance, CLI doctor/deploy dry-run과 packaged contract build가 repository-relative package resolution 없이 통과해야 한다.

Verification

  • npm test --prefix services/toolkit
  • npm test --prefix services/rfq
  • npm test --prefix services/cli
  • scripts/sdk-product-smoke.sh
  • git diff --check

State

passing

Notes

  • production npm registry publish와 release credential 사용은 이 저장소 검증 범위 밖이며, PR merge 후 별도 release 권한으로 수행한다.

STUDIO-001 — Local Deployment Studio

Behavior

  • 로컬 운영자가 브라우저에서 integration mode를 선택하고 실제 corner-store.config.json, corner-store.integration.json과 demo-only corner-store.scenario.json을 생성·검토한다.
  • Local Control API가 허용된 workspace 내부에서만 CLI를 실행하고 doctor, deployment dry-run, Anvil demo broadcast와 verify 결과를 구조화해 반환한다.
  • required doctor failure는 배포를 차단하고, 배포 artifact는 주소의 source of truth로 표시하며 verify 이후 기존 Operations Dashboard로 handoff한다.
  • UI는 demo fixture와 production configuration을 명확히 분리하고 private key, production secret 또는 mainnet broadcast 입력을 제공하지 않는다.
  • integration mode와 account/governance role label은 contextual guide로 실제 생성물, integrator 책임과 reference 경계를 설명한다.
  • network preset은 Anvil, public testnet, Arbitrum과 custom EVM을 설정 및 dry-run 대상으로 제공하되 direct broadcast는 runtime 오설정으로도 확장할 수 없는 Anvil-only gate와 operator RPC allowlist로 제한한다.
  • RFQ module은 검증된 reference ID와 custom adapter slot을 선택하게 하며, module ID 입력이 package 설치나 runtime 구현을 의미하지 않음을 표시한다.
  • Activation은 온체인 mutation 버튼이 아닌 manual evidence checklist임을 명시한다.

Verification

  • Local Control API path confinement와 command guard unit/smoke
  • config/integration validation과 JSON persistence smoke
  • doctor → dry-run → artifact/verify state transition smoke
  • Deployment Studio static UI/control wiring smoke
  • contextual help, network preset/custom target와 module preset/custom slot smoke
  • 로컬 Anvil deployment walkthrough
  • scripts/check.sh
  • git diff --check

State

passing

Notes

  • Completed plan: docs/exec-plans/completed/STUDIO-001-local-deployment-studio.md
  • production ERC-3643 onboarding, mainnet deploy/multisig execution과 secret custody는 범위 밖이다.

RFQ-POLICY-001 — Production RFQ Policy

Behavior

  • production RFQ v1은 protocol non-custodial, exact full-fill을 유지한다.
  • maker settlement account와 quote signer를 분리하고 current authorization을 fill 시점에 다시 검사한다.
  • durable nonce는 maker scope에서 atomic/monotonic하게 할당되며 idempotency conflict와 restart reconciliation을 지원한다.
  • pricing/inventory risk는 서명 전 fail-closed module이고 Router의 최신 compliance가 최종 gate다.
  • partial fill은 기존 quote의 옵션이 아니라 새 quote/adapter version이다.
  • finite compliance cap은 regulated asset quantity에 적용한다.

Verification

  • ADR/product spec consistency review
  • current contract/SDK gap mapping
  • hostile concurrency, signer rotation과 fill-time policy test matrix
  • independent architecture/critic review
  • git diff --check

State

passing

Notes

  • completed plan: docs/exec-plans/completed/RFQ-POLICY-001-production-rfq-policy.md
  • 특정 custodian/dealer/KMS/database vendor와 법률 적합성은 범위 밖이다.

CMP-004 — Wave-3 Illustrative Element Library

Behavior

  • 새로 문서화된 illustrative element 6개를 구현한다: A-06 Affiliate, A-12 Red Flag Knowledge Bar, E-03 Bad Actor Disqualification, F-01 Operator Self-Dealing, F-03 Fraud Surveillance, F-04 Reg M restricted-period buying gate. 각 element는 docs/elements 브랜치에 추가된 new-format docs/compliance/elements walkthrough 문서를 근거로 구현한다.
  • attestation setter는 operator-gated(Governed/onlyOperator)이며 production data source는 각 element 헤더의 approval-gated seam으로 남는다.
  • fail-closed default를 유지한다. F-01 OperatorSelfDealing은 registryAvailable default가 false여서 operator가 roster를 적재하고 명시적으로 켜기 전까지 모든 거래가 fail-closed된다.
  • monitoring element(A-12, F-03)는 거래를 막지 않는다. A-12는 pre-trade STATELESS로 표시만 하고 check()는 항상 pass하며, F-03은 STATEFUL post-trade 로 no-tipping-off party-facing surface(operator-gated view)를 통해 감시만 한다.
  • illustrative reference wiring이며 approved production policy가 아니다. element는 tools/deploy-wave3/DeployWave3Elements.s.sol에서 opt-in으로만 등록하고 active recipe에 붙이지 않는다. 기본 demo 배포 범위는 변경하지 않는다.
  • CLI(services/cli)의 reason-decode 테이블이 wave-3 6개 element를 wave-2와 동일한 수준(name label + per-element reason-code decode 테이블 + smoke-test enumeration)으로 커버한다. wave-2와 마찬가지로 attest 명령 (services/cli/src/elements.ts의 ELEMENT_IDS, 원본 9개)이나 DeployStack에는 추가하지 않는다.

Verification

  • forge test --offline(전체 770/770, pre-task 582 + 신규 188).
  • cd services/cli && npm test(CLI reason-decode 테이블이 이제 wave-3를 커버).
  • per-element unit test: test/unit/compliance/elements/Affiliate.t.sol, test/unit/compliance/elements/RedFlagKnowledgeBar.t.sol, test/unit/compliance/elements/BadActorDisqualification.t.sol, test/unit/compliance/elements/OperatorSelfDealing.t.sol, test/unit/compliance/elements/FraudSurveillance.t.sol, test/unit/compliance/elements/RegMIssuerBuying.t.sol.
  • forge fmt --check.
  • forge lint --severity high --deny warnings src.

State

passing

Notes

  • wave-2 precedent은 TOOLKIT-001 Notes(기본 script discovery 밖 opt-in 등록으로 기본 demo의 컴파일 그래프/배포 범위 보존)와 동일하다. wave-3 element는 DeployStack이나 active recipe에 추가하지 않는다.
  • production data-source seam은 각 element 헤더에 문서화되어 있다(OFAC/ONCHAINID/ EDGAR 등은 approval-gated seam).
  • F-01 OperatorSelfDealing의 registryAvailable fail-closed default는 deploy script가 자동으로 켜지 않는다. operator가 roster 적재 후 명시적으로 setRegistryAvailable(true)를 호출해야 통과가 시작된다.
  • F-03 FraudSurveillance는 STATEFUL(BaseStatefulElement)이므로 배포 후 setEngine(engine) wiring이 필요하다(wave-2 D-01 HolderCount와 동일 패턴).

CMP-005 — A-12 Registration Safety

Behavior

  • opt-in wave-3 배포에서 A-12를 명시적으로 FLAG_ONLY로 등록한다.
  • A-12는 거래를 직접 차단하지 않고 red-flag audit와 operator review로 라우팅한다.
  • active Recipe 배선과 production surveillance data source는 이 변경의 범위 밖이다.
  • one-shot Element 등록이 잘못된 기본 action으로 실행되지 않도록 정적 검증 gate를 둔다.

Verification

  • scripts/check-wave3-element-policies.sh
  • forge build tools/deploy-wave3/DeployWave3Elements.s.sol
  • forge test --offline --match-path test/unit/registry/ElementRegistry.t.sol
  • forge test --offline (870/870)
  • isolated full scripts/check.sh
  • git diff --check

State

passing

Notes

  • PR #96의 배선 위험 분석을 코드와 명세에 반영한다.
  • RedFlagKnowledgeBar의 기존 flag-not-block 동작은 변경하지 않는다.
  • 실제 broadcast/E2E는 active Recipe를 변경하지 않는 opt-in 등록 metadata 수정이고 배포 키가 필요한 경로이므로 실행하지 않는다.