架构与代码库
仓库包含 Solidity 合约、React/Vite dapp 和两个 Node 服务。此 GitBook 独立位于 gitbook/,构建不读取私有配置或协议网络数据。
目录
| 目录 | 职责 |
|---|---|
contracts/src |
代币、hook、库、接口及外围合约 |
contracts/test |
Foundry 场景与不变量测试 |
contracts/audit |
补充验证测试框架与测试活动 |
contracts/scripts |
ABI 导出、检查和部署流程 |
contracts/deployments |
公开版本清单与历史 |
dapp/src/chain |
配置、ABI、读取、报价和交易 |
dapp/src/pages |
Swap、Proof、Keepers、路线图及 V2 模块 |
services/shared |
共享配置、客户端、ABI 及执行追踪 |
services/keeper |
触发无需许可的操作 |
services/floor-bot |
读取事件并准备发布内容 |
audit/reports |
带日期且关联修订的报告与证据 |
gitbook/docs |
本文档的法语源码 |
核心合约
| 组件 | 职责 |
|---|---|
CubitToken |
一次性初始发行 2100 万的 ERC-20,仅 hook 可销毁 |
CubitHook |
税、记账分区、流动性、维护及 V2 连接 |
BandLib |
价格计算、换算和 tick 舍入、价格带几何 |
WallLib |
固定买墙仓位的新链接库,修订仍待验证 |
PoolManager v4 |
池状态、流动性仓位、交换与结算 |
Hook 是 CUBIT 池获准的流动性提供者。资金通过仓位及 PoolManager 的 ERC-6909 claims 追踪,因此 hook 地址原生 ETH 余额不足以衡量储备。
WallLib 操作 hook 存储。链接库不是仓位新所有者;claims 与仓位仍归 hook。部署验证必须包括库字节码与链接。
外围合约
| 组件 | 职责 |
|---|---|
CubitRouter |
exact-input/output 交换、滑点限制、期限、结算及卖出结束销毁 |
CubitLens |
衍生视图、维护状态和买墙簿读取 |
CubitV2 |
稳定模块注册表、修订及首次绑定推荐 |
CubitVault |
CUBIT 存款、锁定与 WETH 奖励 |
CubitForge |
独立子市场精选测试版 |
CubitLaunch |
在原子操作中完成初始存款、初始化及可能的首笔含税买入 |
团队可在注册表替换 Router、Lens、Vault 和 Forge。代币、hook、池标识、奖励 WETH 和注册表锚点不采用此替换机制。
读取路径
前端或 keeper
→ 公开清单:网络、核心、注册表
→ 指定区块的注册表:模块 + 修订
→ 检查模块连接
→ 同一区块的 Lens 与 hook 视图
→ 显示或模拟操作
前端 releases.ts 解析模块,vault.ts 保留旧 Vault 读取。RPC 无响应不能允许签名。
交换路径
前端取得报价后模拟。路由器打开 PoolManager 结算上下文;hook 在交换中征税并隔离吸收代币。路由器结算 delta,完成卖出所需操作。
边界很重要:路由器 callback 仅在预期操作期间允许 PoolManager 访问,付款人来自路由器已认证调用者。
多买墙修订
WallLib 增加永久 ID 买墙簿及 tick 索引。旧 tick 保留,新资金使用当前目标。卖出触及仓位的遍历仍在验证中。
本修订涉及不变量、Lens 计算、前端、ABI、服务和库部署。编译成功不足以宣称所有层都与历史 Sepolia 兼容。版本状态。
来源:仓库所列文件,尤其 WallLib.Book, WallLib.Wall, CubitHook, releases.ts 及服务 README。
CUBIT / 2026 年 9 月 10 日
来源与方法