Logo

🔌 Installation

1️⃣ Installation packeges and dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install curl git wget htop tmux build-essential jq make lz4 gcc unzip -y

➡️ Go Installation

cd $HOME
VER="1.22.11"
wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz"
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz"
rm "go$VER.linux-amd64.tar.gz"
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile
echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
source $HOME/.bash_profile
[ ! -d ~/go/bin ] && mkdir -p ~/go/bin

➡️ Set Vars

You can replace 62 with anything you want. Please write 2 digits.

echo "export STORY_MONIKER="MictoNode_Guide"" >> $HOME/.bash_profile
echo "export STORY_PORT="62"" >> $HOME/.bash_profile
source $HOME/.bash_profile

2️⃣ Install node

cd $HOME
rm -rf story-geth
git clone https://github.com/piplabs/story-geth.git
cd story-geth
git checkout v1.1.0
go build -v ./cmd/geth
mv ./geth $HOME/go/bin/story-geth
cd $HOME
[ ! -d "$HOME/.story/story" ] && mkdir -p "$HOME/.story/story"
[ ! -d "$HOME/.story/geth" ] && mkdir -p "$HOME/.story/geth"

cd $HOME
rm -rf story
git clone https://github.com/piplabs/story
cd story
git checkout v1.3.0
go build -o story ./client 
mv ./story $HOME/go/bin/story
cd $HOME

➡️ Initialize the node

story init --moniker $STORY_MONIKER --network aeneid

➡️ Port

sed -i.bak -e "s%:1317%:${STORY_PORT}317%g;
s%:8551%:${STORY_PORT}551%g" $HOME/.story/story/config/story.toml

sed -i.bak -e "s%:26658%:${STORY_PORT}658%g;
s%:26657%:${STORY_PORT}657%g;
s%:26656%:${STORY_PORT}656%g;
s%^external_address = \"\"%external_address = \"$(wget -qO- eth0.me):${STORY_PORT}656\"%;
s%:26660%:${STORY_PORT}660%g" $HOME/.story/story/config/config.toml

➡️ Indexer & Prometheus

sed -i -e "s/prometheus = false/prometheus = true/" $HOME/.story/story/config/config.toml
sed -i -e "s/^indexer *=.*/indexer = \"null\"/" $HOME/.story/story/config/config.toml

➡️ Seeds & Peers

SEEDS="944e8889ecd7c13623ef1081aae4555d6f525041@b1-b.odyssey-devnet.storyrpc.io:26656"
PEERS="[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:29456,[email protected]:56356,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:56356,[email protected]:26656,[email protected]:26656,[email protected]:26656,[email protected]:28656,[email protected]:28656,[email protected]:30900,[email protected]:33656,[email protected]:26656,[email protected]:26656"
sed -i -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*seeds *=.*/seeds = \"$SEEDS\"/}" \
       -e "/^\[p2p\]/,/^\[/{s/^[[:space:]]*persistent_peers *=.*/persistent_peers = \"$PEERS\"/}" $HOME/.story/story/config/config.toml

➡️ Genesis & Addrbook

wget -O $HOME/.story/story/config/genesis.json https://files.mictonode.com/story/genesis/genesis.json
wget -O $HOME/.story/story/config/addrbook.json  https://files.mictonode.com/story/addrbook/addrbook.json

➡️ Create a service

story-geth

sudo tee /etc/systemd/system/story-geth.service > /dev/null <<EOF
[Unit]
Description=Story Geth
After=network-online.target

[Service]
User=$USER
ExecStart=$HOME/go/bin/story-geth --aeneid --syncmode full --port ${STORY_PORT}303 --http --http.api eth,net,web3,engine --http.vhosts '*' --http.addr 0.0.0.0 --http.port ${STORY_PORT}545 --authrpc.addr 127.0.0.1 --authrpc.port ${STORY_PORT}551 --authrpc.vhosts=* --ws --ws.api eth,web3,net,txpool --ws.addr 0.0.0.0 --ws.port ${STORY_PORT}546 --ws.origins '*'
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

story

sudo tee /etc/systemd/system/story.service > /dev/null <<EOF
[Unit]
Description=Story Service
After=network.target

[Service]
User=$USER
WorkingDirectory=$HOME/.story/story
ExecStart=$(which story) run

Restart=on-failure
RestartSec=5
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF

➡️ Starter Snap (pruned)

