ton-org/kit

ton-manage-wallets

Manage multiple TON wallets, import agentic wallets and rotate operator keys.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/ton-org/kit --skill ton-manage-wallets

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

TON Wallet Management

Manage the local wallet registry and perform advanced agentic wallet operations including import and key rotation.

MCP Tools

Wallet Registry

ToolRequiredOptional
list_wallets——
get_current_wallet——
set_active_walletwalletSelector—
remove_walletwalletSelector—

Agentic Wallet Management

ToolRequiredOptional
agentic_validate_walletaddressnetwork, ownerAddress, collectionAddress
agentic_list_wallets_by_ownerownerAddressnetwork
agentic_import_walletaddressname
agentic_rotate_operator_keywalletSelector—
agentic_complete_rotate_operator_keyrotationId—

Workflows

Switch Active Wallet

  1. Call list_wallets to see all stored wallets
  2. Call set_active_wallet with a walletSelector (id, name, or address)
  3. Confirm with get_current_wallet

Import Existing Agentic Wallet

  1. Call agentic_validate_wallet to verify the wallet address and contract
  2. Call agentic_import_wallet to add it to the registry
  3. If the agent needs to sign transactions and no operator key is available, call agentic_rotate_operator_key and then agentic_complete_rotate_operator_key after the user applies the key change on-chain via the dashboard

Rotate Operator Key

  1. Call agentic_rotate_operator_key — generates a new key pair and returns a dashboard URL for the user to apply the change on-chain
  2. 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
  3. 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
  4. Call agentic_complete_rotate_operator_key with the rotationId; if the chain state has not updated yet, wait briefly and retry instead of forcing extra user input

Notes

  • walletSelector accepts wallet id, name, or address
  • For one-off queries, pass walletSelector directly 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 (or TON_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-wallet skill instead

Relacionados por tarefa

do mesmo repositório

Mais Skills

Todos os Skills