We propose an upgrade to the Rewards Manager and Subgraph Service contracts. This is an incremental improvement, no new protocol mechanisms are introduced. The upgrade refines how rewards are tracked, collected, and reported, and adds integration points that enable deployment of the Issuance Allocator (GIP-0076: Issuance Allocator contract to split issuance across distribution targets) and Rewards Eligibility Oracle (GIP-0079: Indexer Rewards Eligibility Oracle).
Why this matters:
The Rewards Manager gains an optional eligibility oracle hook. When governance connects an oracle (such as the one proposed in GIP-0079, the Rewards Manager consults it at claim time and denies rewards to indexers the oracle reports as ineligible. This is the integration point that allows service quality thresholds to affect reward distribution.
The Rewards Manager can also source its issuance rate from the Issuance Allocator (GIP-0076) instead of its own storage. This is what allows governance to split issuance across multiple targets, such as the Recurring Agreement Manager for indexing agreements, without changing the overall rate.
Every POI presentation now emits a `POIPresented` event that includes whether rewards were claimed, denied, or deferred, and the amount involved. Previously, indexers had limited on-chain visibility into why a POI presentation did or did not result in rewards.
Finally, governance can configure addresses to receive rewards that would otherwise be silently dropped (e.g., due to denied subgraphs or ineligible indexers). This prepares the infrastructure for redirecting unclaimable rewards back into the network, potentially by funding services that improve network health or increase its value to users, though no addresses are set by this upgrade.
Active on deployment:
- Clearer reward outcomes: POI presentation now results in one of three outcomes: claim (rewards distributed), deny (rewards forfeited), or defer (rewards preserved for later). A `POIPresented` event provides on-chain visibility into the outcome and amount.
- Accumulator fixes: Denied subgraphs freeze accumulators rather than accumulating unclaimable rewards. Periods of zero signal, below-minimum signal, and no allocations are tracked rather than silently lost.
Enabled but governance-gated:
- Eligibility oracle integration: Governance can connect an eligibility oracle so that only eligible indexers receive rewards. Does not activate until an oracle is configured.
- Issuance allocator integration: The Rewards Manager can source its issuance rate from the Issuance Allocator (GIP-0076). Does not activate until connected.
- Reclaim infrastructure: Governance can configure addresses to redirect unclaimable rewards back into the network, potentially by funding services that improve network health or increase its value to users. Does not activate until addresses are set.
None of the governance-gated features change protocol issuance or reward flows until separately configured.
For details: GIP-0086: Rewards Manager and Subgraph Service Upgrade