通信协议
本页列出 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}`; };};