Block explorer: https://explorer.cygnusx-1.publicawesome.dev/
Genesis file: https://github.com/public-awesome/networks/releases/download/cygnusx-1a/genesis.json
Hash: sha256sum eacabd1f92a3d750610c53f27641aca0d38ec5fda370b4e821a05003e8b866f2
Seeds: b5c81e417113e283288c48a34f1d57c73a0c6682@seed.cygnusx-1.publicawesome.dev:36656
Peers: https://hackmd.io/ruGVasSzR9iUhIirVff44Q?both
Thank you for submitting a gentx! This guide will provide instructions on getting ready for the testnet.
The Chain Genesis Time is 17:00 UTC on July 15, 2021.
Please have your validator up and ready by this time, and be available for further instructions if necessary at that time.
The primary point of communication for the genesis process will be the #validators channel on the Stargaze Discord.
This guide assumes that you have completed the tasks involved in Part 1. You should be running on a machine that meets the hardware requirements specified in Part 1 with Go installed. We are assuming you already have a daemon home ($HOME/.starsd) setup.
These examples are written targeting an Ubuntu 20.04 system. Relevant changes to commands should be made depending on the OS/architecture you are running on.
Please update to the v0.9.3 tag and rebuild your binaries.
git clone https://github.com/public-awesome/stargaze
cd stargaze
git checkout v0.9.3
make installVerify that everything is OK.
starsd version --long
name: starsd
server_name: starsd
version: '"0.9.3"'
commit: a6ecce88b17428836041caf0fff8ada3c15afd00
build_tags: netgo,ledger
go: go version go1.16.3 darwin/amd64If the software version does not match, then please check your $PATH to ensure the correct starsd is running.
Please save the chain-id to your client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.
starsd config chain-id cygnusx-1We highly recommend validators use cosmovisor to run their nodes. This will make low-downtime upgrades more smoother, as validators don't have to manually upgrade binaries during the upgrade, and instead can preinstall new binaries, and cosmovisor will automatically update them based on on-chain SoftwareUpgrade proposals.
You should review the docs for cosmovisor located here: https://docs.cosmos.network/master/run-node/cosmovisor.html
If you choose to use cosmovisor, please continue with these instructions:
Cosmovisor is currently located in the Cosmos SDK repo, so you will need to download that, build cosmovisor, and add it to you PATH.
git clone https://github.com/cosmos/cosmos-sdk
cd cosmos-sdk
git checkout v0.42.7
make cosmovisor
cp cosmovisor/cosmovisor $GOPATH/bin/cosmovisor
cd $HOMEAfter this, you must make the necessary folders for cosmosvisor in your daemon home directory (~/.starsd).
mkdir -p ~/.starsd
mkdir -p ~/.starsd/cosmovisor
mkdir -p ~/.starsd/cosmovisor/genesis
mkdir -p ~/.starsd/cosmovisor/genesis/bin
mkdir -p ~/.starsd/cosmovisor/upgradesCosmovisor requires some ENVIRONMENT VARIABLES be set in order to function properly. We recommend setting these in
your .profile so it is automatically set in every session.
echo "# Setup Cosmovisor" >> ~/.profile
echo "export DAEMON_NAME=starsd" >> ~/.profile
echo "export DAEMON_HOME=$HOME/.starsd" >> ~/.profile
source ~/.profile
Finally, you should copy the starsd binary into the cosmovisor/genesis folder.
cp $GOPATH/bin/starsd ~/.starsd/cosmovisor/genesis/bin
This will create a new .starsd folder in your HOME directory.
Stargaze comes with a script to generate the genesis file required to start the chain. Therefore, no single party is responsible for starting the chain. Each validator generates their own genesis file, which should be identical for all.
If you don't already have the networks repo cloned:
git clone https://github.com/public-awesome/networks
cd networksUpdate to the latest:
git checkout master
git pullBuild the genesis file:
./build-genesis.shNOTE: This can take 10-30 minutes depending on your setup.
Verify your genesis file was created properly:
./checkgen.sh
42bf3aa2154bfa33deaa77c3a70d2aac94e382eb847ed3f07dbb71be695cd4d0NOTE: You will need to install jq if you haven't already for the above to work.
You should review the config.toml and app.toml that was generated when you ran starsd init last time.
When it comes the min gas fees, our recommendation is to leave this blank for now (charge no gas fees), to make the UX as seamless as possible
for users to be able to pay with IBC assets. So in app.toml:
minimum-gas-prices = ""There shouldn't be any chain database yet, but in case there is for some reason, you should reset it.
starsd unsafe-reset-allNow that everything is setup and ready to go, you can start your node.
cosmovisor startYou will need some way to keep the process always running. If you're on linux, you can do this by creating a service.
sudo tee /etc/systemd/system/starsd.service > /dev/null <<EOF
[Unit]
Description=Stargaze Daemon
After=network-online.target
[Service]
User=$USER
ExecStart=$(which cosmovisor) start
Restart=always
RestartSec=3
LimitNOFILE=4096
Environment="DAEMON_HOME=$HOME/.starsd"
Environment="DAEMON_NAME=starsd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
[Install]
WantedBy=multi-user.target
EOFThen update and start the node
sudo -S systemctl daemon-reload
sudo -S systemctl enable starsd
sudo -S systemctl start starsdYou can check the status with:
systemctl status starsdGood luck! See ya in the Discord!
Disclaimer: This content is provided for informational purposes only, and should not be relied upon as legal, business, investment, or tax advice. You should consult your own advisors as to those matters. References to any securities or digital assets are for illustrative purposes only and do not constitute an investment recommendation or offer to provide investment advisory services. Furthermore, this content is not directed at nor intended for use by any investors or prospective investors, and may not under any circumstances be relied upon when making investment decisions.
This work is a derivative of "Osmosis Genesis Validators Guide", which is a derivative of "Agoric Validator Guide" used under CC BY. The Agoric validator guide is itself is a derivative of "Validating Kava Mainnet" by Kevin Davis, used under CC BY. "Stargaze Cygnus X-1 Testnet Instructions" is licensed under CC BY by Stargaze. It was extensively modified to be relevant to the Stargaze Chain.