签名合约订单¶
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| b_id 必填 | String | 业务线ID |
| wallet_code 必填 | String | DeFi钱包ID |
管理员需要在 DeFi 账户 - EVM 白名单保护下启用"消息签名"功能才能执行此 API 调用。
请求体参数
| 字段 | 类型 | 描述 |
|---|---|---|
| order_no 必填 | String | 订单号 |
| address 必填 | String | 地址 |
| signature_version 必填 | String | 签名类型,参考 METAMASK官方文档 了解更多详情 允许值: V4, personalSign |
| payload 必填 | JsonNode | 签名信息。查看EVM兼容链的格式 |
| chain 必填 | String | Cactus链名称 允许值:参考支持的代币中的网络符号 列 |
| description 可选 | String | 描述 (最多50个字符) |
请求体示例
EVM request.json
{
"address": "0x115eb8585ad0cfA18e1b7Fd39Dfc5c655adF8fB8",
"signature_version": "personalSign",
"payload": {"message": "0x2ca3vaa3....."},
"chain": "ETH",
"order_no": "D00000000001",
"description": ""
}
要获取签名结果,请使用获取智能合约交易详情API并提供orderNo。结果将在 signed_data 字段中返回。
请求体参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
order_no |
String | 订单号 |
address |
String | 地址 |
signature_version |
String | 签名类型 |
payload |
JsonNode | 签名信息。查看BTC链的格式 |
chain |
String | Cactus链名称 |
description |
String | 描述 (最多50个字符) |
BTC链签名类型
| signature_version | 描述 |
|---|---|
| signMessage | 仅消息签名 |
| signPsbt | 交易签名 |
| signPsbts | 多笔交易签名 |
请求体示例
BTC request.json
{
"address": "tb1pkhduwswuk7qhx77djyt730dp77tjrc8ullftfyr2deaa635d55ns04zext",
"signature_version": "signMessage",
"payload": {"text": "hello world~"},
"chain": "BTC",
"order_no": "TX00000000002",
"description": ""
}
要获取签名结果,请使用获取智能合约交易详情API并提供orderNo。结果将在 signed_data 字段中返回。
管理员需要在 DeFi 账户 - Cosmos 生态白名单保护下启用"消息签名"功能才能执行此 API 调用。
请求体参数
| 字段 | 类型 | 描述 |
|---|---|---|
order_no |
String | 订单号 |
address |
String | 地址 |
signature_version |
String | 签名类型 |
payload |
JsonNode | 签名信息。查看基于Cosmos链的格式 |
chain |
String | Cactus链名称 |
description |
String | 描述 (最多50个字符) |
Cosmos签名类型
| signature_version | 描述 |
|---|---|
| signAmino | 传统JSON交易签名 |
| signDirect | Protobuf(现代)交易签名 |
| signArbitrary | 任意数据/消息签名 |
请求体示例
Cosmos request.json
{
"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": [
{
"type": "cosmos-sdk/MsgSend",
"value": {
"from_address": "cosmos1...",
"to_address": "cosmos1...",
"amount": [
{ "denom": "uatom", "amount": "1000000" }
]
}
}
]
},
"chain": "COSMOS",
"order_no": "D00000000001",
"description": ""
}
要获取签名结果,请使用获取智能合约交易详情API并提供orderNo。结果将在 signed_data 字段中返回。
响应¶
响应体¶
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应代码(0 = 成功) |
| message | String | 响应消息 |
| successful | Boolean | 请求是否成功 |
| data | Object | 响应数据(详见下方 data 对象详情) |
data (对象)
| 字段 | 类型 | 描述 |
|---|---|---|
| OrderNo | String | 订单号 |