跳转至

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": "0x2ca3vaa3....."
}
字段 描述
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": "hello world~"
}
字段 描述
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 允许在一次调用中签署多个交易。

使用示例

// Sign Message
const btcPayload = {
  address: "tb1pkhduwswuk7qhx77djyt730dp77tjrc8ullftfyr2deaa635d55ns04zext",
  signature_version: "signMessage",
  payload: {
    text: "Verify ownership of this address"
  },
  chain: "BTC",
  order_no: "SIGN002"
};

await signContract(btcPayload);

基于 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);

各种支持的签名版本摘要

链类型签名版本用例
EVMV4结构化数据签名(EIP-712)
personalSign简单消息签名
BTCsignMessage仅消息签名
signPsbt单个交易签名
signPsbts多个交易签名
CosmossignAmino传统 JSON 交易
signDirect现代 Protobuf 交易
signArbitrary任意数据签名

相关文档