如何将 Phantom 链接到 dApp？ （钱包连接）

将 Phantom 钱包连接到 dApp

1. 确保 Phantom 作为浏览器扩展或移动应用程序安装在目标设备上。支持的浏览器包括 Chrome、Brave、Firefox 和 Edge。移动用户必须激活 iOS 或 Android Phantom 应用程序并更新至版本 3.79。

2. 使用兼容的浏览器导航至 dApp 界面。该网站必须通过 HTTPS 提供服务，并且不会被浏览器安全协议标记为恶意网站。

3. 找到钱包连接按钮 — 通常标记为“连接钱包”、“连接”，或由页面右上角附近的钱包图标表示。

4. 单击 按钮并从显示的可用钱包列表中选择Phantom 。如果 Phantom 未出现，请刷新页面或验证浏览器设置中是否启用了该扩展程序。

5. 将出现一个 Phantom 弹出窗口，请求访问您的公共地址和网络上下文的权限。在批准之前仔细检查所请求的权限。

权限范围和会话行为

1. Phantom 在初始连接时授予对钱包公钥和当前链上下文（例如 Solana 主网、以太坊 Sepolia）的只读访问权限。

2. 连接期间不会暴露私钥、种子短语或交易签名功能。仅当交易流程中的用户操作显式触发时才会发生签名。

3. 除非通过“连接站点”下的 Phantom 内部钱包设置手动断开连接或撤销，否则会话在页面重新加载后仍会持续存在。

4. 每个 dApp 都会收到一个唯一的会话标识符； Phantom 不会跨域共享会话数据，从而强制执行严格的源隔离。

5. 与一个 dApp 断开连接不会影响与其他 dApp 或网络建立的连接。

处理网络不匹配

1. 如果 dApp 在当前 Phantom 配置不支持的网络上运行（例如 dApp 使用 Polygon zkEVM，但 Phantom 设置为 Solana），则会出现警报，提示手动网络切换。

2. Phantom 显示一个下拉菜单，列出所有本机支持的链：Solana、Ethereum、Polygon、Base、Sui 和通过包装资产的 Bitcoin。

3. 选择新网络会触发自动 RPC 端点重新配置，无需重新导入钱包或重新身份验证。

4. 新选择的链的原生资产如果已经持有，会立即出现在余额面板中；否则，界面将显示零余额，直至发生存款。

5. 尝试在不匹配的网络上签署交易会导致在生成签名之前立即被 Phantom 的内部验证器层拒绝。

常见连接故障故障排除

1. 浏览器工具栏中缺少幻影图标表示该扩展已被禁用、被广告/跟踪器拦截器拦截或与当前浏览器版本不兼容。

2. 空白或冻结连接模式通常源于过时的 Phantom 版本 - 通过phantom.app/changelog上的官方变更日志验证当前版本是否为 v3.79。

3. 当 dApp 域未通过 DNSSEC 验证或被 MetaMask 或 Phantom 的嵌入式威胁情报源标记为网络钓鱼时，可能会出现“连接被拒绝”错误。

4. 批准后重复出现“无效签名”消息通常表明设备和 NTP 服务器之间的时钟偏差超过 ±30 秒 - 正确的系统时间可以立即解决此问题。

5. 移动 Safari 用户必须手动启用“桌面站点”模式才能完全兼容 Phantom Web3，因为 iOS WebKit 限制移动视图中的某些钱包注入 API。

常见问题解答

问：我可以在不泄露钱包地址的情况下将 Phantom 连接到 dApp 吗？答：不需要。公共地址披露对于 dApp 交互是强制性的。 Phantom 从不共享私钥或种子短语，但公钥必须可见才能建立身份并验证签名。

问：连接到 dApp 是否会耗尽我的资金？答：不会。仅连接就赋予零支出权限。只有在用户通过 Phantom 的安全 UI 明确确认每笔签名交易后，才能转移资金。

问：为什么 Phantom 有时会显示“不支持的链”，尽管 dApp 声称兼容 Solana？答：dApp 可以配置为 Solana 开发网或测试网，而 Phantom 锁定到主网，反之亦然。检查 dApp 前端配置和 Phantom 网络选择器中链 ID 的一致性。

问：在开发过程中我可以使用 Phantom 连接到本地主机上托管的 dApp 吗？答：是的，前提是本地服务器通过 HTTPS 运行且具有有效证书，或者使用 Phantom 开发人员设置中启用的本地主机异常处理。