The Router contract contains logic to facilitate multi-hop swaps for Terra native & Astroport tokens.
For every swap, the contract checks if the resulting token is the one that was asked for and whether the receiving amount exceeds the minimum to receive.
Initializes the contract with the Astroport factory contract address.
json
{
"astroport_factory": "terra..."
}
receiveCW20 receive msg.
json
{
"receive": {
"sender": "terra...",
"amount": "123",
"msg": "<base64_encoded_json_string>"
}
}
execute_swap_operationSwaps one token to another. single defines whether this swap is single or part of a multi hop route. This message is for internal use.
Swap UST => mABNB
json
{
"execute_swap_operation": {
"operation": {
"astro_swap": {
"offer_asset_info": {
"native_token": {
"denom": "uusd"
}
},
"ask_asset_info": {
"token": {
"contract_addr": "terra..."
}
}
}
},
"to": "terra...",
"max_spread": "0.05",
"single": false
}
}
execute_swap_operationsPerforms multi-hop swap operations for native & Astroport tokens. Swaps execute one-by-one and the last swap will return the ask token. This function is public (can be called by anyone).
Swap KRT => UST => mABNB
json
{
"execute_swap_operations": {
"operations": [
{
"native_swap":{
"offer_denom":"ukrw",
"ask_denom":"uusd"
}
},
{
"astro_swap": {
"offer_asset_info": {
"native_token": {
"denom": "uusd"
}
},
"ask_asset_info": {
"token": {
"contract_addr": "terra..."
}
}
}
}
],
"minimum_receive": "123",
"to": "terra...",
"max_spread": "0.05"
}
}
assert_minimum_receiveChecks that an amount of ask tokens exceeds minimum_receive. This message is for internal use.
json
{
"assert_minimum_receive": {
"asset_info": {
"token": {
"contract_addr": "terra..."
}
},
"prev_balance": "123",
"minimum_receive": "123",
"receiver": "terra..."
}
}
All query messages are described below. A custom struct is defined for each query response.
configReturns the general configuration for the router contract.
json
{
"config": {}
}
simulate_swap_operationsSimulates multi-hop swap operations. Examples:
json
{
"simulate_swap_operations" : {
"offer_amount": "123",
"operations": [
{
"native_swap": {
"offer_denom": "ukrw",
"ask_denom": "uusd"
}
},
{
"astro_swap": {
"offer_asset_info": {
"native_token": {
"denom": "uusd"
}
},
"ask_asset_info": {
"token": {
"contract_addr": "terra..."
}
}
}
}
]
}
}
json
{
"simulate_swap_operations" : {
"offer_amount": "123",
"operations": [
{
"native_swap": {
"offer_denom": "uusd",
"ask_denom": "ukrw"
}
},
{
"astro_swap": {
"offer_asset_info": {
"token": {
"contract_addr": "terra..."
}
},
"ask_asset_info": {
"native_token": {
"denom": "uusd"
}
}
}
}
]
}
}