cetus

核心用法

本 Skill 提供了 Cetus Protocol 在 Sui 区块链上的全套 SDK v2 开发文档，涵盖 11 个核心模块的详细 API 参考。主要模块包括：CLMM SDK（集中流动性做市商）、DLMM SDK（动态流动性离散做市商）、Vaults SDK（自动化金库管理）、Farms SDK（流动性挖矿）、xCETUS SDK（治理代币管理）、Limit Order SDK（限价单）、Burn SDK（永久锁仓）、DCA SDK（定投策略）、Zap SDK（一键流动性操作）以及 Aggregator SDK（多 DEX 聚合器）。每个模块均提供初始化配置、核心功能调用示例（如添加/移除流动性、兑换、质押等）以及参数说明，开发者可通过 npm install @cetusprotocol/* 安装对应包后，参照文档快速集成。

显著优点

1. 模块化架构清晰：11 个 SDK 独立分包，按需引入，避免依赖臃肿，Common SDK 提供底层共享能力。
2. 覆盖完整 DeFi 场景：从基础 AMM 交易、集中流动性管理到高级策略（DCA、限价单、永久锁仓），满足从入门到专业的全链路开发需求。
3. 代码示例详尽：提供 TypeScript 初始化模板、交易构造示例（如 addLiquidityPayload、swapPayload）及错误码对照表，大幅降低集成门槛。
4. 多环境支持：明确区分 mainnet/testnet，支持自定义 RPC 和 SuiClient 注入，便于测试和私有化部署。

潜在缺点与局限性

1. 来源非官方：内容由个人开发者整理（GitHub: k66inthesky），非 Cetus Protocol 官方维护，可能存在与最新版本 SDK 的同步延迟。
2. 纯文档性质：仅提供 API 参考和代码示例，不含实际可执行代码或 SDK 源码，开发者需自行安装官方 npm 包并处理版本兼容问题。
3. 缺乏实时验证：文档中的合约地址和包名需用户自行核对，若官方 SDK 更新接口或迁移合约，文档可能滞后。
4. 安全责任自负：涉及资产操作的代码（如质押、兑换）需开发者在测试网充分验证，文档本身不提供安全审计保证。

适合的目标群体

• Sui 生态开发者：构建基于 Sui 的 DeFi 应用、钱包或资产管理工具的前端/后端工程师。
• 量化策略团队：需要集成 CLMM/DLMM 流动性管理、DCA 定投或限价单功能的策略开发者。
• DeFi 产品经理：调研 Cetus Protocol 功能边界和技术可行性的产品人员。
• 区块链学习者：研究 Move 语言生态和 Sui 链上金融协议实现的开发者。

使用风险

1. 依赖项风险：实际使用时需安装 @cetusprotocol/* 系列 npm 包，若官方包存在漏洞或恶意代码，本 Skill 无法拦截，建议锁定版本并审计依赖。
2. 资产操作风险：文档示例涉及真实资产转移（如 redeemPayload、burn 等不可逆操作），直接复制到生产环境可能导致资金损失，务必在测试网验证。
3. 网络配置风险：自定义 RPC 配置不当可能导致交易广播失败或连接到恶意节点，建议使用官方推荐的公共节点或自建全节点。
4. 版本兼容性：Cetus Protocol 智能合约升级可能导致 SDK 接口变更，需持续关注官方 GitHub 更新，避免使用过时的 API 构造交易。