Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
@MarkCherepovskyi
MarkCherepovskyi committed Aug 9, 2024
1 parent e10065d commit 9779081
Showing 1 changed file with 57 additions and 12 deletions.
69 changes: 57 additions & 12 deletions VALIDATOR.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
* Chain id: `bridge_2607-1`
* Bridgeless-core binary (linux/amd64): https://github.com/hyle-team/bridgeless-core/releases/tag/v12.1.8-rc1
* Genesis file: https://github.com/hyle-team/bridgeless-core/blob/chains/devnet/config/genesis.json
* App.toml file: https://github.com/hyle-team/bridgeless-core/blob/chains/devnet/config/app.toml

## Local installation

Expand All @@ -12,13 +13,15 @@ use “https://github.com/hyle-team/bridgeless-core/releases/tag/v12.1.8-rc1”
The binary is built under Alpine linux. If you are using Ubuntu linux, please install musl-dev
using `sudo apt install musl-dev` command to be able to use Alpine binary on your machine

To generate configs file download the core binary file and rename it to `bridgeless-core` if needed.
To generate configs file download the core binary file and rename it to `bridgeless-core` if needed. Then replace the app.toml file with the downloaded file.

Set envs:

export MONIKER_NAME=YOU_VALIDATOR_NAME
export BRIDGELESS_HOME=YOU_CORE_HOME_PATH
export BRIDGELESS_NODE=tcp://167.99.26.8:26657
```bash
export MONIKER_NAME=YOUR_VALIDATOR_NAME
export BRIDGELESS_HOME=YOUR_CORE_HOME_PATH
export BRIDGELESS_NODE=tcp://138.197.236.88:26657 # node1 rpc address
```

Then to init node struct and generate configs u should execute this

Expand All @@ -33,6 +36,10 @@ Create validator private key:
Dont forget to save the mnemonic and address. That address will be used for your validator staking.
Send you address (bridge…) to our team.

Set env:

export LOCAL_VALIDATOR_ADDRESS=bridge...

Please, backup the following files and folders:

$BRIDGELESS_HOME/config/priv_validator_key.json
Expand All @@ -45,7 +52,7 @@ Get the node id:

The next step is a setting peers into config.toml. Find a `persistent_peers` field and set here at least your node
info(`node_id@node_ip:26656`) and one or two the others.
In our case, past should past `[email protected]:26656`. It's good to have at least 3
In our case, should paste yours `node_id@node_ip:26656` and additionally `[email protected]:26656` . It's good to have at least 3
peers.

To run use env variables:
Expand All @@ -59,10 +66,49 @@ To run use env variables:
- name: DAEMON_ALLOW_DOWNLOAD_BINARIES
value: "true"

### Cosmovisor

Download cosmovisor binary file for your architecture from: https://github.com/cosmos/cosmos-sdk/releases/tag/cosmovisor%2Fv1.5.0

mv <path_to_cosmovisor_binary_file> /usr/local/bin/cosmovisor
chmod u+x /usr/local/bin/cosmovisor

To the simplest updates, run a chain using a `cosmovisor` tool.

mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin && cp YOU_STORE_CORE_BIN(name bridgeless-core) $DAEMON_HOME/cosmovisor/genesis/bin && cosmovisor run start --home=$BRIDGELESS_HOME --rpc.laddr tcp://0.0.0.0:26657
mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin && cp YOU_STORE_CORE_BIN(name bridgeless-core) $DAEMON_HOME/cosmovisor/genesis/bin

You should start cosmovisor as system service(BEST Practise):

```bash
sudo tee /etc/systemd/system/bridgeless.service > /dev/null << EOF
[Unit]
Description=Bridgeless Node
After=network-online.target
[Service]
Environment="DAEMON_NAME=bridgeless-core"
Environment="DAEMON_HOME=${BRIDGELESS_HOME}"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
User=root
ExecStart=/usr/local/bin/cosmovisor run start --home=${BRIDGELESS_HOME} --rpc.laddr tcp://0.0.0.0:26657
Restart=on-failure
RestartSec=10
LimitNOFILE=10000
[Install]
EOF
#start service
sudo systemctl daemon-reload
sudo systemctl enable bridgeless
sudo systemctl start bridgeless
```

Check logs:

