mcpField
S
sui-cli

sui-cli

github.com/mystenlabs开发19216 次安装今天更新
代码仓库

关于 sui-cli

sui-cli 是介绍 Sui 网络环境、交易 Gas 和 Epoch 的参考技能,面向使用 Sui CLI 与 Move 的开发者。内容仅依据 docs.sui.io,并强调网络选择与 Gas 预算注意事项。

主要功能

  1. 01对比四种 Sui 网络环境
  2. 02说明交易 Gas 组成
  3. 03介绍 Epoch 与 Gas 价格
  4. 04列出 CLI 网络和预算注意事项

适用场景

  1. 01选择测试或部署所用环境
  2. 02了解交易 Gas 成本因素
  3. 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.tomlsui-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 技能)。

评论

支持 Markdown