Installation

System Specs

Hardware	Requirement
CPU	4 Cores
RAM	16 GB
Disk	500 GB
Bandwidth	25 MBit/s

https://docs.story.foundation/docs/node-setup

Install dependencies

sudo apt update
sudo apt-get update
sudo apt install curl git make jq build-essential gcc unzip wget lz4 aria2 -y

Download Story-Geth binary v1.0.1

cd $HOME
git clone https://github.com/piplabs/story-geth
cd story-geth
make geth
cp build/bin/geth $HOME/go/bin/story-geth
source $HOME/.bash_profile
story-geth version

You will see the version of the geth binary:

 ⚡ root@josephtran  ~  story-geth version
Geth
Version: 1.0.1-stable
Git Commit: c50b42fc245adbd03b2b51b84e6c1ba47b624f09
Git Commit Date: 20250130
Architecture: amd64
Go Version: go1.22.0
Operating System: linux
GOPATH=
GOROOT=

Download Story binary v1.1.0

cd $HOME
rm -rf story-linux-amd64
wget https://github.com/piplabs/story/releases/download/v1.1.0/story-linux-amd64
[ ! -d "$HOME/go/bin" ] && mkdir -p $HOME/go/bin
if ! grep -q "$HOME/go/bin" $HOME/.bash_profile; then
  echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
fi
chmod +x story-linux-amd64
sudo cp $HOME/story-linux-amd64 $HOME/go/bin/story
source $HOME/.bash_profile
story version

You should expect to see version 1.0.0-stable:

⚡ root@josephtran  ~  story version
Version       v1.1.0-stable
Git Commit    0949ba7
Git Timestamp 2025-02-05T05:49:22Z

Clear state:

If you ever run into issues and would like to try joining the network from a COMPLETELY fresh state

Caution

WARNING: THIS WILL DELETE YOUR priv_validator_key.json FILE. Please backup your key /root/.story/story/config/priv_validator_key.json before remove old node.

rm -rf $HOME/.story

Init Story Testnet Aeneid node

story init --network aeneid --moniker "Your_moniker_name"

Create story-geth service file

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

[Service]
User=root
ExecStart=/root/go/bin/story-geth --aeneid --syncmode full
Restart=on-failure
RestartSec=3
LimitNOFILE=4096

[Install]
WantedBy=multi-user.target
EOF

Create story service file

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

[Service]
User=root
ExecStart=/root/go/bin/story run
Restart=on-failure
RestartSec=3
LimitNOFILE=4096

[Install]
WantedBy=multi-user.target
EOF

Download snapshot

# download Story snapshot
cd $HOME
rm -f Story_snapshot.lz4
aria2c -x 16 -s 16 -k 1M https://story.j-node.net/testnet/Story_snapshot.lz4

# download Geth snapshot
cd $HOME
rm -f Geth_snapshot.lz4
aria2c -x 16 -s 16 -k 1M https://story.j-node.net/testnet/Geth_snapshot.lz4

# backup priv_validator_state.json
cp $HOME/.story/story/data/priv_validator_state.json $HOME/.story/priv_validator_state.json.backup

# remove old data
rm -rf $HOME/.story/story/data
rm -rf $HOME/.story/geth/aeneid/geth/chaindata

# decompress Story snapshot
sudo mkdir -p $HOME/.story/story/data
lz4 -d -c Story_snapshot.lz4 | pv | sudo tar xv -C $HOME/.story/story/ > /dev/null

# decompress Geth snapshot
sudo mkdir -p $HOME/.story/geth/aeneid/geth/chaindata
lz4 -d -c Geth_snapshot.lz4 | pv | sudo tar xv -C $HOME/.story/geth/aeneid/geth/ > /dev/null

# restore priv_validator_state.json
cp $HOME/.story/priv_validator_state.json.backup $HOME/.story/story/data/priv_validator_state.json

Reload and start story-geth

sudo systemctl daemon-reload && \
sudo systemctl start story-geth && \
sudo systemctl enable story-geth && \
sudo systemctl status story-geth

Reload and start story

sudo systemctl daemon-reload && \
sudo systemctl start story && \
sudo systemctl enable story && \
sudo systemctl status story

Check logs

sudo journalctl -u story-geth -f -o cat

Wait a minute for connect peers

sudo journalctl -u story -f -o cat

Check sync status

curl localhost:26657/status | jq

Check block sync left:

while true; do
    local_height=$(curl -s localhost:26657/status | jq -r '.result.sync_info.latest_block_height');
    network_height=$(curl -s https://aeneid.storyrpc.io/status | jq -r '.result.sync_info.latest_block_height');
    blocks_left=$((network_height - local_height));
    echo -e "\033[1;38mYour node height:\033[0m \033[1;34m$local_height\033[0m | \033[1;35mNetwork height:\033[0m \033[1;36m$network_height\033[0m | \033[1;29mBlocks left:\033[0m \033[1;31m$blocks_left\033[0m";
    sleep 5;
done

Faucet token

• Faucet link:

Story | Google Cloud Faucet

• Explorer:

STORY Explorer

Create validator

Export validator Public Key & Private key

By default, when you run story init a validator key is created for you. To view your validator key, run the following command:

story validator export

This will print out your validator public key file in compressed and uncompressed formats. By default, we use the hex-encoded compressed key for public identification.

Compressed Public Key (hex): 03bdc7b8940babe9226d52d7fa299a1faf3d64a82f809889256c8f146958a63984
Compressed Public Key (base64): A73HuJQLq+kibVLX+imaH689ZKgvgJiJJWyPFGlYpjmE
Uncompressed Public Key (hex): 04bdc7b8940babe9226d52d7fa299a1faf3d64a82f809889256c8f146958a6398496b9e2af0a3a1d199c3cc1d09ee899336a530c185df6b46a9735b25e79a493af
EVM Address: 0x9EacBe2C3B1eb0a9FC14106d97bd3A1F89efdDCc
Validator Address: storyvaloper1p470h0jtph4n5hztallp8vznq8ehylsw9vpddx
Delegator Address: story1p470h0jtph4n5hztallp8vznq8ehylswtr4vxd

In addition, if you want to export the derived EVM private key of your validator into the default data config directory, please run the following:

story validator export --export-evm-key

Note that to participate in consensus, at least 1024 IP must be staked (equivalent to 1024000000000000000000 wei)!
Faucet link: https://cloud.google.com/application/web3/faucet/story/aeneid/

Create validator

story validator create --stake 1024000000000000000000 --private-key "your_private_key" --moniker "your_moniker_name"

Caution

Backup the validator key:

• File location: /root/.story/story/config/priv_validator_key.json
• Copy this file to your local machine. Store it carefully; this is the most crucial key for your validator.

• Directoryroot

  • Directory.story

    • Directorystory

      • Directoryconfig

        • priv_validator_key.json important file
      • …

Validator Staking

story validator stake \
   --validator-pubkey "VALIDATOR_PUB_KEY_IN_HEX" \
   --stake 1024000000000000000000 \
   --private-key xxxxxxxxxxxxxx

Replace VALIDATOR_PUB_KEY_IN_HEX Amount: 1024000000000000000000=1024 IP Token

# Delete node

Caution

Backup your data, private key, validator key before remove node.

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