cw20-base

Crates.iocw20-base
lib.rscw20-base
version2.0.0
sourcesrc
created_at2020-07-07 08:15:05.053051
updated_at2024-03-26 21:02:31.811019
descriptionBasic implementation of a CosmWasm-20 compliant token
homepagehttps://cosmwasm.com
repositoryhttps://github.com/CosmWasm/cw-plus
max_upload_size
id262213
size152,581
Core Rust Developers (github:cosmwasm:core-rust-developers)

documentation

https://docs.cosmwasm.com

README

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.

Commit count: 3157

cargo fmt