sui-cli について
sui-cli は、Sui のネットワーク環境、トランザクションの Gas、Epoch を説明するリファレンススキルです。Sui CLI や Move を扱う開発者向けで、docs.sui.io の情報に基づき、ネットワーク選択と Gas 予算の注意点を示します。
主な機能
- 014 種類の Sui 環境を比較
- 02トランザクション Gas の内訳を説明
- 03Epoch と Gas 価格を解説
- 04CLI のネットワークと予算の注意点
活用シーン
- 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 ネットワークとガス
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 には、4 つのネットワーク環境があります。
- Mainnet: 本番ネットワークです。SUI トークンには実際の金銭的価値があります。最終デプロイに使用します。
- Testnet: Mainnet の機能を反映しています。フォーセットから無料の SUI トークンを入手できます。統合テストとステージングに使用します。
- Devnet: 開発用ネットワークです。無料の SUI トークンを利用できます。初期段階の開発や試験に使用します。
- Localnet: マシン上でローカルに実行されます。オフラインでの開発や単体テストに使用します。
ガスコストモデル
Sui のすべてのトランザクションでは、ガスの支払いに SUI トークンが必要です。ガスの合計コストは次のとおりです。
ガスコスト = 計算コスト + ストレージコスト - ストレージリベート
- 計算コスト: トランザクションの実行に必要な計算量に比例します。
- ストレージコスト: オンチェーンで新しいオブジェクトを保存したり、オブジェクトを拡張したりする際のコストです。オブジェクトが占有するバイト数に応じて支払います。
- ストレージリベート: トランザクションによってオブジェクトが削除されたり、サイズが縮小されたりすると、解放されたストレージ分のリベートを受け取ります。これにより、使用されていない状態のクリーンアップが促されます。
ガス予算(--gas-budget)では、支払いに充てる上限額を指定します。トランザクションのコストが予算を超えると、トランザクションは失敗し、ガス予算の一部が請求されます。Testnet と Devnet では、フォーセットから無料のトークンを入手できます(フォーセットの利用方法については、sui-client スキルを参照してください)。ガス価格はエポックごとに変動する場合があります。RPC を通じて現在のガス価格を確認してください。
エポック
エポックとは、バリデーターセットとガス価格が一定に保たれる固定期間です。Mainnet では、1 エポックは約 24 時間です。エポックの境界では、ネットワークがステーキング報酬を処理し、バリデーターを入れ替え、ガス価格を更新します。Move では ctx.epoch() を使って現在のエポック番号を読み取り、ctx.epoch_timestamp_ms() を使ってエポックの開始時刻を読み取ります。
ルール
- CLI からトランザクションを送信する際は、必ず
--gas-budgetを指定してください。 sui client switch --env <ENV>を使用してネットワークを切り替えてください。client.yamlを手動で編集しないでください。
よくある間違い
- ネットワークの切り替えを忘れる。 Testnet のつもりで Mainnet に公開してしまうことがあります。必ず
sui client active-envで確認してください。 - Testnet/Devnet でガスが不足する。 フォーセットを使用して無料のトークンを入手してください(
sui-clientスキルを参照してください)。