Skip to content

setup-and-test.md

Latest commit

 

History

History
213 lines (157 loc) · 7.72 KB

setup-and-test.md

File metadata and controls

213 lines (157 loc) · 7.72 KB

개발 환경 설치 및 테스트 가이드

1) 툴체인 설치

Solana 공식 Quick Installation으로 Rust, Solana CLI, Anchor CLI를 한 번에 설치합니다.

curl --proto '=https' --tlsv1.2 -sSfL https://solana-install.solana.workers.dev | bash

설치 후 버전 확인:

rustc --version        # 1.84.1 (BPF toolchain)
solana --version       # 2.3.13
anchor --version       # 0.31.x
node --version         # 18 이상
yarn --version

Quick Installation이 실패하면 Solana 문서의 Install Dependencies 섹션에서 개별 설치를 진행하세요.

2) 단위 테스트

Rust 단위 테스트

# contract/programs/open_parametric/ 에서
cargo test

특정 테스트만 실행:

cargo test settle_flight_claim_test
cargo test settle_flight_no_claim_test
cargo test activate_master_test

Anchor/TypeScript 통합 테스트

contract/ 디렉토리에서 실행합니다.

# 전체 테스트 (로컬 validator 포함 자동 시작)
anchor test

# 특정 파일만
yarn ts-mocha -p ./tsconfig.json -t 1000000 tests/settle_flight_claim.ts

현재 테스트 파일 (26개 통과):

파일 테스트 수 커버 범위
tests/settle_flight_claim.ts 1 Master/Flight 기본 E2E — Claim 경로
tests/settle_flight_no_claim.ts 4 NoClaim E2E, ceded=0/50%, 119분 경계
tests/payout_tiers.ts 6 4단계 지급 티어 (2H/3H/4-5H/6H) + cancelled 오버라이드
tests/multiple_flights.ts 5 단일 Master 하에 다수 Flight 독립 정산
tests/error_cases.ts 10 인가·상태·중복 정산 등 에러 경로 전반
tests/open_parametric.ts 1 기본 smoke test

Track B(Switchboard) 통합 테스트: QuoteVerifier가 실제 온체인 Switchboard 환경을 요구하므로 localnet에서는 불가합니다. devnet에서 05b-claim 스크립트로 수동 검증합니다.

3) 데모 스크립트

모든 스크립트는 contract/ 디렉토리에서 yarn demo:<N>-<이름> 형태로 실행합니다.

스크립트 목록 및 실행 순서

번호 명령어 파일 설명
1 demo:1-setup 01-setup.ts 리더 키페어 + SPL 민트 생성, .state.json 초기화
2 demo:2-feed-create 02-feed-create.ts Track B 전용 — Switchboard Pull Feed 생성 (1회)
3 demo:3-master-setup 03-master-setup.ts MasterPolicy 생성·활성화 + 토큰 계정 셋업
4 demo:4-flight-create 04-flight-create.ts FlightPolicy 발행 (프리미엄 이체)
5a demo:5a-resolve 05a-resolve.ts Track A — AviationStack API → resolve_flight_delay
5b demo:5b-claim 05b-claim.ts Track B — Switchboard oracle → check_oracle_and_resolve_flight
6 demo:6-settle 06-settle.ts 상태에 따라 settle_flight_claim 또는 settle_flight_no_claim 실행

스크립트 간 상태는 scripts/.state.json 파일로 공유됩니다.

Track A 전체 실행 순서 (AviationStack Trusted Resolver)

cd contract

# 1. 초기 셋업 (리더 키페어·민트 생성, 최초 1회)
yarn demo:1-setup

# 2. MasterPolicy 생성 및 활성화
#    oracle_feed = PublicKey.default (Track A 전용)
#    이미 MASTER_ID=1 계정이 있으면: MASTER_ID=2 yarn demo:3-master-setup
yarn demo:3-master-setup

# 3. FlightPolicy 발행
FLIGHT_NO=KE017 yarn demo:4-flight-create

# 4. AviationStack API로 지연 데이터 조회 → 온체인 반영
AVIATIONSTACK_API_KEY=<키> FLIGHT_NO=KE017 yarn demo:5a-resolve

# 5. 정산
yarn demo:6-settle

Track B 전체 실행 순서 (Switchboard On-Demand)

cd contract

# 1. 초기 셋업 (최초 1회)
yarn demo:1-setup

# 2. Switchboard Pull Feed 생성 (1회, devnet)
#    생성된 feedPubkey가 .state.json에 저장됨
AVIATIONSTACK_API_KEY=<키> FLIGHT_NO=KE017 yarn demo:2-feed-create

