DeFi 负载格式¶
本页面提供了在不同区块链生态系统中进行签名操作所需的 JSON 请求格式。
参考签名合约订单 API 端点文档
EVM 兼容链(Ethereum、Polygon、BSC、Avalanche 等)支持两种签名类型:
V4(EIP-712 类型化数据签名)¶
EIP-712 允许使用域分离进行结构化数据签名。
{
"domain": {
"chainId": "5",
"name": "Ether Mail",
"verifyingContract": "0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC",
"version": "1"
},
"message": {
"contents": "Hello, Bob!",
"from": {
"name": "Cow",
"wallets": [
"0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826",
"0xDeaDbeefdEAdbeefdEadbEEFdeadbeEFdEaDbeeF"
]
},
"to": [
{
"name": "Bob",
"wallets": [
"0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB",
"0xB0BdaBea57B0BDABeA57b0bdABEA57b0BDabEa57",
"0xB0B0b0b0b0b0B000000000000000000000000000"
]
}
]
},
"primaryType": "Mail",
"types": {
"EIP712Domain": [
{"name": "name", "type": "string"},
{"name": "version", "type": "string"},
{"name": "chainId", "type": "uint256"},
{"name": "verifyingContract", "type": "address"}
],
"Group": [
{"name": "name", "type": "string"},
{"name": "members", "type": "Person[]"}
],
"Mail": [
{"name": "from", "type": "Person"},
{"name": "to", "type": "Person[]"},
{"name": "contents", "type": "string"}
],
"Person": [
{"name": "name", "type": "string"},
{"name": "wallets", "type": "address[]"}
]
}
}
| 字段 | 描述 |
|---|---|
| domain | 定义签名域(链 ID、合约、版本) |
| message | 要签名的实际数据 |
| primaryType | 要签名的主要类型 |
| types | 结构化数据的类型定义 |
有关 EIP-712 的更多详细信息,请参阅 MetaMask 官方文档.
personalSign
用于任意字符串的简单消息签名。
| 字段 | 描述 |
|---|---|
| message | 要签名的消息的十六进制字符串 |
使用示例
// Personal Sign
const evmPayload = {
address: "0x115eb8585ad0cfA18e1b7Fd39Dfc5c655adF8fB8",
signature_version: "personalSign",
payload: {
message: "0x48656c6c6f20576f726c64" // "Hello World" 的十六进制形式
},
chain: "ETH",
order_no: "SIGN001",
description: "Sign message"
};
await signContract(evmPayload);
比特币签名支持三种不同的操作:
signMessage¶
签署任意文本消息。
| 字段 | 描述 |
|---|---|
| text | 要签名的纯文本消息 |
signPsbt / signPsbts¶
签署一个或多个部分签名的比特币交易(PSBT)。
[
{
"id": 1,
"options": {
"auto_finalized": false,
"to_sign_inputs": [
{
"index": 0,
"address": null,
"public_key": "03b7d09ec077ecdd4dd50c21d68637f0f2bc8f32e8973a7456924308eeba4ecf13",
"sighash_types": null,
"disable_tweak_signer": false
}
]
},
"rawtx": null,
"dapp": "https://stake2.dev.btcs.network/my-staking#btc",
"psbt_hex": "70736274ff010052020000000160aa1a9123351f1a74ba04f861693c0d894cb299ada7170844a3fae53b1643e90000000000feffffff01a5b40d0000000000160014c3fcec007e97b22d72859fb900f8aafe87d676a6d31736670001012b40420f0000000000220020bc30954e24a0f54e027f0d9d8203b1e8304873ce40dfb9eda40e28e8f6bbf20401052004d3173667b17576a914c3fcec007e97b22d72859fb900f8aafe87d676a688ac0000",
"signed_psbt_hex": null
}
]
| 字段 | 描述 |
|---|---|
| id | 交易标识符 |
| options.auto_finalized | 是否自动完成交易 |
| options.to_sign_inputs | 要签名的输入数组 |
| options.to_sign_inputs[].index | 要签名的输入索引 |
| options.to_sign_inputs[].public_key | 用于签名的公钥 |
| options.to_sign_inputs[].sighash_types | 签名哈希类型(可选) |
| psbt_hex | 十六进制格式的 PSBT |
| dapp | 请求签名的 dApp URL |
signPsbt 用于签署单个交易,而 signPsbts 允许在一次调用中签署多个交易。
使用示例¶
基于 Cosmos 的链支持三种签名类型:
signAmino¶
传统 JSON 交易签名(向后兼容)。
{
"account_number": "123",
"chain_id": "cosmoshub-4",
"fee": {
"amount": [
{ "denom": "uatom", "amount": "1000" }
],
"gas": "200000"
},
"memo": "Test transaction",
"msgs": [
{
"type": "cosmos-sdk/MsgSend",
"value": {
"from_address": "cosmos1...",
"to_address": "cosmos1...",
"amount": [
{ "denom": "uatom", "amount": "1000000" }
]
}
}
],
"sequence": "42"
}
| 字段 | 描述 |
|---|---|
| account_number | 区块链上的账户号码 |
| chain_id | 链标识符 |
| fee | 交易费用详情 |
| msgs | 要执行的消息数组 |
| sequence | 账户序列号 |
signDirect¶
现代 Protobuf 交易签名(推荐用于新实现)。
{
"body": {
"messages": [
{
"@type": "/cosmos.bank.v1beta1.MsgSend",
"from_address": "cosmos1...",
"to_address": "cosmos1...",
"amount": [
{ "denom": "uatom", "amount": "1000000" }
]
}
],
"memo": "Test transaction",
"timeout_height": "0",
"extension_options": [],
"non_critical_extension_options": []
},
"auth_info": {
"signer_infos": [
{
"public_key": {
"@type": "/cosmos.crypto.secp256k1.PubKey",
"key": "A3..."
},
"mode_info": {
"single": {
"mode": "SIGN_MODE_DIRECT"
}
},
"sequence": "42"
}
],
"fee": {
"amount": [
{ "denom": "uatom", "amount": "1000" }
],
"gas_limit": "200000",
"payer": "",
"granter": ""
}
},
"chain_id": "cosmoshub-4",
"account_number": "123"
}
| 字段 | 描述 |
|---|---|
| body | 包含消息的交易体 |
| auth_info | 包含签名者详细信息的身份验证信息 |
| chain_id | 链标识符 |
| account_number | 账户号码 |
signArbitrary¶
签署任意数据或消息(不一定是交易)。
{
"chain_id": "cosmoshub-4",
"account_number": "123",
"sequence": "42",
"fee": {
"amount": [],
"gas": "0"
},
"msgs": [
{
"type": "sign/MsgSignData",
"value": {
"signer": "cosmos1...",
"data": "VGhpcyBpcyBhIHRlc3QgbWVzc2FnZQ=="
}
}
],
"memo": ""
}
| 字段 | 描述 |
|---|---|
| msgs | 包含 MsgSignData 消息 |
| msgs[].value.data | Base64 编码的要签名的任意数据 |
| msgs[].value.signer | 签名者的地址 |
signArbitrary 中的 data 字段必须使用 Base64 编码。
使用示例¶
// Sign Amino
const cosmosPayload = {
address: "cosmos1qqp3t4zhpwxp8sjq9j7p42flf4z5r0u9ex7n3k",
signature_version: "signAmino",
payload: {
account_number: "123",
chain_id: "cosmoshub-4",
fee: {
amount: [{ denom: "uatom", amount: "1000" }],
gas: "200000"
},
memo: "Test transaction",
msgs: [/* ... */],
sequence: "42"
},
chain: "COSMOS",
order_no: "SIGN003"
};
await signContract(cosmosPayload);
各种支持的签名版本摘要¶
| 链类型 | 签名版本 | 用例 |
|---|---|---|
| EVM | V4 | 结构化数据签名(EIP-712) |
personalSign | 简单消息签名 | |
| BTC | signMessage | 仅消息签名 |
signPsbt | 单个交易签名 | |
signPsbts | 多个交易签名 | |
| Cosmos | signAmino | 传统 JSON 交易 |
signDirect | 现代 Protobuf 交易 | |
signArbitrary | 任意数据签名 |