如何将Coinbase钱包连接到DApp？

钱包集成架构

1. Coinbase 钱包作为兼容 EIP-1193 和 EIP-1474 标准的注入提供商运行。当作为浏览器扩展安装或通过移动深度链接启动时，它会在浏览器上下文中公开一个全局以太坊对象。

2.钱包支持以太坊主网和多个EVM兼容链，包括Base、Optimism、Arbitrum和Polygon。链配置必须与 DApp 的目标网络参数保持一致。

3. 连接启动需要通过模式界面明确的用户同意。根据 Coinbase 钱包客户端 SDK 强制执行的当前安全策略，不允许自动或静默身份验证。

4. 会话持久性依赖于域源范围内的本地存储。每个 dApp 都维护自己隔离的会话状态，防止跨站点钱包状态泄漏。

5. 断开连接事件会触发立即撤销所有先前授予的权限，包括帐户暴露和交易签名功能。

前端实现步骤

1. 通过 npm 导入官方 Coinbase 钱包 SDK： npm install @coinbase/wallet-sdk 。该包包括类型化接口、错误处理实用程序和链感知提供程序包装器。

2. 使用CoinbaseWalletSDK实例化钱包连接器，其中必填字段为：与目标区块链 RPC 端点相对应的 appName、appLogoUrl 和 jsonRpcUrl。

3. 初始化提供程序实例并调用activate()以启动连接流程。这将打开一个本机模式，提示用户批准或拒绝访问。

4. 成功后，返回的提供程序对象将发出accountsChanged和chainChanged事件，从而启用连接地址和网络状态的反应式UI 更新。

5. 所有后续合约调用或交易提交都必须通过此提供程序实例进行路由，以确保签名路由与活动会话保持一致。

安全执行机制

1. 每个交易请求在签名生成之前都会经过设备端验证。钱包显示完整的有效负载详细信息，包括接收者、价值、气体参数和函数调用数据。

2. 智能合约交互需要明确的函数名称和参数类型验证。 ABI 解码在钱包的沙盒运行时环境中本地执行。

3. 被拒绝的交易会记录在钱包的内部审计跟踪中，并带有时间戳和操作哈希值，只有用户可以通过钱包的历史记录选项卡访问。

4. 针对已知恶意域实时运行网络钓鱼检测。任何从列入黑名单的源进行连接的尝试都会立即触发警告横幅并阻止进一步的交互。

5. 私钥材料永远不会离开设备的安全区域。签名操作仅发生在钱包的隔离加密模块内。

通用权限范围

1. eth_accounts ：授予对当前选定的以太坊地址的只读访问权限。基本钱包检测和余额显示所需的。

2. eth_signTypedData_v4 ：启用符合 EIP-712 的结构化消息签名。用于登录流程和链下证明。

3. eth_sendTransaction ：授权广播签名的以太坊交易。仅在用户手动确认后触发。

4. individual_sign ：支持旧版明文签名。已弃用以支持类型化数据，但保留是为了向后兼容。

5. eth_sign ：允许原始哈希签名。仅限于具有经过验证的域信誉评分的白名单 dApp。

常见问题解答

问：为什么 Coinbase 钱包在开发过程中拒绝来自本地主机的连接尝试？答：默认情况下，出于安全原因，钱包强制执行仅 HTTPS 来源。开发人员必须使用 mkcert 等工具通过 HTTPS 为其本地 dApp 提供服务，或者使用设置中提供的钱包开发人员模式切换开关。

问：连接后我可以通过编程方式切换网络吗？答：是的，通过wallet_switchEthereumChain RPC 方法。在应用更改之前，钱包会显示一个确认屏幕，列出目标链 ID、区块浏览器 URL 和本机货币符号。

问：如果用户在连接时更改钱包内选择的帐户，会发生什么情况？答：钱包会发出一个包含新地址数组的accountsChanged事件。 DApp 必须侦听此事件并相应地更新 UI 元素，而无需重新连接。

问：是否可以在不触发连接提示的情况下检测Coinbase钱包是否安装？答：是的，在调用任何激活方法之前检查是否存在window.ethereum?.isCoinbaseWallet 。仅当检测到官方钱包扩展或移动应用程序时，此属性才返回 true。