通訊協定
本頁列出 D9 錢包透過 JSON-RPC(包含注入式提供者與 WalletConnect v2)所使用的協定識別碼與訊息結構,適用於自訂通道處理或伺服器端驗章情境。
| 類別 | 值 |
|---|---|
| 注入式提供者 | window.injectedWeb3['d9-wallet'] |
| WalletConnect 命名空間 | d9net(自訂 CAIP 命名空間) |
| 協定鏈 ID | d9net:000000000000000000000000000000d9 |
| 帳戶 (CAIP-10) | d9net:000000000000000000000000000000d9:<address> |
認證簽發者 iss (DID PKH) |
did:pkh:d9net:000000000000000000000000000000d9:<address> |
d9_signMessage
Section titled “d9_signMessage”請求錢包在鏈下對任意位元組資料進行簽署:
type SignMessageRequest = { account: `d9net:${string}:${string}`; message: `0x${string}`; // 0x 開頭的十六進位編碼位元組};
type SignMessageResponse = { account: `d9net:${string}:${string}`; chainId: string; signature: `0x${string}`; // 十六進位編碼的密碼學簽章};d9_signTransaction
Section titled “d9_signTransaction”請求使用者對 Substrate 交易簽署負載進行簽署:
type SignTransactionRequest = { version: 1; // D9 封套協定版本號 account: `d9net:${string}:${string}`; transaction: { address: string; // 發送者 SS58 位址 blockHash: `0x${string}`; blockNumber: `0x${string}`; era: `0x${string}`; genesisHash: `0x${string}`; // 真實鏈上 32 位元組創世雜湊 method: `0x${string}`; // SCALE 編碼的 Call 位元組 nonce: `0x${string}`; specVersion: `0x${string}`; transactionVersion: `0x${string}`; signedExtensions: string[]; tip: `0x${string}`; version: 4; // Substrate Extrinsic 版本號 };};
type SignTransactionResponse = { version: 1; account: `d9net:${string}:${string}`; chainId: string; signature: `0x${string}`; // SCALE 編碼的 MultiSignature 位元組 signedTransaction?: `0x${string}`; // 選用的完整 Extrinsic 位元組,可直接透過 RPC 廣播};d9_authenticate (CACAO / SIWX)
Section titled “d9_authenticate (CACAO / SIWX)”請求 CAIP-122 登入認證憑證。錢包會向使用者顯示 statement 並對規範 SIWX 訊息進行簽署。請在伺服器端依 登入認證 (SIWX) 驗證回傳的 CACAO 憑證。
type D9Cacao = { h: { t: "caip122"; }; p: { domain: string; aud: string; chain_id: "d9net:000000000000000000000000000000d9"; nonce: string; request_id: string; iss: `did:pkh:d9net:${string}:${string}`; version: "1"; iat: string; // ISO 8601 UTC 時間 exp: string; // ISO 8601 UTC 時間 nbf?: string; statement?: string; resources?: string[]; }; s: { t: "sr25519" | "ed25519" | "ecdsa"; s: `0x${string}`; // 十六進位編碼簽章 public_key?: `0x${string}`; };};