Add V31 docs (#9567)

* Add V31 docs

* Add Checksums

* Add upgrade details

Author: JohnnyWyles

networks/osmosis-1/upgrades/v31/mainnet/guide.md

@@ -0,0 +1,116 @@
+# Mainnet Upgrade Guide: From Version v30 to v31
+
+## Overview
+
+- **v31 Proposal**: [Proposal Page](https://www.mintscan.io/osmosis/proposals/990)
+- **v31 Upgrade Block Height**: 47626000
+- **v31 Upgrade Countdown**: [Block Countdown](https://www.mintscan.io/osmosis/blocks/47626000)
+
+## Hardware Requirements
+
+### Memory Specifications
+
+Although this upgrade is not expected to be resource-intensive, a minimum of 64GB of RAM is advised. If you cannot meet this requirement, setting up a swap space is recommended.
+
+#### Configuring Swap Space
+
+_Execute these commands to set up a 32GB swap space_:
+
+```sh
+sudo swapoff -a
+sudo fallocate -l 32G /swapfile
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+```
+
+_To ensure the swap space persists after reboot_:
+
+```sh
+sudo cp /etc/fstab /etc/fstab.bak
+echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
+```
+
+For an in-depth guide on swap configuration, please refer to [this tutorial](https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-20-04).
+
+---
+
+## Cosmovisor Configuration
+
+### Initial Setup (For First-Time Users)
+
+If you have not previously configured Cosmovisor, follow this section; otherwise, proceed to the next section.
+
+Cosmovisor is strongly recommended for validators to minimize downtime during upgrades. It automates the binary replacement process according to on-chain `SoftwareUpgrade` proposals.
+
+Documentation for Cosmovisor can be found [here](https://docs.cosmos.network/main/tooling/cosmovisor).
+
+#### Installation Steps
+
+_Run these commands to install and configure Cosmovisor_:
+
+```sh
+go install github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor@v1.0.0
+mkdir -p ~/.osmosisd
+mkdir -p ~/.osmosisd/cosmovisor
+mkdir -p ~/.osmosisd/cosmovisor/genesis
+mkdir -p ~/.osmosisd/cosmovisor/genesis/bin
+mkdir -p ~/.osmosisd/cosmovisor/upgrades
+cp $GOPATH/bin/osmosisd ~/.osmosisd/cosmovisor/genesis/bin
+mkdir -p ~/.osmosisd/cosmovisor/upgrades/v31/bin
+cp $GOPATH/bin/osmosisd ~/.osmosisd/cosmovisor/upgrades/v31/bin
+```
+
+_Add these lines to your profile to set up environment variables_:
+
+```sh
+echo "# Cosmovisor Setup" >> ~/.profile
+echo "export DAEMON_NAME=osmosisd" >> ~/.profile
+echo "export DAEMON_HOME=$HOME/.osmosisd" >> ~/.profile
+echo "export DAEMON_ALLOW_DOWNLOAD_BINARIES=false" >> ~/.profile
+echo "export DAEMON_LOG_BUFFER_SIZE=512" >> ~/.profile
+echo "export DAEMON_RESTART_AFTER_UPGRADE=true" >> ~/.profile
+echo "export UNSAFE_SKIP_BACKUP=true" >> ~/.profile
+source ~/.profile
+```
+
+### Upgrading to v31
+
+_To prepare for the upgrade, execute these commands_:
+
+```sh
+mkdir -p ~/.osmosisd/cosmovisor/upgrades/v31/bin
+cd $HOME/osmosis
+git pull
+git checkout v31.0.0
+make build
+cp build/osmosisd ~/.osmosisd/cosmovisor/upgrades/v31/bin
+```
+
+At the designated block height, Cosmovisor will automatically upgrade to version v31.
+
+---
+
+## Manual Upgrade Procedure
+
+Follow these steps if you opt for a manual upgrade:
+
+1. Monitor Osmosis until it reaches the specified upgrade block height: 47626000.
+2. Observe for a panic message followed by continuous peer logs, then halt the daemon.
+3. Perform these steps:
+
+```sh
+cd $HOME/osmosis
+git pull
+git checkout v31.0.0
+make install
+```
+
+4. Restart the Osmosis daemon and observe the upgrade.
+
+---
+
+## Additional Resources
+
+- Osmosis Documentation: [Website](https://docs.osmosis.zone)
+- Community Support: [Discord](https://discord.com/invite/osmosis)

networks/osmosis-1/upgrades/v31/mainnet/v31_binaries.json

@@ -0,0 +1,6 @@
+{
+  "binaries": {
+    "linux/amd64": "https://github.com/osmosis-labs/osmosis/releases/download/v31.0.0/osmosisd-31.0.0-linux-amd64?checksum=d435408b845e79a2594594a315d9d22797fdbb7871a5936df68f51f0df557957",
+    "linux/arm64": "https://github.com/osmosis-labs/osmosis/releases/download/v31.0.0/osmosisd-31.0.0-linux-arm64?checksum=b5c44e74c4dc484f8492d10a24fcd3f75a43dccaa40ab083662741beeeaa20cc"
+  }
+}