Reference

Glossary

66 terms, defined once. Terms marked obsolete are kept deliberately: you will meet them in material written before Arbitrum or before Horizon, and knowing they are dead is more useful than not finding them at all.

A

Agora

The language indexers write cost models in. Maps query shapes to prices so the gateway knows what serving your answer costs.

Read the lesson

Allocation

A commitment of an indexer’s stake to a specific subgraph, which they undertake to index and serve. The unit that earns indexing rewards.

Read the lesson

Arbitrator

Decides disputes, and under Horizon also decides the slash amount by severity within a cap. A human judgement, appointed through governance.

Read the lesson

Arbitrum One

The Ethereum layer two where the protocol contracts and stakeable GRT operate. Not Ethereum mainnet.

Read the lesson · Protocol settlement layer: Arbitrum One

AssemblyScript

The language subgraph mappings are usually written in. Compiles to WebAssembly, and its runtime forbids anything non-deterministic.

Read the lesson

B

Bonding curve obsolete

The L1 curation pricing model, where share price rose with shares issued. Replaced on Arbitrum by a flat curve. Advice about timing the curve describes a protocol that no longer exists.

Read the lesson

C

Cobb-Douglas obsolete

The previous query fee rebate mechanism, replaced by exponential rebates in GIP-0051. It depended on global network state and historically burned over half of query fees.

Read the lesson · Query fees burned under Cobb-Douglas: over 50%

Cost model

An indexer’s published pricing for query shapes. Priced too high and the gateway routes elsewhere; too low and you serve expensive queries at a loss.

Read the lesson

Curation tax curation deposit charge

The charge on entering a curation position. Burned rather than paid to anyone, so nobody in the system profits from churn.

Read the lesson · Curation tax: 1%

Curator

Deposits GRT against a subgraph to signal that it is worth indexing. Paid from query fees on that subgraph, so the return depends on the forecast being right.

Read the lesson

D

Data service

Under Horizon, a service that indexers provision stake to, with its own rules, obligations and slashing. The Subgraph Service is the first and today the dominant one.

Read the lesson

Delegation capacity

The ceiling on delegated stake an indexer can usefully accept, a multiple of their self-stake. Beyond it, rewards for every delegator in the pool are diluted.

Read the lesson · Maximum delegation ratio: 16x

Delegation tax obsolete

A charge formerly levied on delegation deposits. Removed by Horizon. The tokenomics page still describes it, which is recorded as a known contradiction.

Read the lesson · Delegation tax: 0%

Delegator

Puts GRT behind an indexer without running anything, taking a share of what that indexer earns after the indexer’s cut.

Read the lesson

Dispute

A challenge to an indexer’s POI or query response, raised by a Fisherman with a deposit and decided by arbitrators.

Read the lesson

E

Epoch

A protocol time unit used for accounting. Less central under Horizon than in earlier designs, where allocation lifetimes were denominated in epochs.

Read the lesson

Exponential rebates

The current query fee rebate mechanism from GIP-0051. Depends only on your own stake and your own fees, with no term for any other indexer.

Read the lesson · Rebate function lambda: 0.6

F

Firehose

The extraction layer. Instruments a chain node to emit an ordered stream of flat files, so history is read sequentially rather than over request-response RPC.

Read the lesson

Fisherman

Anyone who raises a dispute against an indexer. Requires a deposit, which is what stops disputes becoming a harassment tool.

Read the lesson · Fisherman dispute deposit: 10,000 GRT

G

Gateway

Sits between an application and indexers. Selects an indexer, attaches the payment receipt, and fails over. You never query an indexer directly.

Read the lesson

GCS Graph Curation Shares

What you receive for signalling. Your claim on a subgraph’s curation pool is proportional to the shares you hold, and exiting means burning them.

Read the lesson

GGP Graph Governance Proposal

What the Council actually votes on, potentially bundling several GIPs into one release. Six positive votes accept it.

Read the lesson

GIP Graph Improvement Proposal

A written proposal for a protocol change. Anyone can write one, and its existence means somebody argued for it rather than that anything was decided.

Read the lesson

GIP-0051

Replaced Cobb-Douglas rebates with the exponential rebate function. The clearest single document on why the old mechanism had to go.

Read the lesson

GIP-0089 Innovation Allocation

Council-approved redirect of a share of protocol issuance to the Foundation treasury, effective 2026-08-31. Reduces the issuance reaching indexers and delegators.

Read the lesson · Issuance redirected to the Innovation Allocation: 20%

Graph Council

A six-of-ten multisig governing the protocol, balancing five stakeholder groups. Not a token vote.

Read the lesson

Graph Explorer

The official interface for browsing subgraphs, indexers and protocol state, and for delegating and curating.

Read the lesson

Graph Foundation

Holds and deploys funds, including grants. Distinct from the Council, which approves protocol changes. A grant is not protocol approval.

Read the lesson

graph-node

The component that executes subgraphs: follows chains, runs mappings, writes entities to Postgres and answers GraphQL.

Read the lesson

GraphTally TAP · Timeline Aggregation Protocol

The payment system. Signed receipts per query aggregate into vouchers that settle on chain, so payment need not happen per query and need not be trusted.

Read the lesson

GRT

The protocol token, used for staking, delegation, curation signal and query fees. Operates on Arbitrum One for protocol purposes.

Read the lesson · Initial GRT supply: 10 billion GRT

H

Horizon Graph Horizon

The protocol upgrade live from 2025-12-11 that made The Graph a substrate for multiple data services, with stake provisioned per service.

