skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
ton-connect/kit177 installs

ton-swap

Swap or trade tokens on the TON blockchain via DEX. Use when the user wants to swap, trade, exchange, convert, buy, or sell tokens like GRAM (ex. TON), USDT, jUSDC, or any jetton. Covers phrases like "swap GRAM (ex. TON) for USDT", "trade tokens", "buy USDT", "exchange jettons".

How do I install this agent skill?

npx skills add https://github.com/ton-connect/kit --skill ton-swap
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is safe. It enables token swaps on the TON blockchain using a multi-step workflow that includes transaction emulation and mandatory user confirmation, aligning with security best practices for blockchain interactions.

  • Socketwarn

    1 alert: gptSecurity

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Swap TON Tokens

Swap tokens on TON via DEX aggregator. Two-step flow: get a quote, confirm with the user, then execute.

MCP Tools

ToolRequiredOptional
get_swap_quotefromToken, toToken, amountwalletSelector
emulate_transactionmessagesvalidUntil
send_raw_transactionmessageswalletSelector
get_known_jettons——

Workflow

  1. If the user mentions a token by name (e.g., "USDT", "jUSDC"), call get_known_jettons to resolve the jetton address
  2. Call get_swap_quote with fromToken, toToken, and amount
    • Use "TON" for native GRAM (ex. TON), or the jetton master contract address for tokens
    • Amount is human-readable (e.g., "1.5" = 1.5 GRAM (ex. TON))
  3. Call emulate_transaction with the quote's transaction.messages to dry-run the swap — verify the expected money flow (GRAM (ex. TON)/jetton balance changes) before sending
  4. Show the quote details and emulation results to the user and ask one short yes/no confirmation
  5. Call send_raw_transaction with the transaction params returned by the quote
  6. Poll get_transaction_status with the returned normalizedHash until status is completed or failed (see ton-balance skill). User can ask to skip polling.

Notes

  • Always confirm the swap with the user before executing; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
  • The quote returns transaction messages ready for send_raw_transaction
  • After execution, poll get_transaction_status by default. User can specify whether to check status.
  • If no wallet is configured, use the ton-create-wallet skill first

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-swap">View ton-swap on skillZs</a>