关于 sui-cli
sui-cli 是介绍 Sui 网络环境、交易 Gas 和 Epoch 的参考技能,面向使用 Sui CLI 与 Move 的开发者。内容仅依据 docs.sui.io,并强调网络选择与 Gas 预算注意事项。
主要功能
- 01对比四种 Sui 网络环境
- 02说明交易 Gas 组成
- 03介绍 Epoch 与 Gas 价格
- 04列出 CLI 网络和预算注意事项
适用场景
- 01选择测试或部署所用环境
- 02了解交易 Gas 成本因素
- 03提交前检查网络与 Gas 设置
MCP 相关
该技能建议通过 Sui 文档 MCP 服务(https://sui.mcp.kapa.ai)查询最新信息并进行验证。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mystenlabs/ skills --skill sui-cli安装后在 Claude Code 中输入/sui-cli确认已加载。
附带文件evals/evals.json
详细介绍
Sui 网络与 Gas
**MCP 工具:**如果你的环境支持,也请查询 Sui 文档 MCP 服务(
https://sui.mcp.kapa.ai),获取最新答案。可用它进行验证,并查询这些参考文件未涵盖的详细信息。
**来源限制:**本技能中的所有信息均仅来源于 docs.sui.io。扩展或更新本技能时,只能从该来源获取信息。请勿使用第三方博客、教程或非官方文档。
相关技能
| 主题 | 技能 |
|---|---|
| CLI 客户端配置、地址、水龙头、浏览器 | sui-client/ |
| 安装 Sui CLI(suiup) | sui-install/ |
| Move 项目设置与 Move.toml | sui-move-project/ |
| 发布和升级包 | sui-publish/ |
Sui 网络
Sui 提供四种网络环境:
- **Mainnet:**生产网络。SUI 代币具有真实货币价值。用于最终部署。
- **Testnet:**功能与 Mainnet 相似。可通过水龙头获取免费 SUI 代币。用于集成测试和预发布。
- **Devnet:**开发网络。可获取免费 SUI 代币。用于早期开发和试验。
- **Localnet:**在你的计算机上本地运行。用于离线开发和单元测试。
Gas 费用模型
Sui 上的每笔交易都需要使用 SUI 代币支付 Gas。Gas 总费用为:
Gas 费用 = 计算费用 + 存储费用 - 存储返还
- **计算费用:**与执行交易所需的计算量成正比。
- **存储费用:**在链上存储新对象或扩展对象的费用。你需要为对象占用的字节付费。
- **存储返还:**交易删除对象或缩小其尺寸时,你会获得释放存储空间的返还。这会鼓励清理未使用的状态。
Gas 预算(--gas-budget)用于设置你愿意支付的最高金额。如果交易费用超出预算,交易会失败,但仍会扣除部分 Gas 预算。在 Testnet 和 Devnet 上,可通过水龙头获取免费代币(获取方式请参阅 sui-client 技能)。Gas 价格可能会随 epoch 变化;可通过 RPC 查询当前 Gas 价格。
Epoch
Epoch 是验证者集合和 Gas 价格保持不变的固定时间段。Mainnet 上的一个 epoch 大约为 24 小时。在 epoch 边界,网络会处理质押奖励、轮换验证者并更新 Gas 价格。在 Move 中,使用 ctx.epoch() 读取当前 epoch 编号,使用 ctx.epoch_timestamp_ms() 读取 epoch 开始时间。
规则
- 通过 CLI 提交交易时,务必指定
--gas-budget。 - 使用
sui client switch --env <ENV>切换网络。不要手动编辑client.yaml。
常见错误
- **忘记切换网络。**本想发布到 Testnet,却发布到了 Mainnet。请务必使用
sui client active-env确认当前网络。 - **Testnet/Devnet 上 Gas 不足。**使用水龙头获取免费代币(请参阅
sui-client技能)。