⚙️ Installation

Chain ID: agoric-3 | Node Version: v0.35.0-u20.2 | Custom Port: 166

Recommended Hardware:

Node Type
CPU
RAM
Storage

Mainnet

8

16GB

250GB

Install dependencies

# Update system and install build tools
sudo apt -q update 
sudo apt -qy install curl git jq lz4 build-essential 
sudo apt -qy upgrade

Automatic Installation

source <(curl -s https://raw.githubusercontent.com/validexisinfra/Agoric/main/installmain.sh)

Manual Installation

# Adding a Node.js repository 
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo bash -
# Adding a Yarn repository using signed-by
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/yarnkey.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/yarnkey.gpg] https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
# Update system
sudo apt update
# Uninstalling an old version of Node.js (if any)
sudo apt remove -y nodejs
sudo apt autoremove -y
# Installing Node.js and Yarn
sudo apt install -y nodejs=18.* yarn
# Install Go
sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.23.6.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)
echo "export PATH=$PATH:/usr/local/go/bin:/usr/local/bin:$HOME/go/bin" >> $HOME/.bash_profile
source $HOME/.bash_profile
go version

# go version go1.23.0 linux/amd64
# Come up with the name of your node and replace it instead <your_moniker>
MONIKER=<your_moniker>
# Clone project repository
cd $HOME
rm -rf agoric-upgrade-20
git clone https://github.com/Agoric/agoric-sdk.git agoric-upgrade-19
cd agoric-upgrade-20
git checkout agoric-upgrade-20

# Install and build Agoric Javascript packages
yarn install && yarn build

# Install and build Agoric Cosmos SDK support
(cd packages/cosmic-swingset && make)

Setup config

# Set node configuration
agd config chain-id agoric-3
agd config keyring-backend file
agd config node tcp://localhost:26657

# Initialize the node
agd init $MONIKER --chain-id agoric-3

# Download genesis and addrbook
curl -Ls https://snapshots.kjnodes.com/agoric/genesis.json > $HOME/.agoric/config/genesis.json
curl -Ls https://snapshots.kjnodes.com/agoric/addrbook.json > $HOME/.agoric/config/addrbook.json

# Add seeds
sed -i -e "s|^seeds *=.*|seeds = \"[email protected]:12759\"|" $HOME/.agoric/config/config.toml

# Set minimum gas price
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.025ubld\"|" $HOME/.agoric/config/app.toml

# Set pruning
sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
 $HOME/.agoric/config/app.toml

For Agoric nodes, make sure you set iavl-disable-fastnode = true in app.toml.

Set custom ports

You can change value CUSTOM_PORT=166 To any other ports

CUSTOM_PORT=166
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:${CUSTOM_PORT}58\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:${CUSTOM_PORT}57\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:${CUSTOM_PORT}60\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:${CUSTOM_PORT}56\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":${CUSTOM_PORT}66\"%" $HOME/.agoric/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:${CUSTOM_PORT}17\"%; s%^address = \":8080\"%address = \":${CUSTOM_PORT}80\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:${CUSTOM_PORT}90\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:${CUSTOM_PORT}91\"%; s%^address = \"0.0.0.0:8545\"%address = \"0.0.0.0:${CUSTOM_PORT}45\"%; s%^ws-address = \"0.0.0.0:8546\"%ws-address = \"0.0.0.0:${CUSTOM_PORT}46\"%" $HOME/.agoric/config/app.toml
#Set config with new custom port
agd config node tcp://localhost:${CUSTOM_PORT}57
# Create service file
sudo tee /etc/systemd/system/agoricd.service > /dev/null << EOF
[Unit]
Description=Agoric node service
After=network-online.target

[Service]
Type=simple
User=${USER}
ExecStart=$(which agd) start --home ${HOME}/.agoric
Restart=on-failure
RestartSec=10
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF
# Download latest chain snapshot
SOON
# Enable and start service
sudo systemctl daemon-reload
sudo systemctl enable agoricd
sudo systemctl start agoricd && sudo journalctl -u agoricd -f -o cat
# Check status
agd status 2>&1 | jq .SyncInfo

#"catching_up": false means that the node is synchronized, we are waiting for complete synchronization

Wallets

# Create wallet
agd keys add wallet

The wallet has been created. In the last line there will be a phrase that must be written down

# If the wallet was already there, restore it
agd keys add wallet --recover

# Insert the seed phrase from your wallet
# If everything is correct, you will see your wallet data

Validator

Do not forget to create a profile on https://keybase.io/ and set a profile photo there that will be imported by key and used for your validators.

agd tx staking create-validator \
--amount=1000000ubld \
--pubkey $(agd tendermint show-validator) \
--moniker "YOUR_MONIKER_NAME" \
--identity "YOUR_KEYBASE_ID" \
--details "YOUR_DETAILS" \
--website "YOUR_WEBSITE_URL" \
--chain-id=agoric-3 \
--commission-rate="0.1" \
--commission-max-rate="0.20" \
--commission-max-change-rate="0.1" \
--min-self-delegation="1" \
--from wallet \
--gas-adjustment=1.4 -y

!!! Save priv_validator_key.json which is located in /root/.agoric/config

Last updated