4 releases (2 stable)

1.0.4 Mar 26, 2024
1.0.4-astroport-v2 Dec 7, 2023
1.0.3 Oct 23, 2023
1.0.3-astroport-v2 Oct 31, 2023

#8 in #liquidity

Download history 91/week @ 2024-04-14 110/week @ 2024-04-21 106/week @ 2024-04-28 88/week @ 2024-05-05 39/week @ 2024-05-12 39/week @ 2024-05-19 48/week @ 2024-05-26 193/week @ 2024-06-02 23/week @ 2024-06-09 61/week @ 2024-06-16 44/week @ 2024-06-23 49/week @ 2024-06-30 36/week @ 2024-07-07 50/week @ 2024-07-14 84/week @ 2024-07-21 62/week @ 2024-07-28

232 downloads per month
Used in 4 crates (via cw-it)

GPL-3.0-only

580KB
13K SLoC

Astroport Liquidity Manager

The Astroport Liquidity Manager is a contract that allows users to provide and withdraw liquidity from the Astroport xyk and stable pools with additional slippage limit enforcement. This contract is meant to be non-upgradable and standalone. It depends only on the actual Astroport factory address. Liquidity Manager also exposes provide/withdraw simulation queries for xyk and stable pools.


InstantiateMsg

Initializes the contract with the Astroport factory contract address.

{
  "astroport_factory": "wasm1..."
}

ExecuteMsg

receive

CW20 receive msg. Handles only withdraw messages which should come from Astroport LP tokens.

{
  "receive": {
    "sender": "wasm...",
    "amount": "123",
    "msg": "<base64_encoded_json_string>"
  }
}

where <base64_encoded_json_string> is a base64 encoded json string of the following format:

{
  "withdraw_liquidity": {
    "pair_msg": {
      "withdraw_liquidity": {}
    },
    "min_assets_to_receive": [
      {
        "info": {
          "native_token": {
            "denom": "uusd"
          }
        },
        "amount": "100000"
      },
      {
        "info": {
          "token": {
            "contract_addr": "wasm1...cw20address"
          }
        },
        "amount": "100000"
      }
    ]
  }
}

min_assets_to_receive enforces after-withdraw check that the user receives at least the specified amount of assets.

provide_liquidity

Provides liquidity through Liquidity Manager with slippage limit enforcement. Handles XYK pair imbalanced provide and returns excess assets to the user.

{
  "provide_liquidity": {
    "pair_addr": "wasm1...",
    "pair_msg": {
      "provide_liquidity": {
        "assets": [
          {
            "info": {
              "native_token": {
                "denom": "uusd"
              }
            },
            "amount": "100000"
          },
          {
            "info": {
              "token": {
                "contract_addr": "wasm1...cw20address"
              }
            },
            "amount": "100000"
          }
        ],
        "slippage_tolerance": "0.02",
        "auto_stake": true,
        "receiver": "wasm1...addr"
      }
    },
    "min_lp_to_receive": "1000"
  }
}

pair_msg is equal to original Astroport provide message for all pools. min_lp_to_receive enforces after-provide check that the user receives at least the specified amount of LP tokens.

QueryMsg

simulate

Simulates liquidity provide or withdraw.

Provide simulation example:

{
  "simulate_provide": {
    "pair_addr": "wasm1...addr",
    "pair_msg": {
      "provide_liquidity": {
        "assets": [
          {
            "info": {
              "native_token": {
                "denom": "uusd"
              }
            },
            "amount": "100000"
          },
          {
            "info": {
              "token": {
                "contract_addr": "wasm1...cw20address"
              }
            },
            "amount": "100000"
          }
        ],
        "slippage_tolerance": "0.02",
        "auto_stake": true,
        "receiver": "wasm1...addr"
      }
    }
  }
}

Withdraw simulation example:

{
  "simulate_withdraw": {
    "pair_addr": "wasm1...addr",
    "lp_tokens": "1000"
  }
}

Dependencies

~13MB
~256K SLoC