Read the lesson

Hosted Service obsolete

The retired centralised deployment target. A tutorial telling you to deploy there predates the current protocol entirely, and its economics will be wrong too.

Read the lesson

I

Indexer

Runs the infrastructure: follows chains, builds indexes, serves queries, publishes proofs. The only role that operates a service and can be slashed for false claims.

Read the lesson

indexer-agent

The decision-making component. Opens and closes allocations by your indexing rules, manages deployments, and submits redemption transactions.

Read the lesson

indexer-service-rs

The query front door. Validates the payment receipt attached to each query, forwards to graph-node, and stores receipts. Stateless.

Read the lesson

indexer-tap-agent

Aggregates stored receipts into redeemable vouchers. Runs as a single instance. If it stops, queries are served for free and nothing looks wrong.

Read the lesson

Indexing reward cut

The share of indexing rewards the indexer keeps. The remainder goes to the delegation pool, so a lower cut is better for delegators.

Read the lesson

Indexing rewards

Paid from new issuance to indexers allocated to subgraphs who prove their work. Exist whether or not anyone queried anything, which is what lets new subgraphs get indexed.

Read the lesson · Annual GRT issuance: 3%

Indexing rules

The policy telling indexer-agent what to allocate to. Modes include always, never, rules and offchain.

Read the lesson

Issuance

Newly minted GRT, targeted at a percentage of supply per year, funding indexing rewards. A share is now redirected to the Foundation treasury.

Read the lesson · Annual GRT issuance: 3%

M

Manifest subgraph.yaml

The file declaring which contracts a subgraph watches, from which block, and which handler runs for each event.

Read the lesson

Mapping

The handler code turning a chain event into entity writes. Must be deterministic: no network calls, no clock, no randomness.

Read the lesson

maxPOIStaleness

How long an allocation can go without a fresh POI before it stops earning. Nothing is confiscated, it simply stops paying.

Read the lesson · Maximum POI staleness: 28 days

O

Operator key

A key authorised to act for an indexer, submitting POIs, allocations and redemptions, without being able to move the stake.

Read the lesson

Over-delegation

Delegated stake beyond an indexer’s capacity. The excess cannot be used and rewards for every delegator in the pool are diluted, not just the newest.

Read the lesson · Maximum delegation ratio: 16x

P

POI Proof of Indexing

A hash committing to the data an indexer derived. Not a cryptographic proof: it makes claims comparable, so dishonesty is detectable by anyone doing the same work.

Read the lesson

Provision

Stake committed to a named data service under that service’s rules. Horizon’s replacement for one general staking pool.

Read the lesson

Q

Query fee cut

The share of query fees the indexer keeps, with the remainder going to the delegation pool. Like the reward cut, it points at the indexer.

Read the lesson

Query fees

Real revenue paid by data consumers for queries. As large as demand and no larger, in contrast to issuance.

Read the lesson · Query fee burn: 1%

R

RAV Receipt Aggregate Voucher

Many signed receipts collapsed into one object saying everything up to here totals this much. What actually settles on chain.

Read the lesson

Rebate

The portion of query fees an indexer keeps, determined by the exponential rebate function from their own stake ratio. The remainder is burned.

Read the lesson

Receipt

A payment record signed by the payer and sent with each query. Signed by the payer rather than issued by the indexer, because the indexer has the incentive to inflate it.

Read the lesson

Reorg reorganisation

A chain retracting blocks. Indexed data derived from retracted blocks must be unwound, which constrains how mappings can accumulate state.

Read the lesson

S

Schema schema.graphql

A subgraph’s entity definitions. Both the storage model and the query API, and the most expensive thing to change once consumers exist.

Read the lesson

Self-stake

An indexer’s own staked GRT, as opposed to delegated stake. It is what is at risk for misbehaviour and it sets the delegation capacity ceiling.

Read the lesson · Minimum Indexer self-stake: 100,000 GRT

Signal

GRT deposited against a subgraph by curators, indicating it is worth indexing. A forecast of query demand with money behind it.

Read the lesson

Slashing

Loss of staked GRT for a proven false claim. Under Horizon the amount is judged by arbitrators within a cap rather than fixed. Downtime is not slashable.

Read the lesson · Maximum slashable percentage: 10%

Stake ratio

An indexer’s stake divided by the query fees they generated on a subgraph. The only input to the rebate function, and effectively flat past about 8.

Read the lesson

Subgraph

A manifest, a schema and mappings that together define a deterministic function from chain events to queryable entities.

Read the lesson

Subgraph Service

The first and currently dominant Horizon data service, covering subgraph indexing and serving. Indexers register directly with it.

Read the lesson

Subgraph Studio

Where subgraphs are developed and deployed before publishing to the network, and where API keys are managed.

Read the lesson

Substreams

Composable WebAssembly modules over a Firehose stream. Outputs cache and work parallelises by block range, which is why backfills are fast.

Read the lesson

T

Thawing period undelegation period · unbonding

The wait between undelegating and withdrawing, during which capital earns nothing. Exists so stake is still reachable when misbehaviour is arbitrated.

Read the lesson · Undelegation (thawing) period: 28 days

Token API

A REST API for balances, transfers, prices and NFT ownership across several chains, built on Substreams. No subgraph to author and no signal to post.

Read the lesson

U

Unsignal

Withdrawing curation signal by burning shares back to the pool. On Arbitrum the cost does not depend on when you entered.

Read the lesson