跳转至

签名合约订单

请求

POST https://api.mycactus.dev/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/signatures
POST https://api.mycactus.com/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/signatures

参数

路径参数

字段类型描述
b_id
必填
String业务线ID
wallet_code
必填
StringDeFi钱包ID

管理员需要在 DeFi 账户 - EVM 白名单保护下启用"消息签名"功能才能执行此 API 调用。

请求体参数

字段类型描述
order_no
必填
String订单号
address
必填
String地址
signature_version
必填
String签名类型,参考 METAMASK官方文档 了解更多详情
允许值: V4, personalSign
payload
必填
JsonNode签名信息。查看EVM兼容链的格式
chain
必填
StringCactus链名称
允许值:参考支持的代币中的网络符号 列
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

签名类型
允许值: signMessage, signPsbt, signPsbts

payload
必填

JsonNode 签名信息。查看BTC链的格式

chain
必填

String

Cactus链名称
允许值:BTC

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

签名类型
允许值: signAmino, signDirect, signArbitrary

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 订单号

响应示例

{
    "code": 0,
    "message": "",
    "successful": true,
    "data": {
        "OrderNo": "D00000000001"
    }
}