EVM(BSC/ETH/Base)交易API

交易步骤

  1. 客户端本地授权inToken给交易Router合约(主币除外)

BSC链 Router合约地址:0x4eadd85e7a6bb368eb1e3fb22b56ecac79e9058f

ETH链 Router合约地址:0x77acf9c55106e20fa41f418e2453cdae7ba62f2f

Base链 Router合约地址:0x574bb43779bfa604f3c5a7d35f82b0dcd9bcf0f9

  1. 调用构造交易API,API将会使用最佳路由拼装交易参数,客户端可使用返回的txContent作为InputData,以及其他需要的参数

  2. 客户端本地进行交易拼装和签名,建议使用EIP-1559arrow-up-right标准进行交易拼装并签名

  3. 调用发送交易API或自行发送交易至链上

签名交易教程 https://docs.ethers.org/v6/api/providers/#Signer-signTransactionarrow-up-right

ethers js库 https://github.com/ethers-io/ethers.jsarrow-up-right

API详情

构造交易

通过用户输入的入参,构造待签名的交易

接口信息:

  • 请求方法:POST

  • 请求路径:/v1/thirdParty/chainWallet/createEvmTx

  • Content-Type:application/json

请求参数:

参数名
类型
是否必须
说明

chain

string

链名称,枚举为bsc/eth/base

creatorAddress

string

交易发起地址

inAmount

string

输入金额,最小精度

inTokenAddress

string

输入代币地址 其中之一必须是主币或USDT

outTokenAddress

string

输出代币地址 其中之一必须是主币或USDT

swapType

string

交易类型,枚举为buy/sell

slippage

string

滑点(百分比) 单位bps,即10000为100%

feeRecipient

string

返佣地址

请求示例:

响应参数:

参数名
类型
说明

status

int

状态码

msg

string

响应消息

data

object

响应数据

data为以下结构体的数组

data字段说明:

参数名
类型
说明

chain

string

链名称,枚举为bsc/eth/base

creatorAddress

string

交易创建者地址,即from地址

swapType

string

交易类型

inTokenAddress

string

输入代币地址

outTokenAddress

string

输出代币地址

toAddress

string

交易to地址

txContent

string

交易内容,作为交易拼装的inputData

slippage

string

滑点(百分比),单位bps

minReturn

string

最小返回数量

inAmount

string

输入数量

estimateOut

string

预估输出数量

gasLimit

string

交易gas limit

amms

string[]

AMM信息

createPrice

string

创建价格,单位USD

requestTxId

string

请求交易id

响应示例:

发送签名后的交易

通过用户输入的入参,发送签名后的交易

接口信息:

  • 请求方法:POST

  • 请求路径:/v1/thirdParty/chainWallet/sendSignedEvmTx

  • Content-Type:application/json

请求参数:

参数名
类型
是否必须
说明

chain

string

链名称,枚举为bsc/。eth/base

requestTxId

string

请求交易id,通过构造交易接口获取

signedTx

string

签名后的交易,使用base64 encode之后的字串

useMev

bool

是否开启防夹

请求示例:

响应参数:

参数名
类型
说明

status

int

状态码

msg

string

响应消息

data

object

响应数据

data为以下结构体的数组

data字段说明:

参数名
类型
说明

hash

string

交易hash

err

string

链上返回的错误信息

响应示例:

Last updated