cycles-quartz/docs/neutrond_setup.md

CosmWasm Binaries: Manual Install and Configure

Note - We highly recommend setting up neutrond with the docker image provided. However, we have provided these detailed instructions in case you wanted to take a deeper look.

Quartz expects to interact with a CosmWasm-based blockchain. The default/archetypal binary is neutrond. We have included instructions for wasmd, but it is not supported in the cli today.

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

• Install
• Configure from scratch
• Configure existing

Install

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

For neutrond:

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

For wasmd (NOTE - NOT SUPPORTED BY CLI):

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

Configure From Scratch

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

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

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

Run

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

to initialize the local neutrond folder.

Now open the file ~/.neutrond/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 neutrond. You'll use this to deploy contracts:

neutrond keys add admin 

This should output a neutron address.

Now create the genesis file.

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

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

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

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

Configure CORS

In ~/.neutrond/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 ~/.neutrond/config/app.toml:

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

Now, finally:

neutrond start

neutrond start 

And you should have a chain making blocks!

You can also reduce the block time by lowering timeout_commit in ~/.neutrond/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:

neutrond 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