跳转到内容

通信协议

本页列出 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}`;
};
};