ton-manage-wallets
Manage multiple TON wallets, import agentic wallets and rotate operator keys. Use when the user wants to switch wallets, list wallets, import an existing wallet, rotate an operator key, or manage their wallet registry.
How do I install this agent skill?
npx skills add https://github.com/ton-connect/kit --skill ton-manage-walletsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill allows management of TON wallets and operator keys, using a local configuration file for storage and system tools to assist with on-chain operations. Analysis shows the behavior is consistent with legitimate wallet management software.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ton-connect/kit/ton-manage-wallets">View ton-manage-wallets on skillZs</a>