如何将核心钱包连接到 Avalanche DeFi 应用程序

核心钱包集成架构

1. Core Wallet 作为符合 EIP-1193 的注入提供商运行，为跨 EVM 兼容链（包括 Avalanche C-Chain）的 dApp 交互提供标准化接口。

2. 钱包将以太坊对象注入全局窗口范围，无需外部 SDK 即可直接访问request 、 on 、 removeListener等方法。

3. Avalanche专用链配置必须预先注册在Core Wallet的网络列表中；缺少条目会触发用户在首次连接期间手动输入 RPC 端点。

4. 签名请求默认遵循 EIP-1559 交易格式，动态 Gas 估算源自 Avalanche 的公共 RPC 端点，例如 https://api.avax.network/ext/bc/C/rpc。

5. 多链支持通过switchEthereumChain方法处理，允许 Avalanche Fuji 测试网和主网之间无缝转换，而无需重新加载 dApp UI。

前端连接流程

1. 使用window.ethereum?.isCore或window.ethereum?.providers?.find(p => p.isCore)检测 Core 钱包是否存在，以将其与 MetaMask 或其他注入的钱包区分开来。

2. 使用ethereum.request({ method: 'eth_requestAccounts' })初始化连接，提示用户批准并返回授权地址数组。

3. 使用ethereum.request({ method: 'eth_getBalance', params: [address, 'latest'] })获取账户余额，通过BigInt转换将结果从十六进制字符串解析为十进制。

4. 通过ethereum.on('chainChanged', handleChainChange)监听网络更改事件，确保 dApp 状态反映当前的 Avalanche 链 ID（主网为 43114，Fuji 为 43113）。

5、通过ethereum.on('accountsChanged',handleAccountsChanged)实现断线处理，检测地址撤销或钱包锁定。

Avalanche DeFi 合约交互

1. 在 Avalanche C-Chain 上部署的智能合约需要 ABI 和合约地址来实例化 Viem 或 ethers.js合约对象以进行读/写操作。

2. 对于 Pangolin 或 Trader Joe 上的代币交换，使用encodeFunctionData构建交易参数，并根据 Uniswap V2 分叉标准编码准确的输入金额、滑点容限和截止日期。

3. 使用已签名的有效负载调用eth_sendTransaction ，该有效负载包含根据 Avalanche 的 Gas 定价模型进行验证的to 、 data 、 value 、 gasLimit和maxFeePerGas字段。

4. 使用eth_getTransactionReceipt轮询或通过ethereum.request({ method: 'eth_subscribe', params: ['newHeads'] })事件订阅来监控交易状态。

5. 通过解析交易收据中嵌入的恢复原因字符串，处理常见的恢复原因，例如流动性不足、截止日期到期或价格影响检查失败。

安全验证清单

1. 确认所有 RPC 调用均源自 Avalanche 的官方端点（而非第三方代理），以防止 DNS 劫持或响应篡改。

2. 在启动任何涉及资金转移或批准的交互之前，根据 Snowtrace.io 上经过验证的来源验证合约地址。

3. 通过检查document.location.origin与 Core Wallet 内部权限数据库中注册的白名单 dApp 域是否匹配来强制执行严格的域绑定。

4. 如果personal_sign或eth_signTypedData_v4响应缺少EIP-191 和EIP-712 规范中定义的匹配前缀模式，则拒绝未签名的消息签名。

5. 禁用由 URL 参数或查询字符串触发的合约调用的自动执行，除非由已知的 dApp 身份密钥对进行加密签名。

常见问题解答

问：Core Wallet 是否支持自定义 Avalanche 子网？ Core Wallet 仅支持原生 C-Chain 和 X-Chain 开箱即用交互；子网集成需要手动 RPC 配置，默认情况下不启用。

问：我可以将 Core Wallet 与 Avalanche 的 EVM 兼容 L2（例如 AvaxCanary 或 NFTPort）一起使用吗？是的，前提是这些 L2 公开标准 EVM JSON-RPC 端点并在连接之前在 Core Wallet 的网络注册表中注册其链 ID。

问：为什么在安装了 MetaMask 的情况下我的 dApp 无法检测到 Core Wallet？发生这种情况是因为两个钱包都注入了window.ethereum ；检测逻辑必须迭代window.ethereum.providers并验证isCore标志，而不是仅仅依赖于顶级属性的存在。

问：Core Wallet 中是否支持 Avalanche 交易的硬件钱包？ Core Wallet 本身并不集成 Ledger 或 Trezor 设备；用户必须依赖基于浏览器的签名或通过兼容桥路由的外部 walletconnect 会话。