插件錢包 - SDK#
接入前提#
如果尚未下載 KC Wallet 插件錢包,請前往下載頁:如果已下載插件錢包,請檢查你的瀏覽器是否正常運行插件錢包。請複製以下程式碼到瀏覽器的開發者控制台:EVM 鏈#
標準錢包方法#
| 方法 | 参数 | 返回类型 | 描述 |
|---|
| enable | - | Promise | - |
| isConnected | - | boolean | true |
| - | - | Promise | personal_sign 等。callback |
| - | - | - | 鏈id的十六進制表示 |
建立連線#
若要連線錢包,可透過下列程式碼發起「錢包連線」,呼叫 eth_requestAccounts 方法以存取使用者帳戶地址。監聽帳戶地址變化#
每當 eth_accounts RPC 方法的返回值發生變化時,KC Wallet 都會發出對應事件通知 DApp 地址的變化。eth_accounts 會返回一個空陣列或包含單一帳戶地址的陣列;若返回的帳戶地址存在,即為允許呼叫者存取的最近使用帳戶地址。由於呼叫者以其 URL origin 識別,因此具有相同來源(origin)的站點會持有相同的權限。只要使用者公開的帳戶地址發生變化,就會發出 accountsChanged。取得 chainId#
所有遠端程序呼叫(RPC)請求都會提交到目前連線的網路,因此準確取得使用者的鏈 ID 對 EVM 系應用開發至關重要。使用 eth_chainId 方法獲取使用者目前的鏈 ID:監聽 chainChanged 事件以監測使用者更改網路:鏈 ID#
以下為 KC Wallet 預設支援的以太坊鏈 ID。更 多資訊請參考 chainid.network| 十六进位 | 十进位 | 網路 |
|---|
| 0x1 | 1 | Ethereum Main Network (Mainnet) |
| 0x4115 | 166610G | - |
| 0x38 | 56 | BNB Smart Chain |
| 0xa4b1 | - | 42161 Arbitrum One |
| 0xa86a | - | 43114 Avalanche C |
| 0x2105 | - | 8453 Base |
| 0x138de | - | 80094 Berachain |
| 0x659 | - | 1625 Gravity Alpha |
| 0x3e7 | - | 999 HyperEVM |
| 0x141 | - | KuCoin 321 Community Chain |
| 0x8f | - | 143Monad |
| 0x279f | 10143 | Monad Testnet |
| 0xa | - | 10 Optimism |
| 0x18232 | - | 98866 Plume |
| 0x89 | - | 137 Polygon |
| 0x531 | - | 1329 Sei EVM |
| 0x13a7 | - | 5031 Somnia |
| 0xc4 | - | 196 XLayer |
切換鏈#
若要切換目前錢包與 DApp 所連線的鏈,可參考以下範例:訊息簽名#
簽名任意訊息#
personal_sign (通常稱為 signPersonalMessage)用於使用使用者的以太坊私鑰簽名任意文字訊息。簽名結構化資料#
eth_signTypedData (或特指 eth_signTypedData_v4 )用於依據 EIP-712 標準簽名結構化資料。此標準允許應用程式對複雜且結構化的資料建立密碼學簽名,確保簽名既可讀又可驗證。簽名交易#
交易是區塊鏈上的正式動作。在 KC Wallet 中必須透過呼叫 eth_sendTransaction 來發起交易。交易可包含簡單的以太坊轉帳,也可能涉及代幣轉帳、部署新智慧合約,或以任何方式改變鏈上狀態。這些交易必須由外部帳戶的簽名(或簡單密鑰對)發起。在 KC Wallet 中可使用 kcwallet.request 來發起交易。本節主要介紹本文件涉及的交易參數。文件中多數交易參數將由 OKX Wallet 處理。交易分為傳統交易與 EIP-1559 交易,以下依序說明。傳統交易#
EIP-1559 交易#
對於 EIP-1559 交易,相較於傳統交易最大的不同在於以 maxPriorityFeePerGas 與 maxFeePerGas 取代 gasPrice。maxPriorityFeePerGas(可選):使用者願意支付給打包該交易的礦工/驗證者的額外小費,以激勵其優先打包交易。
maxFeePerGas(可選):使用者願意為每單位 gas 支付的最高總費用,包含基礎費與優先費。
Modified at 2026-04-08 03:28:57
