04 / 构建阅读需 6 分钟

架构与代码库

仓库包含 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 日 来源与方法