28 releases (stable)

5.7.0-cw1.0 Oct 28, 2024
5.3.0 Aug 21, 2024
5.2.0 Jul 4, 2024
4.0.3 Jun 19, 2024
0.3.1 Dec 15, 2021

#7 in #asset-info

Download history 2089/week @ 2024-12-02 1733/week @ 2024-12-09 720/week @ 2024-12-16 70/week @ 2024-12-23 56/week @ 2024-12-30 629/week @ 2025-01-06 771/week @ 2025-01-13 1048/week @ 2025-01-20 3415/week @ 2025-01-27 1541/week @ 2025-02-03 2174/week @ 2025-02-10 736/week @ 2025-02-17 713/week @ 2025-02-24 1952/week @ 2025-03-03 4484/week @ 2025-03-10 2540/week @ 2025-03-17

9,706 downloads per month
Used in 45 crates (38 directly)

Apache-2.0

220KB
4.5K SLoC

Astroport: Common Types

This is a collection of common types and queriers which are commonly used in Astroport contracts.

Data Types

AssetInfo

AssetInfo is a convenience wrapper to represent whether a token is the native one (from a specific chain, like LUNA for Terra) or not. It also returns the contract address of that token.

pub enum AssetInfo {
    Token { contract_addr: Addr },
    NativeToken { denom: String },
}

Asset

It contains asset info and a token amount.

pub struct Asset {
    pub info: AssetInfo,
    pub amount: Uint128,
}

PairInfo

It is used to represent response data coming from a Pair-Info-Querier.

pub struct PairInfo {
    pub asset_infos: [AssetInfo; 2],
    pub contract_addr: Addr,
    pub liquidity_token: String,
    pub pair_type: PairType,
}

Queriers

Native Token Balance Querier

It uses the CosmWasm standard interface to query an account's balance.

pub fn query_balance(
    querier: &QuerierWrapper,
    account_addr: impl Into<String>,
    denom: impl Into<String>,
) -> StdResult<Uint128>

Token Balance Querier

It provides a similar query interface to Native-Token-Balance-Querier for fetching CW20 token balances.

pub fn query_token_balance(
    querier: &QuerierWrapper,
    contract_addr: impl Into<String>,
    account_addr: impl Into<String>,
) -> StdResult<Uint128>

Token Supply Querier

It fetches a CW20 token's total supply.

pub fn query_supply(
    querier: &QuerierWrapper,
    contract_addr: impl Into<String>,
) -> StdResult<Uint128>

Pair Info Querier

Accepts two tokens as input and returns a pair's information.

pub fn query_pair_info(
    querier: &QuerierWrapper,
    factory_contract: impl Into<String>,
    asset_infos: &[AssetInfo; 2],
) -> StdResult<PairInfo>

Swap Pairs Simulating

Simulate

Simulates a swap and returns the output amount, the spread and commission amounts.

pub fn simulate(
    querier: &QuerierWrapper,
    pair_contract: impl Into<String>,
    offer_asset: &Asset,
) -> StdResult<SimulationResponse>

Reverse Simulate

Simulates a reverse swap and returns an input amount, the spread and commission amounts.

pub fn reverse_simulate(
    querier: &QuerierWrapper,
    pair_contract: impl Into<String>,
    offer_asset: &Asset,
) -> StdResult<ReverseSimulationResponse>

Dependencies

~16MB
~346K SLoC