SuperAPI AI 工具集

ton-nfts

智能体与模型

查看项目

更新于 10-16 02:29

技能介绍

用途:在 TON 区块链上查看与转移 NFT。适用于用户想查看自己的 NFT、列出收藏品、检查 NFT 详情、发送 NFT 或转移 NFT 的场景。

主要能力(MCP 工具):get_nfts(可选 limit、offset、walletSelector)列出当前钱包 NFT;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)签名并广播。

使用方式:列出我的 NFT 时调用 get_nfts,用 limit、offset 分页。查看详情调用 get_nft 并传入 nftAddress。发送 NFT 时:先 get_nfts 找到 NFT 地址;调用 build_nft_transfer 构建交易(不会发送);用 emulate_transaction 传入返回的 transaction.messages 预览(推荐广播前执行);转移前向用户请求一次简短的是/否确认;再用 send_raw_transaction 传入 transaction.messages 与 transaction.fromAddress 广播(转账绑定构建时使用的钱包);随后用 get_transaction_status 轮询返回的 normalizedHash,直到 status 为 completed 或 failed(参见 ton-balance 技能)。

注意事项:build_nft_transfer 仅构建交易,send_raw_transaction 才负责签名并广播;emulate_transaction 使用虚假签名预览预期余额变化;转移 NFT 前始终需用户确认,优先使用宿主客户端的结构化确认 UI,否则接受自然语言的是/否,不要求固定确认短语;若未配置钱包,先使用 ton-create-wallet 技能。