55 releases (6 stable)

new 2.0.0 Mar 26, 2024
1.1.2 Nov 23, 2023
1.1.0 Jun 20, 2023
1.0.1 Dec 19, 2022
0.1.0 Jul 7, 2020

#1429 in Magic Beans

Download history 2817/week @ 2023-12-04 3625/week @ 2023-12-11 3538/week @ 2023-12-18 1539/week @ 2023-12-25 1968/week @ 2024-01-01 3392/week @ 2024-01-08 2446/week @ 2024-01-15 2633/week @ 2024-01-22 3258/week @ 2024-01-29 2916/week @ 2024-02-05 4567/week @ 2024-02-12 3269/week @ 2024-02-19 4078/week @ 2024-02-26 3211/week @ 2024-03-04 4450/week @ 2024-03-11 3408/week @ 2024-03-18

15,358 downloads per month
Used in 94 crates (80 directly)

Apache-2.0

165KB
3.5K SLoC

CW20 Basic

This is a basic implementation of a cw20 contract. It implements the CW20 spec and is designed to be deployed as is, or imported into other contracts to easily build cw20-compatible tokens with custom logic.

Implements:

  • CW20 Base
  • Mintable extension
  • Allowances extension

Running this contract

You will need Rust 1.44.1+ with wasm32-unknown-unknown target installed.

You can run unit tests on this via:

cargo test

Once you are happy with the content, you can compile it to wasm via:

RUSTFLAGS='-C link-arg=-s' cargo wasm
cp ../../target/wasm32-unknown-unknown/release/cw20_base.wasm .
ls -l cw20_base.wasm
sha256sum cw20_base.wasm

Or for a production-ready (optimized) build, run a build command in the the repository root: https://github.com/CosmWasm/cw-plus#compiling.

Importing this contract

You can also import much of the logic of this contract to build another ERC20-contract, such as a bonding curve, overiding or extending what you need.

Basically, you just need to write your handle function and import cw20_base::contract::handle_transfer, etc and dispatch to them. This allows you to use custom ExecuteMsg and QueryMsg with your additional calls, but then use the underlying implementation for the standard cw20 messages you want to support. The same with QueryMsg. You could reuse instantiate as it, but it is likely you will want to change it. And it is rather simple.

Look at cw20-staking for an example of how to "inherit" all this token functionality and combine it with custom logic.

Dependencies

~4.5–6MB
~135K SLoC