Skip to content

Update indexing FAQ and delegating guide for Graph Horizon#1086

Merged
benface merged 5 commits intographprotocol:mainfrom
cargopete:docs/horizon-faq-delegating-update
Mar 18, 2026
Merged

Update indexing FAQ and delegating guide for Graph Horizon#1086
benface merged 5 commits intographprotocol:mainfrom
cargopete:docs/horizon-faq-delegating-update

Conversation

@cargopete
Copy link
Contributor

@cargopete cargopete commented Mar 18, 2026

Summary

Closes #1072

Updates the Indexing Overview FAQ and Delegating guide to reflect Graph Horizon (GIP-0066/0068/0085) changes. The Horizon upgrade fundamentally changed how rewards are collected and how delegation works. The primary operational docs had not been updated.

Changes

website/src/pages/en/indexing/overview.mdx

  • Rewrite FAQ: rewards are collected via periodic POI submission, not on allocation close
  • Remove 28-epoch maximum allocation lifetime language (Horizon removed maxAllocationEpochs)
  • Rewrite "The Life of an Allocation" section for Horizon lifecycle
  • Update POI FAQ entry to reflect rolling submission model
  • Add concrete maxPOIStaleness value (28 days) with force-closure consequences
  • Add new "Provisions and Data Services" section
  • Add inline notes on per-service delegation cut parameters and flexible slashing
  • Add cross-reference banner to /en/graph-horizon/ at top of page

website/src/pages/en/resources/roles/delegating/delegating.mdx

  • Remove all references to the 0.5% delegation tax (confirmed removed: __DEPRECATED_delegationTaxPercentage)
  • Add "Delegating under Graph Horizon" subsection covering per-data-service delegation
  • Document support for up to 100 simultaneous undelegation requests
  • Add note on auto-migration of existing delegations to SubgraphService
  • Add forward-looking note on future slashability capability

Verified from source

Parameter Source Value
maxPOIStaleness migrate.arbitrumOne.json5 2419200 sec (28 days)
delegationTaxPercentage HorizonStakingStorage.sol Deprecated, removed
maxAllocationEpochs HorizonStakingStorage.sol Deprecated, removed

What was NOT changed

  • /en/graph-horizon/ section (already accurate, used as source of truth)
  • GraphTally/TAP guide (already updated for Horizon v2.0.0)
  • Curation documentation (Horizon did not change curation mechanics)

@cargopete cargopete force-pushed the docs/horizon-faq-delegating-update branch from 1b0781d to 8715c69 Compare March 18, 2026 15:13
@cargopete cargopete marked this pull request as ready for review March 18, 2026 15:19
@cargopete cargopete requested a review from a team as a code owner March 18, 2026 15:19
cargopete and others added 4 commits March 18, 2026 21:26
Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com>
Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com>
Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com>
Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com>
@cargopete cargopete requested a review from benface March 18, 2026 19:27
Copy link
Contributor

@benface benface left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙌

@benface benface merged commit 400bddb into graphprotocol:main Mar 18, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

faq out of date ref indexing rewards

2 participants