CosmWasm

WebAssembly Smart Contracts for the Cosmos SDK

Rust crates

The following Rust crates are maintained in this repository:

Crate	Usage	Download	Docs	Coverage
cosmwasm‑check	Contract development
cosmwasm‑core	Internal use only
cosmwasm‑crypto	Internal use only
cosmwasm‑derive	Internal use only
cosmwasm‑schema	Contract development
cosmwasm‑schema‑derive	Internal use only
cosmwasm‑std	Contract development
cosmwasm‑vm	Host environments
cosmwasm‑vm‑derive	Internal use only
cw‑schema	Contract development
cw‑schema‑derive	Internal use only

Dependencies

The following diagram shows the dependencies between the Rust crates in this repository:

---
config:
  theme: 'forest'
---

graph BT
    A("`**cosmwasm-core**
        3.0.6`")

    B("`**cosmwasm-std**
        3.0.6`")

    C("`**cosmwasm-crypto**
        3.0.6`")

    D("`**cosmwasm-vm**
        3.0.6`")

    E("`**cosmwasm-vm-derive**
        3.0.6`")

    F("`**cosmwasm-derive**
        3.0.6`")

    G("`**cosmwasm-schema**
        3.0.6`")

    H("`**cosmwasm-schema-derive**
        3.0.6`")

    I("`**cosmwasm-check**
        3.0.6`")

    J("`**cw-schema**
        3.0.6`")

    K("`**cw-schema-derive**
        3.0.6`")

    A --> B
    A --> C
    A --> D
    C --> B
    C --> D
    B --> D
    E --> D
    F --> B
    H --> G
    B --> I
    D --> I
    G --> B
    J --> B
    J --> G
    K --> J

Overview

To get that contract to interact with a system needs many moving parts. To get oriented, here is a list of the various components of the CosmWasm ecosystem:

Standard library:

This code is compiled into Wasm bytecode as part of the smart contract.

• cosmwasm-std - A crate in this workspace. Provides the bindings and all imports needed to build a smart contract.
• cw-storage-plus - A crate which provides convenience helpers for interacting with storage with powerful types supporting composite primary keys, secondary indexes, automatic snapshotting, and more. This is used in most modern contracts.

Building contracts:

• cosmwasm-template - A starter-pack to get you quickly building your custom contract compatible with the CosmWasm system.
• cosmwasm-plus - Some sample contracts for use and inspiration. These provide usable primitives and interfaces for many use cases, such as fungible tokens, NFTs, multisigs, governance votes, staking derivatives, and more. Look in packages for docs on the various standard interfaces, and contracts for the implementations. Please submit your contract or interface via PR.
• rust-optimizer - A docker image and scripts to take your Rust code and produce the smallest possible Wasm output, deterministically. This is designed for preparing contracts for deployment as well as validating that a given deployed contract is based on some given source code, allowing a similar contract verification algorithm as Etherscan.

Building locally instead of using the docker image can leak some information about the directory structure of your system and makes the build non-reproducible.

Executing contracts:

• cosmwasm-vm - A crate in this workspace. Uses the wasmer engine to execute a given smart contract. Also contains code for gas metering, storing, and caching wasm artifacts.
• wasmvm - High-level go bindings to all the power inside cosmwasm-vm. Easily allows you to upload, instantiate and execute contracts, making use of all the optimizations and caching available inside cosmwasm-vm.
• [wasmd](https://github.com/CosmW