gr1dnetwork/circuit-node repository overview

⁠Grid Node Delegate Guide

⁠How to Run a Circuit Node

Grid lets you contribute compute to the network by running a Circuit Node and delegating your Node License to it via a job execution wallet. Follow the steps below to get started.

⁠Prerequisites

Before starting, ensure you have:

• Docker installed (on Linux, Mac, or Windows)
• A wallet address that owns node licenses (used in the OWNERS_ALLOWLIST)
• A separate burner wallet address (automatically generated by the node client and delegated to the Circuit Node)
• Testnet ETH on Arbitrum Sepolia (for gas on the burner wallet during testnet)

⁠Hardware Requirements

⁠Minimum:

• CPU with 1+ cores
• 2GB RAM
• 5GB Disk Space
• 4Mbps Internet Connection

⁠Recommended:

• Fast CPU with 2+ cores
• 4GB+ RAM
• 10GB+ Disk Space
• 8+ Mbps Internet Connection

⁠Step 1: Run the Circuit Node

⁠Linux & Mac

Open your terminal and run:

mkdir -p ~/flohive && docker run --pull always -v ~/flohive:/app/cache \
-e OWNERS_ALLOWLIST=0xLicenseOwnerAddress gr1dnetwork/circuit-node

⁠Windows

Open Command Prompt and run:

mkdir %USERPROFILE%\flohive 2>nul & docker run --pull always -v %USERPROFILE%\flohive:/app/cache ^
-e OWNERS_ALLOWLIST=0xLicenseOwnerAddress gr1dnetwork/circuit-node

⁠Step 2: Delegate a Burner Wallet

After the node is up and running:

1. Visit https://run.gr1d.network⁠
2. Connect your wallet that holds the node license(s)
3. Click the “Delegate” button
4. Enter your burner wallet address
5. Click “Delegate” to finalize

This links the execution wallet to your node license.

⁠Step 3: Fund the Burner Wallet

Your burner wallet needs gas to execute jobs.

To get your node burner address, check the logs for the following output:

[INFO] Using burner wallet {"address":"burner_address"}

• During testnet, send testnet ETH on Arbitrum Sepolia to your burner address.
• You can get testnet ETH from Sepolia faucets, e.g.:
  https://hackquest.io/faucets/421614⁠

⁠Done!

You’re now ready to run a Circuit Node and contribute to the Grid network.
Jobs will be executed on-chain via your delegated burner wallet.