Story Protocol

Mainnet

Story is making the legal system for creative Intellectual Property (IP) more efficient by turning IP "programmable" on the blockchain. To do this, we have created Story Network: a purpose-built layer 1 blockchain where people or programs alike can license, remix, and monetize IP according to transparent terms set by creators themselves. Resources

Website	https://www.storyprotocol.xyz/
Github	https://github.com/piplabs/story
Explorer	https://explorer.story.foundation/
Docs	https://docs.story.foundation/docs/
Discord	https://discord.gg/storyprotocol

Hardware requirements

CPU

8 cores

RAM

32 GB

Storage

500 GB NVME

Network

25 MBit/s

OS

Linux (Ubuntu 24.04 x64)

Installation 💾

Update repositories

apt update && apt upgrade -y

Install dependencies

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

Install GO

cd $HOME && ver="1.24.10" && \
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" && \
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bash_profile && \
source ~/.bash_profile && go version

Set var (replace your Moniker and custom port)

echo 'export MONIKER="Moniker"' >> $HOME/.bash_profile
echo "export STORY_CHAIN_ID="story"" >> $HOME/.bash_profile
echo "export STORY_PORT="26"" >> $HOME/.bash_profile
source $HOME/.bash_profile

Get binaries

# Get Story-geth
cd $HOME
rm -rf story-geth
git clone https://github.com/piplabs/story-geth.git
cd story-geth
git checkout v1.2.1
make geth
mkdir -p $HOME/go/bin/
mv build/bin/geth  $HOME/go/bin/story-geth
[ ! -d "$HOME/.story/story-geth" ] && mkdir -p "$HOME/.story/story-geth"
story-geth version


# Get Story
cd $HOME
wget -O story-linux-amd64 https://github.com/piplabs/story/releases/download/v1.5.2/story-linux-amd64
cp story-linux-amd64 $HOME/go/bin/story
sudo chown -R $USER:$USER $HOME/go/bin/story
sudo chmod +x $HOME/go/bin/story
[ ! -d "$HOME/.story/story" ] && mkdir -p "$HOME/.story/story"
story version

Initialize

story init --moniker $MONIKER --network $STORY_CHAIN_ID

Set custom ports in story.toml and config.toml file (if needed)

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

Enable prometheus and disable indexing

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

Create a service Story-geth

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

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

[Install]
WantedBy=multi-user.target
EOF

Create a service 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

Restart and run

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

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

Check status

curl localhost:${STORY_PORT}657/status | jq

Check logs

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

Sync from snapshot

You can find and use community snapshots. Wait for full synchronization before proceeding to the next step.

Create a validator

View validator key

story validator export

Export EVM private key

story validator export --export-evm-key

You can import the private key into an EVM wallet

For create the validator, you need 1024 $IP token.

Create a validator

Move your txt file to .env file with your private key

The .env file should look like the following (make sure not to add a 0x prefix):

PRIVATE_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

mv $HOME/.story/story/config/private_key.txt $HOME/.env

Create validator (locked):

story validator create --stake 1024000000000000000000 --moniker $MONIKER --chain-id 1514 --unlocked=false

Or create validator (unlocked):

story validator create --stake 1024000000000000000000 --moniker $MONIKER --chain-id 1514 --unlocked=true

Remember to backup your validator priv_key from here

cat $HOME/.story/story/config/priv_validator_key.json

Useful commands ⚙️

node info

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

logs

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

restart service

sudo systemctl restart story-geth
sudo systemctl restart story

stop service

sudo systemctl stop story-geth
sudo systemctl stop story

enable service

sudo systemctl enable story-geth
sudo systemctl enable story

disable service

sudo systemctl disable story-geth
sudo systemctl disable story

Delete 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