跳转至

创建合约订单

请求

POST https://api.mycactus.dev/custody/v1/api/projects/{b_id}/contract/call
POST https://api.mycactus.com/custody/v1/api/projects/{b_id}/contract/call

参数

路径参数

字段 类型 描述

b_id
必填

String 业务线ID

请求体参数

字段类型描述
order_no
必填
String订单号(最多 50 个字符)
from_wallet_code
必填
String来源钱包ID
from_address
必填
String来源地址
to_address
必填
String合约地址
amount
必填
Decimal金额
chain
必填
StringCactus链名称
允许值:参考币种列表中的网络缩写列
contract_data
必填
String合约数据(十六进制字节)
gas_limit
必填
String参考合约建议的gas限制。
fee_rate_level
可选
StringETH系列费率等级
允许值:NORMAL, HIGHER, LOW, CUSTOM
fee_rate
可选
Decimal当使用 CUSTOM 费率类型时,需要传入具体的 fee_rate_level 参数。其可用范围可通过 查询提币费率范围获取。对于 EIP1559 系列,该参数等同于 MaxFeeRate。
max_fee_per_gas
可选
Decimal最大费用
max_priority_fee_per_gas
可选
Decimal优先费用
description
可选
String订单描述(最多 50 个字符)

字段类型描述
order_no
必填
String订单号(最多 50 个字符)
from_wallet_code
必填
String来源钱包ID
from_address
必填
String来源地址
amount
必填
Decimal金额。
允许值:0
chain
必填
StringCactus链名称
允许值:SOLANA
contract_instructions
必填
ListSolana智能合约指令
sign_trans
可选
BooleanSolana签名交易。
如果该字段设置为 true,交易仅会进行签名,不会广播到区块链。要获取签名结果,请使用 获取智能合约交易详情 接口,并查看 contract_instructions 字段。
description
可选
String订单描述(最多 50 个字符)

字段类型描述
order_no
必填
String订单号 (最多 50 个字符)
from_wallet_code
必填
String来源钱包 ID
from_address
必填
String来源地址
amount
必填
Decimal允许值: 0
chain
必填
StringCactus 链名称
允许值: STELLAR
contract_data
必填
StringStellar 合约数据(JSON)。包含两个字段:opts(交易发起者地址,用于身份验证、手续费扣除及序列号控制)和 xdr(XDR 编码的交易信封)。请参考请求体示例。
description
可选
String订单描述 (最多 50 个字符)
fee_rate_level
可选
String允许值: NORMAL, HIGHER, LOW, CUSTOM
fee_rate
可选
Decimal当使用 CUSTOM 费率类型时,需要传入具体的 fee_rate_level 参数。其可用范围可通过 查询提币费率范围获取。

字段类型描述
order_no
必填
String订单号(最多 50 个字符)
from_wallet_code
必填
String来源钱包ID
from_address
必填
String来源地址
chain
必填
StringCactus链名称
允许值:SUI
amount
必填
Decimal金额
允许值:0
contract_data_json
必填
StringJSON 格式的交易数据
contract_data
可选
StringSUI 交易块字节数据(Base64 编码的交易数据)
to_address
可选
String接收方合约地址
description
可选
String订单描述(最多 50 个字符)

请求体示例

{
    "order_no": "D666666000001",
    "from_wallet_code": "CHETH6454313788",
    "from_address": "0x018050e30e4bf1cf79bb8b8c2297aa750da04544",
    "to_address": "0xb597cd8d3217ea6477232f9217fa70837ff667af",
    "amount": "0",
    "chain": "ETH",
    "contract_data": "0x095ea7b3000000000000000000000000f2fbf9a6710afda1c4aab2e922de9d69e0c97fd2ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
    "gas_price_level": "NORMAL",
    "gas_price": null,
    "gas_limit": 52418,
    "description": "Contract call test"
}
{
    "order_no": "SOLANA0001",
    "from_wallet_code": "DeFiSOL4504203001",
    "from_address": "7TsrCQwS7Y8WNhaaSYtY1z3PFDKhouQhZiLDFfKN5KkX",
    "amount": "0",
    "chain": "SOLANA",
    "contract_instructions":[
        {
            "address_table_lookups": [],
            "compiled_instructions": [
                {
                    "account_key_indexes": [
                        0,
                        1
                    ],
                    "data": "2Bxs412MvVNQj111",
                    "program_id_index": 2
                }
            ],
            "header": {
                "num_readonly_signed_accounts": 0,
                "num_readonly_unsigned_accounts": 1,
                "num_required_signatures": 1
            },
            "recent_blockhash": null,
            "sequence": 0,
            "signatures": [
                "1111111111111111111111111111111111111111111111111111111111111111"
            ],
            "static_account_keys": [
                "FsYr6MJTe4HuzPw91cFDWJqR7WLtbsT7xJjPeqHVMPAa",
                "ECaYNZoMuDeUsuowGJSKgzzTm5pnupxiDbtbdLTTwYMa",
                "11111111111111111111111111111111"
            ],
            "version": -1
        }
    ],
    "description": "Contract call for SOLANA"
}

