From efba0bdabd20f7ceacfaf40467a69c1c13d25a7a Mon Sep 17 00:00:00 2001 From: cargopete Date: Tue, 9 Jun 2026 20:25:22 +0300 Subject: [PATCH] docs(delegating): clarify actively-earning delegation as the APR/APY denominator --- .../resources/roles/delegating/delegating.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/website/src/pages/en/resources/roles/delegating/delegating.mdx b/website/src/pages/en/resources/roles/delegating/delegating.mdx index 79804c78a501..8601db742583 100644 --- a/website/src/pages/en/resources/roles/delegating/delegating.mdx +++ b/website/src/pages/en/resources/roles/delegating/delegating.mdx @@ -146,6 +146,23 @@ This gives the Delegator a share of the pool: > The formula above shows that it is possible for an Indexer offering only 20% to Delegators to provide a better reward than an Indexer giving 90%. Simply do the math to determine the best reward. +### Measuring actively-earning delegation + +When estimating APR or APY, divide rewards by the delegation that is **actively earning** — not by the Indexer's raw delegated total. + +When a Delegator undelegates, their GRT enters the 28-day thawing period and stops earning rewards. These tokens remain counted in the delegation pool's total balance even after thawing completes, right up until they are explicitly withdrawn. Dividing rewards by the raw delegated total therefore **understates** the real return, and the effect grows the longer withdrawals are deferred. + +The actively-earning base excludes thawing tokens: + +``` +activeDelegation = delegatedTokens - thawingTokens +``` + +- **On-chain:** call `getDelegatedTokensAvailable(serviceProvider, verifier)` on the HorizonStaking contract — it already excludes thawing delegation (including thawed-but-not-yet-withdrawn tokens). +- **Network subgraph:** compute `Provision.delegatedTokens - Provision.delegatedThawingTokens`. + +Use this value as the denominator when calculating delegation APR/APY. + ## Delegator FAQs and Bugs ### MetaMask "Pending Transaction" Bug