# 3. MasterPolicy 생성 및 활성화
#    oracle_feed = state.json의 feedPubkey (자동으로 읽어 등록)
#    이미 MASTER_ID=1 계정이 있으면: MASTER_ID=2 yarn demo:3-master-setup
yarn demo:3-master-setup

# 4. FlightPolicy 발행
FLIGHT_NO=KE017 yarn demo:4-flight-create

# 5. Switchboard oracle → check_oracle_and_resolve_flight
#    1~2분 대기 후 실행 (oracle 노드 처리 시간)
yarn demo:5b-claim

# 6. 정산
yarn demo:6-settle

주요 환경변수

변수 대상 스크립트 설명
ANCHOR_PROVIDER_URL 2–6 RPC 엔드포인트 (기본: http://localhost:8899)
MASTER_ID 3-master-setup MasterPolicy ID (기본: 1). ID=1 계정이 이미 존재하면 MASTER_ID=2 등으로 증가
AVIATIONSTACK_API_KEY 2-feed-create, 5a-resolve AviationStack API 키
FLIGHT_NO 2-feed-create, 4-flight-create, 5a-resolve 항공편 코드 (기본: KE017)
FLIGHT_DATE 5a-resolve 날짜 YYYY-MM-DD (기본: FlightPolicy의 departure_ts)
CHILD_POLICY_ID 5a-resolve, 5b-claim, 6-settle 처리할 FlightPolicy ID (기본: 마지막 항목)
PROGRAM_ID 전체 프로그램 ID override (기본: IDL의 address 필드에서 자동 로드)

고정 키페어 파일

스크립트는 아래 경로의 고정 키페어 파일을 사용합니다. 최초 1회 생성 후 재사용됩니다.

역할 경로
Leader (운영자) ~/.config/solana/riskmesh-leader.json
Participant A ~/.config/solana/riskmesh-participant-a.json
Participant B ~/.config/solana/riskmesh-participant-b.json
Reinsurer ~/.config/solana/riskmesh-reinsurer.json

파일이 없으면 아래 명령으로 생성합니다:

solana-keygen new --outfile ~/.config/solana/riskmesh-leader.json --no-passphrase
solana-keygen new --outfile ~/.config/solana/riskmesh-participant-a.json --no-passphrase
solana-keygen new --outfile ~/.config/solana/riskmesh-participant-b.json --no-passphrase
solana-keygen new --outfile ~/.config/solana/riskmesh-reinsurer.json --no-passphrase

참여사 배분 (shareBps): Leader 50% / Participant A 30% / Participant B 20%

.state.json 구조

스크립트들이 순서대로 실행되면서 .state.json에 데이터를 채워나갑니다.

{
  "mint": "...",                         // 1-setup이 생성
  "leaderKey": [...],                    // 1-setup이 생성
  "feedPubkey": "...",                   // 2-feed-create가 저장 (Track B만) — 온체인 PullFeed 주소
  "feedCid": "bafkrei...",              // 2-feed-create가 저장 (Track B만) — IPFS CID
  "feedHash": "0xabc123...",            // 2-feed-create가 저장 (Track B만) — feedId (sha256 of OracleFeed)
  "masterId": 1,                         // 3-master-setup이 저장
  "masterPda": "...",                    // 3-master-setup이 저장
  "leaderAta": "...",                    // 3-master-setup이 저장 (Leader ATA)
  "leaderDepositWallet": "...",          // 3-master-setup이 저장 (PDA 소유)
  "reinsurerPoolWallet": "...",          // 3-master-setup이 저장 (PDA 소유)
  "reinsurerDepositWallet": "...",       // 3-master-setup이 저장 (PDA 소유)
  "leaderPoolWallet": "...",             // 3-master-setup이 저장 (PDA 소유, 3 USDC 적립)
  "participantAPoolWallet": "...",       // 3-master-setup이 저장 (PDA 소유, 1.8 USDC 적립)
  "participantADepositWallet": "...",    // 3-master-setup이 저장 (Participant A ATA)
  "participantBPoolWallet": "...",       // 3-master-setup이 저장 (PDA 소유, 1.2 USDC 적립)
  "participantBDepositWallet": "...",    // 3-master-setup이 저장 (Participant B ATA)
  "flightPolicies": [                    // 4-flight-create가 추가
    {
      "childId": 1,
      "pda": "...",
      "flightNo": "KE017",
      "departureTs": 1234567890
    }
  ]
}