sudo journalctl -u bridgeless -f --no-hostname -o cat

Or, simply start with command:

cosmovisor run start --home=$BRIDGELESS_HOME --rpc.laddr tcp://0.0.0.0:26657

Note, that your node has several ports that is required to be omen on your machine:

Expand All @@ -72,16 +118,15 @@ Note, that your node has several ports that is required to be omen on your machi
- "8545" # EVM HTTP RPC
- "8546" # EVM WS RPC

Also, please note that `app.toml` file contains the configuration for the gas price accepted by your validator.
- `minimum-gas-prices = "1abridge"`
Also, please note that `app.toml` file contains the configuration for the gas price accepted by your validator.
- `minimum-gas-prices = "1abridge"`

### Finishing with the validator

After receiving confirmation from ourside about token transfer, execute command to stake tokens
and become a validator. You need to stake exactly `100000000000000000000abridge` (10^18) that is equal to 1 BRIDGE.

bridgeless-core tx staking create-validator --amount 100000000000000000000abridge --commission-max-change-rate "0.01" --commission-max-rate "0.2" --commission-rate "0.1" --min-self-delegation "1" --details "Meet new bridgeless validator" --pubkey $(bridgless-core tendermint show-validator --home=$BRIDGELESS_HOME) --moniker $MONIKER_NAME --chain-id bridge_2607-1 --fees 0bridge --from $LOCAL_VALIDATOR_ADDRESS --home=$BRIDGELESS_HOME --node=$BRIDGELESS_NODE --keyring-backend=test

./bridgeless-core tx staking create-validator --amount 1000000000000000000abridge --commission-max-change-rate "0.01" --commission-max-rate "0.2" --commission-rate "0.1" --min-self-delegation "1" --details "Meet new bridgeless validator" --pubkey $(./bridgeless-core tendermint show-validator --home=$BRIDGELESS_HOME) --moniker $MONIKER_NAME --chain-id bridge_2607-1 --fees 0abridge --from $LOCAL_VALIDATOR_ADDRESS --home=$BRIDGELESS_HOME --node=$BRIDGELESS_NODE --keyring-backend=test --log_level="debug" --broadcast-mode="block" --trace --gas 10000000

## Docker compose

Expand All @@ -104,7 +149,7 @@ BRIDGELESS_HOME

To generate folder struct execute the command:

docker run --volume $BRIDGELESS_HOME/config/validator:/config/validator ghcr.io/hyle-team/bridgeless-core:{last_tag} init $MONIKER_NAME main--chain-id bridge_2607-1 --home=$BRIDGELESS_HOME --keyring-backend test
docker run --volume $BRIDGELESS_HOME/config/validator:/config/validator ghcr.io/hyle-team/bridgeless-core:{last_tag} init $MONIKER_NAME main--chain-id bridge_2607-1 --home=$BRIDGELESS_HOME --keyring-backend test

Modify docker-compose.yml:

Expand Down Expand Up @@ -162,4 +207,4 @@ Find docker container id

Init validator

docker exec -it <container-id> tx staking create-validator --amount 100000000000000000000abridge --commission-max-change-rate "0.01" --commission-max-rate "0.2" --commission-rate "0.1" --min-self-delegation "1" --details "Meet new bridgeless validator" --pubkey $(bridgless-core tendermint show-validator --home=$BRIDGELESS_HOME) --moniker $MONIKER_NAME --chain-id bridge_2607-1 --fees 0bridge --from $LOCAL_VALIDATOR_ADDRESS --home=$BRIDGELESS_HOME --node=$BRIDGELESS_NODE --keyring-backend=test
docker exec -it <container-id> tx staking create-validator --amount 100000000000000000000abridge --commission-max-change-rate "0.01" --commission-max-rate "0.2" --commission-rate "0.1" --min-self-delegation "1" --details "Meet new bridgeless validator" --pubkey $(docker exec -it tendermint show-validator --home=$BRIDGELESS_HOME) --moniker $MONIKER_NAME --chain-id bridge_2607-1 --fees 0bridge --from $LOCAL_VALIDATOR_ADDRESS --home=$BRIDGELESS_HOME --node=$BRIDGELESS_NODE --keyring-backend=test

0 comments on commit 9779081

Please sign in to comment.