1. 아키텍처 개요
자세한 흐름은 SuperEarn 동작 방식과 핵심 컴포넌트를 참고하세요.2. 배포 주소
Kaia
Ethereum
프로덕션에서는 주소를 상수로 다루되, 업그레이드 대비 설정 가능하게 유지하세요.
3. 핵심 인터페이스
여기에 통합 시 주로 쓰는 부분만 요약합니다. 전체 ABI는 배포된 JSON 아티팩트(ISuperEarnRouter, ICooldownVault, IVault 등)와 OpenZeppelin 표준 ABI를 참고하세요.3.1 ISuperEarnRouter (SuperEarnRouter)
역할단일 엔트리포인트로 예치/리딤 전체 플로우를 처리합니다. 모든 사용자/통합 쓰기는 라우터를 거쳐야 하며 CooldownVault는 직접 호출 불가(클레임은 퍼미션리스지만 보통 키퍼가 실행). 주요 이벤트
amount: USDT (6 decimals)minSharesOut: 최소 수령 지분(슬리피지 보호)receiver: 지분 수령 주소(옵션)
previewRedeem: 현재 지분 가격 기준 예상 언더라이잉(쿨다운 이후).redeem: SuperVault 지분을 소각하고 CooldownVault 리딤 요청 생성 →requestId반환/이벤트.
InsufficientShares, InsufficientAssets, InvalidReceiver, InvalidPrice, Unauthorized
3.2 ICooldownVault
역할입·출금 큐, 쿨다운, 손실 한도 관리. 사용자 직접 호출은 불가하며, 라우터/키퍼가 호출. 주요 이벤트
OnlyGovernance, OnlyManagers, OnlyStrategy, OnlyKeepers, InvalidReceiver, RequestAlreadyClaimed, HealthCheckFailed, CooldownPeriodTooLong.
3.3 IVault (Super Vault / Remote Vault)
역할
CooldownVault 지분을 래핑하는 Super Vault입니다. EarnUSDT shares의 기초입니다.
주요 조회
3.4 Runespear 메시징/어댑터 주요 컨트랙트 (참고)
- OriginAdapter / Remote Adapter — CCIP + 브릿지 호출, 자산/메시지 정합 처리
- OriginAgent / Remote Agent — 메시지 라우팅, 상태 스냅샷 전달
- BridgeAccountant — 이동 중 자산 추적, 이중 계산 방지
- StateSnapshot — 각 메시지에 포함되는 볼트/브릿지 상태
4. 통합 메모
- 예치/출금은 라우터 경유:
SuperEarnRouter외 직접 CooldownVault 입·출금 불가. - 지분 가격 모델: EarnUSDT는 리베이스하지 않으므로
pricePerShare기반으로 가치 계산. - 쿨다운/유동성 고려: 리딤은 요청 → (쿨다운) → 클레임 순서이지만, 실제 클레임은 유동성 기반입니다. 유동성이 충분하면 쿨다운 만료 전에도 청구되고, 유동성이 없으면 만료 후에도 대기합니다. cooldown은 정상 상환 소요 시간의 상한으로 보세요.
previewClaim의isClaimable은 시간 기반 만료만,maxAssetsOut은 현재 유동성을 반영하므로, 실제 청구 가능 여부는claim시뮬레이션으로 확인하세요. 보통은 keeper가 대신 claim합니다. - 슬리피지 보호:
minSharesOut,minAssetsOut을 꼭 지정하세요. - 크로스체인 회계: 이동 중 자산은 보수적으로 처리되어 일시적으로 값이 낮게 보일 수 있습니다.