使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/ton-org/kit --skill ton-manage-wallets开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
TON Wallet Management
Manage the local wallet registry and perform advanced agentic wallet operations including import and key rotation.
MCP Tools
Wallet Registry
| Tool | Required | Optional |
|---|---|---|
list_wallets | — | — |
get_current_wallet | — | — |
set_active_wallet | walletSelector | — |
remove_wallet | walletSelector | — |
Agentic Wallet Management
| Tool | Required | Optional |
|---|---|---|
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 | — |
Workflows
Switch Active Wallet
- Call
list_walletsto see all stored wallets - Call
set_active_walletwith awalletSelector(id, name, or address) - Confirm with
get_current_wallet
Import Existing Agentic Wallet
- Call
agentic_validate_walletto verify the wallet address and contract - Call
agentic_import_walletto add it to the registry - If the agent needs to sign transactions and no operator key is available, call
agentic_rotate_operator_keyand thenagentic_complete_rotate_operator_keyafter the user applies the key change on-chain via the dashboard
Rotate Operator Key
- Call
agentic_rotate_operator_key— generates a new key pair and returns a dashboard URL for the user to apply the change on-chain - If local browser or shell tools are available, open the dashboard URL yourself; only send the raw link when automatic opening is unavailable or fails
- Ask the user only to approve the on-chain key change in their wallet; do not require them to re-paste the URL or type a fixed confirmation phrase
- Call
agentic_complete_rotate_operator_keywith therotationId; if the chain state has not updated yet, wait briefly and retry instead of forcing extra user input
Notes
walletSelectoraccepts wallet id, name, or address- For one-off queries, pass
walletSelectordirectly to wallet-scoped tools instead of changing the active wallet - Use available shell/browser tools to open dashboard URLs for the user whenever possible
- For confirmations and small option sets, prefer the host client's structured confirmation/choice UI when available; otherwise use a short natural-language yes/no prompt and never require an exact magic word
- Registry data is stored in
~/.config/ton/config.json(orTON_CONFIG_PATH) - Read tools work with imported agentic wallets that don't yet have an
operator_private_key; write tools require it - Management tool responses never expose private keys, mnemonics, or API keys
- To create a brand new agentic wallet, use the
ton-create-walletskill instead
