如何將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。

常見問題解答

Q：為什麼 Coinbase 錢包在開發過程中拒絕來自本地主機的連線嘗試？答：預設情況下，出於安全原因，錢包強制執行僅 HTTPS 來源。開發人員必須使用 mkcert 等工具透過 HTTPS 為其本機 dApp 提供服務，或使用設定中提供的錢包開發人員模式切換開關。

Q：連接後我可以透過程式切換網路嗎？答：是的，透過wallet_switchEthereumChain RPC 方法。在應用變更之前，錢包會顯示一個確認畫面，列出目標鏈 ID、區塊瀏覽器 URL 和本機貨幣符號。

Q：如果用戶在連線時更改錢包內選擇的帳戶，會發生什麼事？答：錢包會發出一個包含新位址陣列的accountsChanged事件。 DApp 必須偵聽此事件並相應地更新 UI 元素，而無需重新連接。

Q：是否可以在不觸發連線提示的情況下偵測Coinbase錢包是否安裝？答：是的，在呼叫任何啟動方法之前檢查是否存在window.ethereum?.isCoinbaseWallet 。僅當偵測到官方錢包擴充或行動應用程式時，此屬性才會傳回 true。