mcpField
T
ton-create-wallet

ton-create-wallet

github.com/ton-orgその他10113 回インストール25 週間前に更新
リポジトリ

ton-create-wallet について

ton-create-walletは、TON上にオンチェーンのエージェントウォレットをデプロイするスキルです。オペレーターキー生成、ダッシュボードでの承認、コールバックまたはアドレスによるセットアップ完了を案内します。

主な機能

  1. 01オペレーターキーとセットアップ草案の生成
  2. 02デプロイ用ダッシュボードURLの提示
  3. 03保留中のウォレット設定の追跡
  4. 04セットアップの完了またはキャンセル
  5. 05コールバックまたはアドレスでの完了

活用シーン

  1. 01TON上で新しいエージェントウォレットをデプロイ
  2. 02保留中のウォレットデプロイを追跡
  3. 03ダッシュボード承認後にセットアップを完了
  4. 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_setupsetupId で指定した保留中のセットアップを読み取ります
agentic_complete_root_wallet_setupコールバックまたは手動のウォレットアドレス指定でオンボーディングを完了します
agentic_cancel_root_wallet_setup保留中のセットアップをキャンセルします
ツールのパラメーター
ツール必須任意
agentic_start_root_wallet_setup—network、name、source、collectionAddress、tonDeposit
agentic_get_root_wallet_setupsetupId—
agentic_complete_root_wallet_setupsetupIdwalletAddress、ownerAddress
agentic_cancel_root_wallet_setupsetupId—

ワークフロー

  1. agentic_start_root_wallet_setup を呼び出します。これによりオペレーターキーペアが生成され、setupId、dashboardUrl、callbackUrl が返されます
  2. 環境でローカルのブラウザーまたはシェルツールが利用できる場合は、プラットフォームのオープナー(open、xdg-open、start)またはブラウザー自動化を使って、自分で dashboardUrl を開きます。自動で開けない場合、または開くのに失敗した場合に限り、ユーザーにリンクを貼り付けます
  3. ユーザーには、メインの TON ウォレットからウォレットのデプロイを承認するよう伝えるだけにします。URL の再入力や途中のデータのコピーは求めないでください
  4. 長時間稼働する stdio/HTTP MCP サーバーのセッションでは、コールバックフローが利用可能な場合、agentic_get_root_wallet_setup または agentic_list_pending_root_wallet_setups をポーリングして、status: "callback_received" になるまで待ってから、setupId を指定して agentic_complete_root_wallet_setup を呼び出します。
  5. 生のワンショット CLI では、コールバックのポーリングを省略します。ユーザーがウォレットをデプロイした後に walletAddress を尋ね、その walletAddress を指定して agentic_complete_root_wallet_setup を呼び出します
  6. get_current_wallet または list_wallets を使ってウォレットが有効であることを確認します(ton-manage-wallets スキルを参照)

仕組み

  • エージェントはオペレーター秘密鍵を保持し、自律的にトランザクションへ署名できます
  • ユーザーはオーナーキーを保持し、いつでも資金を引き出したり、アクセスを取り消したりできます
  • ウォレットはカストディアルサービスではなく、オンチェーンのスマートコントラクト(NFT ベース)です
  • ダッシュボードは agents.ton.org にあります

環境変数

変数説明
NETWORKmainnet(デフォルト)または testnet
AGENTIC_CALLBACK_BASE_URLオンボーディングコールバックの公開 URL(HTTP モードでは自動設定)
AGENTIC_CALLBACK_PORTコールバックサーバーのポート

注意事項

  • コールバックを使った完了処理は、長時間稼働する stdio/HTTP MCP サーバーのセッション向けです。生の CLI では、手動で walletAddress を指定して完了してください
  • 現在の環境でダッシュボードを自動的に開ける場合は、ユーザーに手動で URL を開くよう求めず、自動で開いてください
  • 生の CLI モードでは、コールバックサーバーがフローを完了できるほど長く稼働しないため、デプロイ後にウォレットアドレスを尋ねてください
  • ウォレットの作成後、送金またはスワップのスキルを使用する前に、ウォレットへ TON を入金してください

コメント