extern crate alloc; use frame_support::pallet_prelude::{Decode, Encode}; use substrate_fixed::types::U64F64; use subtensor_runtime_common::{AlphaBalance, NetUid, TaoBalance}; use subtensor_swap_interface::SwapHandler; use super::*; /// One holding inside a validator's beta basket, valued two ways: `spot_tao` marks at the /// pool's spot price (`price * alpha`, comparable across explorers), `realizable_tao` is the /// slippage-aware quote a full redemption would fetch right now (what NAV is built from). #[freeze_struct("eb63d95e3b7a7bc7")] #[derive(Decode, Encode, PartialEq, Eq, Clone, Debug, TypeInfo)] pub struct BasketHolding { pub netuid: NetUid, pub alpha: AlphaBalance, pub spot_tao: TaoBalance, pub realizable_tao: TaoBalance, } /// Everything an explorer needs to render one validator's beta basket in a single call: /// valuation (realizable NAV and spot NAV), share supply (share price = `nav_tao / shares`), /// lifetime flow counters (performance = `(nav + redeemed) / deposited`), the validator's /// weight vector (strategy), and the per-subnet holdings breakdown. #[freeze_struct("f467309dda61a20e")] #[derive(Decode, Encode, PartialEq, Eq, Clone, Debug, TypeInfo)] pub struct BasketSummary { pub hotkey: AccountId, /// Realizable (slippage-aware) NAV in TAO — the fund's redemption value. pub nav_tao: TaoBalance, /// Spot-marked NAV in TAO (`Σ price * alpha`) — the fund's headline mark. pub spot_nav_tao: TaoBalance, /// Outstanding fund shares `P`. pub shares: u64, /// Lifetime TAO value deposited into the fund. pub deposited_tao: TaoBalance, /// Lifetime TAO redeemed (claimed) out of the fund. pub redeemed_tao: TaoBalance, /// The validator's root weight vector `w` (its curation strategy), exactly as stored. pub weights: Vec<(NetUid, u16)>, /// Per-subnet holdings, each valued at spot and realizable. pub holdings: Vec, } impl Pallet { /// Spot-marked TAO value of `alpha` on `netuid`: `current_price * alpha`. Unlike /// [`Self::realizable_tao_for_alpha`] this ignores depth/slippage, so it can exceed what a /// redemption would fetch — it is exposed for display/analytics only and is never used for /// share pricing or redemption sizing. pub fn spot_tao_for_alpha(netuid: NetUid, alpha: u64) -> u64 { if alpha == 0 { return 0; } // Root holdings are TAO held 1:1; stable-mechanism subnets redeem 1:1. if netuid.is_root() || SubnetMechanism::::get(netuid) != 1 { return alpha; } T::SwapInterface::current_alpha_price(netuid.into()) .saturating_mul(U64F64::saturating_from_num(alpha)) .saturating_to_num::() } /// Full explorer-facing summary of one validator's beta basket. Always returns a summary /// (all-zero for a hotkey with no basket). pub fn get_validator_basket_summary(hotkey: &T::AccountId) -> BasketSummary { let mut nav: u64 = 0; let mut spot_nav: u64 = 0; let holdings: Vec = Self::get_basket_holdings(hotkey) .into_iter() .map(|(netuid, alpha)| { let realizable = Self::realizable_tao_for_alpha(netuid, alpha.to_u64()); let spot = Self::spot_tao_for_alpha(netuid, alpha.to_u64()); nav = nav.saturating_add(realizable); spot_nav = spot_nav.saturating_add(spot); BasketHolding { netuid, alpha, spot_tao: spot.into(), realizable_tao: realizable.into(), } }) .collect(); BasketSummary { hotkey: hotkey.clone(), nav_tao: nav.into(), spot_nav_tao: spot_nav.into(), shares: BasketShares::::get(hotkey), deposited_tao: BasketDepositedTao::::get(hotkey), redeemed_tao: BasketRedeemedTao::::get(hotkey), weights: Self::get_validator_root_weights(hotkey), holdings, } } /// Summaries for every validator with an active basket (outstanding shares), the /// network-wide leaderboard in one call. pub fn get_all_validator_baskets() -> Vec> { BasketShares::::iter_keys() .map(|hotkey| Self::get_validator_basket_summary(&hotkey)) .collect() } /// A staker's basket positions across all its validators: `(hotkey, owed_shares, /// payout_tao)` per validator with a non-zero position. `payout_tao` is the realizable /// (mark-to-market) TAO a claim would fetch right now. pub fn get_root_basket_positions( coldkey: &T::AccountId, ) -> Vec<(T::AccountId, u64, TaoBalance)> { StakingHotkeys::::get(coldkey) .into_iter() .filter_map(|hotkey| { let owed_shares = Self::get_basket_owed_shares(&hotkey, coldkey) .min(BasketShares::::get(&hotkey)); if owed_shares == 0 { return None; } let payout = Self::get_basket_payout_tao(&hotkey, coldkey); Some((hotkey, owed_shares, payout.into())) }) .collect() } }