Skip to content

docs(delegating): clarify actively-earning delegation as the APR/APY denominator #1109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cargopete wants to merge 1 commit into
base: main
Choose a base branch
from
+17 −0
Open

docs(delegating): clarify actively-earning delegation as the APR/APY denominator #1109

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions website/src/pages/en/resources/roles/delegating/delegating.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading