[maintainer] Validator APY / staking-yield modelling

[JSONbored]

APY/yield is the most differentiated validator-directory column and explicitly the harder slice: it requires an economics model (emission-to-stake yield over a freshness-aware window) plus reasoning about the daily-stale neuron tier vs near-real-time economics — not a deterministic pure-function bounty. Maintainer-owned per the featureGaps P2 split.

Deliverables

• Define the APY methodology (annualized emission/stake over a chosen window, root vs alpha handling) and document it in an ADR or methodology note
• Implement the computation server-side with explicit freshness handling (the metagraph tier is a ~daily rollup)
• Expose apy in /api/v1/validators + contracts + OpenAPI; add a methodology-callout in the UI
• Tests including zero-stake / zero-emission guards and window edge cases

References

• repo/src/metagraph-neurons.mjs:336 (loadGlobalValidators - where APY would derive from)
• repo-ui/src/components/metagraphed/methodology-callout.tsx (disclosure pattern)
• assessment/featureGaps.md P2 (APY = maintainer slice)

---

size: M · maintainer-only (owner)

[linear-code]

JSO-2089