如何将 Talisman 钱包连接到 Polkadot dApp

了解 Talisman 钱包集成

1. Talisman Wallet 是专为 Polkadot 生态设计的浏览器扩展和移动应用程序，支持 Astar、Moonbeam 和 Litentry 等平行链。

2. 实现了 Polkadot-JS 扩展接口标准，可以与基于 Substrate 的链上构建的 dApp 无缝交互。

3. 与依赖 window.ethereum 注入的以太坊钱包不同，Talisman 注入 window.talismanEthereum 和 window.injectedWeb3 对象以公开其签名和帐户管理功能。

4. 当连接到支持 EVM 的平行链时，钱包支持标准底层外部交易和 EVM 兼容交易。

5. 其 UI 层直接在浏览器上下文中呈现交易确认，无需外部重定向或深层链接。

连接设置的先决条件

1. 用户必须从https://talisman.xyz/download安装官方 Talisman 浏览器扩展 - 不支持第三方版本，可能会损害密钥安全。

2. dApp 必须使用 @polkadot/api v12+ 初始化 Polkadot-JS API，并包含目标平行链运行时的正确类型定义。

3. 前端代码需要在尝试连接之前检测 window.injectedWeb3，因为缺少则表示钱包未安装或禁用。

4. 网络配置必须与 dApp 的预期链相匹配 — Talisman 根据已知的可信提供商验证 RPC 端点，并默认拒绝未经验证的自定义 URL。

5. 对于移动用户，Talisman手机应用程序必须通过二维码扫描进行配对；这使用噪声协议框架握手建立加密会话。

分步连接流程

1. dApp 从 @polkadot/extension-dapp 调用 web3Enable('MyDapp') 来请求访问注入提供程序的权限。

2. Talisman 以可用帐户列表进行响应，每个帐户都携带编码地址、genesisHash 和 networkId 元数据。

3. dApp 选择一个账户，并通过 api.tx.* 方法发起 SignAndSendTransaction 调用，触发 Talisman 的模态叠加。

4. 用户在批准或拒绝之前查看外部详细信息，包括费用估算、重量和托盘调用结构。

5. 获得批准后，Talisman 使用 Schnorrkel (sr25519) 或 Ed25519 密钥对有效负载进行签名，并将签名的交易返回给 dApp 进行提交。

处理连接错误

1. 如果 window.injectedWeb3 未定义，dApp 应显示提示，指示用户安装或启用扩展。

2. web3Enable 期间出现“未找到提供商”错误通常意味着 Talisman 正在私有模式下运行或已阻止当前源。

3. 签名拒绝会导致错误对象，代码为 1011，指示用户取消而不是加密失败。

4. 无效的genesisHash不匹配会引发错误代码1002——当dApp连接到测试网而Talisman配置为主网时会发生这种情况，反之亦然。

5. 二维码配对超时错误源于会话令牌过期；新的 QR 码必须每 90 秒重新生成一次。

常见问题解答

问：Talisman 支持硬件钱包集成吗？答：是的，Talisman 原生支持 Polkadot 和 Kusama 网络的 Ledger 设备。用户必须在 Ledger 上安装 Polkadot 应用程序，并在 Talisman 设置中启用盲签名。

问：我可以将 Talisman 连接到与以太坊兼容的 dApp 吗？答：仅当这些 dApp 部署在支持 EVM 的 Polkadot 平行链（例如 Moonbeam 或 Moonriver）上时。 Talisman 不会在以太坊主网上公开 window.ethereum。

问：为什么 Talisman 拒绝我的自定义 RPC 端点？答：Talisman 维护着一份经过审核的 RPC 提供商的精选列表。自定义端点需要通过扩展弹出窗口中的开发人员模式切换手动白名单。

问：有没有办法以编程方式检测 Talisman 是否已锁定或解锁？答：不会。Talisman 故意隐藏内部状态以防止侧通道泄漏。唯一可观察到的信号是对 web3Accounts() 的成功响应或特定错误代码的失败。