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, musselnet 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:

• https://rpc.musselnet.cosmwasm.com/status (opens new window)
• https://faucet.musselnet.cosmwasm.com/status (opens new window)
• https://lcd.musselnet.cosmwasm.com/node_info (opens new window)

We have set up two native tokens - FRITES (ufrites) for becoming a validator and MAYO (umayo) for paying fees. Available frontends:

• Block explorer (opens new window)
• Code explorer (opens new window)

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 (opens new window) and Testnet section.

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 musselnet network configurations to the shell:

Copy source <(curl -sSL https://raw.githubusercontent.com/CosmWasm/testnets/master/musselnet/defaults.env)

Setup the client:

Copy # 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:

Copy JSON=$(jq -n --arg addr $(wasmd keys show -a fred) '{"denom":"umayo","address":$addr}') && curl -X POST --header "Content-Type: application/json" --data "$JSON" https://faucet.musselnet.cosmwasm.com/credit JSON=$(jq -n --arg addr $(wasmd keys show -a thief) '{"denom":"umayo","address":$addr}') && curl -X POST --header "Content-Type: application/json" --data "$JSON" https://faucet.musselnet.cosmwasm.com/credit

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.

Copy export NODE="--node https://rpc.musselnet.cosmwasm.com:443" export TXFLAG="$NODE --chain-id musselnet-2 --gas-prices 0.01umayo --gas auto --gas-adjustment 1.3"

Setup Node REPL

Beyond the standard CLI tooling, we have also produced a flexible TypeScript library CosmJS (opens new window), 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 (opens new window), 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.

Full usage and installation instructions are on the README (opens new window), also here are the source codes prepacked with network configurations you can use on-the-fly:

The command below is obsolete and updated soon.

Copy ## musselnet npx @cosmjs/cli@^0.23 --init https://raw.githubusercontent.com/CosmWasm/testnets/master/musselnet/cli_helper.ts

Using the REPL:

Copy // Create or load account const mnemonic = loadOrCreateMnemonic('fred.key') mnemonicToAddress(mnemonic) const { address, client } = await connect(mnemonic, {}) address client.getAccount() // if empty - this only works with CosmWasm hitFaucet(defaultFaucetUrl, address, 'FRITES') client.getAccount()

You need to put RPC endpoint and

Run Local Node (optional)

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

Copy # default home is ~/.wasmd # if you want to setup multiple apps on your local make sure to change this value APP_HOME="~/.wasmd" RPC="http://localhost:26657" CHAIN_ID="localnet" # 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 # add your wallet addresses to genesis wasmd add-genesis-account $(wasmd keys show -a main) 10000000000ucosm,10000000000stake --home ${APP_HOME} wasmd add-genesis-account $(wasmd keys show -a validator) 10000000000ucosm,10000000000stake --home ${APP_HOME} # add fred's address as validator's address wasmd gentx validator --home ${APP_HOME} 1000000000stake --chain-id ${CHAIN_ID} # 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}