ton-manage-wallets

TON ウォレット管理

ローカルのウォレットレジストリを管理し、インポートや鍵のローテーションなど、高度なエージェント型ウォレット操作を実行します。

MCP ツール

ウォレットレジストリ

ツール	必須	任意
list_wallets	—	—
get_current_wallet	—	—
set_active_wallet	walletSelector	—
remove_wallet	walletSelector	—

エージェント型ウォレット管理

ツール	必須	任意
agentic_validate_wallet	address	network、ownerAddress、collectionAddress
agentic_list_wallets_by_owner	ownerAddress	network
agentic_import_wallet	address	name
agentic_rotate_operator_key	walletSelector	—
agentic_complete_rotate_operator_key	rotationId	—

ワークフロー

アクティブなウォレットを切り替える

1. list_wallets を呼び出し、保存されているすべてのウォレットを確認します
2. walletSelector（ID、名前、またはアドレス）を指定して set_active_wallet を呼び出します
3. get_current_wallet で確認します

既存のエージェント型ウォレットをインポートする

1. agentic_validate_wallet を呼び出して、ウォレットアドレスとコントラクトを検証します
2. agentic_import_wallet を呼び出して、ウォレットをレジストリに追加します
3. エージェントがトランザクションに署名する必要があり、オペレーターキーがない場合は、agentic_rotate_operator_key を呼び出します。その後、ユーザーがダッシュボードからオンチェーンで鍵の変更を適用したら、agentic_complete_rotate_operator_key を呼び出します

オペレーターキーをローテーションする

1. agentic_rotate_operator_key を呼び出します。新しいキーペアが生成され、ユーザーがオンチェーンで変更を適用するためのダッシュボード URL が返されます
2. ローカルのブラウザーツールまたはシェルツールを利用できる場合は、ダッシュボード URL を自分で開きます。自動で開けない場合、または開くのに失敗した場合に限り、リンクをそのまま送信します
3. ユーザーにはウォレット内でオンチェーンの鍵変更を承認することだけを依頼します。URL の再貼り付けや、決まった確認フレーズの入力を求めないでください
4. rotationId を指定して agentic_complete_rotate_operator_key を呼び出します。チェーンの状態がまだ更新されていない場合は、ユーザーに追加の入力を求めず、少し待ってから再試行します

注意事項

• walletSelector にはウォレット ID、名前、またはアドレスを指定できます
• 1 回限りの問い合わせでは、アクティブなウォレットを変更するのではなく、ウォレットを指定するツールに walletSelector を直接渡します
• 可能な場合は、利用できるシェルツールまたはブラウザーツールを使用して、ユーザーのためにダッシュボード URL を開きます
• 確認や少数の選択肢を提示する場合は、ホストクライアントの構造化された確認・選択 UI が利用できれば、そちらを優先します。利用できない場合は、自然な言葉で簡潔な「はい／いいえ」の質問をし、特定の合言葉を要求しないでください
• レジストリデータは ~/.config/ton/config.json（または TON_CONFIG_PATH）に保存されます
• 読み取りツールは、まだ operator_private_key がないインポート済みのエージェント型ウォレットでも使用できます。書き込みツールにはこの鍵が必要です
• 管理ツールの応答に、秘密鍵、ニーモニック、API キーが含まれることはありません
• 新しいエージェント型ウォレットを作成するには、代わりに ton-create-wallet スキルを使用します