Skip to main content
Version: 0.14

Setting Up Environment

You need an environment to run contracts. You can either run your node locally or connect to an existing network. For easy testing, oysternet network is online, you can use it to deploy and run your contracts. If you want to setup and run against a local blockchain, click here

To verify testnet is currently running, make sure the following URLs are all working for you:

We have set up two native tokens - STAR (ustar) for becoming a validator and SPONGE (usponge) for paying fees. Available frontends:

You can use these to explore txs, addresses, validators and contracts feel free to deploy one pointing to our rpc/lcd servers and we will list it.

You can find more information about other testnets: CosmWasm/testnets.

When interacting with network, you can either use wasmd which is a Go client or Node REPL. Altough Node REPL is recommended for contract operations, since JSON manipulation is not intuitive with the Shell/Go client.

Setup Go CLI

Let's configure wasmd exec, point it to testnets, create wallet and ask tokens from faucet:

First source the oysternet network configurations to the shell:

source <(curl -sSL

Setup the client:

# add wallets for testing
wasmd keys add fred
"name": "fred",
"type": "local",
"address": "wasm13nt9rxj7v2ly096hm8qsyfjzg5pr7vn5saqd50",
"pubkey": "wasmpub1addwnpepqf4n9afaefugnfztg7udk50duwr4n8p7pwcjlm9tuumtlux5vud6qvfgp9g",
"mnemonic": "hobby bunker rotate piano satoshi planet network verify else market spring toward pledge turkey tip slim word jaguar congress thumb flag project chalk inspire"

wasmd keys add bob
wasmd keys add thief

You need some tokens in your address to interact. If you are using local node you can skip this step. Requesting tokens from faucet:

JSON=$(jq -n --arg addr $(wasmd keys show -a fred) '{"denom":"usponge","address":$addr}') && curl -X POST --header "Content-Type: application/json" --data "$JSON"
JSON=$(jq -n --arg addr $(wasmd keys show -a thief) '{"denom":"usponge","address":$addr}') && curl -X POST --header "Content-Type: application/json" --data "$JSON"

Export wasmd Parameters

If you intend to use wasmd as client, we recommend you to setup these variables. Otherwise You will have to define type in node, chain id and gas-prices details with every command you execute. Also for this tutorial we will use these variables. So make sure you export these before proceeding.

# bash
export NODE="--node $RPC"
export TXFLAG="${NODE} --chain-id ${CHAIN_ID} --gas-prices 0.001usponge --gas auto --gas-adjustment 1.3"

# zsh
export NODE=(--node $RPC)
export TXFLAG=($NODE --chain-id $CHAIN_ID --gas-prices 0.001usponge --gas auto --gas-adjustment 1.3)

If command above throws error, this means your shell is different. If no errors, try running this:

wasmd query bank total $NODE

Setup Node REPL

Beyond the standard CLI tooling, we have also produced a flexible TypeScript library CosmJS, which runs in Node.js as well as in modern browsers and handles queries and submitting transactions. Along with this library, we produced @cosmjs/cli, which is a super-charged Node console. It supports await, does type checking for helpful error messages, and preloads many CosmJS utilities. If you are comfortable with the Node console, you will probably find this easier and more powerful than the CLI tooling.

Using the REPL:

// Create or load account
const mnemonic = loadOrCreateMnemonic('fred.key')

const {address, client} = await connect(mnemonic, {})

// if empty - this only works with CosmWasm
hitFaucet(defaultFaucetUrl, address, 'STAR')

Run Local Node (optional)

If you are interested in running your local network you can use the script below:

# default home is ~/.wasmd
# if you want to setup multiple apps on your local make sure to change this value
# initialize wasmd configuration files
wasmd init localnet --chain-id ${CHAIN_ID} --home ${APP_HOME}

# add minimum gas prices config to app configuration file
sed -i -r 's/minimum-gas-prices = ""/minimum-gas-prices = "0.01ucosm"/' ${APP_HOME}/config/app.toml

# Create main address
# --keyring-backend test is for testing purposes
# Change it to --keyring-backend file for secure usage.
export KEYRING="--keyring-backend test --keyring-dir $HOME/.wasmd_keys"
wasmd keys add main $KEYRING

# create validator address
wasmd keys add validator $KEYRING

# add your wallet addresses to genesis
wasmd add-genesis-account $(wasmd keys show -a main $KEYRING) 10000000000ucosm,10000000000stake --home ${APP_HOME}
wasmd add-genesis-account $(wasmd keys show -a validator $KEYRING) 10000000000ucosm,10000000000stake --home ${APP_HOME}

# add fred's address as validator's address
wasmd gentx validator 1000000000stake --home ${APP_HOME} --chain-id ${CHAIN_ID} $KEYRING

# collect gentxs to genesis
wasmd collect-gentxs --home ${APP_HOME}

# validate the genesis file
wasmd validate-genesis --home ${APP_HOME}

# run the node
wasmd start --home ${APP_HOME}