Links

Sample Transactions

Overview

Here are some samples of the transaction object that is created in swap service. Rango currently returns four different types of transactions based on the blockchain that the transaction is happening on. This includes:
  • EVM: This type supports all Ethereum-based blockchains, including Ethereum, BSC, Polygon, Fantom, Harmony, Avalanche, etc.
  • COSMOS: Rango uses this, as the name indicates, for all the cosmos-based networks, including the Cosmos itself, Osmosis, Akash, etc. + Thorchain/Terra and Binance Chain (BNB network)
  • TRANSFER: This type is mostly used for UTXO blockchains, including BTC, LTC, BCH, DOGE, etc.
  • TRON: For Tron Transactions.
  • STARKNET: This type is used for starknet transactions.
  • SOLANA: For different types of Solana transactions.
Let's see some examples here.
Here is the structure of an EVM transaction:
"tx": {
// This fields equals to EVM for all EVM Transactions
"type": "EVM",
// The blockchain that this transaction is going to run in
"blockChain": {
"name": "FANTOM",
"defaultDecimals": 18,
"addressPatterns": [
"^(0x)[0-9A-Fa-f]{40}$"
],
"feeAssets": [
{
"blockchain": "FANTOM",
"symbol": "FTM",
"address": null
}
],
"type": "EVM",
"chainId": "250"
},
// The source wallet address, can be null
"from": "0xeb2629a2734e272bcc07bda959863f316f4bd4cf",
// Address of dex/bridge smart contract that is going to be called
"txTo": "0x2a7813412b8da8d18Ce56FE763B9eb264D8e28a8",
// Address of source token erc20 contract for increasing approve amount
"approveTo": null,
// The data of approve transaction (null value means no approve needed)
"approveData": null,
// The data of main transaction, it can be null in case of native token transfer
"txData": "0x0b320d9500000000000000000000000000000000000000000000000000000000000000000000000000000000000000006626c47c00f1d87902fc13eecfac3ed06d5e8d8a00000000000000000000000000000000000000000000000566fb0f266083987400000000000000000000000000000000000000000000000004cc4f07028c678c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000034d8edb091aed6929f535b0f06407964e2b935cc000000000000000000000000000000000000000000000000000000000000003800000000000000000000000000000000000000000000000000000181a0615b7d0000000000000000000000000000000000000000000000000000000000007917000000000000000000000000000000000000000000000000054da24e2a77c01e000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000f491e7b69e4244ad4002bc14e878a34207e38c29000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e47ff36ab50000000000000000000000000000000000000000000000078bed27ba3317dd2a00000000000000000000000000000000000000000000000000000000000000800000000000000000000000002a7813412b8da8d18ce56fe763b9eb264d8e28a80000000000000000000000000000000000000000000000000000000062b871de000000000000000000000000000000000000000000000000000000000000000200000000000000000000000021be370d5312f44cb42ce377bc9b8a0cef1a4c830000000000000000000000006626c47c00f1d87902fc13eecfac3ed06d5e8d8a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000038000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010ed43c718714eb63d5aa57b78b54704e256024e0000000000000000000000004691937a7508860f876c9c0a2a617e7d9e945d4b000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c00000000000000000000000000000000000000000000000001af7aa59c0e923100000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000062b875630000000000000000000000000000000000000000000000000000000000000001000000000000000000000000eb2629a2734e272bcc07bda959863f316f4bd4cf0000000000000000000000002702d89c1c8658b49c45dd460deebcc45faec03c00000000000000000000000000000000000000000000000000000000000002200000000000000000000000001f5aaeedaa649712ccca0af8b3af0a4721c58cd2000000000000000000000000cb2a1486bcec00242b8e1934d2cb6a8075da18d900000000000000000000000000000000000000000000000000000000000000020000000000000000000000004691937a7508860f876c9c0a2a617e7d9e945d4b000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000010000000000000000000000007e8a8b130272430008eca062419acd8b423d339d",
// The amount of transaction in case of native token transfer
"value": "0x57115007b8d87c01e",
// The suggested gas limit for this transaction
"gasLimit": "0x9eb10",
// The suggested gas price for this transaction
"gasPrice": "3308471992",
// Recommended max priority gas price (only for Ethereum and Polygon)
"priorityGasPrice": null,
// Max gas price for Ethereum (max value for BaseGasPrice + PriorityGasPrice)
"maxGasPrice": null
}

2. COSMOS Sample Transaction:

