Skip to main content
Version: 0.16



Synopsis CosmWasm is a new smart contracting platform built for the cosmos ecosystem. If you haven't yet heard of it, please check out this intro. The purpose of this documentation is to give a deep dive into the technology for developers who wish to try it out or integrate it into their product. Particularly, it is aimed at Go developers with experience with the Cosmos SDK, as well as Rust developers looking for a blockchain platform.

How to use CosmWasm

CosmWasm is written as a module that can plug into the Cosmos SDK. This means that anyone currently building a blockchain using the Cosmos SDK can quickly and easily add CosmWasm smart contracting support to their chain, without adjusting existing logic. We also provide a sample binary of CosmWasm integrated into the gaiad binary, called wasmd, so you can launch a new smart-contract enabled blockchain out of the box, using documented and tested tooling and the same security model as the Cosmos Hub.

You will need a running blockchain to host your contracts and use them from an app. We will explain how to connect to a testnet or set up a local "dev net" in a later section. And plan to soon release a hosted testnet, to which all developers can simply upload their contracts, in order to easy run a demo and to share their contract with others.


  • Getting Started dives you into hands-on training. It gently leads you through modifying, deploying, and executing a smart contract on a local blockchain. It is the ideal place to go through and get acquainted with all the aspects of the system, without too much hard work coding.

  • Architecture explains much of the high-level design and 03-architecture of CosmWasm. Before you start designing systems, it is good to understand the mental model and capabilities of the system. If you just want to get your hands dirty with working code, you can skip this section for now and come back later when you are ready to ponder design.

  • Learn will demonstrate developing smart contracts from zero to production with step by step explanations, code snippets, scripts and more.

  • Workshops has great collection of demonstrations and verbal explanation of CosmWasm tech stack recorded by our team in various events and organisations.

  • Plus is for state of art CosmWasm smart contracts.

  • IBC is for all the things related to CosmWasm and IBC. Relayers, Active Network Connections, IBC enabled smart contracts and more.

Further Studies

you can dig into our code and start writing your own contracts:

There are quite a few high level articles on medium that explain the various components of our stack and where we are going.

Many thanks to the Interchain Foundation for funding most of the development work to bring CosmWasm to production.