Skip to main content
Version: 0.16

Your First Contract

Buckle up, we will now get first-hand experience with CosmWasm, by:

  • Starting up our own CosmWasm-enabled blockchain (just one node for now)
  • Modifying an existing contract
  • Deploying it to our system
  • Executing it via the cli

If you are more of a research first, then get your hands dirty second person, you should go ahead to Architecture. Read it first and then head back here.

We will not dive into smart contract development in this section. You can follow the steps here to test out smart contracts on a testnet without drowning in smart contract development details. We will demonstrate setting up environment, compiling, deploying, and interacting. Then to make things a bit more interesting, we will show modifying the example escrow contract by adding a backdoor to it in the Hijack Escrow tutorial. It exposes an identical API to the original one, but has one hidden command added. This also shows the importance of verifying the source code behind any contract you run.

This is designed for programmers who are comfortable with the command-line and using Linux or MacOS. It is helpful to have a basic understanding of Rust and Go, but we will lead you through, so you need no prior knowledge. The next tutorial, name service will assume knowledge of these basics. And it will show all the development flow from zero to production.


Installation will show you how to setup the required software tooling for CosmWasm.

Setting up Environment will show you how to setup the client environment, and interact with the faucet.

Downloading and Compiling Contract will demonstrate downloading and compiling smart contract code to wasm byte code.

Interacting with Contracts will show deploying, initializing and executing smart contracts.

Next Steps is the last part of the tutorial. It wraps up this section and points you in the direction of further learning.

Dev Academy

Dev Academy is a set of modular and step-by-step educational materials designed to provide a quick start for anyone awho wants to learn and get started with concepts like blockchain, smart contracts, DAOs and more. Dev Academy content can be used at workshops, university courses or at home. By the end, you will have a good understanding of many interesting topics including CosmWasm.

Video Version

The coding sections for smart contracts are also available as a series of videos, leading you through the code structure.