This repo is a collection of simple contracts built with the cosmwasm framework. Smart contracts here are for only demonstration purposes, not production ready. Production grade smart contracts are collected under cw-plus.

This repo's organization is relatively simple. The top-level directory is just a placeholder and has no real code. And we use workspaces to add multiple contracts below. This allows us to compile all contracts with one command.

The following contracts are available for use. For each of the contracts in contracts, you can view the source code under src and a precompiled wasm ready for deployment called contract.wasm.

Take a look here:

• escrow - A basic escrow with timeout and partial release
• erc20 - Basic implementation the erc20 interface for CosmWasm, as a base for token designers
• nameservice - Simple name service application to buy names and map values to those names
• voting - An example voting contract to create, manage, vote and deposit on polls
• simple-option - A contract that replicates options in finance
• cw20-pot - Basic smart contract using cw20 contact

You can get more info from README.md file in each of the contacts.

If you want to add a contract, first fork this repo and create a branch for your PR. I suggest setting it up via cw-template:

cargo generate --git https://github.com/CosmWasm/cw-template.git --name FOO

Then update the README.md to reflect your actual contract (just read the README.md in the autogenerated template - it explains a lot).

Before you merge the code, make sure it builds and passes all tests:

./devtools/build_test_all.sh

Once you pass these checks, please open a PR on this repo.

On every tag release builds are automatically created and deployed to GitHub Releases.

You can build release artifacts manually like this, which creates a reproducible optimized build for each contract and saves them to the ./artifacts directory:

docker run --rm -v "$(pwd)":/code \
  --mount type=volume,source="$(basename "$(pwd)")_cache",target=/code/target \
  --mount type=volume,source=registry_cache,target=/usr/local/cargo/registry \
  cosmwasm/rust-optimizer:0.12.3 ./contracts/*/