README.md

Guide to Run Fuel Testnet Node

About Fuel

Fuel is an operating system specifically designed for Ethereum rollups, helping developers build scalable decentralized economies.

• Twitter / X
• Website
• Discord
• Docs
• GitHub
• Explorer
• Forum
• Fuel Türkiye

About Fuel Node

In the Fuel blockchain, a node—commonly known as a client—is essential software that downloads, stores, and continuously updates a local copy of the blockchain. This software plays a key role in verifying the authenticity of each block and transaction, ensuring your node stays fully synchronized with the network. Fuel's nodes operate on a Proof of Authority (PoA) consensus mechanism, where trusted validators are tasked with block creation and transaction validation. This method enables the network to deliver faster transaction times and greater energy efficiency compared to other consensus models like Proof of Work or Proof of Stake.

Why Run a Node on Fuel?

Running your own Fuel node comes with significant benefits:

• Full Control: By hosting your own node, you maintain complete control over your interactions with the Fuel blockchain, avoiding rate limits and third-party dependencies.
• Network Independence: Running your own node ensures that you're not reliant on external services, granting you the freedom to execute queries and interact directly with the blockchain without restrictions.

System Requirements

Hardware	Minimum	Recommended
Processor	2 Cores	8 Cores
Memory	4 GB	12 GB
Storage	30 GB	100 GB

Step 1: System Updates and Installation of Required Tools

Update System Packages

sudo apt-get update && sudo apt-get upgrade -y
sudo apt install wget curl

Rust and Cargo Installation

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

source $HOME/.cargo/env

Check Rust version:

rustup --version

Step 2: Fuel Toolchain

Download and Install Fuel

curl https://install.fuel.network | sh
source /root/.bashrc

Check the fuelup to make sure it is installed correctly:

fuelup --version

Generating a P2P Key Pair

Note: After entering the command, it will give you important information. Remember to write it down and do not share it with anyone.

fuel-core-keygen new --key-type peering

Cloning the Chain Configuration and Copying Files

git clone https://github.com/FuelLabs/chain-configuration chain-configuration
mkdir ~/.fuel-testnet
cp -r chain-configuration/ignition/* ~/.fuel-testnet/

To obtain an RPC endpoint for Sepolia Ethereum, visit Alchemy and navigate to Apps > Endpoints > Networks. Under the Ethereum section, select Sepolia to obtain your RPC URL. We will use this URL as the Sepolia-ETH-RPC-ENDPOINT in the node configuration.

Step 3: Running Node

Create Screen

screen -S fuel-node

Run Node

Note: Change the NODENAME, P2P-SECRET, Sepolia-ETH-RPC-ENDPOINT values to your own.

fuel-core run \
--service-name=`NODENAME` \
--keypair `P2P-SECRET` \
--relayer `Sepolia-ETH-RPC-ENDPOINT` \
--ip=0.0.0.0 --port=4000 --peering-port=30333 \
--db-path ~/.fuel-testnet \
--snapshot ~/.fuel-testnet \
--utxo-validation --poa-instant false --enable-p2p \
--reserved-nodes /dns4/p2p-testnet.fuel.network/tcp/30333/p2p/16Uiu2HAmDxoChB7AheKNvCVpD4PHJwuDGn8rifMBEHmEynGHvHrf \
--sync-header-batch-size 100 \
--enable-relayer \
--relayer-v2-listening-contracts=0x01855B78C1f8868DE70e84507ec735983bf262dA \
--relayer-da-deploy-height=5827607 \
--relayer-log-page-size=500 \
--sync-block-stream-buffer-size 30

The logs should look like this. You can exit the screen with CTRL A+D. When you exit in this way, your node will continue to run on the screen.

Stopping Node

To stop the node, use the following command to reattach to the screen session:

screen -r fuel-node

Once inside the screen session, press CTRL + C to stop the node.