Blog

SPS Validator Node: How to update to new version

By @hanv•3/19/2025•splinterlands

Quick Summary

./run.sh stop

git fetch --tags -f && git checkout v1.3.0

Update SNAPSHOT_URL and BLOCKS_BEHIND_HEAD in the .env file

Full snapshot URL update (replace the old URL with this one)
SNAPSHOT_URL=https://d33cuc2qlex36c.cloudfront.net/prod-snapshot-2025-11-25.zip

Lite snapshot URL update (small size, for users who only receive license rewards):
SNAPSHOT_URL=https://d33cuc2qlex36c.cloudfront.net/prod-slim-snapshot-2025-11-25.zip

BLOCKS_BEHIND_HEAD Value change (default changed to 3)
BLOCKS_BEHIND_HEAD=3

./run.sh replay  # type y, y

./run.sh start all

./run.sh logs  # Blocks to head: Wait until it becomes 0

After it becomes 0, change the status to Active in the Node UI

Done! Change the detail for other version & snapshot url

There are three kinds of updates as stated in the README file.

"block-hash-stable" updates. These are updates that you don't need to apply. They normally add additional endpoints to the validator API, or improve or fix bugs with the installation scripts.

"block-hash-breaking" updates. These are updates that you must apply before their scheduled "go-live" block. If your node is not updated before the go-live block, your node's block hash will be different, and you will not earn rewards.

"schema-breaking" updates. These are updates you must apply before their scheduled "go-live" block, but you must apply them on the block before the go-live block.

Version 1.0.1 is a block-hash-stable update.

To update node,

Inactivate your node first
https://thespsdao.github.io/SPS-Validator/validator-nodes/manage

2025-03-19-13-04-28.png


run ``` git fetch --tags -f && git checkout v1.0.1 

You can see this message. This message is normal

![2025-03-19-13-03-41.png](https://files.peakd.com/file/peakd-hive/hanv/EoATWzdJP7FbSspLVPa4t9YPq8NdMZ8FBA3HYbNDp6qXbr1eZkLpHs1uDLFdTXsw643.png)

./run.sh stop


![2025-03-20-07-36-36.png](https://files.peakd.com/file/peakd-hive/hanv/EoCZv13VyrjfyhBvGYc1TrvRDRqncJLp7TZzrVB2dKSCAVhGELXdQK3WjvukkewHeMv.png)

./run.sh rebuild_service validator

To rebuild the validator with the latest updates. This will also start the validator.

![2025-03-19-13-05-47.png](https://files.peakd.com/file/peakd-hive/hanv/23tv6RpaSo8FvCsptPdm6n9DxSc55vdS6e6XgnoeEYKfdHy2hn2EgTabHUCTNwK4KbPeV.png)

./run.sh rebuild_service ui

if you want to rebuild the UI.

Wait to become block to head:0

![2025-03-19-13-07-34.png](https://files.peakd.com/file/peakd-hive/hanv/23tS12fRXdSs5m2FrKKGgKVToikf2q2rDimZGywEEFejrCG81CPjHueVaWtTxQaiPgXi8.png)

Activate your node again

![2025-03-19-13-08-09.png](https://files.peakd.com/file/peakd-hive/hanv/48FmUS4BRVv58vuMH7YJijdU972YjGYTL2dkjnsV7MUrpUYiv5tSZLPDnFB8Ykjw2p.png)

You can see your node is running with update version!
https://thespsdao.github.io/SPS-Validator/validator-nodes/manage

![2025-03-19-13-08-56.png](https://files.peakd.com/file/peakd-hive/hanv/23tcNRVyjdHrevxXbuVEWZFsqoJu9DSk7J23MRk9QVb3QEWHC6AeHgvLC3uQ4Rioqi4BX.png)

comments