For cosmos, we have two type of transactions based on signType field: AMINO and DIRECT.
"tx": {
// This fields equals to COSMOS for all COSMOS Transactions
"type": "COSMOS",
// Source wallet address for this transaction
"fromWalletAddress": "osmo1unf2rcytjxfpz8x8ar63h4qeftadptg5t0nqcl",
// The blockchain that this transaction is going to run in
"blockChain": "OSMOSIS",
// A real cosmos message, most fields of this object should be directly passed
// to wallet for signing by user, the important part is msgs field that contains
// all the cosmos actions that should be performed.
"data": {
"chainId": "osmosis-1",
"account_number": 102721,
"sequence": "686",
"msgs": [
{
"type": "osmosis/gamm/swap-exact-amount-in",
"value": {
"sender": "osmo1unf2rcytjxfpz8x8ar63h4qeftadptg5t0nqcl",
"routes": [
{
"pool_id": "5",
"token_out_denom": "ibc/9712DBB13B9631EDFA9BF61B55F1B2D290B2ADB67E3A4EB3A875F3B6081B3B84"
},
{
"pool_id": "6",
"token_out_denom": "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2"
}
],
"token_in": {
"denom": "uosmo",
"amount": "1000000"
},
"token_out_min_amount": "49999"
}
}
],
"protoMsgs": [
{
"type_url": "/osmosis.gamm.v1beta1.MsgSwapExactAmountIn",
"value": [
10,
43,
// ...
]
}
],
"memo": "",
"source": null,
"fee": {
"gas": "900000",
"amount": [
{
"denom": "uosmo",
"amount": "22500"
}
]
},
// Sign type, could be AMINO or DIRECT
"signType": "AMINO",
"rpcUrl": null
},
// An alternative to CosmosMessage object for the cosmos wallets
// that do not support generic Cosmos messages
"rawTransfer": null
}
}
"tx": {
// This fields equals to COSMOS for all COSMOS Transactions
"type": "COSMOS",
// Source wallet address for this transaction
"fromWalletAddress": "juno1unf2rcytjxfpz8x8ar63h4qeftadptg54xrtf3",
"blockChain": "JUNO",
"data": {
"chainId": "juno-1",
"account_number": 125507,
"sequence": "309",
"msgs": [
{
"typeUrl": "/cosmwasm.wasm.v1.MsgExecuteContract",
"value": {
"sender": "juno1unf2rcytjxfpz8x8ar63h4qeftadptg54xrtf3",
"contract": "juno1pctfpv9k03v0ff538pz8kkw5ujlptntzkwjg6c0lrtqv87s9k28qdtl50w",
"msg": "eyJleGVjdXRlX3N3YXBfb3BlcmF0aW9ucyI6eyJvcGVyYXRpb25zIjpbeyJ3eW5kZXhfc3dhcCI6eyJhc2tfYXNzZXRfaW5mbyI6eyJuYXRpdmUiOiJpYmMvQzRDRkY0NkZENkRFMzVDQTRDRjRDRTAzMUU2NDNDOEZEQzlCQTRCOTlBRTU5OEU5QjBFRDk4RkUzQTIzMTlGOSJ9LCJvZmZlcl9hc3NldF9pbmZvIjp7Im5hdGl2ZSI6InVqdW5vIn19fV0sIm1heF9zcHJlYWQiOiIwLjAxIn19",
"funds": [
{
"denom": "ujuno",
"amount": "1000000"
}
]
}
}
],
"protoMsgs": [],
"memo": "",
"source": null,
"fee": {
"gas": "1000000",
"amount": [
{
"denom": "ujuno",
"amount": "2500"
}
]
},
// Sign type, could be AMINO or DIRECT
"signType": "DIRECT",
"rpcUrl": "https://rpc-juno.itastakers.com:443/"
},
"rawTransfer": null
}
Here is the structure of an UTXO (Transfer) transaction:
"tx": {
// This fields equals to TRANSFER for all UTXO Transactions
"type": "TRANSFER",
// The method that should be passed to wallet including deposit, transfer
"method": "transfer",
// Source wallet address that can sign this transaction
"fromWalletAddress": "qruy9zr8x9k335pkvqpfas3jsjfesq5gzu4nreyn4j",
// Destination wallet address that the fund should be sent to
"recipientAddress": "qzumtx6ufk3qu92slcsg5ajehujehzcquydmhaq0eh",
// The memo of transaction, can be null
"memo": "=:ETH.ETH:0x6f33bb1763eebead07cf8815a62fcd7b30311fa3:1080176077:rg:0",
// The machine-readable amount of transaction
"amount": "10000000000",
// The decimals of the asset
"decimals": 8,
// An asset with its ticker
"asset": {
"blockchain": "BCH",
"symbol": "BCH",
"address": null,
"ticker": "BCH"
}
}
Here is the structure of a Tron transaction:
"tx": {
// This fields equals to TRON for all TRON Transactions
"type": "TRON",
// Transaction blockchain
"blockChain": {
"name": "TRON",
"defaultDecimals": 18,
"addressPatterns": [
"^T[1-9A-HJ-NP-Za-km-z]{33}$"
],
"feeAssets": [
{
"blockchain": "TRON",
"symbol": "TRX",
"address": null
}
],
"type": "TRON",
"chainId": "728126428"
},
// The data of smart contract call
"raw_data": {
"contract": [
{
"parameter": {
"value": {
"data": "b24ebddb000000000000000000000000000000000000000000000000000000000001160500000000000000000000000000000000000000000000000000000189ea5a08a000000000000000000000000000000000000000000000000000000000000f4240",
"owner_address": "414a9bbc3fe169c752a08de9c7becfb4921034ae4a",
"contract_address": "41a2726afbecbd8e936000ed684cef5e2f5cf43008",
"call_value": 1000000
},
"type_url": "type.googleapis.com/protocol.TriggerSmartContract"
},
"type": "TriggerSmartContract"
}
],
"ref_block_bytes": "1091",
"ref_block_hash": "5310b46b57c59d0d",
"expiration": 1691853975000,
"fee_limit": 1500000000,
"timestamp": 1691853916537
},
"approve_raw_data": null,
"raw_data_hex": "0a02109122085310b46b57c59d0d40d8dbebd29e315ad301081f12ce010a31747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e54726967676572536d617274436f6e74726163741298010a15414a9bbc3fe169c752a08de9c7becfb4921034ae4a121541a2726afbecbd8e936000ed684cef5e2f5cf4300818c0843d2264b24ebddb000000000000000000000000000000000000000000000000000000000001160500000000000000000000000000000000000000000000000000000189ea5a08a000000000000000000000000000000000000000000000000000000000000f424070f992e8d29e31900180dea0cb05",
"approve_raw_data_hex": null,
"__payload__": {
"call_value": 1000000,
"contract_address": "41a2726afbecbd8e936000ed684cef5e2f5cf43008",
"fee_limit": 1500000000,
"function_selector": "trxToTokenSwapInput(uint256,uint256,uint256)",
"owner_address": "414a9bbc3fe169c752a08de9c7becfb4921034ae4a",
"parameter": "000000000000000000000000000000000000000000000000000000000001160500000000000000000000000000000000000000000000000000000189ea5a08a000000000000000000000000000000000000000000000000000000000000f4240",
"chainType": 0
},
"approve_payload": null,
"txID": "45a6390a1c1fe80832bd654cbb08bd5c6e804f4fe7f0fc4014421b84280e044c",
"approveTxID": null,
"visible": false,
"approveVisible": null
}
Here is the structure of a StarkNet transaction:
"tx": {
// This fields equals to STARKNET for all STARKNET Transactions
"type": "STARKNET",
// Transaction blockchain
"blockChain": "STARKNET",
// List of calldata to sign a multiple transaction
"calls": [
{
"contractAddress": "0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
"entrypoint": "approve",
"calldata": [
"0x07a6f98c03379b9513ca84cca1373ff452a7462a3b61598f0af5bb27ad7f76d1",
"0x000000000000000000000000000f4240",
"0x00000000000000000000000000000000"
]
},
{
"contractAddress": "0x07a6f98c03379b9513ca84cca1373ff452a7462a3b61598f0af5bb27ad7f76d1",
"entrypoint": "swapExactTokensForTokens",
"calldata": [
"0x000000000000000000000000000f4240",
"0x00000000000000000000000000000000",
"0x00000000000000000000000065434224",
"0x00000000000000000000000000000000",
"2",
"0x49d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
"0xda114221cb83fa859dbdb4c44beeaa0bb37c7537ad5ae66fe5e0efd20e6eb3",
"0x473ab17973104e37d341d8127e1b109e7960443a7b08abb63a76e1e3e405067",
"1691858292"
]
}
],
// List of approves calldata if needed
"approveCalls": null,
// Max fee for the transaction
"maxFee": null
}
Note: Remember to broadcast the signed transaction to Solana rpcs with base64 encoding. The base58 encoding is deprecated, but it is still the default method in Solana docs.
tx": {
// This fields equals to SOLANA for all SOLANA Transactions
"type": "SOLANA",
// Transaction blockchain
"blockChain": "SOLANA",
// Wallet address of transaction initiator
"from": "3HsNMDtxPRUzwLpDJemmNVbasm11Ei5CGGCjktgHh27F",
// Transaction identifier in case of retry
"identifier": "Swap",
// List of instructions
"instructions": [ ],
// Recent blockHash. Nullable. Filled only if message is already partially signed
"recentBlockhash": null,
// List of signatures. Filled only if message is already partially signed
"signatures": [ ],
// When serialized message appears, there is no need for other fields and you just sign and send it
"serializedMessage": [1,0,95,96,...,1,253],
// Can be LEGACY or VERSIONED
"txType": "VERSIONED"
}