/cosmwasm-examples

Example contracts for using cosmwasm

Primary LanguageRustApache License 2.0Apache-2.0

Cosmwasm Examples

CircleCI

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 cosmwasm-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.

Usage:

The following contracts are available for use. You can view the source code under src and a precompiled wasm ready for deployment under 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

Development

Starting a contract

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

cargo generate --git https://github.com/confio/cosmwasm-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).

Preparing for merge

Before you merge the code, make sure it builds and passes all tests, both in the package, and when calling it from the root packages cargo wasm && cargo test. This should show your package is covered by the CI.

There is also quite some useful information in Development.md and Publishing.md in the newly generated contract.

You should also prepare a compiled contract.wasm before each merge to master. This is not enforced by the CI (a full build each commit), but should be tested on merge. See rust-optimizer for an explanation of how to make a deterministic build.

rm -rf artifacts

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.10.1

# verify output - these should be the same
sha256sum artifacts/*.wasm
cat artifacts/checksums.txt

If the sha256 hash changes without any code changes, even when compiling on different machines, or removing those cache volumes, then please submit an issue on rust-optimizer.

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