아키텍처와 코드베이스
저장소에는 Solidity 컨트랙트, React/Vite dapp, Node 서비스 두 개가 있습니다. GitBook은 gitbook/에 독립적이며 빌드에서 비공개 설정이나 프로토콜 네트워크 데이터를 읽지 않습니다.
디렉터리
| 디렉터리 | 역할 |
|---|---|
contracts/src |
토큰, hook, 라이브러리, 인터페이스, 주변 컨트랙트 |
contracts/test |
Foundry 시나리오·불변조건 테스트 |
contracts/audit |
추가 검증 하네스·캠페인 |
contracts/scripts |
ABI 내보내기, 검사, 배포 절차 |
contracts/deployments |
공개 버전 manifest·이력 |
dapp/src/chain |
설정, ABI, 읽기, 견적, 거래 |
dapp/src/pages |
Swap, Proof, Keepers, 로드맵, V2 모듈 |
services/shared |
공유 설정, 클라이언트, ABI, 실행 추적 |
services/keeper |
무허가 작업 실행 |
services/floor-bot |
이벤트 읽기·게시 준비 |
audit/reports |
날짜·개정별 보고서와 증거 |
gitbook/docs |
이 문서의 프랑스어 원본 |
핵심 컨트랙트
| 구성요소 | 역할 |
|---|---|
CubitToken |
초기 2,100만 일회 발행 ERC-20, hook만 소각 가능 |
CubitHook |
세금, 회계 구획, 유동성, 유지보수, V2 연결 |
BandLib |
가격 계산, 변환·tick 반올림, 밴드 형상 |
WallLib |
고정 매수벽 포지션용 새 링크 라이브러리, 개정 검증 필요 |
PoolManager v4 |
풀 상태, 유동성 포지션, 스왑, 정산 |
hook은 CUBIT 풀의 허가된 유동성 공급자입니다. 자금은 포지션과 PoolManager ERC-6909 claims로 추적하므로 hook 주소 네이티브 ETH 잔액만으로 준비금을 측정할 수 없습니다.
WallLib는 hook 저장소에서 동작합니다. 링크 라이브러리가 새 포지션 소유자가 되는 것은 아니며 claims와 포지션은 hook에 남습니다. 라이브러리 bytecode와 linking도 배포 검증에 포함해야 합니다.
주변 컨트랙트
| 구성요소 | 역할 |
|---|---|
CubitRouter |
exact-input/output 스왑, 슬리피지 한도, 기한, 정산, 매도 종료 소각 |
CubitLens |
파생 뷰, 유지보수 상태, 장부 읽기 |
CubitV2 |
안정된 모듈 레지스트리, 개정, first-bound 추천 |
CubitVault |
CUBIT 예치, 잠금, WETH 보상 |
CubitForge |
격리된 자식 시장 선별 베타 |
CubitLaunch |
원자적 작업으로 초기 예치·초기화·가능한 첫 과세 매수 |
팀은 레지스트리에서 Router, Lens, Vault, Forge를 교체합니다. 토큰, hook, 풀 식별자, 보상 WETH, 레지스트리 앵커는 이 교체 방식에 해당하지 않습니다.
읽기 경로
프런트엔드 또는 keeper
→ 공개 manifest: 네트워크, 핵심, 레지스트리
→ 특정 블록의 레지스트리: 모듈 + 개정
→ 모듈 연결 검사
→ 같은 블록의 Lens와 hook 뷰
→ 작업 표시 또는 시뮬레이션
프런트엔드 releases.ts가 모듈을 확인하고 vault.ts가 이전 Vault 읽기를 유지합니다. RPC 무응답은 서명을 허용하는 근거가 아닙니다.
스왑 경로
프런트엔드는 견적 후 시뮬레이션합니다. 라우터가 PoolManager 정산 맥락을 열고 hook이 스왑에서 세금과 흡수 토큰 분리를 처리합니다. 라우터는 delta를 정산하고 매도 필수 작업을 마칩니다.
경계가 중요합니다. 라우터 callback은 예상 작업 동안 PoolManager만 접근하며 payer는 라우터의 인증된 caller에서 나옵니다.
다중 매수벽 개정
WallLib는 영구 ID 매수벽 장부와 tick 색인을 추가합니다. 기존 tick은 유지하고 새 자금은 현재 목표를 씁니다. 매도가 닿는 포지션 순회는 검증 중입니다.
이 개정은 불변조건, Lens 계산, 프런트엔드, ABI, 서비스, 라이브러리 배포에 영향을 줍니다. 컴파일만으로 모두 과거 Sepolia와 호환된다고 할 수 없습니다. 버전 상태.
출처: 명시된 저장소 파일, 특히 WallLib.Book, WallLib.Wall, CubitHook, releases.ts 및 서비스 README.