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:

  1. Connect your wallet that holds the node license(s)

  2. Click the “Delegate” button

  3. Enter your burner wallet address

  4. 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"}

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