用途:为指定域名和 challenge 字符串生成 TonConnect 的 TonProof 所有权证明签名,用于登录或第三方认证,证明对当前钱包的控制权,不涉及资金转账。
主要能力:提供 generate_ton_proof 工具,必填 domain、payload,可选 walletSelector;另有 get_wallet 工具,可选 walletSelector。生成的 proof 包含 address(raw 格式钱包地址)、chain(TON Connect 链 id,主网 -239,测试网 -3)、walletStateInit(base64)、publicKey、timestamp、domainLengthBytes 与 domainValue、signature(base64 TonProof 签名)以及原始 payload。
使用方式:先从用户或验证服务获取准确的 domain 和 payload;不要编辑、规范化、解码或自行编造 payload,它是签名内容的一部分。发送前用对话/确认类工具做一次简短的 yes/no 确认。然后调用 generate_ton_proof 传入 domain 和 payload。将 proof JSON 返回给用户;仅当用户明确要求集成时才提交给服务。若配置了多个钱包,应传 walletSelector 而非切换当前钱包。若未配置钱包,需先使用 ton-create-wallet 技能。
限制:TonProof 用于认证和证明钱包所有权,不会转移资金;仍需要签名权限,只读的代理钱包须先完成操作员密钥轮换才能生成 proof;只应为用户明确提供或直接来自验证服务的域名和 payload 生成 proof。