Skip to content

Commit efba0bd

Browse files
committed
docs(delegating): clarify actively-earning delegation as the APR/APY denominator
1 parent b758663 commit efba0bd

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

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

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,23 @@ This gives the Delegator a share of the pool:
146146

147147
> 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.
148148
149+
### Measuring actively-earning delegation
150+
151+
When estimating APR or APY, divide rewards by the delegation that is **actively earning** — not by the Indexer's raw delegated total.
152+
153+
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.
154+
155+
The actively-earning base excludes thawing tokens:
156+
157+
```
158+
activeDelegation = delegatedTokens - thawingTokens
159+
```
160+
161+
- **On-chain:** call `getDelegatedTokensAvailable(serviceProvider, verifier)` on the HorizonStaking contract — it already excludes thawing delegation (including thawed-but-not-yet-withdrawn tokens).
162+
- **Network subgraph:** compute `Provision.delegatedTokens - Provision.delegatedThawingTokens`.
163+
164+
Use this value as the denominator when calculating delegation APR/APY.
165+
149166
## Delegator FAQs and Bugs
150167

151168
### MetaMask "Pending Transaction" Bug

0 commit comments

Comments
 (0)