如何將核心錢包連接到 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 身分金鑰對進行加密簽署。

常見問題解答

Q：Core Wallet 是否支援自訂 Avalanche 子網路？ Core Wallet 僅支援原生 C-Chain 和 X-Chain 開箱即用互動；子網路整合需要手動 RPC 配置，預設不啟用。

Q：我可以將 Core Wallet 與 Avalanche 的 EVM 相容 L2（例如 AvaxCanary 或 NFTPort）一起使用嗎？是的，前提是這些 L2 公開標準 EVM JSON-RPC 端點並在連接之前在 Core Wallet 的網路註冊表中註冊其鏈 ID。

Q：為什麼在安裝了 MetaMask 的情況下我的 dApp 無法偵測到 Core Wallet？發生這種情況是因為兩個錢包都注入了window.ethereum ；檢測邏輯必須迭代window.ethereum.providers並驗證isCore標誌，而不是僅依賴頂級屬性的存在。

Q：Core Wallet 中是否支援 Avalanche 交易的硬體錢包？ Core Wallet 本身並不會整合 Ledger 或 Trezor 裝置；使用者必須依賴基於瀏覽器的簽章或透過相容橋路由的外部 walletconnect 工作階段。