#assets #cosmos #helper #coin #tokens #native #representation

cw-asset

Helper library for interacting with Cosmos assets (native coins and CW20 tokens)

18 releases (stable)

3.1.1 Feb 13, 2024
3.0.0 Feb 3, 2023
2.4.0 Nov 8, 2022
2.2.0 Jul 10, 2022
0.3.1 Dec 31, 2021

#1002 in Magic Beans

Download history 766/week @ 2023-12-06 1050/week @ 2023-12-13 755/week @ 2023-12-20 459/week @ 2023-12-27 606/week @ 2024-01-03 645/week @ 2024-01-10 698/week @ 2024-01-17 977/week @ 2024-01-24 897/week @ 2024-01-31 1645/week @ 2024-02-07 1769/week @ 2024-02-14 951/week @ 2024-02-21 1046/week @ 2024-02-28 1548/week @ 2024-03-06 1593/week @ 2024-03-13 1186/week @ 2024-03-20

5,566 downloads per month
Used in 71 crates (38 directly)

Apache-2.0

75KB
1.5K SLoC

cw-asset

A unified representation of various types of Cosmos fungible assets, and helper functions for interacting with them

License

Contents of this repository are open source under Apache 2.0.


lib.rs:

A unified representation of various types of Cosmos fungible assets, and helper functions for interacting with them

Basic usage

The following code generates messages the sends some SDK coins and CW20 tokens to a recipient:

use cosmwasm_std::{Api, Response};
use cw_asset::{Asset, AssetError};

fn transfer_two_assets(api: &dyn Api) -> Result<Response, AssetError> {
    let asset1 = Asset::native("uusd", 12345u128);
    let msg1 = asset1.transfer_msg("recipient_addr")?;

    let asset2 = Asset::cw20(api.addr_validate("token_addr")?, 67890u128);
    let msg2 = asset1.transfer_msg("recipient_addr")?;

    Ok(Response::new()
        .add_message(msg1)
        .add_message(msg2)
        .add_attribute("asset_sent", asset1.to_string())
        .add_attribute("asset_sent", asset2.to_string()))
}

Asset list

An AssetList struct is also provided for dealing with multiple assets at the same time:

use cosmwasm_std::{Api, Response};
use cw_asset::{Asset, AssetError, AssetList};

fn transfer_multiple_assets(api: &dyn Api) -> Result<Response, AssetError> {
    let assets = AssetList::from(vec![
        Asset::native("uusd", 12345u128),
        Asset::cw20(api.addr_validate("token_addr")?, 67890u128),
    ]);

    let msgs = assets.transfer_msgs(api.addr_validate("recipient_addr")?)?;

    Ok(Response::new().add_messages(msgs).add_attribute("assets_sent", assets.to_string()))
}

Use in messages

Asset and AssetList each comes with an unchecked counterpart which contains unverified addresses and/or denoms, and implements traits that allow them to be serialized into JSON, so that they can be directly used in Cosmos messages:

use cosmwasm_schema::cw_serde;
use cw_asset::AssetUnchecked;

#[cw_serde]
pub enum ExecuteMsg {
    Deposit {
        asset: AssetUnchecked,
    },
}

Although Asset and AssetList also implement the related traits, hence can also be used in messages, it is not recommended to do so; it is a good security practice to never trust addresses passed in by messages to be valid. Instead, also validate them yourselves:

use cosmwasm_std::{Api, StdResult};
use cw_asset::{Asset, AssetError, AssetUnchecked};

const ACCEPTED_DENOMS: &[&str] = &["uatom", "uosmo", "uluna"];

fn validate_deposit(api: &dyn Api, asset_unchecked: AssetUnchecked) -> Result<(), AssetError> {
    let asset: Asset = asset_unchecked.check(api, Some(ACCEPTED_DENOMS))?;
    Ok(())
}

Dependencies

~6MB
~137K SLoC