Check Snapshot Height 
echo "STORY Snapshot Height: $(curl -s https://files.mictonode.com/story/snapshot/block-height.txt)"

cp $HOME/.story/story/data/priv_validator_state.json $HOME/.story/story/priv_validator_state.json.backup
rm -rf $HOME/.story/story/data
rm -rf $HOME/.story/geth/aeneid/geth/chaindata
mkdir -p $HOME/.story/geth/aeneid/geth

SNAPSHOT_URL="https://files.mictonode.com/story/snapshot/"
LATEST_COSMOS=$(curl -s $SNAPSHOT_URL | grep -oP 'story_\d{8}-\d{4}_\d+_cosmos\.tar\.lz4' | sort | tail -n 1)
LATEST_GETH=$(curl -s $SNAPSHOT_URL | grep -oP 'story_\d{8}-\d{4}_\d+_geth\.tar\.lz4' | sort | tail -n 1)

if [ -n "$LATEST_COSMOS" ] && [ -n "$LATEST_GETH" ]; then
  COSMOS_URL="${SNAPSHOT_URL}${LATEST_COSMOS}"
  GETH_URL="${SNAPSHOT_URL}${LATEST_GETH}"

  echo "Downloading Cosmos snapshot: $LATEST_COSMOS"
  curl "$COSMOS_URL" | lz4 -dc - | tar -xf - -C $HOME/.story/story

  echo "Downloading Geth snapshot: $LATEST_GETH"
  curl "$GETH_URL" | lz4 -dc - | tar -xf - -C $HOME/.story/geth/aeneid/geth

  mv $HOME/.story/story/priv_validator_state.json.backup $HOME/.story/story/data/priv_validator_state.json
else
  echo "Snapshot not found."
fi

➡️ Let’s get started

sudo systemctl daemon-reload
sudo systemctl enable story story-geth
sudo systemctl start story-geth && sleep 5 && sudo systemctl start story

journalctl -u story -u story-geth -f

➡️ Create Validator

View your validator key

story validator export

Export EVM private key

story validator export --export-evm-key

View EVM private key and make a key backup

cat $HOME/.story/story/config/private_key.txt

Once “catching_up” is “false”, move on to the next step

curl localhost:$(sed -n '/\[rpc\]/,/laddr/ { /laddr/ {s/.*://; s/".*//; p} }' $HOME/.story/story/config/config.toml)/status | jq

story-geth --exec "eth.syncing" attach ~/.story/geth/aeneid/geth.ipc

Create validator

for locked

export PRIVATE_KEY=$(cat $HOME/.story/story/config/private_key.txt | grep "PRIVATE_KEY" | awk -F'=' '{print $2}')

story validator create \
  --stake 1024000000000000000000 \
  --moniker "$STORY_MONIKER" \
  --chain-id 1315 \
  --unlocked=false \
  --rpc "https://aeneid.storyrpc.io"

for unlocked

export PRIVATE_KEY=$(cat $HOME/.story/story/config/private_key.txt | grep "PRIVATE_KEY" | awk -F'=' '{print $2}')

story validator create \
  --stake 1024000000000000000000 \
  --moniker "$STORY_MONIKER" \
  --chain-id 1315 \
  --unlocked=true \
  --rpc "https://aeneid.storyrpc.io" \

➡️ Delegate to yourself

  • Flexible period (default)

    • No lock period
    • 1.0x reward multiplier

  • Short period (90 days)

    • 1.1x reward multiplier

--staking-period "short"

  • Medium period (360 days)
    • 1.5x reward multiplier

--staking-period "medium"

  • Long period (540 days)
    • 2.0x reward multiplier

--staking-period "long"

export PRIVATE_KEY=$(cat $HOME/.story/story/config/private_key.txt | grep "PRIVATE_KEY" | awk -F'=' '{print $2}')

story validator stake --chain-id 1315 --validator-pubkey $(story validator export | grep "Compressed Public Key (hex)" | awk '{print $NF}') --stake amount000000000000000000 --rpc "https://aeneid.storyrpc.io"

➡️ Complete deletion

sudo systemctl stop story story-geth
sudo systemctl disable story story-geth
rm -rf $HOME/.story
rm -rf $HOME/story
rm -rf $HOME/story-geth
sudo rm /etc/systemd/system/story.service /etc/systemd/system/story-geth.service
sudo systemctl daemon-reload