ton-create-wallet について
ton-create-walletは、TON上にオンチェーンのエージェントウォレットをデプロイするスキルです。オペレーターキー生成、ダッシュボードでの承認、コールバックまたはアドレスによるセットアップ完了を案内します。
主な機能
- 01オペレーターキーとセットアップ草案の生成
- 02デプロイ用ダッシュボードURLの提示
- 03保留中のウォレット設定の追跡
- 04セットアップの完了またはキャンセル
- 05コールバックまたはアドレスでの完了
活用シーン
- 01TON上で新しいエージェントウォレットをデプロイ
- 02保留中のウォレットデプロイを追跡
- 03ダッシュボード承認後にセットアップを完了
- 04ワンショットCLI利用でウォレットアドレスを使って設定を完了
MCP 対応
MCPツールを使って、エージェントウォレットの設定を開始、確認、完了、キャンセルします。長時間稼働するstdioまたはHTTPのMCPセッションでは、コールバックによる完了が可能です。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ton-org/ skills --skill ton-create-walletインストール後、Claude Code で/ton-create-walletを入力して読み込まれたか確認します。
詳細
TON エージェント型ウォレットの作成
TON 上にオンチェーンのエージェント型ウォレットをデプロイします。エージェントがオペレーターキーを生成し、ローカルのブラウザー/シェルツールが利用できる場合はダッシュボードを開きます。コールバック方式の完了処理は、長時間稼働する stdio/HTTP MCP サーバーのセッションでのみ使用します。
MCP ツール
| ツール | 説明 |
|---|---|
agentic_start_root_wallet_setup | オペレーターキーを生成し、保留中のセットアップを作成して、ダッシュボード URL を返します |
agentic_list_pending_root_wallet_setups | 保留中のセットアップ下書きとコールバックの状態を一覧表示します |
agentic_get_root_wallet_setup | setupId で指定した保留中のセットアップを読み取ります |
agentic_complete_root_wallet_setup | コールバックまたは手動のウォレットアドレス指定でオンボーディングを完了します |
agentic_cancel_root_wallet_setup | 保留中のセットアップをキャンセルします |
ツールのパラメーター
| ツール | 必須 | 任意 |
|---|---|---|
agentic_start_root_wallet_setup | — | network、name、source、collectionAddress、tonDeposit |
agentic_get_root_wallet_setup | setupId | — |
agentic_complete_root_wallet_setup | setupId | walletAddress、ownerAddress |
agentic_cancel_root_wallet_setup | setupId | — |
ワークフロー
agentic_start_root_wallet_setupを呼び出します。これによりオペレーターキーペアが生成され、setupId、dashboardUrl、callbackUrlが返されます- 環境でローカルのブラウザーまたはシェルツールが利用できる場合は、プラットフォームのオープナー(
open、xdg-open、start)またはブラウザー自動化を使って、自分でdashboardUrlを開きます。自動で開けない場合、または開くのに失敗した場合に限り、ユーザーにリンクを貼り付けます - ユーザーには、メインの TON ウォレットからウォレットのデプロイを承認するよう伝えるだけにします。URL の再入力や途中のデータのコピーは求めないでください
- 長時間稼働する stdio/HTTP MCP サーバーのセッションでは、コールバックフローが利用可能な場合、
agentic_get_root_wallet_setupまたはagentic_list_pending_root_wallet_setupsをポーリングして、status: "callback_received"になるまで待ってから、setupIdを指定してagentic_complete_root_wallet_setupを呼び出します。 - 生のワンショット CLI では、コールバックのポーリングを省略します。ユーザーがウォレットをデプロイした後に
walletAddressを尋ね、そのwalletAddressを指定してagentic_complete_root_wallet_setupを呼び出します get_current_walletまたはlist_walletsを使ってウォレットが有効であることを確認します(ton-manage-walletsスキルを参照)
仕組み
- エージェントはオペレーター秘密鍵を保持し、自律的にトランザクションへ署名できます
- ユーザーはオーナーキーを保持し、いつでも資金を引き出したり、アクセスを取り消したりできます
- ウォレットはカストディアルサービスではなく、オンチェーンのスマートコントラクト(NFT ベース)です
- ダッシュボードは
agents.ton.orgにあります
環境変数
| 変数 | 説明 |
|---|---|
NETWORK | mainnet(デフォルト)または testnet |
AGENTIC_CALLBACK_BASE_URL | オンボーディングコールバックの公開 URL(HTTP モードでは自動設定) |
AGENTIC_CALLBACK_PORT | コールバックサーバーのポート |
注意事項
- コールバックを使った完了処理は、長時間稼働する stdio/HTTP MCP サーバーのセッション向けです。生の CLI では、手動で
walletAddressを指定して完了してください - 現在の環境でダッシュボードを自動的に開ける場合は、ユーザーに手動で URL を開くよう求めず、自動で開いてください
- 生の CLI モードでは、コールバックサーバーがフローを完了できるほど長く稼働しないため、デプロイ後にウォレットアドレスを尋ねてください
- ウォレットの作成後、送金またはスワップのスキルを使用する前に、ウォレットへ TON を入金してください
コメント
Markdown 対応