Request to create a transaction
POST /1.0/client/create-transaction.
Accepts the following parameters:
This call creates a new transaction in the system and returns the transfer data.
An example of a successful response (HTTP Code 200):
{
"data": {
"id": "feb1443b-83ab-4dcd-9725-400b84555b7c", //transaction ID in the system
"service": "lifi", // service that handles the transaction
"router": "lifi", // router that handles the transaction
"bridge": "cbridge", // bridge that handles the transaction
"status": "new", // transaction status in the system
"transferDataFrom": { // transaction data on the departure network
"network": "POL", // departure network symbol
"crypto": "USDC", // departure token symbol
"decimals": 6, // departure token decimals
"amount": "26773259", // transfer amount
"amountInUsd": "26.77" // transfer amount in USD
},
"transferDataTo": { // transaction data on the destination network
"network": "FTM", // destination network symbol
"crypto": "USDC", // destination token symbol
"decimals": 6, // destination token decimals
"amount": "26741575", // amount to be received
"amountInUsd": "26.74" // amount to be received в USD
},
"transactionData": { // transfer data
"approve": { // data to confirm token withdrawal (if tokens are sent); if native tokens - this block is empty
"data": "0x0", // transfer data, which must be signed with a private key
"addressFrom": "0x4c33c110EA0873c549a6cC1F615bAB9fD7D21263d", // departure address from which the approval is sent
"addressTo": "0x5c59718F693b2FDbC7c3d8449581dC3a8435AA54", // address to which the approval is sent (the address of the token in the departure network)
"gasLimit": "0x11170", // the amount of gas the approval burns (in hex format)
"gasPrice": "0xaa27ae7f5", // gas price in hex format
"nonce": "0x1a", // serial number of the transaction at the address in hex format
"coinValue": "0x0", // the number of native tokens sent upon confirmation
"tokenValue": "0x198870b", // the number of tokens for approval (in hex format)
"chainId": 137 // departure network ID
},
"transfer": { // data for transfer initialization
"data": "0х0", // transfer data, which must be signed with the private key
"addressFrom": "0x4c33c110EA0873c58a6cC1F615bAB9fD7D21263d", // address from which the transfer is initialized
"addressTo": "0x5c59718F693b9FDbC7c3d3149581dC3a8435AA54", // address to which the transfer is initialized (usually a bridge/router contract)
"gasLimit": "0xf6dfe", // the amount of gas the transfer burns (in hex format)
"gasPrice": "0xa8d4dc606", // gas price in hex format
"nonce": "0x1b", // the serial number of the transaction in hex format
"coinValue": "0x0", // the number of native tokens sent upon transfer initialization
"tokenValue": "0x198870b", // the number of tokens sent upon transfer initialization
"chainId": 137 // departure network ID
}
},
"fee": { // bridges and routers fee data
"amount": "4936.000000", // amount of fee in cryptocurrency
"symbol": "USDC", // fee currency symbol
"decimals": 6, // fee currency decimals
"amountInUsd": "0.00" // amount of fee in USD
}
},
"success": true // request success flag
}
Example of sent data validation error (HTTP code 400):
{
"success": false, // request success flag
"message": "Validation error", // error message
"errors": [ // list of errors
{
"field": "networkFrom", // request field, the validation of which ended with an error
"messages": [ // validation error messages
"Field are required"
]
}
]
}
Example of a common request error (HTTP code 400):
{
"success": false, // request success flag
"message": "Not enough balance" // error message
}
Example of server error (HTTP code 500):
{
"success": false, // request success flag
"message": "Internal Server Error" // error message
}
Last updated