The Web3 Index Subgraph

This package contains the source code for the Web3 Index Subgraph, a subgraph for indexing and querying fee data across Web3 network protocols using The Graph.

Requirements

• Node.js 20.19+ (see .nvmrc)
• Yarn 1.22.22 (via Corepack)
• @graphprotocol/graph-cli
• Arbitrum + Polygon RPC endpoints if you plan to run a local graph-node

Install

nvm use
npm install -g corepack
corepack enable
corepack prepare yarn@1.22.22 --activate
yarn install

Manifest workflow

This subgraph supports multiple networks:

• subgraph.yaml - Arbitrum manifest (indexes Livepeer + The Graph Billing)
• subgraph.polygon.yaml - Polygon manifest (indexes The Graph Billing only)
• subgraph.mainnet.yaml - Ethereum mainnet manifest (indexes Livepeer + The Graph Staking)

Each manifest already encodes its network, address, and start block, so the build/deploy scripts point directly at the desired file without rewriting them in-place.

Build + validate

Run the commands in this order whenever you change schemas/abis or switch manifests:

yarn codegen            # regenerates bindings for every manifest (must run first)
yarn build              # default Arbitrum build
yarn build:polygon      # polygon build (re-run codegen if generated files changed)
yarn build:mainnet      # mainnet build (re-run codegen if generated files changed)

Generated bindings live in generated/ and are recreated every build.

Local graph-node (optional)

1. Clone graph-node and update docker-compose.yml (or .env) so the ethereum env points to your RPC endpoints, e.g.

   ETHEREUM_RPC=arbitrum-one:https://arb-mainnet.g.alchemy.com/v2/<KEY>,polygon:https://polygon-mainnet.g.alchemy.com/v2/<KEY>
   

2. docker compose up inside graph-node/docker, wait for port 8020 to come up, then in this repo:

   yarn graph create --node http://localhost:8020/ web-3-index # run once
   yarn build
   yarn deploy:local

Subgraph Studio / The Graph Network

yarn graph auth <DEPLOY_KEY>
yarn deploy:studio           # Studio slug: web-3-index-arbitrum
yarn deploy:studio:polygon   # Studio slug: web-3-index-polygon
yarn deploy:studio:mainnet   # Studio slug: web-3-index-mainnet

Grab the deployment ID from Studio and drop it into GRAPH_SUBGRAPH_<NETWORK>_ID for the web app.

Handy scripts

Command	Description
yarn codegen	Regenerates bindings for Arbitrum, mainnet, and Polygon; always run this first
yarn build[:network]	Builds the manifest for that network using the latest generated files
yarn deploy:local[:net]	Deploys the current manifest to a local graph-node (ensure bindings are regenerated)
yarn deploy:studio[:net]	Deploys to Subgraph Studio (run yarn codegen first if code changed)
yarn lint	ESLint
yarn prettier	Formatting check