CosmWasm Binaries: Install and Configure

Quartz expects to interact with a CosmWasm-based blockchain. The default/archetypal binary is wasmd. We also use neutrond for the testnet.

Here we describe how to get setup from scratch or how to use an existing wasmd binary/network you have access to.

Install
Configure from scratch
Configure existing

Install

To build from source, first make sure you have Go installed.

Then for wasmd:

git clone https://github.com/cosmwasm/wasmd/
cd wasmd
git checkout v0.45.0
go install ./cmd/wasmd

Or for neutrond:

git clone -b main https://github.com/neutron-org/neutron.git
cd neutron
git checkout v4.0.0
make install

Configure From Scratch

We have to initialize a new chain and load it with some accounts.

We'll assume you're using wasmd but it could be neutrond or any other.

We also have to give the chain a chain ID. We'll use testing.

Run

wasmd init <your name> --chain-id testing

to initialize the local wasmd folder.

Now open the file ~/.wasmd/config/client.toml and change the field keyring-backend from os to test:

toml keyring-backend = "test"

Now, finally, we can create a local admin key for your wasmd. You'll use this to deploy contracts:

wasmd keys add admin

This should output a wasm address.

Now create the genesis file.

# generate a second key for the validator 
wasmd keys add validator

# fund both accounts in genesis 
wasmd genesis add-genesis-account admin 100000000000stake,100000000000ucosm 
wasmd genesis add-genesis-account validator 100000000000stake,100000000000ucosm

# sign genesis tx from validator and compose genesis 
wasmd genesis gentx validator 100000000stake --chain-id testing 
wasmd genesis collect-gentxs

Before finally starting the node, for it to work with the front end, you need to configure CORS.

Configure CORS

In ~/.wasmd/config/config.toml, you'll need to make sure the listen address binds to the public IP (0.0.0.0) and the CORS allows all origins:

[rpc] 
laddr = "tcp://0.0.0.0:26657" 
cors_allowed_origins = ["*"]

And in ~/.wasmd/config/app.toml:

[api] 
enable = true 
address = "tcp://0.0.0.0:1317" 
enabled-unsafe-cors = true

Now, finally:

wasmd start

wasmd start

And you should have a chain making blocks!

You can also reduce the block time by lowering timeout_commit in ~/.wasmd/config/config.toml.

Now that you have the chain running, you can start running the enclave and proxy in other windows.

Return to the getting started guide

Configure Existing

If you want to join an existing testnet you either need to setup a node and sync that testnet or find a node to use.

You'll also need to setup an account and get it funded.

Assuming you're using the Neutron testnet, create a new account called admin:

neutron keys add admin

Now use a faucet or send this address to someone who can give you funds on the tesnet.

If you have funds yourself you can simply transfer them:

neutrond tx bank send <sender key name> <recipient address> <amount>
--chain-id testing -y

One your admin account is funded on the network, return to the getting started guide

3.3 KiB Raw Blame History