Skip to main content

Archival Node

Running an Archival node for the 0G-Galileo-Testnet means providing complete historical data storage and access for the network, maintaining the full blockchain history and state.

What You'll Need
  • Linux system with sufficient disk space for archive data
  • lz4 compression tool installed
  • Public IP address for node connectivity
  • Stable internet connection

Hardware Requirements​

ComponentRequirement
Memory64 GB
CPU8 cores
DiskLarge NVME SSD (for full archive data)
Bandwidth100 MBps for Download / Upload

Prerequisites​

Required Files​

  1. Node Package: galileo-archive.tar.gz
  2. Archive Snapshot: Download from https://chain-snapshot.oss-cn-hongkong.aliyuncs.com/snapshot/galileo/archive/20250717.tar.lz4

System Requirements​

  • Linux system with sufficient disk space for archive data
  • lz4 compression tool installed
  • Public IP address for node connectivity

Setup Guide​

1. Download Node Package​

Download the node package: galileo-archive.tar.gz

2. Extract Node Package​

Unzip the file to your home directory

3. Download Archive Snapshot​

Download the archive node snapshot from:

https://chain-snapshot.oss-cn-hongkong.aliyuncs.com/snapshot/galileo/archive/20250717.tar.lz4

4. Extract Snapshot​

lz4 -d 20250717.tar.lz4 | tar -xvf - -C /your/snapshot/directory

Deployment Steps​

1. Copy Files and Set Permissions​

cd galileo-v1.2.0
cp -r 0g-home {your data path}
sudo chmod 777 ./bin/geth
sudo chmod 777 ./bin/0gchaind

2. Initialize Geth​

./bin/geth init --state.scheme=hash --db.engine=pebble --datadir /{your data path}/0g-home/geth-home ./genesis.json

3. Initialize 0gchaind with Temporary Directory​

./bin/0gchaind init {node name} --home /{your data path}/tmp

4. Copy Node Files to 0gchaind Home​

cp /{your data path}/tmp/data/priv_validator_state.json /{your data path}/0g-home/0gchaind-home/data/
cp /{your data path}/tmp/config/node_key.json /{your data path}/0g-home/0gchaind-home/config/
cp /{your data path}/tmp/config/priv_validator_key.json /{your data path}/0g-home/0gchaind-home/config/

5. Copy Data from Snapshot​

cp -r /your/snapshot/directory/0g-home/geth-home/geth/chaindata /{your data path}/0g-home/geth-home/geth/
cp -r /your/snapshot/directory/0g-home/0gchaind-home/data /{your data path}/0g-home/0gchaind-home/

6. Start 0gchaind​

cd galileo-v1.2.0
nohup ./bin/0gchaind start \
    --rpc.laddr tcp://0.0.0.0:26657 \
    --chaincfg.chain-spec devnet \
    --chaincfg.kzg.trusted-setup-path=kzg-trusted-setup.json \
    --chaincfg.engine.jwt-secret-path=jwt-secret.hex \
    --chaincfg.kzg.implementation=crate-crypto/go-kzg-4844 \
    --chaincfg.block-store-service.enabled \
    --chaincfg.node-api.enabled \
    --chaincfg.node-api.logging \
    --chaincfg.node-api.address 0.0.0.0:3500 \
    --pruning=nothing \
    --home /{your data path}/0g-home/0gchaind-home \
    --p2p.seeds 85a9b9a1b7fa0969704db2bc37f7c100855a75d9@8.218.88.60:26656 \
    --p2p.external_address {your node ip}:26656 > /{your data path}/0g-home/log/0gchaind.log 2>&1 &

7. Start Geth​

cd galileo-v1.2.0
nohup ./bin/geth \
    --config geth-archive-config.toml \
    --nat extip:{your node ip} \
    --bootnodes enode://de7b86d8ac452b1413983049c20eafa2ea0851a3219c2cc12649b971c1677bd83fe24c5331e078471e52a94d95e8cde84cb9d866574fec957124e57ac6056699@8.218.88.60:30303 \
    --datadir /{your data path}/0g-home/geth-home \
    --state.scheme=hash \
    --gcmode archive \
    --networkid 16601 > /{your data path}/0g-home/log/geth.log 2>&1 &

8. Verify Setup​

Check the logs to ensure the node is running properly:

# Check Geth logs
tail -f /{your data path}/0g-home/log/geth.log

# Check 0gchaind logs
tail -f /{your data path}/0g-home/log/0gchaind.log
Success Indicators
  • 0gchaind should show "Committed state" messages
  • Geth should show archive mode synchronization
  • No error messages in either log

Important Configuration Notes​

Variables to Replace​

  • {your data path}: Your chosen data directory path
  • {node name}: Your chosen node name
  • {your node ip}: Your server's public IP address
  • /your/snapshot/directory: Path where you extracted the snapshot

Directory Structure​

After setup, your directory structure should look like:

{your data path}/
└── 0g-home/
    ├── geth-home/
    ├── 0gchaind-home/
    │   ├── config/
    │   │   ├── node_key.json
    │   │   └── priv_validator_key.json
    │   └── data/
    │       └── priv_validator_state.json
    └── log/
        ├── 0gchaind.log
        └── geth.log

Network Ports​

Ensure the following ports are open:

  • 26657: 0gchaind RPC
  • 26656: 0gchaind P2P
  • 3500: Node API
  • 30303: Geth network

Archive Node Benefits​

Archive nodes provide several key benefits to the 0G network:

  • Complete Historical Data: Full access to all historical blockchain data and state
  • Enhanced Query Capabilities: Support for complex historical queries and analytics
  • Network Resilience: Backup and redundancy for the network's historical data
  • Developer Support: Essential for applications requiring historical blockchain data
Storage Requirements

Archive nodes require significantly more storage space than regular nodes as they maintain the complete blockchain history. Ensure adequate disk space before setup.