跳到內容

通訊協定

本頁列出 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>

請求錢包在鏈下對任意位元組資料進行簽署:

type SignMessageRequest = {
account: `d9net:${string}:${string}`;
message: `0x${string}`; // 0x 開頭的十六進位編碼位元組
};
type SignMessageResponse = {
account: `d9net:${string}:${string}`;
chainId: string;
signature: `0x${string}`; // 十六進位編碼的密碼學簽章
};

請求使用者對 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 廣播
};

請求 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}`;
};
};