ton-proof

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TON Proof Authentication

TON Proof 认证

Generate a signed TonConnect proof-of-ownership payload for a domain and challenge string. This proves control of the active wallet without sending a transaction.

为域名和挑战字符串生成经过签名的TonConnect所有权证明载荷。这无需发送交易即可证明对当前钱包的控制权。

MCP Tools

MCP 工具

Tool	Required	Optional
`generate_ton_proof`	`domain` , `payload`	`walletSelector`
`get_wallet`	—	`walletSelector`

工具	必填	可选
`generate_ton_proof`	`domain` 、 `payload`	`walletSelector`
`get_wallet`	—	`walletSelector`

Workflow

工作流程

Get the exact
```
domain
```
and
```
payload
```
from the user or the verifying service
Do not edit, normalize, decode, or invent the payload; it is part of the signed proof
Ask one short yes/no confirmation before sending; If there are tools for dialogs/confirmation available, use them instead of a free-text prompt.
Call
```
generate_ton_proof
```
with the domain and payload
Return the proof JSON to the user, or submit it to the service only when the user explicitly asked for that integration step

从用户或验证服务获取准确的
```
domain
```
和
```
payload
```
请勿编辑、标准化、解码或自行生成载荷；它是签名证明的一部分
在发送前请求用户进行简短的是/否确认；如果有对话框/确认工具可用，请使用它们而非自由文本提示。
使用
```
domain
```
和
```
payload
```
调用
```
generate_ton_proof
```
将证明JSON返回给用户，或仅在用户明确要求该集成步骤时提交至服务

Output

输出内容

The proof includes:

```
address
```
: active wallet address in raw format
```
chain
```
: TON Connect chain id (
```
-239
```
for mainnet,
```
-3
```
for testnet)
```
walletStateInit
```
: wallet state init in base64
```
publicKey
```
: wallet public key
```
timestamp
```
: Unix timestamp used in the proof
```
domainLengthBytes
```
and
```
domainValue
```
: signed domain metadata
```
signature
```
: base64 TonProof signature
```
payload
```
: original challenge payload

证明包含以下信息：

```
address
```
: 当前钱包的原始格式地址
```
chain
```
: TON Connect 链ID（主网为
```
-239
```
，测试网为
```
-3
```
）
```
walletStateInit
```
: base64格式的钱包状态初始化数据
```
publicKey
```
: 钱包公钥
```
timestamp
```
: 证明中使用的Unix时间戳
```
domainLengthBytes
```
和
```
domainValue
```
: 经过签名的域名元数据
```
signature
```
: base64格式的TonProof签名
```
payload
```
: 原始挑战载荷

Notes

注意事项

TonProof is for authentication and proof of wallet ownership; it does not transfer funds
TonProof still requires signing access. Imported read-only agentic wallets need operator key rotation completed before this tool can generate a proof
Only generate a proof for domains and payloads the user intentionally provided or that came directly from the verifying service
If multiple wallets are configured, pass
```
walletSelector
```
instead of changing the active wallet for a one-off proof
If no wallet is configured, use the
```
ton-create-wallet
```
skill first

TonProof用于认证和钱包所有权证明；不涉及资金转账
TonProof仍需要签名权限。导入的只读代理钱包需要先完成操作员密钥轮换，才能使用此工具生成证明
仅为用户有意提供或直接来自验证服务的域名和载荷生成证明
如果配置了多个钱包，请传递
```
walletSelector
```
，而非为一次性证明切换当前钱包
如果未配置钱包，请先使用
```
ton-create-wallet
```
技能