feat: cw20-snapshot

.gitignore

@@ -26,3 +26,5 @@ tarpaulin-report.*
 
 packages/*/schema
 contracts/*/schema
+
+.env

contracts/cw20-snapshot/.cargo/config.toml

@@ -0,0 +1,6 @@
+[alias]
+wasm = "build --release --lib --target wasm32-unknown-unknown"
+wasm-debug = "build --lib --target wasm32-unknown-unknown"
+unit-test = "test --lib"
+integration-test = "test --test integration"
+schema = "run --bin schema"

contracts/cw20-snapshot/Cargo.toml

@@ -0,0 +1,32 @@
+[package]
+name = "cw20-snapshot"
+version = { workspace = true }
+authors = ["Ethan Frey <[email protected]>"]
+edition = "2021"
+description = "Basic implementation of a CosmWasm-20 compliant token"
+license = "Apache-2.0"
+repository = "https://github.com/CosmWasm/cw-plus"
+homepage = "https://cosmwasm.com"
+documentation = "https://docs.cosmwasm.com"
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[features]
+# use library feature to disable all instantiate/execute/query exports
+library = []
+
+[dependencies]
+cosmwasm-schema = { workspace = true }
+cw2 = { workspace = true }
+cw20 = { workspace = true }
+cw-storage-plus = { workspace = true }
+cosmwasm-std = { workspace = true }
+schemars = { workspace = true }
+semver = { workspace = true }
+serde = { workspace = true }
+thiserror = { workspace = true }
+
+[dev-dependencies]
+cw-multi-test = { workspace = true }
+cw-utils = { workspace = true }

contracts/cw20-snapshot/README.md

@@ -0,0 +1,48 @@
+# CW20 Basic
+
+This is a basic implementation of a cw20 contract. It implements
+the [CW20 spec](../../packages/cw20/README.md) and is designed to
+be deployed as is, or imported into other contracts to easily build
+cw20-compatible tokens with custom logic.
+
+Implements:
+
+- [x] CW20 Base
+- [x] Mintable extension
+- [x] 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`](https://github.com/CosmWasm/cw-tokens/tree/main/contracts/cw20-staking) for an example of how to "inherit"
+all this token functionality and combine it with custom logic.