이 문서는 Corner Store RFQ reference stack을 로컬 Anvil이 아니라 공개 테스트넷에 실제로 배포하는 가장 단순한 절차다.
배포 결과는 실제 테스트넷 트랜잭션과 컨트랙트 주소로 남는다. 다만 배포되는 ERC-3643 자산, Trusted Issuer claim, quote token과 초기 잔액은 해커톤 검증을 위한 fixture이며 실제 BUIDL 또는 Securitize 연동이 아니다.
처음 한 번:
- 최신
main준비 - 테스트넷 전용 배포 지갑 생성 또는 등록
- Faucet에서 테스트 gas token 수령
.env.testnet에 테스트 계정 주소 입력
배포할 때:
- 환경변수 불러오기
- 네트워크와 잔액 확인
- 시뮬레이션
- 실제 배포
- 생성된 artifact와 컨트랙트 주소 확인
아래 명령은 모두 Corner Store 저장소 루트에서 실행한다.
cd /path/to/corner-store현재 위치 확인:
pwd
test -f foundry.toml && echo "Corner Store root: OK"현재 작업 중인 브랜치에 미커밋 변경이 없다면:
git fetch origin
git switch main
git pull --ff-only origin main현재 브랜치에 미커밋 변경이 있거나 다른 작업을 유지해야 한다면, 별도의 clean worktree를 만드는 편이 안전하다.
git fetch origin
git worktree add /tmp/corner-store-testnet origin/main
cd /tmp/corner-store-testnet배포 파일이 있는지 확인한다.
test -f .env.testnet.example
test -x scripts/deploy-testnet-rfq.sh둘 중 하나라도 실패하면 아직 public-testnet 배포 코드가 없는 브랜치다.
| 항목 | 값 |
|---|---|
| Network | <testnet-name> |
| Chain ID | <chain-id> |
| RPC | <rpc-url> |
| Explorer | <explorer-url> |
| Gas token | 테스트 ETH 등 네트워크의 gas token |
RPC, Chain ID, Faucet, Explorer 값은 배포 대상 네트워크 운영자의 공식 문서에서
확인한다. 이후 명령과 설정의 <chain-id>, <rpc-url>, <explorer-url>은 그
값으로 바꿔 사용한다.
공용 RPC는 rate limit이 있을 수 있다. 배포 중 RPC 제한이 반복되면 네트워크 운영자가
지원하는 별도 RPC provider를 사용하되 Chain ID는 반드시 <chain-id>인지 확인한다.
실제 자산을 보관하는 지갑을 사용하지 말고 테스트넷 전용 지갑을 사용한다.
cast wallet import corner-store-testnet --interactive실행 중 입력하는 것:
- 테스트넷 전용 개인키
- 로컬 keystore를 암호화할 비밀번호
개인키는 명령행, .env.testnet, Git에 넣지 않는다. 이후 배포 명령에서는 개인키
대신 --account corner-store-testnet을 사용한다.
등록 확인:
cast wallet list
cast wallet address --account corner-store-testnet출력된 주소가 이번 배포의 CORNER_STORE_TESTNET_DEPLOYER다.
위에서 확인한 deployer 주소로 공식 Faucet에서 테스트 gas token을 받는다.
잔액 확인:
cast balance \
"$(cast wallet address --account corner-store-testnet)" \
--rpc-url <rpc-url>Corner Store reference stack은 여러 컨트랙트와 초기화 트랜잭션을 배포한다. 시뮬레이션에서 예상한 비용보다 충분히 여유 있는 잔액을 준비한다.
저장소 루트에서:
cp .env.testnet.example .env.testnetNo such file or directory가 나오면 다음을 확인한다.
pwd
git branch --show-current
ls -la .env.testnet.example scripts/deploy-testnet-rfq.sh파일이 없다면 1번 단계의 최신 main 또는 clean worktree 준비를 다시 수행한다.
.env.testnet에 다음처럼 입력한다.
RPC_URL=<rpc-url>
CHAIN_ID=<chain-id>
# 선택: Blockscout 기반 explorer에서 source verification을 할 때만 입력
BLOCKSCOUT_API_URL=<blockscout-api-url>
# cast wallet address --account corner-store-testnet 결과
CORNER_STORE_TESTNET_DEPLOYER=0x...
# 짧은 해커톤 fixture에서는 deployer와 같아도 된다.
CORNER_STORE_GOVERNANCE=0x...
CORNER_STORE_OPERATOR=0x...
# 테스트용 Maker와 투자자 지갑 주소
CORNER_STORE_TESTNET_MAKER=0x...
CORNER_STORE_TESTNET_INVESTOR=0x...
CORNER_STORE_TESTNET_INVESTOR_B=0x...
CORNER_STORE_TESTNET_INELIGIBLE_INVESTOR=0x...
# Mock Trusted Issuer 전용 폐기 가능한 테스트 키
# 실제 운영·자산 보관 지갑의 키를 사용하지 않는다.
CORNER_STORE_TESTNET_ISSUER_KEY=0x...
CORNER_STORE_DEPLOYMENT_ID=hackathon-testnet-rfq
# 배포본 브라우저 데모 설정
CORNER_STORE_TESTNET_RPC_URL=<rpc-url>
CORNER_STORE_TESTNET_EXPLORER_URL=<explorer-url>
CORNER_STORE_TESTNET_DEMO_HOST=127.0.0.1
CORNER_STORE_TESTNET_DEMO_PORT=8791| 환경변수 | 역할 |
|---|---|
DEPLOYER |
배포와 초기 설정 트랜잭션에 서명 |
GOVERNANCE |
배포 후 핵심 설정 소유권을 받는 주소 |
OPERATOR |
Maker 승인, 정책 운영 등 테스트 운영 권한 |
MAKER |
RFQ 가격을 제시하고 반대편 자산을 공급 |
INVESTOR |
정상 체결을 보여주는 적격 투자자 A |
INVESTOR_B |
quote 후 claim 만료 거부 시나리오용 적격 투자자 B |
INELIGIBLE_INVESTOR |
비적격 투자자 차단 시나리오용 |
ISSUER_KEY |
Mock ONCHAINID claim을 서명하는 테스트 전용 issuer 키 |
Governance와 Operator는 짧은 해커톤 배포에서는 deployer 주소를 재사용할 수 있다. Maker와 투자자들은 거래 주체가 다르므로 서로 다른 테스트 지갑을 사용하는 편이 데모가 명확하다.
.env.testnet은 커밋하지 않는다.
git check-ignore .env.testnet새 터미널을 열 때마다 저장소 루트에서 실행한다.
set -a
source .env.testnet
set +a필수값 확인:
printf 'RPC=%s\nCHAIN_ID=%s\nDEPLOYER=%s\n' \
"$RPC_URL" "$CHAIN_ID" "$CORNER_STORE_TESTNET_DEPLOYER"CORNER_STORE_TESTNET_ISSUER_KEY 같은 비밀값은 출력하지 않는다.
cast chain-id --rpc-url "$RPC_URL"
cast balance "$CORNER_STORE_TESTNET_DEPLOYER" --rpc-url "$RPC_URL"첫 번째 명령 결과가 반드시 공식 문서의 대상 Chain ID와 같아야 한다.
<chain-id>
다르면 배포하지 않는다.
--broadcast 없이 실행하면 테스트넷에 트랜잭션을 전송하지 않는다.
scripts/deploy-testnet-rfq.sh \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID" \
--account corner-store-testnet확인할 것:
- sender가
CORNER_STORE_TESTNET_DEPLOYER와 같은가 - Chain ID가
<chain-id>인가 - 시뮬레이션이 revert 없이 끝나는가
- deployer의 테스트 gas token이 충분한가
시뮬레이션이 성공한 뒤에만 실행한다.
scripts/deploy-testnet-rfq.sh \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID" \
--account corner-store-testnet \
--broadcast \
--verify--verify로 배포와 source verification을 함께 수행한다. verifier 설정은
explorer에 따라 다르다. Etherscan 호환 explorer와 Blockscout 기반 explorer의
옵션은 docs/testnet-deployment.md의
8절(Explorer Source Verification)을 따른다. Foundry가 keystore 비밀번호를
요청하면 3번 단계에서 설정한 비밀번호를 입력한다.
스크립트는 다음을 자동으로 수행한다.
- 대상 Chain ID 재확인
- ERC-3643/ONCHAINID 테스트 fixture 배포
- Compliance registry, Engine, Router 배포
- RFQ Adapter, Venue와 Maker Authorizer 배포
- BUIDL-like Manifest와 테스트 claim/잔액 초기화
- 온체인 배포 결과 검증
- 트랜잭션과 컨트랙트 주소를 artifact에 저장
배포 중 일부 트랜잭션만 성공하고 실패했다면 같은 deployment ID로 무작정
재실행하지 않는다. 로그와 broadcast/ 기록을 먼저 확인한다.
정상 완료 시 다음 파일이 생성된다.
deployments/public/hackathon-testnet-rfq-<chain-id>.json
주소 요약:
scripts/list-testnet-deployments.shJSON 출력:
scripts/list-testnet-deployments.sh --jsonartifact에는 다음이 기록된다.
- 배포 소스 commit
- Chain ID
- 배포 트랜잭션 hash
- ERC-3643 테스트 토큰
- Compliance Engine
- Execution Router
- RFQ Adapter와 Venue
- Maker Authorizer
- 테스트 참여자 주소
개인키와 RPC credential은 artifact에 저장되지 않는다.
배포 스크립트는 Maker나 투자자 대신 서명할 수 없다. 실제 거래 전에 각 참여자 지갑이 배포된 RFQ Adapter에 RWA와 quote token allowance를 승인해야 한다.
각 참여자 keystore를 등록한 후 아래 명령을 해당 계정으로 실행한다.
CORNER_STORE_ARTIFACT=deployments/public/hackathon-testnet-rfq-<chain-id>.json \
forge script script/ApproveTestnetRFQ.s.sol:ApproveTestnetRFQ \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID" \
--account <participant-keystore-name> \
--broadcast최소한 Maker와 정상 거래에 사용할 투자자 A는 승인해야 한다.
CORNER_STORE_ARTIFACT=deployments/public/hackathon-testnet-rfq-<chain-id>.json \
CORNER_STORE_REQUIRE_APPROVALS=true \
forge script script/VerifyTestnetRFQ.s.sol:VerifyTestnetRFQ \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID"검증기는 다음 문제를 발견하면 실패한다.
- artifact와 현재 Chain ID 불일치
- 배포 주소에 코드가 없음
- governance/operator 불일치
- Manifest 또는 RFQ venue 비활성
- Maker 미승인
- 초기 inventory 부족
- 요청한 참여자의 allowance 부족
Maker용 테스트넷 전용 키를 로컬 환경변수로 제공해야 RFQ backend가 firm quote에 서명할 수 있다. 이 키도 실제 자산 지갑과 분리하고 Git에 저장하지 않는다.
export CORNER_STORE_TESTNET_ARTIFACT=deployments/public/hackathon-testnet-rfq-<chain-id>.json
export CORNER_STORE_TESTNET_RPC_URL=<rpc-url>
export CORNER_STORE_TESTNET_EXPLORER_URL=<explorer-url>
export CORNER_STORE_TESTNET_MAKER_KEY=0x...
scripts/run-testnet-rfq-demo.sh출력된 주소를 브라우저에서 열고 artifact에 등록된 투자자 지갑을 연결한다.
이 데모는 기존 로컬 scripts/showcase.sh와 별개다.
scripts/showcase.sh: Anvil에서 결정적으로 실행하는 발표용 시나리오scripts/run-testnet-rfq-demo.sh: 이미 공개 테스트넷에 배포된 artifact를 사용하는 실제 테스트넷 거래 증명
최초 한 번:
cast wallet import corner-store-testnet --interactive
cp .env.testnet.example .env.testnet.env.testnet 작성 후:
set -a
source .env.testnet
set +a
scripts/deploy-testnet-rfq.sh \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID" \
--account corner-store-testnet
scripts/deploy-testnet-rfq.sh \
--rpc-url "$RPC_URL" \
--chain-id "$CHAIN_ID" \
--account corner-store-testnet \
--broadcast현재 위치가 저장소 루트가 아니거나 public-testnet 코드가 없는 이전 브랜치다.
git fetch origin
git worktree add /tmp/corner-store-testnet origin/main
cd /tmp/corner-store-testnet
cp .env.testnet.example .env.testnet잘못된 RPC를 사용하고 있다. 대상 테스트넷의 Chain ID는 공식 문서의 <chain-id>다.
deployer의 테스트 gas token이 부족하다. Faucet에서 추가로 받은 뒤 잔액을 다시 확인한다.
public deployment 기록은 덮어쓰지 않는다. 새로운 ID를 사용한다.
export CORNER_STORE_DEPLOYMENT_ID=hackathon-testnet-rfq-v2deployer 개인키는 .env.testnet에 넣지 않는다.
cast wallet import corner-store-testnet --interactive로 암호화된 Foundry keystore에 한 번 등록하고 배포 시
--account corner-store-testnet만 사용한다.