Node Installation

Running a Celestium full node allows you to participate in the network, validate blocks, and access blockchain data directly. Follow the steps below to set up and run a Celestium node.

Hardware Requirements

Ensure your system meets the minimum hardware specifications to run a Celestium node efficiently:

• CPU: 16-core processor

• Memory: 32 GB RAM

• Storage: 2 TB NVMe SSD

• Network: 100 Mbps bandwidth

Install Dependencies

Make sure you have the following installed on your machine:

• Linux (Ubuntu 22.04 recommended) or any compatible Unix-based OS

• CMake (for build automation)

• GCC / Clang (C++ compiler)

• Git (for cloning repositories)

• Rust (for Rust components)

bash

sudo apt update
sudo apt install build-essential cmake git curl
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

Clone Celestium Client

Retrieve the Celestium client source code from the official repository:

bash

git clone https://github.com/celestium-network/celestium-client.git
cd celestium-client

Build the Node

Compile the node from source:

bash

mkdir build && cd build
cmake ..
make -j$(nproc)

Run the Node

After building, run the node to connect to the Celestium Testnet:

bash

./celestium-node --rpc http://rpc-private-testnet.celestium.network --chain-id 252525

Check Node Status

Once the node is running, you can verify its status using:

bash

curl -X POST http://127.0.0.1:8545 -H "Content-Type: application/json" --data '{
  "jsonrpc":"2.0",
  "method":"eth_syncing",
  "params":[],
  "id":1
}'

A response indicating false means your node is fully synced.

---

Next Steps

• Connect wallets like MetaMask to the Celestium Testnet.

• Deploy smart contracts using Hardhat or Foundry.

• Explore the network using http://testnet.celestium.network.

This setup will ensure your node is ready to interact with the Celestium blockchain network.