ton-org/kit

ton-create-wallet

Create and deploy a TON agentic wallet.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/ton-org/kit --skill ton-create-wallet

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Create TON Agentic Wallet

Deploy an on-chain agentic wallet on TON. The agent generates operator keys, opens the dashboard when local browser/shell tools are available, and uses callback-based completion only in long-lived stdio/HTTP MCP server sessions.

MCP Tools

ToolDescription
agentic_start_root_wallet_setupGenerate operator keys, create pending setup, return dashboard URL
agentic_list_pending_root_wallet_setupsList pending setup drafts and their callback status
agentic_get_root_wallet_setupRead one pending setup by setupId
agentic_complete_root_wallet_setupFinish onboarding from callback or manual wallet address
agentic_cancel_root_wallet_setupCancel a pending setup

Tool Parameters

ToolRequiredOptional
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—

Workflow

  1. Call agentic_start_root_wallet_setup — this generates an operator key pair and returns a setupId, dashboardUrl, and callbackUrl
  2. If the environment exposes local browser or shell tools, open dashboardUrl yourself with the platform opener (open, xdg-open, start) or browser automation; only paste the link to the user if automatic opening is unavailable or fails
  3. Tell the user only to approve wallet deployment from their main TON wallet; do not ask them to retype the URL or copy intermediate data
  4. In long-lived stdio/HTTP MCP server sessions, poll agentic_get_root_wallet_setup or agentic_list_pending_root_wallet_setups and wait for status: "callback_received" when callback flow is available; then call agentic_complete_root_wallet_setup with setupId;
  5. In raw one-shot CLI usage, skip callback polling and ask for walletAddress after the user deploys the wallet; then call agentic_complete_root_wallet_setup with walletAddress
  6. Confirm the wallet is active with get_current_wallet or list_wallets (see ton-manage-wallets skill)

How It Works

  • The agent keeps the operator private key — it can sign transactions autonomously
  • The user keeps the owner key — they can withdraw funds or revoke access at any time
  • The wallet is an on-chain smart contract (NFT-based), not a custodial service
  • The dashboard is at agents.ton.org

Environment Variables

VariableDescription
NETWORKmainnet (default) or testnet
AGENTIC_CALLBACK_BASE_URLPublic URL for the onboarding callback (auto in HTTP mode)
AGENTIC_CALLBACK_PORTPort for the callback server

Notes

  • Callback-driven completion is for long-lived stdio/HTTP MCP server sessions; raw CLI should use manual walletAddress completion
  • If automatic dashboard opening is supported in the current environment, do it instead of asking the user to open the URL manually
  • In raw CLI mode, ask for the wallet address after deployment because the callback server is not available long enough to complete the flow
  • After wallet creation, fund the wallet with GRAM (ex. TON) before using transfer or swap skills

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills