Kiến trúc và mã nguồn
Kho mã gồm hợp đồng Solidity, dapp React/Vite và hai dịch vụ Node. GitBook này độc lập trong gitbook/: quá trình build không đọc cấu hình riêng tư hay dữ liệu mạng giao thức.
Các thư mục
| Thư mục | Trách nhiệm |
|---|---|
contracts/src |
Token, hook, thư viện, interface và hợp đồng ngoại vi |
contracts/test |
Kiểm thử kịch bản và bất biến Foundry |
contracts/audit |
Bộ khung và chiến dịch kiểm chứng bổ sung |
contracts/scripts |
Xuất ABI, kiểm tra và quy trình triển khai |
contracts/deployments |
Manifest công khai của phiên bản và lịch sử |
dapp/src/chain |
Cấu hình, ABI, đọc, báo giá và giao dịch |
dapp/src/pages |
Swap, Proof, Keepers, lộ trình và mô-đun V2 |
services/shared |
Cấu hình chung, client, ABI và theo dõi thực thi |
services/keeper |
Thực hiện thao tác không cần cấp quyền |
services/floor-bot |
Đọc sự kiện và chuẩn bị bài đăng |
audit/reports |
Báo cáo có ngày và bằng chứng gắn với bản sửa đổi |
gitbook/docs |
Nguồn tiếng Pháp của tài liệu này |
Hợp đồng lõi
| Thành phần | Trách nhiệm |
|---|---|
CubitToken |
ERC-20 phát hành ban đầu một lần 21 triệu; chỉ hook được burn |
CubitHook |
Thuế, ngăn kế toán, thanh khoản, bảo trì và kết nối V2 |
BandLib |
Tính giá, chuyển đổi và làm tròn tick, hình học các dải |
WallLib |
Thư viện liên kết mới cho vị thế tường cố định; bản sửa đổi còn cần xác thực |
PoolManager v4 |
Trạng thái pool, vị thế thanh khoản, swap và quyết toán |
Hook là nhà cung cấp thanh khoản được phép của pool CUBIT. Vốn theo dõi trong vị thế và qua claim ERC-6909 của PoolManager; số dư ETH gốc ở địa chỉ hook không đủ đo dự trữ.
WallLib thao tác trên storage của hook. Thư viện liên kết không trở thành chủ vị thế: claim và vị thế vẫn thuộc hook. Kiểm chứng triển khai phải gồm bytecode thư viện và linking.
Hợp đồng ngoại vi
| Thành phần | Trách nhiệm |
|---|---|
CubitRouter |
Swap exact-input/output, giới hạn slippage, deadline, quyết toán và burn cuối lệnh bán |
CubitLens |
View suy ra, trạng thái bảo trì và đọc sổ tường |
CubitV2 |
Sổ đăng ký mô-đun ổn định, bản sửa đổi và giới thiệu first-bound |
CubitVault |
Gửi CUBIT, khóa và thưởng WETH |
CubitForge |
Beta tuyển chọn thị trường con độc lập |
CubitLaunch |
Gửi ban đầu, khởi tạo và có thể mua đầu tiên chịu thuế trong một thao tác nguyên tử |
Đội ngũ có thể thay Router, Lens, Vault và Forge trong sổ đăng ký. Token, hook, định danh pool, WETH thưởng và neo sổ đăng ký không theo cơ chế thay này.
Đường đi của lần đọc
Frontend hoặc keeper
→ manifest công khai: mạng, lõi, sổ đăng ký
→ sổ đăng ký ở block xác định: mô-đun + bản sửa đổi
→ kiểm tra kết nối các mô-đun
→ Lens và view hook tại cùng block
→ hiển thị hoặc mô phỏng thao tác
Ở frontend, releases.ts phân giải mô-đun, vault.ts giữ khả năng đọc Vault cũ. RPC không trả lời không được cho phép ký.
Đường đi của swap
Frontend lấy báo giá rồi mô phỏng. Router mở ngữ cảnh quyết toán PoolManager; hook tham gia swap để áp thuế và tách token hấp thụ. Router quyết toán delta và hoàn tất thao tác cần cho lệnh bán.
Ranh giới rất quan trọng: chỉ PoolManager được gọi callback router trong thao tác mong đợi; payer đến từ người gọi router đã xác thực.
Bản sửa đổi nhiều tường
WallLib thêm sổ tường theo ID vĩnh viễn và chỉ mục tick. Tick cũ giữ nguyên, vốn mới dùng mục tiêu hiện tại. Việc duyệt vị thế lệnh bán chạm tới đang được xác thực.
Bản sửa đổi tác động bất biến, tính toán Lens, frontend, ABI, dịch vụ và triển khai thư viện. Biên dịch không đủ tuyên bố mọi lớp tương thích với Sepolia lịch sử. Tình trạng phiên bản.
Nguồn: các tệp trong kho được nêu, nhất là WallLib.Book, WallLib.Wall, CubitHook, releases.ts và README dịch vụ.