Chain restart is due at 1700 UTC on Tuesday 3rd January 2023. We will use quicksilverd v1.2.0 to export and restart the chain. You must upgrade before the export, else the export will fail. For build instructions, see below.

1. git fetch && git checkout v1.2.0
2. make install
3. quicksilverd export --for-zero-height --height 115000 > export-quicksilver-1-115000.json
4. jq . export-quicksilver-1-115000.json -S -c | shasum -a256
5. Check output matches 7df73ba5fdbaf6f4b5cced3f16b8f44047ad8f42a7a6f87f764413b474e81c54
6. Run python3 migrate-genesis.py
7. jq . genesis.json -S -c | shasum -a256
8. Check output matches cab2352d12f9e388bc633d909a26eaea8fc52904990405cd20d72077415a51d2
9. cp genesis.json ~/.quicksilverd/config/genesis.json (be sure to replace ~/.quicksilverd with your node's HOME).
10. quicksilverd tendermint unsafe-reset-all
11. If you use an external signer, update the chain_id and reset state.
12. quicksilverd start or, if using systemd, systemctl start quicksilver

• 4 cores (max. clock speed possible)
• 16GB RAM
• 500GB+ of NVMe or SSD disk

Current version: v1.2.0

Requires Go version v1.19+.

> git clone https://github.com/ingenuity-build/quicksilver && cd quicksilver
> git fetch origin --tags
> git checkout v1.2.0
> make install
or
> make build

make build will output the binary in the build directory.

Alternatively, to build a docker container, use make build-docker.

To verify if the installation was successful, execute the following command:

> quicksilverd version --long

It will display the version of quicksilverd currently installed:

name: quicksilverd
server_name: quicksilverd
version: 1.2.0
commit: 0ce6daf33aaeb93e1cb306a1fc8672c0123cffd1
build_tags: netgo,ledger
go: go version go1.19.2 linux/amd64

Ensure go version is 1.19+; using 1.18 will cause non-deterministic behaviour.

1. Init Chain and start your node

   > quicksilverd init <moniker-name> --chain-id=quicksilver-2

2. Create a local key pair Note: we recommend only using Ledger for mainnet! Key security is important!

   > ## create a new key:
   > quicksilverd keys add <key-name>
   > ## or use a ledger:
   > quicksilverd key add <key-name> --ledger
   > ## or import an old key:
   > quicksilverd keys show <key-name> -a

3. Download genesis Fetch genesis.json into quicksilverd's config directory (default: ~/.quicksilverd)

   > curl -s https://raw.githubusercontent.com/ingenuity-build/mainnet/main/genesis.json > genesis.json

   Genesis sha256

    jq . ~/.quicksilverd/config/genesis.json -S -c | shasum -a256
    cab2352d12f9e388bc633d909a26eaea8fc52904990405cd20d72077415a51d2  -

4. Define minimum gas prices

    sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0001uqck\"/;" ~/.quicksilverd/config/app.toml

5. Define seed nodes

    export SEEDS="[email protected]:11156,[email protected]:11156,00f51227c4d5d977ad7174f1c0cea89082016ba2@seed-quick-mainnet.moonshot.army:26650"
    sed -i.bak -e "s/^seeds *=.*/seeds = \"$SEEDS\"/" ~/.quicksilverd/config/config.toml

6. Start your node and sync to the latest block

7. Create validator

   $ quicksilverd tx staking create-validator \
   --amount 50000000uqck \
   --commission-max-change-rate "0.1" \
   --commission-max-rate "0.20" \
   --commission-rate "0.1" \
   --min-self-delegation "1" \
   --details "a short description lives here" \
   --pubkey=$(quicksilverd tendermint show-validator) \
   --security-contact "[email protected]" \
   --moniker <your_moniker> \
   --chain-id quicksilver-2 \
   --from <key-name>

Optional, but highly recommended for upgrade automation.

Cosmovisor is process manager for Cosmos-SDK application binaries that enables node automation. It monitors the application's governance module for upgrade proposals and allows for automation of application binary downloads and replacement, resulting in near zero-downtime chain upgrades.

Using go version 1.15 or later:

go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@latest

or, specify the target version, for example:

go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/[email protected]

Confirm installation with:

which cosmovisor

The output should be a path to the cosmovisor binary:

/home/<user>/go/bin/cosmovisor

The following environment variables must be set:

1. export DAEMON_NAME=quicksilverd
2. export DAEMON_HOME=$HOME/.quicksilverd
3. export DAEMON_DATA_BACKUP_DIR=$HOME/.quicksilverd/data_backup

Ensure your environment setup is correctly configured to persist across sessions. Make use of the appropriate system environment configuration files, such as .profile to accomplish this.

Cosmovisor expects the following directory structure in $DAEMON_HOME/cosmovisor:

.
├── current -> genesis or upgrades/<name>
├── genesis
│   └── bin
│       └── $DAEMON_NAME
└── upgrades
    └── <name>
        └── bin
            └── $DAEMON_NAME

Create the target directory structure with the following:

mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
mkdir -p $DAEMON_HOME/cosmovisor/upgrades

current is a symlink that will be created by cosmovisor.

Cosmovisor requires the genesis binary to be set. Do this by copying the quicksilverd binary to $DAEMON_HOME/cosmovisor/genesis/bin/$DAEMON_NAME.

# find quicksilverd binary
which quicksilverd
# copy binary to cosmovisor genesis using output from above command, e.g.
cp build/quicksilverd $DAEMON_HOME/cosmovisor/genesis/bin/$DAEMON_NAME

Create the system service file:

sudo touch /etc/systemd/system/cosmovisor.service

Use an editor like vim, micro or nano and set the contents of the file according to your system configuration, for example:

[Unit]
Description=cosmovisor
After=network-online.target
[Service]
User=<your-user>
ExecStart=/home/<your-user>/go/bin/cosmovisor start
Restart=always
RestartSec=3
LimitNOFILE=4096
Environment="DAEMON_NAME=quicksilverd"
Environment="DAEMON_HOME=/home/<your-user>/.quicksilverd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=false"
# Set buffer size to handle:
# https://github.com/cosmos/cosmos-sdk/pull/8590
Environment="DAEMON_LOG_BUFFER_SIZE=512"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_POLL_INTERVAL=300ms"
Environment="DAEMON_DATA_BACKUP_DIR=${HOME}/.quicksilverd"
# Set to true if disk space is limited:
Environment="UNSAFE_SKIP_BACKUP=false"
Environment="DAEMON_PREUPGRADE_MAX_RETRIES=0"
[Install]
WantedBy=multi-user.target

IMPORTANT: If you have limited disk space please set UNSAFE_SKIP_BACKUP=true. This will avoid an upgrade failure due to insufficient disk space when the backup is created.

Enable and start the cosmovisor service:

sudo systemctl daemon-reload
sudo systemctl enable cosmovisor
sudo systemctl restart cosmovisor

Check that the service is running:

sudo systemctl status cosmovisor