Yield Intelligence Changelog
Full version history of Yield Intelligence methodology decisions, from v1.0 to v4.2.
Jump to Version
LatestLatest Version
v4.2Mar 10, 2026
Source-aware history and confidence-weighted arbitration
Yield rankings now preserve per-source history, retain benchmark provenance, and prefer higher-confidence sources when multiple candidates disagree.
Impact Snapshot
- yield_history now persists per-source rows with best-source markers instead of a single mixed best series
- 7d and 30d APY metrics are computed from source-specific history, preventing source-switch contamination
- Rankings now include provenance for benchmark freshness, safety coverage, source-switch state, and selection reasoning
- Cross-source arbitration can reject divergent discovered or fallback sources when canonical sources disagree materially
v4.2Mar 10, 2026Source-aware history and confidence-weighted arbitration
Yield rankings now preserve per-source history, retain benchmark provenance, and prefer higher-confidence sources when multiple candidates disagree.
- yield_history now persists per-source rows with best-source markers instead of a single mixed best series
- 7d and 30d APY metrics are computed from source-specific history, preventing source-switch contamination
- Rankings now include provenance for benchmark freshness, safety coverage, source-switch state, and selection reasoning
- Cross-source arbitration can reject divergent discovered or fallback sources when canonical sources disagree materially
DetailsHide details
v4.2Mar 10, 2026
Source-aware history and confidence-weighted arbitration
Yield rankings now preserve per-source history, retain benchmark provenance, and prefer higher-confidence sources when multiple candidates disagree.
- yield_history now persists per-source rows with best-source markers instead of a single mixed best series
- 7d and 30d APY metrics are computed from source-specific history, preventing source-switch contamination
- Rankings now include provenance for benchmark freshness, safety coverage, source-switch state, and selection reasoning
- Cross-source arbitration can reject divergent discovered or fallback sources when canonical sources disagree materially
Impact Notes
- yield_history now persists per-source rows with best-source markers instead of a single mixed best series
- 7d and 30d APY metrics are computed from source-specific history, preventing source-switch contamination
- Rankings now include provenance for benchmark freshness, safety coverage, source-switch state, and selection reasoning
- Cross-source arbitration can reject divergent discovered or fallback sources when canonical sources disagree materially
0 commits
v4.1Mar 7, 2026Conservative LUSD Stability Pool source
LUSD gained a deterministic B.Protocol / Liquity Stability Pool source that estimates only the LQTY incentive stream and labels that limitation explicitly.
- Added direct on-chain LUSD source using Liquity Stability Pool deposits and CommunityIssuance totals
- APR converts projected LQTY emissions to USD using CoinGecko spot price and excludes ETH liquidation gains by design
- LUSD can now surface both B.Protocol Stability Pool and auto-discovered lending alternatives in the same ranking payload
DetailsHide details
v4.1Mar 7, 2026
Conservative LUSD Stability Pool source
LUSD gained a deterministic B.Protocol / Liquity Stability Pool source that estimates only the LQTY incentive stream and labels that limitation explicitly.
- Added direct on-chain LUSD source using Liquity Stability Pool deposits and CommunityIssuance totals
- APR converts projected LQTY emissions to USD using CoinGecko spot price and excludes ETH liquidation gains by design
- LUSD can now surface both B.Protocol Stability Pool and auto-discovered lending alternatives in the same ranking payload
Impact Notes
- Added direct on-chain LUSD source using Liquity Stability Pool deposits and CommunityIssuance totals
- APR converts projected LQTY emissions to USD using CoinGecko spot price and excludes ETH liquidation gains by design
- LUSD can now surface both B.Protocol Stability Pool and auto-discovered lending alternatives in the same ranking payload
0 commits
v4.0Mar 3, 2026ReconstructedMulti-source rankings and alternative-source transparency
Yield rankings moved from single-source rows to per-source modeling, so each coin can expose both native and wrapper yield paths.
- yield_data primary key changed to (stablecoin_id, source_key) with per-source rows
- is_best now marks the highest-APY source per coin; non-best alternatives are retained
- Tier 2 matching aggregates all valid sources (native map, wrapper map, symbol fallback)
- /api/yield-rankings now includes altSources[] and UI exposes +N alternative source details
DetailsHide details
v4.0Mar 3, 2026Reconstructed
Multi-source rankings and alternative-source transparency
Yield rankings moved from single-source rows to per-source modeling, so each coin can expose both native and wrapper yield paths.
- yield_data primary key changed to (stablecoin_id, source_key) with per-source rows
- is_best now marks the highest-APY source per coin; non-best alternatives are retained
- Tier 2 matching aggregates all valid sources (native map, wrapper map, symbol fallback)
- /api/yield-rankings now includes altSources[] and UI exposes +N alternative source details
Impact Notes
- yield_data primary key changed to (stablecoin_id, source_key) with per-source rows
- is_best now marks the highest-APY source per coin; non-best alternatives are retained
- Tier 2 matching aggregates all valid sources (native map, wrapper map, symbol fallback)
- /api/yield-rankings now includes altSources[] and UI exposes +N alternative source details
Reconstructed from git commit history.1 commit
- b94e042
v3.3Mar 3, 2026ReconstructedCoverage ratchet: deterministic overrides + address-aware discovery
Auto-discovered lending coverage expanded with stricter quality gates, deterministic overrides, and contract-address fallback matching for symbol drift.
- Auto-discovery added minimum APY/TVL filters and expanded protocol allowlist coverage
- Deterministic pool overrides introduced for hard-to-match symbols (including explicit safety bypass handling)
- findBestLendingPool now falls back to underlying token address matches when symbol matching fails
- Price-derived fallback explicitly extended to BUIDL when no usable on-chain or DL source exists
DetailsHide details
v3.3Mar 3, 2026Reconstructed
Coverage ratchet: deterministic overrides + address-aware discovery
Auto-discovered lending coverage expanded with stricter quality gates, deterministic overrides, and contract-address fallback matching for symbol drift.
- Auto-discovery added minimum APY/TVL filters and expanded protocol allowlist coverage
- Deterministic pool overrides introduced for hard-to-match symbols (including explicit safety bypass handling)
- findBestLendingPool now falls back to underlying token address matches when symbol matching fails
- Price-derived fallback explicitly extended to BUIDL when no usable on-chain or DL source exists
Impact Notes
- Auto-discovery added minimum APY/TVL filters and expanded protocol allowlist coverage
- Deterministic pool overrides introduced for hard-to-match symbols (including explicit safety bypass handling)
- findBestLendingPool now falls back to underlying token address matches when symbol matching fails
- Price-derived fallback explicitly extended to BUIDL when no usable on-chain or DL source exists
Reconstructed from git commit history.4 commits
- d9bf617
- 39f3f95
- 2a45230
- ce2293d
v3.2Mar 2, 2026ReconstructedInherited blacklistability alignment for inline safety scoring
Yield sync safety scoring switched to shared blacklistability logic (including reserve inheritance), improving parity with report-card safety behavior.
- Resilience inputs in inline safety computation now use shared isBlacklistable() logic
- Risk penalties in PYS better reflect inherited blacklist exposure
- Reduced divergence between yield-page safety grades and safety-scores page outputs
DetailsHide details
v3.2Mar 2, 2026Reconstructed
Inherited blacklistability alignment for inline safety scoring
Yield sync safety scoring switched to shared blacklistability logic (including reserve inheritance), improving parity with report-card safety behavior.
- Resilience inputs in inline safety computation now use shared isBlacklistable() logic
- Risk penalties in PYS better reflect inherited blacklist exposure
- Reduced divergence between yield-page safety grades and safety-scores page outputs
Impact Notes
- Resilience inputs in inline safety computation now use shared isBlacklistable() logic
- Risk penalties in PYS better reflect inherited blacklist exposure
- Reduced divergence between yield-page safety grades and safety-scores page outputs
Reconstructed from git commit history.1 commit
- 595f176
v3.1Mar 1, 2026ReconstructedAuto-discovery hardening and finite-math safeguards
Post-launch hardening pass improved reliability of discovered yield rows and prevented non-finite volatility values from polluting persisted rankings.
- NAV tokens were included in inline safety scoring instead of defaulting to implicit NR behavior
- Yield sync now reuses cached DeFiLlama pools from DEX sync to reduce upstream fetch failures
- Non-finite 30-day APY volatility values are sanitized before D1 writes
DetailsHide details
v3.1Mar 1, 2026Reconstructed
Auto-discovery hardening and finite-math safeguards
Post-launch hardening pass improved reliability of discovered yield rows and prevented non-finite volatility values from polluting persisted rankings.
- NAV tokens were included in inline safety scoring instead of defaulting to implicit NR behavior
- Yield sync now reuses cached DeFiLlama pools from DEX sync to reduce upstream fetch failures
- Non-finite 30-day APY volatility values are sanitized before D1 writes
Impact Notes
- NAV tokens were included in inline safety scoring instead of defaulting to implicit NR behavior
- Yield sync now reuses cached DeFiLlama pools from DEX sync to reduce upstream fetch failures
- Non-finite 30-day APY volatility values are sanitized before D1 writes
Reconstructed from git commit history.3 commits
- 2e2a0aa
- 9decd36
- 4402307
v3.0Mar 1, 2026ReconstructedAutomatic lending-opportunity discovery
Yield Intelligence expanded beyond explicitly yield-bearing tokens by automatically discovering best lending pools for safer non-yield-bearing coins.
- Added allowlist-based auto-discovery pass over DeFiLlama lending pools
- Eligibility gated by safety score threshold before pool selection
- Introduced defillama-auto source type and lending-opportunity yield classification
DetailsHide details
v3.0Mar 1, 2026Reconstructed
Automatic lending-opportunity discovery
Yield Intelligence expanded beyond explicitly yield-bearing tokens by automatically discovering best lending pools for safer non-yield-bearing coins.
- Added allowlist-based auto-discovery pass over DeFiLlama lending pools
- Eligibility gated by safety score threshold before pool selection
- Introduced defillama-auto source type and lending-opportunity yield classification
Impact Notes
- Added allowlist-based auto-discovery pass over DeFiLlama lending pools
- Eligibility gated by safety score threshold before pool selection
- Introduced defillama-auto source type and lending-opportunity yield classification
Reconstructed from git commit history.1 commit
- 2b1a551
v2.1Mar 1, 2026ReconstructedWarning-signal telemetry and fxUSD native mapping
Yield rows gained warning-signal state for anomaly detection, while deterministic pool coverage expanded with fxUSD native yield mapping.
- warning_signals persistence added with spike/divergence/trend/reward/TVL-outflow checks
- Signal detection now uses market-median APY and prior TVL context per coin
- Tier-2 deterministic source map added explicit fxUSD Stability Pool coverage
DetailsHide details
v2.1Mar 1, 2026Reconstructed
Warning-signal telemetry and fxUSD native mapping
Yield rows gained warning-signal state for anomaly detection, while deterministic pool coverage expanded with fxUSD native yield mapping.
- warning_signals persistence added with spike/divergence/trend/reward/TVL-outflow checks
- Signal detection now uses market-median APY and prior TVL context per coin
- Tier-2 deterministic source map added explicit fxUSD Stability Pool coverage
Impact Notes
- warning_signals persistence added with spike/divergence/trend/reward/TVL-outflow checks
- Signal detection now uses market-median APY and prior TVL context per coin
- Tier-2 deterministic source map added explicit fxUSD Stability Pool coverage
Reconstructed from git commit history.2 commits
- dcdefde
- 35f8021
v2.0Mar 1, 2026ReconstructedWave-1 coverage expansion and numerical hardening
Wave-1 expanded native/wrapper mappings and tightened core PYS stability math to avoid edge-case distortion.
- Added wave-1 variant/pool mappings for additional native-yield stablecoins
- Near-zero mean handling in stability/variance math prevents coefficient-of-variation blowups
- Safety fallback and finite-value guards were formalized for ranking writes
DetailsHide details
v2.0Mar 1, 2026Reconstructed
Wave-1 coverage expansion and numerical hardening
Wave-1 expanded native/wrapper mappings and tightened core PYS stability math to avoid edge-case distortion.
- Added wave-1 variant/pool mappings for additional native-yield stablecoins
- Near-zero mean handling in stability/variance math prevents coefficient-of-variation blowups
- Safety fallback and finite-value guards were formalized for ranking writes
Impact Notes
- Added wave-1 variant/pool mappings for additional native-yield stablecoins
- Near-zero mean handling in stability/variance math prevents coefficient-of-variation blowups
- Safety fallback and finite-value guards were formalized for ranking writes
Reconstructed from git commit history.2 commits
- f5ecd72
- 6b327eb
v1.1Mar 1, 2026ReconstructedLaunch-audit corrections for APY windowing and display
Early launch audit corrected APY window semantics and cleaned up yield stability presentation/lookup behavior.
- 7-day APY switched to timestamp-window filtering instead of proportional sample slicing
- Tier-1 previous exchange-rate reads were reused from cached lookup state
- Yield stability display normalized as a true 0-100 percentage in UI components
DetailsHide details
v1.1Mar 1, 2026Reconstructed
Launch-audit corrections for APY windowing and display
Early launch audit corrected APY window semantics and cleaned up yield stability presentation/lookup behavior.
- 7-day APY switched to timestamp-window filtering instead of proportional sample slicing
- Tier-1 previous exchange-rate reads were reused from cached lookup state
- Yield stability display normalized as a true 0-100 percentage in UI components
Impact Notes
- 7-day APY switched to timestamp-window filtering instead of proportional sample slicing
- Tier-1 previous exchange-rate reads were reused from cached lookup state
- Yield stability display normalized as a true 0-100 percentage in UI components
Reconstructed from git commit history.1 commit
- 873842c
v1.0Mar 1, 2026ReconstructedInitial Yield Intelligence release
Launched Yield Intelligence schema, cron computation pipeline, API surface, and dashboard integration.
- Introduced three-tier APY resolution (on-chain rate, DeFiLlama pool, NAV price-derived fallback)
- Launched PYS model (risk penalty + variance sustainability multiplier + scaling factor)
- Added yield_data/yield_history tables and public yield-rankings/yield-history API handlers
DetailsHide details
v1.0Mar 1, 2026Reconstructed
Initial Yield Intelligence release
Launched Yield Intelligence schema, cron computation pipeline, API surface, and dashboard integration.
- Introduced three-tier APY resolution (on-chain rate, DeFiLlama pool, NAV price-derived fallback)
- Launched PYS model (risk penalty + variance sustainability multiplier + scaling factor)
- Added yield_data/yield_history tables and public yield-rankings/yield-history API handlers
Impact Notes
- Introduced three-tier APY resolution (on-chain rate, DeFiLlama pool, NAV price-derived fallback)
- Launched PYS model (risk penalty + variance sustainability multiplier + scaling factor)
- Added yield_data/yield_history tables and public yield-rankings/yield-history API handlers
Reconstructed from git commit history.5 commits
- 0709a1d
- 569664e
- 22695dc
- 81ba632
- 0e7b8b3