From 314a261c092855b52cc2ea96b15190b0489d5f4f Mon Sep 17 00:00:00 2001 From: JafarAz Date: Fri, 6 Oct 2023 03:50:06 +0300 Subject: [PATCH] =?UTF-8?q?=D0=A7=D1=82=D0=BE-=D1=82=D0=BE=20=D1=81=20?= =?UTF-8?q?=D1=87=D0=B5=D0=BC-=D1=82=D0=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../composable-cosmos-mainnet.md | 65 +++++++++++++ docs/docs/developer-guides/testnet-3.md | 43 +++++++++ docs/docs/developer-guides/testnet-4.md | 94 +++++++++++++++++++ docs/sidebars.js | 4 + 4 files changed, 206 insertions(+) create mode 100644 docs/docs/developer-guides/composable-cosmos-mainnet.md create mode 100644 docs/docs/developer-guides/testnet-3.md create mode 100644 docs/docs/developer-guides/testnet-4.md diff --git a/docs/docs/developer-guides/composable-cosmos-mainnet.md b/docs/docs/developer-guides/composable-cosmos-mainnet.md new file mode 100644 index 00000000000..de303adeb38 --- /dev/null +++ b/docs/docs/developer-guides/composable-cosmos-mainnet.md @@ -0,0 +1,65 @@ +# Composable Cosmos chain mainnet: centauri-1 + +## Hardware recommendation +``` +Quad core or larger amd64 CPU +64GB+ RAM +1TB+ NVMe Storage +``` +## Binary + +Mainnet launch version: v2.3.5, precompiled binary for linux-amd64 could be found here: https://github.com/notional-labs/composable-centauri/releases/tag/v2.3.5 + +``` +git clone https://github.com/notional-labs/composable-centauri +cd composable-centauri +git checkout v5.2.2 +make install +``` +:::note +Ensure you are running the latest release, head to the [repository](https://github.com/notional-labs/composable-centauri) for the Composable Cosmos chain for assurance. +::: + +## Genesis +Final mainnet genesis: https://raw.githubusercontent.com/notional-labs/composable-networks/main/mainnet/genesis.json +``` +banksyd tendermint unsafe-reset-all +wget -O ~/.banksy/config/genesis.json https://raw.githubusercontent.com/notional-labs/composable-networks/main/mainnet/genesis.json +``` + +## P2P connection +You can set the peers/seeds in `config.toml`: +``` +sed -i.bak -E "s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1"'"c7f52f81ee1b1f7107fc78ca2de476c730e00be9@65.109.80.150:2635"'"|" ~/.banksy/config/config.toml +``` + +*Seeds:* +``` +c7f52f81ee1b1f7107fc78ca2de476c730e00be9@65.109.80.150:2635 +``` + +*Persistent peers:* +``` +4cb008db9c8ae2eb5c751006b977d6910e990c5d@65.108.71.163:2630,63559b939442512ed82d2ded46d02ab1021ea29a@95.214.55.138:53656 +``` + +## Explorer + +Nodestake: https://explorer.nodestake.top/composable/ + +Ping Pub: https://ping.pub/composable + +## Snapshots +Fresh state synced snapshots and other mainnet materials could be found here: https://polkachu.com/networks/composable +Thanks to Polkachu. + +## Creating the Validator + +After getting your node synced and token ready, submit this transaction to create your validator: +``` +centaurid tx staking create-validator --pubkey=$(centaurid tendermint show-validator) --moniker VAL_NAME --details="XXXX" --identity XXXX --security-contact XXXX --website XXXX --commission-max-rate 0.1 --commission-max-change-rate 0.05 --commission-rate 0.05 --min-self-delegation 1 --from YOUR_KEY --amount=1000000000000ppica --chain-id centauri-1 +``` + +:::caution +Remember to back up your `priv_validator_key.json` in ~/.centauri/config/ alongside with the seed phrases to your wallet. +::: \ No newline at end of file diff --git a/docs/docs/developer-guides/testnet-3.md b/docs/docs/developer-guides/testnet-3.md new file mode 100644 index 00000000000..b7dec6a57ef --- /dev/null +++ b/docs/docs/developer-guides/testnet-3.md @@ -0,0 +1,43 @@ +# Composable Cosmos chain: Testnet 3 + + +## Syncing materials + +### Binary and config + +Testnet-3 launch version: v2.3.5, precompiled binary for linux could be found here: https://github.com/notional-labs/composable-testnet/releases/tag/v2.3.5 + +``` +cd ~/composable-testnet +git fetch --all +git checkout v2.3.5 +make install +banksyd tendermint unsafe-reset-all +``` + +:::note +Ensure you are running the latest release, head to the [repository](https://github.com/notional-labs/composable-centauri) for the latest testnet releases. +::: + +### Peers & seeds: +You can set the peers/seeds in `config.toml` or run the node with `--p2p.seeds="" --p2p.persistent_peers=""` + +Feel free to PR your peers/seeds on the respective repository: + +*Seeds:* +``` +364b8245e72f083b0aa3e0d59b832020b66e9e9d@65.109.80.150:21500, +d2deff06cf95c0d016d8f65822e1c74ce2af9def@95.217.58.111:37656 +``` + +### Download the genesis and start: +``` +wget -O ~/.banksy/config/genesis.json https://raw.githubusercontent.com/notional-labs/composable-networks/main/banksy-testnet-3/genesis.json +banksyd start --p2p.seeds 364b8245e72f083b0aa3e0d59b832020b66e9e9d@65.109.80.150:21500 +``` + +## Explorer + +Nodestake: https://explorer.nodestake.top/composable-testnet + +Ping Pub: https://testnet.ping.pub/centauritestnet diff --git a/docs/docs/developer-guides/testnet-4.md b/docs/docs/developer-guides/testnet-4.md new file mode 100644 index 00000000000..f23fc7a93f8 --- /dev/null +++ b/docs/docs/developer-guides/testnet-4.md @@ -0,0 +1,94 @@ +# Composable Cosmos Chain Testnet 4 + +## Information +- Network information: https://github.com/notional-labs/composable-networks/tree/main/banksy-testnet-4 +- Chain ID: banksy-testnet-4 +- Genesis: https://raw.githubusercontent.com/notional-labs/composable-networks/main/banksy-testnet-4/genesis.json +- Binary: https://github.com/notional-labs/composable-centauri/releases/tag/v5.2.4-testnet4 +- Current version: v5.2.4-testnet4 +- Peers: a89d3d9fc0465615aa1100dcf53172814aa2b8cf@168.119.91.22:2260 +- Public Notional endpoints: + - RPC: https://rpc-banksy4.notional.ventures:443 + - API: https://api-banksy4.notional.ventures:443 + - gRPC: http://168.119.91.22:2263 +- Block Explorer: Coming soon + +## Setup Instruction + +**1. Building the binary** + +There are two ways of setting up the `centaurid` binary, building from source or installing from binary URL, which is mentioned in the install script in the next section. + +To build the binary from source, run these commands: + +``` +#mkdir $HOME/go/bin # ignore this command if you already have $HOME/go/bin folder +export PATH=$PATH:$HOME/go/bin +cd $HOME +git clone https://github.com/notional-labs/composable-centauri +cd composable-centauri +git checkout v5.2.4-testnet4 # Using v5.2.4-testnet4 +make install +centaurid version # v5.2.4-testnet4 +``` + +**2. Joining testnet** + +Here is a full script to install `centaurid binary` and run the node with state sync. This script should be run with administration privileges by running `sudo script.sh`: + +``` +# script.sh +centaurid init --chain-id banksy-testnet-4 +wget https://raw.githubusercontent.com/notional-labs/composable-networks/main/banksy-testnet-4/genesis.json -O $HOME/.banksy/config/genesis.json + + +# state sync +SNAP_RPC="https://rpc-banksy4.notional.ventures:443" +LATEST_HEIGHT=$(curl -s $SNAP_RPC/block | jq -r .result.block.header.height); \ +BLOCK_HEIGHT=$((LATEST_HEIGHT - 2000)); \ +TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash) +sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; \ +s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; \ +s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; \ +s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"|" $HOME/.banksy/config/config.toml + +# run node +centaurid start --p2p.seeds a89d3d9fc0465615aa1100dcf53172814aa2b8cf@168.119.91.22:2260 +``` + +**3. Join testnet as a validator** +To join `banksy-testnet-4` as a validator, you should setup a running node as in step 1 above and wait for it to be fully synced, and then setup validator: + +- Create a key: +``` +centaurid keys add # generate a new key, or use `--recover` to recover an existed key with mnemonic +``` + +- For testnet tokens, head to ethibc-testnet-faucet channel on the Composable discord and send the following message with your address included: + +``` +$request
composable +``` + +- To see the current balance of the address, run the following command: + +``` +$balance
composable +``` + +- Create validator: +``` +centaurid tx staking create-validator --amount=1000000000000ppica --moniker="" --chain-id=banksy-testnet-4 --commission-rate="0.05" --commission-max-change-rate="0.01" --commission-max-rate="0.20" --from= --node=https://rpc-banksy4.notional.ventures:443 --gas=auto --min-self-delegation 10 --pubkey=$(centaurid tendermint show-validator) +``` + +To add validator info: + +``` +centaurid tx staking edit-validator \ + --website="" \ # URL to validator website + --identity="" \ # keybase.io identity + --details="" \ # Additional detail + --security-contact="" \ # security email + --from= \ + --node="https://rpc-banksy4.notional.ventures:443" +``` diff --git a/docs/sidebars.js b/docs/sidebars.js index 36b1c99486a..efa9e53bad6 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -244,6 +244,10 @@ "developer-guides/oracle-set-up-guide", "developer-guides/collator-guide", "developer-guides/local-picasso-guide", + "developer-guides/composable-cosmos-mainnet", + "developer-guides/testnet-3", + "developer-guides/testnet-4", + ], ecosystem: [ {