创建合约订单¶
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
b_id |
String | 业务线ID |
请求体参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| order_no 必填 | String | 订单号(最多 50 个字符) |
| from_wallet_code 必填 | String | 来源钱包ID |
| from_address 必填 | String | 来源地址 |
| to_address 必填 | String | 合约地址 |
| amount 必填 | Decimal | 金额 |
| chain 必填 | String | Cactus链名称 允许值:参考币种列表中的网络缩写列 |
| contract_data 必填 | String | 合约数据(十六进制字节) |
| gas_limit 必填 | String | 参考合约建议的gas限制。 |
| fee_rate_level 可选 | String | ETH系列费率等级 允许值: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 必填 | String | Cactus链名称 允许值:SOLANA |
| contract_instructions 必填 | List | Solana智能合约指令 |
| sign_trans 可选 | Boolean | Solana签名交易。 如果该字段设置为 true,交易仅会进行签名,不会广播到区块链。要获取签名结果,请使用 获取智能合约交易详情 接口,并查看 contract_instructions 字段。 |
| description 可选 | String | 订单描述(最多 50 个字符) |
| 字段 | 类型 | 描述 |
|---|---|---|
| order_no 必填 | String | 订单号 (最多 50 个字符) |
| from_wallet_code 必填 | String | 来源钱包 ID |
| from_address 必填 | String | 来源地址 |
| amount 必填 | Decimal | 允许值: 0 |
| chain 必填 | String | Cactus 链名称 允许值: STELLAR |
| contract_data 必填 | String | Stellar 合约数据(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 必填 | String | Cactus链名称 允许值:SUI |
| amount 必填 | Decimal | 金额 允许值:0 |
| contract_data_json 必填 | String | JSON 格式的交易数据 |
| contract_data 可选 | String | SUI 交易块字节数据(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 | 订单号 |