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를 식별한다.
• 여러 Recipe의 Element를 cumulative AND로 실행 전에 평가한다.
• 허용된 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 services/rfq, services/rfq-demo-backend and services/cli
• 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 the live Anvil deployment artifact, 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

--keep leaves both Anvil and the RFQ demo backend running. In another terminal, request and settle the quote through the protected Router path:

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.

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를 기준으로 한다.