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
Note: The Circuit Node does not need a static IP address or open ports.
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
Important: The
OWNERS_ALLOWLIST
environment variable must be set to the wallet address that owns your Grid node licenses. This allows the node to validate ownership before participating in job execution.
Step 2: Delegate a Burner Wallet
After the node is up and running:
Connect your wallet that holds the node license(s)
Click the “Delegate” button
Enter your burner wallet address
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.
Last updated