ton-send

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Send GRAM (ex. TON) & Tokens

发送GRAM（例如TON）与代币

Transfer GRAM (ex. TON) or jettons to any address. Supports TON DNS resolution for

.ton

and

.t.me

domains.

向任意地址转移GRAM（例如TON）或jetton。支持对.ton和.t.me域名进行TON DNS解析。

MCP Tools

MCP工具

Tool	Required	Optional
`build_ton_transfer`	`toAddress` , `amount`	`comment` , `walletSelector`
`build_jetton_transfer`	`toAddress` , `jettonAddress` , `amount`	`comment` , `walletSelector`
`emulate_transaction`	`messages`	`validUntil`
`send_raw_transaction`	`messages`	`validUntil` , `fromAddress` , `walletSelector`
`resolve_dns`	`domain`	—
`back_resolve_dns`	`address`	—

build_ton_transfer

and

build_jetton_transfer

do NOT broadcast — they return ready-to-send

transaction.messages

plus

transaction.fromAddress

. Preview with

emulate_transaction

, then broadcast with

send_raw_transaction

工具	必填参数	可选参数
`build_ton_transfer`	`toAddress` , `amount`	`comment` , `walletSelector`
`build_jetton_transfer`	`toAddress` , `jettonAddress` , `amount`	`comment` , `walletSelector`
`emulate_transaction`	`messages`	`validUntil`
`send_raw_transaction`	`messages`	`validUntil` , `fromAddress` , `walletSelector`
`resolve_dns`	`domain`	—
`back_resolve_dns`	`address`	—

build_ton_transfer

和

build_jetton_transfer

不会广播交易——它们会返回已准备好发送的

transaction.messages

以及

transaction.fromAddress

。可使用

emulate_transaction

预览交易，再通过

send_raw_transaction

广播。

Workflows

工作流

Send GRAM (ex. TON)

发送GRAM（例如TON）

If the user provides a DNS name (e.g.,
```
foundation.ton
```
,
```
user.t.me
```
) instead of a raw address, call
```
resolve_dns
```
first
Call
```
build_ton_transfer
```
with address and amount to build the transaction (it is NOT sent)
Preview it with
```
emulate_transaction
```
using the returned
```
transaction.messages
```
(recommended before broadcasting)
Ask one short yes/no confirmation that restates the amount and recipient

Broadcast with

send_raw_transaction

passing the

transaction.messages

and

transaction.fromAddress

Poll
```
get_transaction_status
```
with the returned
```
normalizedHash
```
until status is
```
completed
```
or
```
failed
```
(see
```
ton-balance
```
skill). User can ask to skip polling.

如果用户提供的是DNS名称（例如
```
foundation.ton
```
、
```
user.t.me
```
）而非原始地址，先调用
```
resolve_dns
```
使用地址和金额调用
```
build_ton_transfer
```
构建交易（此时交易未发送）
使用返回的
```
transaction.messages
```
调用
```
emulate_transaction
```
预览交易（建议在广播前执行）
向用户发送简短的确认请求，重述金额和收款方，只需用户回复是/否

传入

transaction.messages

和

transaction.fromAddress

，调用

send_raw_transaction

广播交易

使用返回的
```
normalizedHash
```
调用
```
get_transaction_status
```
轮询，直到状态变为
```
completed
```
或
```
failed
```
（参考
```
ton-balance
```
技能）。用户可要求跳过轮询。

Send Jetton (Token)

发送Jetton（代币）

If user mentions a token by name, call
```
get_known_jettons
```
(see
```
ton-balance
```
skill) to find the
```
jettonAddress
```
Call
```
get_jetton_balance
```
to verify sufficient balance
Call
```
build_jetton_transfer
```
with the
```
jettonAddress
```
,
```
toAddress
```
, and
```
amount
```
to build the transaction (it is NOT sent)
Preview it with
```
emulate_transaction
```
using the returned
```
transaction.messages
```
(recommended before broadcasting)
Ask one short yes/no confirmation before sending
Broadcast with
```
send_raw_transaction
```
passing the
```
transaction.messages
```
and
```
transaction.fromAddress
```
(jetton messages target the sender's jetton wallet)
Poll
```
get_transaction_status
```
until completed or failed

如果用户提及代币名称，调用
```
get_known_jettons
```
（参考
```
ton-balance
```
技能）获取
```
jettonAddress
```
调用
```
get_jetton_balance
```
验证余额是否充足
使用
```
jettonAddress
```
、
```
toAddress
```
和金额调用
```
build_jetton_transfer
```
构建交易（此时交易未发送）
使用返回的
```
transaction.messages
```
调用
```
emulate_transaction
```
预览交易（建议在广播前执行）
发送简短的是/否确认请求，确认后再发送
传入
```
transaction.messages
```
和
```
transaction.fromAddress
```
调用
```
send_raw_transaction
```
广播交易（jetton消息指向发送者的jetton钱包）
轮询
```
get_transaction_status
```
直到交易完成或失败

Notes

注意事项

Amounts are human-readable (e.g.,
```
"1.5"
```
= 1.5 GRAM (ex. TON),
```
"100"
```
= 100 tokens)
```
build_ton_transfer
```
/
```
build_jetton_transfer
```
build the transaction only;
```
send_raw_transaction
```
is the tool that actually signs and broadcasts
Use
```
emulate_transaction
```
to preview expected balance changes before broadcasting (fake signature)
Always confirm with the user before broadcasting a transfer; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
After broadcasting, 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

金额为人类可读格式（例如
```
"1.5"
```
= 1.5 GRAM（例如TON），
```
"100"
```
= 100枚代币）

build_ton_transfer

build_jetton_transfer

仅构建交易；实际签名并广播交易的工具是

send_raw_transaction

可使用
```
emulate_transaction
```
在广播前预览预期的余额变化（模拟签名）
广播转账前务必获得用户确认；若有宿主客户端的结构化确认UI则优先使用，否则接受自然语言的是/否回复，无需固定确认语
广播后默认轮询
```
get_transaction_status
```
。用户可指定是否检查状态。
若未配置钱包，需先使用
```
ton-create-wallet
```
技能