Back to Details

ton-nfts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

TON NFT Operations

TON NFT操作

View and transfer NFTs on the TON blockchain.
在TON区块链上查看和转移NFT。

MCP Tools

MCP工具

ToolRequiredOptional
get_nfts
—
limit
, 
offset
, 
walletSelector
get_nfts_by_address
address
limit
, 
offset
get_nft
nftAddress
—
build_nft_transfer
nftAddress
, 
toAddress
comment
, 
walletSelector
emulate_transaction
messages
validUntil
send_raw_transaction
messages
validUntil
, 
fromAddress
, 
walletSelector
build_nft_transfer
does NOT broadcast — it returns ready-to-send 
transaction.messages
plus 
transaction.fromAddress
. Preview with 
emulate_transaction
, then broadcast with 
send_raw_transaction
.
工具必填参数可选参数
get_nfts
—
limit
, 
offset
, 
walletSelector
get_nfts_by_address
address
limit
, 
offset
get_nft
nftAddress
—
build_nft_transfer
nftAddress
, 
toAddress
comment
, 
walletSelector
emulate_transaction
messages
validUntil
send_raw_transaction
messages
validUntil
, 
fromAddress
, 
walletSelector
build_nft_transfer
不会广播交易——它会返回待发送的 
transaction.messages
以及 
transaction.fromAddress
。请使用 
emulate_transaction
进行预览，再通过 
send_raw_transaction
广播。

Workflows

工作流程

List My NFTs

列出我的NFT

  1. Call 
    get_nfts
    to list NFTs in the active wallet
  2. Use 
    limit
    and 
    offset
    for pagination
  1. 调用 
    get_nfts
    列出当前活跃钱包中的NFT
  2. 使用 
    limit
    和 
    offset
    进行分页

View NFT Details

查看NFT详情

  1. Call 
    get_nft
    with the 
    nftAddress
  1. 传入 
    nftAddress
    调用 
    get_nft

Send an NFT

发送NFT

  1. Call 
    get_nfts
    to find the NFT address if the user doesn't have it
  2. Call 
    build_nft_transfer
    with 
    nftAddress
    and 
    toAddress
    to build the transaction (it is NOT sent)
  3. Preview it with 
    emulate_transaction
    using the returned 
    transaction.messages
    (recommended before broadcasting)
  4. Ask one short yes/no confirmation before transferring the NFT
  5. Broadcast with 
    send_raw_transaction
    passing the 
    transaction.messages
    and 
    transaction.fromAddress
    (the NFT transfer is bound to the wallet it was built for)
  6. Poll 
    get_transaction_status
    with the returned 
    normalizedHash
    until status is 
    completed
    or 
    failed
    (see 
    ton-balance
    skill)
  1. 如果用户不知道NFT地址，先调用 
    get_nfts
    查找
  2. 传入 
    nftAddress
    和 
    toAddress
    调用 
    build_nft_transfer
    构建交易（不会实际发送）
  3. 使用返回的 
    transaction.messages
    调用 
    emulate_transaction
    预览交易（广播前推荐执行此步骤）
  4. 转让NFT前需向用户确认，仅需简短的是/否确认即可
  5. 传入 
    transaction.messages
    和 
    transaction.fromAddress
    调用 
    send_raw_transaction
    广播交易（NFT转让与构建交易时使用的钱包绑定）
  6. 使用返回的 
    normalizedHash
    轮询 
    get_transaction_status
    ，直到状态变为 
    completed
    （已完成）或 
    failed
    （失败）（参见 
    ton-balance
    skill）

Notes

注意事项

  • build_nft_transfer
    builds the transaction only; 
    send_raw_transaction
    is the tool that signs and broadcasts it
  • Use 
    emulate_transaction
    to preview expected balance changes before broadcasting (fake signature)
  • Always confirm with the user before transferring an NFT; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
  • If no wallet is configured, use the 
    ton-create-wallet
    skill first
  • build_nft_transfer
    仅用于构建交易；
    send_raw_transaction
    才是负责签名和广播的工具
  • 广播前可使用 
    emulate_transaction
    预览预期的余额变化（使用模拟签名）
  • 转让NFT前必须征得用户同意；优先使用宿主客户端的结构化确认UI，若无则支持自然语言的是/否确认，无需固定确认话术
  • 若未配置钱包，请先使用 
    ton-create-wallet
    skill