如果提供了 recent_blockhash,该交易必须在获取该 blockhash 后的 60 秒内完成广播,否则将会失效,因此订单提交、审核等流程需及时完成。

如果未提供 recent_blockhash(即为 null),Cactus 会在交易广播前自动补充有效的 blockhash,此时交易不受提交或审核流程延迟的影响。

{
    "order_no": "STELLAR0001",
    "from_wallet_code": "DeFiXLM0000000001",
    "from_address": "GAC2IWR3ETHSJKOQUIRU7PIFE6ZFUQKKGLY5SH3REKB3DTXMSQRC2MRZ",
    "amount": "0",
    "chain": "STELLAR",
    "contract_data": "{\"opts\":{\"address\":\"GAC2IWR3ETHSJKOQUIRU7PIFE6ZFUQKKGLY5SH3REKB3DTXMSQRC2MRZ\",\"network_passphrase\":\"Test SDF Network ; September 2015\"},\"xdr\":\"AAAAAgAAAAAFpFo7JM8kqdCiI0+9BSeyWkFKMvHZH3Eig7HO7JQiLQBwEBkAGFZXAAAAEAAAAAEAAAAAAAAAAAAAAABpxEIWAAAAAAAAAAEAAAAAAAAAGAAAAAAAAAABiBqPDN6w3AqtjeChlK9EkpFXvfiHkiIhITjRV4o74c4AAAAGc3VibWl0AAAAAAAEAAAAEgAAAAAAAAAABaRaOyTPJKnQoiNPvQUnslpBSjLx2R9xIoOxzuyUIi0=\"}"
}

contract_data 字段须以序列化 JSON 字符串格式提交。

{
    "order_no": "TS900900000001",
    "from_wallet_code": "DeFiSUI2422761342",
    "from_address": "0xa806a02b8216f2a8635d8cc7b042f7b394c45bf2c11b6f9671f39c22e483d947",
    "chain": "SUI",
    "amount": "0",
    "contract_data_json": "{\"version\":2,\"sender\":\"0xffd1bcf6cb5b9ed32f7ab........\",\"expiration\":null,\"gasData\":{\"budget\":\"5000000\",\"price\":\"1000\",\"owner\":null,\"payment\":[{\"objectId\":\"0x37afef2ce0014852f4b038dbe20c6fc4b469526f3f365da982a93050c6731497\",\"version\":\"799396354\",\"digest\":\"6G4zV1waF2pPAgqjy5hAmZa6yNPqsEvAgbixiaVjREmm\"}]},\"inputs\":[{\"Object\":{\"SharedObject\":{\"objectId\":\"0x59acb288bfbfb44d9a127e088b00c745733c70306f0b9fcce5d43daaadfdb298\",\"initialSharedVersion\":534215830,\"mutable\":false}}},{\"Pure\":{\"bytes\":\"FiesEE8JAsE68iAB87GnoA7bas79uWkZErodsYIgbh0=\"}},{\"Pure\":{\"bytes\":\"YEOZOwAAAAA=\"}},{\"Object\":{\"SharedObject\":{\"objectId\":\"0x0000000000000000000000000000000000000000000000000000000000000006\",\"initialSharedVersion\":1,\"mutable\":false}}}],\"commands\":[{\"MoveCall\":{\"package\":\"0x9c1718dd14d7d366d9296269b8ba830fccb3d2ea30263b8eaf5609c9ec224b3e\",\"module\":\"mtoken\",\"function\":\"request_mint_to\",\"typeArguments\":[\"0x7b4300310b5d9680105a6e6ec1484e8cb94e779cc261c21dd6c3b6d6416679f1::mt::MT\"],\"arguments\":[{\"Input\":0},{\"Input\":1},{\"Input\":2},{\"Input\":3}]}}],\"digest\":\"4FvMAJzBVCfiq59Ny2bMFQrodBW66TfHMDw3QmziuNJc\"}",
    "contract_data": "",
    "to_address": "",
    "description": ""
}

响应

响应体

字段 类型 描述
code Integer 响应代码(0 = 成功)
message String 响应消息
successful Boolean 请求是否成功
data Object 响应数据(详见下方 data 对象详情)

data (对象)

字段 类型 描述
OrderNo String 订单号

响应示例

{
    "code": 0,
    "message": "",
    "data": {
        "OrderNo": "D555222000000001" //订单号,与请求体参数中声明的一致
    },
    "successful": true
}