Corner Store

Corner Store is a Solidity SDK and reference execution system for DEX-level compliance of tokenized assets. The SDK models market access with reusable Element, Recipe, Manifest, and Operator boundaries. The Corner Store reference DEX proves the model across AMM, RFQ, and future Order Book adapters.

The SDK has two extension axes: policies are registered through Element/Recipe/Manifest, while execution venues or external DEX integrations are registered through a generic Router/Adapter boundary. Concrete Corner Store adapters and deployment configuration are reference implementations.

The repository currently contains the architecture and development plan, a vendored Uniswap v3 deployment tool, the Foundry product scaffold, and initial reference execution adapters including AMM and RFQ settlement paths.

Main Use Cases

• 제3의 DEX가 재사용할 수 있는 compliance interface와 registry 모델을 제공한다.
• Router를 수정하지 않고 정책과 execution Adapter를 등록·교체한다.
• 자산 Manifest와 거래 context로 applicable Recipe를 식별한다.
• Manifest의 RecipeBinding[]에 따라 필수 Recipe는 AND, 같은 path group의 대안 Recipe는 OR, 비차단 Recipe는 flag로 실행 전에 평가한다.
• 허용된 venue adapter로 거래를 전달한다.
• ERC-3643 token transfer enforcement와 Corner Store 거래 정책의 실패를 원자적으로 처리한다.
• Corner Store DEX로 SDK의 testnet 실행 흐름을 증명한다.

Repository Guide

• AGENTS.md: 세션 운영 규칙과 필수 명령
• ARCHITECTURE.md: 시스템 경계와 디렉터리 라우터
• FEATURES.md: feature behavior, verification과 state
• PROGRESS.md: 현재 상태와 다음 작업
• DECISIONS.md: 주요 결정과 이유
• QUALITY.md: 모듈별 품질 상태
• docs/testing.md: 테스트와 완료 기준
• docs/security.md: 보안 규칙

Product Documentation

• docs/README.md: documentation map and source-of-truth rules
• docs/MVP-v2-multi-venue.md: current product scope
• docs/architecture/README.md: responsibility boundaries
• docs/ROADMAP.md: implementation phases and completion criteria
• tools/deploy-v3/UPSTREAM.md: vendored upstream provenance

Tech Stack

• Contracts: Solidity + Foundry
• Tests: Forge
• Local chain: Anvil
• RFQ reference service: TypeScript
• RFQ demo backend and reference CLI: TypeScript
• Vendored deployment tooling: TypeScript, Yarn, ethers v5

Local Setup

Required tools:

• Foundry stable (forge, anvil; live E2E verified with v1.7.1)
• Node.js and npm for the TypeScript services under services/, including RFQ, CLI, Toolkit, Operator API and Compliance Data SDK
• Yarn for tools/deploy-v3

Foundry 버전을 바꾼 뒤 script broadcast에서 constructor decoding 오류가 나면 서로 다른 버전의 build artifact가 섞이지 않도록 forge clean 후 재실행한다.

Install or refresh the vendored tool dependencies when needed:

cd tools/deploy-v3
yarn install --frozen-lockfile

Development Commands

The product contracts use Foundry. The current scaffold contains the Compliance Core, Execution Integration Kit, AMM reference adapter, RFQ v1 reference settlement adapter, and related fixtures/tests.

Build

forge build

Test

forge test --offline

Format

forge fmt

Local Node

anvil

RFQ TypeScript SDK

services/rfq provides TypeScript SDK helpers for RFQ quote backends. It builds the same EIP-712 typed data that RFQAdapter verifies, assigns expiry and nonce, signs quotes through a caller-provided signer, and exposes pricing, nonce and risk-check interfaces for integrators. It is not a hosted production RFQ server, dealer, pricing engine, inventory manager, custody service, websocket feed, orderbook, or compliance decision engine.

cd services/rfq
npm ci
npm test

Local RFQ Demo Backend

services/rfq-demo-backend is a local-only HTTP application built from the RFQ SDK. It reads addresses from the live Anvil deployment artifact and presentation, wallet, initial qualification and temporal-expiry fixtures from a validated scenario JSON. It uses the configured mock maker and fixed-rate pricing and returns RFQAdapter-compatible signed quotes. It is not a hosted or production RFQ operator service.

scripts/e2e-anvil.sh --profile buidl-like --keep

For the short RFQ-first stakeholder walkthrough, omit the AMM scenario suite:

scripts/e2e-anvil.sh --profile buidl-like --mode rfq

Use another versioned local fixture without editing application code. Schema v2 can replace account bindings, initial balances, fixed mock pricing, default buy/sell amounts, wallet/QP facts and presentation values:

scripts/demo.sh --profile buidl-like \
  --scenario services/rfq-demo-backend/config/demo-scenario.json

Add --keep for an interactive follow-up; the runner restores the demo maker after its rejection check so a new quote can be filled immediately.

The selected scenario is copied into the deployment runtime input and its hash is written to the deployment artifact. The backend refuses a mismatched scenario, while balances displayed after deployment are read from the live token contracts.

--keep leaves both Anvil and the RFQ demo backend running. Open the printed dashboard URL, choose a demo wallet, select 매수 or 매도, request a firm quote and settle it through the protected Router; no CLI copy/paste is required. Buy moves the settlement asset to the maker and RWA to the investor. Sell reverses those token legs, and Portfolio shows both live balance deltas.

For a terminal-only flow, request and settle the quote directly:

# 5,000,000 is the tracked default scenario amount.
node services/cli/dist/cli/src/index.js rfq-quote \
  --backend http://127.0.0.1:8787 --amount-in 5000000 --out quote.json
node services/cli/dist/cli/src/index.js buy 0 --venue rfq --quote quote.json

See services/rfq-demo-backend/README.md for the complete local flow and production replacement boundaries.

Compliance Data SDK

services/compliance-data implements the provider-neutral ADR-008 foundation: TA lot/lineage resolution, conservative acquisition snapshots, person-group state and tamper-evident rejection/surveillance records. It does not include or claim compatibility with an undocumented production Securitize API.

cd services/compliance-data
npm ci
npm test

Check All

scripts/check.sh

The vendored Uniswap deployment tool has its own commands and scope:

cd tools/deploy-v3
yarn test

Read tools/deploy-v3/CORNER_STORE_PROFILE.md before changing the deployment profile.

Runtime Notes

• local Anvil runtime과 자동 E2E는 scripts/e2e-anvil.sh로 제공한다.
• tools/deploy-v3는 제품 배포 orchestrator가 아니라 독립 vendored module이다.
• 현재 작업 상태와 다음 feature는 PROGRESS.md와 FEATURES.md를 기준으로 한다.