PoE Contracts

This repo maintains contracts and support libraries for building the Tgrade PoE contracts. These are not available under an open source license, you need permission from Confio to use them.

It is organized like cosmwasm-plus. You can use that as a reference.

Compiling

To compile all the contracts, run the following in the repo root:

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/workspace-optimizer:0.12.4

This will compile all packages in the contracts directory and output the stripped and optimized wasm code under the artifacts directory as output, along with a checksums.txt file.

If you hit any issues there and want to debug, you can try to run the following in each contract dir: RUSTFLAGS="-C link-arg=-s" cargo build --release --target=wasm32-unknown-unknown --locked

Creating a new contract

You can start with cosmwasm-template as a basis:

cd contracts
cargo generate --git https://github.com/CosmWasm/cosmwasm-template.git --name CONTRACT_NAME
cd CONTRACT_NAME

# remove unneeded files
rm -rf .circleci .github .git
rm .cargo-ok .editorconfig .gitignore rustfmt.toml
rm Developing.md Importing.md Publishing.md LICENSE NOTICE

# regenerate schema for CI tests
cargo schema

git add .

Then add it to CI, by editing .circleci/config.yml. Just copy the contract_tgrade_dso section and rename it, pointing to your new contract.

Finally, update Cargo.toml to use the current version used by all other contracts in this repo.

Debugging

Sometimes errors might be not helpful enough, or actual error with vague description might come from depths of other tgrade or cosmwasm related dependencies. In such case you might want to check backtraces.

Make sure you have nightly installed:

$ rustup install nightly

and then run:

$ RUST_BACKTRACE=1 cargo +nightly test --features backtraces

to get more detailed backtraces.