mcpField
S
sui-client

sui-client

github.com/mystenlabs開発19356 回インストール今日更新
リポジトリ

sui-client について

Sui 開発者向けのクライアント設定ガイドです。環境、アドレス、鍵、トークン、トランザクションの操作に加え、復旧やトラブル対応も扱います。

主な機能

  1. 01クライアント環境とアドレスの設定
  2. 02アドレスの作成と復旧
  3. 03残高と Gas コインの確認
  4. 04開発ネットワーク用 SUI の取得
  5. 05プログラマブルトランザクションでのコイン統合

活用シーン

  1. 01Sui CLI クライアントの初回設定
  2. 02設定済み Sui ネットワークの切り替え
  3. 03リカバリーフレーズからのアドレス復旧
  4. 04Gas 用コインオブジェクトの整理

MCP 対応

利用可能な環境では、Sui ドキュメント MCP サーバー https://sui.mcp.kapa.ai を参照し、ガイドの検証や資料にない情報の確認を行います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mystenlabs/skills --skill sui-client

インストール後、Claude Code で/sui-clientを入力して読み込まれたか確認します。

同梱ファイルevals/evals.json

詳細

クライアント設定とトークン

MCP ツール： お使いの環境で利用可能な場合は、最新の回答を得るために Sui ドキュメント MCP サーバー（https://sui.mcp.kapa.ai）にも問い合わせてください。検証や、これらの参照ファイルに記載されていない詳細の確認に利用してください。

情報源の制約： 情報源は docs.sui.io のみに限定してください。

Sui クライアントの設定

初回セットアップ

初めて sui client を実行すると、設定ファイルの作成を求められます。デフォルトを受け入れてください（Enter キーを押すか、Y を入力します）。sui client -y を使うと、この確認を省略できます。

次のものが生成されます。

  • 新しい鍵ペアとアドレス
  • 12 単語のリカバリーフレーズ（一度だけ表示され、保存されません。すぐに書き留めてください）
  • client.yaml 設定ファイル
設定ファイル

Sui は次の場所に設定を保存します。

  • macOS/Linux： ~/.sui/sui_config/client.yaml
  • Windows： %USERPROFILE%\.sui\sui_config\client.yaml

ファイルには次の内容が含まれます。

  • ネットワーク環境への接続情報（Mainnet、Testnet、Devnet、Localnet）
  • アクティブな環境（デフォルト：Testnet）
  • アクティブなアドレス
  • キーストアのファイルパス
環境とアドレスの管理
コマンド用途
sui client active-env現在のネットワークを表示します
sui client active-address現在のアドレスを表示します
sui client envs設定済みの環境をすべて一覧表示します
sui client switch --env devnet別のネットワークに切り替えます
sui client switch --address <ADDRESS>別のアドレスに切り替えます
sui client new-address ed25519新しいアドレスを作成します
sui client addressesエイリアス付きでローカルのアドレスをすべて一覧表示します
sui client balanceSUI トークンの残高を確認します
sui client gasガスコインのオブジェクトを一覧表示します
鍵の保存

秘密鍵は別のファイルに保存されます。

  • macOS/Linux： ~/.sui/sui_config/sui.keystore
  • Windows： %USERPROFILE%\.sui\sui_config\sui.keystore

このファイルには、Base64 でエンコードされた秘密鍵が含まれます。お使いのマシンのシステムキーストアとは異なります。

復元

リカバリーフレーズからアドレスを復元するには：

sui keytool import '<12-WORD-PHRASE>' ed25519

フレーズ全体を一重引用符で囲み、正しい順序で入力する必要があります。

SUI トークンの入手

Testnet と Devnet での開発には、ガス代として SUI トークンが必要です。これらのネットワーク上のトークンは無料で、金銭的価値はありません。

Faucet の利用方法
方法手順
Web faucetfaucet.sui.io にアクセスし、アドレスを入力してネットワークを選択し、「Request SUI」をクリックします
CLI（Devnet/Localnet のみ）sui client faucet — Devnet と Localnet でのみ動作し、Testnet では動作しません
TypeScript SDK@mysten/sui/faucet の requestSuiFromFaucetV2()
DiscordSui Discord に参加し、#devnet-faucet または #testnet-faucet で !faucet <ADDRESS> を使用します
コミュニティの FaucetN1Stake faucet、SuiLearn faucet（レート制限はそれぞれ別です）

重要：sui client faucet は Devnet と Localnet でのみ動作します。Testnet では動作しません。Testnet トークンを入手するには、faucet.sui.io の Web faucet、または上記の別の方法を使用してください。Testnet で sui client faucet を提案しないでください。

Faucet にはレート制限があります。制限に達した場合は、しばらく待つか、別の Faucet を試してください。

コインの管理

小さな SUI コインオブジェクトを多数持っていて、ガス代に十分な大きさのコインが一つもない場合は、sui client ptb を使って統合します。

# Merge one coin into another
sui client ptb \
  --merge-coins @0xPRIMARY_COIN_ID "[@0xCOIN_TO_MERGE_ID]"

# Merge multiple coins at once
sui client ptb \
  --merge-coins @0xPRIMARY_COIN_ID "[@0xCOIN_A, @0xCOIN_B, @0xCOIN_C]"

CLI からトランザクション操作を行う場合は、すべて sui client ptb を使用してください。sui client merge-coin のようなレガシーのヘルパーは、合成しにくく、非推奨になる可能性があるため、使用を避けてください。その他のパターンについては、ptbs スキルの cli.md を参照してください。

残高の確認
sui client balance

または、エクスプローラーの SuiVision（suivision.xyz）や Suiscan（suiscan.xyz）を使用してください。

エクスプローラーとデータツール

SuiVision（suivision.xyz）や Suiscan（suiscan.xyz）を使って、トランザクション、オブジェクト、アドレス、トークン残高を確認できます。Sui は、ネットワークごとに詳細なデータクエリを実行できる GraphQL RPC を提供しています。デバッグのために、sui replay（CLI 組み込み機能）を使って過去のトランザクションをローカルで再実行できます。

ルール

  • 一貫性を保つため、書き込みと読み取りは同じ fullnode に送信してください。
  • ガス予算、ガス価格、コイン選択はウォレットに管理させてください。フロントエンドにガス予算をハードコードしないでください。
  • レガシーの単機能コマンド（merge-coin、split-coin、transfer など）ではなく、すべての CLI トランザクション操作に sui client ptb を使用してください。

コメント

Markdown 対応