05163c3eba
Co-authored-by: Dave Kaj <davidkajpust@informal.systems> Co-authored-by: Ubuntu <big-cycles@quartz-sgx-test-release.vjset0kafl0exefwnpdw0qebjd.bx.internal.cloudapp.net> Co-authored-by: hu55a1n1 <sufialhussaini@gmail.com>
146 lines
3.6 KiB
Markdown
146 lines
3.6 KiB
Markdown
# 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](#install)
|
|
- [Configure from scratch](#configure-from-scratch)
|
|
- [Configure existing](#configure-existing)
|
|
|
|
## Install
|
|
|
|
To build from source, first make sure you have Go installed.
|
|
|
|
For `neutrond`:
|
|
|
|
```bash
|
|
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):
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
neutrond keys add admin
|
|
```
|
|
|
|
This should output a neutron address.
|
|
|
|
Now create the genesis file.
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```toml
|
|
[rpc]
|
|
laddr = "tcp://0.0.0.0:26657"
|
|
cors_allowed_origins = ["*"]
|
|
```
|
|
|
|
And in `~/.neutrond/config/app.toml`:
|
|
|
|
```toml
|
|
[api]
|
|
enable = true
|
|
address = "tcp://0.0.0.0:1317"
|
|
enabled-unsafe-cors = true
|
|
```
|
|
|
|
Now, finally:
|
|
|
|
## neutrond start
|
|
|
|
```bash
|
|
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](/docs/getting_started.md#installation)
|
|
|
|
## 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`:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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](/docs/getting_started.md#installation)
|