如何将 Tonkeeper 连接到 TON dApp

钱包准备和网络验证

1. 从 tonkeeper.com 或经过验证的 iOS、Android 或桌面平台应用程序商店安装官方 Tonkeeper 应用程序。

2. 启动 Tonkeeper 并确认它正在 TON 主网上运行——通过检查顶部栏中的网络指示器来验证这一点；如果显示“Testnet”，请访问“设置”，点击 Tonkeeper 徽标五次以打开“开发人员菜单”，然后切换到主网。

3. 确保钱包至少包含 0.1 TON 来支付大多数 dApp 所需的初始交易费用和合约部署成本。

4. 将 24 字恢复短语备份到安全的离线位置 — 此步骤是不可逆的，并且在任何链上交互之前都是强制性的。

5. 确认没有第三方扩展或叠加层干扰钱包的 UI 渲染或签名提示。

通过 dApp 接口启动连接

1. 使用支持的浏览器（例如启用了 JavaScript 的 Chrome、Edge 或 Safari）导航到基于 TON 的目标 dApp。

2. 找到并单击“连接钱包”按钮——通常位于 dApp 界面的右上角。

3. 在显示的钱包列表中选择“Tonkeeper”；除非 dApp 连接流程明确指示，否则避免扫描 QR 码。

4. Tonkeeper 内将出现一个弹出模式，请求许可共享您的公共地址并签署会话请求 - 点击“批准”。

5. dApp将显示您连接的地址，并可能触发自动余额同步；不会传输任何私钥或助记词。

地址格式和兼容性处理

1. Tonkeeper 默认生成可退回格式的地址（例如EQB4c1b2ede12aa76f4a44353944258bcc8f99e9c7c474711a152c78b43218e296 ），支持自动纠错，是面向用户交互的首选。

2. 某些 dApp 需要不可退回的地址来进行智能合约调用——Tonkeeper 在“账户信息”>“复制地址”> 切换选项下提供了两种变体。

3. 验证 dApp 是否正确解析工作链 ID（0 表示基础链）和账户 ID 组件；不匹配的工作链处理会导致静默连接失败。

4. 如果 dApp 使用 TonConnect 协议 v2，请确保 Tonkeeper 版本≥4.12.0——旧版本缺乏对多重签名会话握手的支持。

5. 不要手动编辑或截断地址字符串——校验和和前缀编码以加密方式绑定到底层公钥。

签名和交易授权流程

1. 当发起交易或数据签名请求时，dApp 发送包含方法名称、参数和过期时间戳的结构化负载。

2. Tonkeeper 显示本机确认屏幕，显示确切的操作类型（ sendMessage或signData ）、目标地址、金额和附加备忘录。

3. 用户必须明确批准每个操作——设计上不允许批量批准或自动签名策略。

4. 获得批准后，Tonkeeper 在规范化有效负载上计算 Ed25519 签名，并将其与签名的消息哈希一起返回到 dApp。

5. 失败的签名总是会导致区块链层面立即拒绝；不会发生部分或回退执行。

常见连接故障故障排除

1. 如果钱包未能出现在连接器列表中，请清除浏览器缓存并禁用广告拦截器或过滤 WebSocket 或注入脚本的隐私扩展。

2. 持续存在的“无效会话”错误表明 TonConnect 配对已过期 - 通过单击 dApp 中的“断开钱包”来重新连接，然后重新启动连接。

3. 空白或冻结的确认模式通常源于过时的 Tonkeeper 版本 - 通过官方应用商店或 tonkeeper.com/download 进行更新。

4. dApp 显示与 Tonkeeper 的“帐户信息”之间的地址不匹配表明网络上下文不正确 - 仔细检查 dApp 后端和钱包是否在相同的 TON 网络端点上运行。

5. 签名请求期间重复出现超时消息表明本地互联网不稳定或 ISP 级 WebSocket 阻塞 - 切换到移动数据或在 Tonkeeper 设置中启用 Tor 模式。

常见问题解答

问：我可以将 Tonkeeper 同时连接到多个 dApp 而无需重新批准吗？答：是的——Tonkeeper 维护每个 dApp 域的持久会话密钥；每个新源都需要一次性配对，但后续交互将跳过重新身份验证，除非手动撤销。

问：连接到 dApp 是否会授予其访问我的交易历史记录或余额详细信息的权限？答：不，仅共享公共地址；所有余额和历史查询都必须通过由用户同意和显式 RPC 调用控制的 TON API 端点执行。

问：为什么有些 dApp 即使选择了 Tonkeeper，仍显示“不支持的钱包”？答：当 dApp 强制执行与 Tonkeeper 当前适配器层不兼容的旧版 TonConnect v1 或自定义 RPC 包装器时，就会发生这种情况 - 请检查 dApp 文档以了解支持的最低 SDK 版本。

问：将 Tonkeeper 连接到非 HTTPS 域上托管的 dApp 是否安全？答：否 — Tonkeeper 完全阻止与 HTTP 源的连接；仅允许具有有效证书的 TLS 安全域发起钱包会话。