The Big Picture
When stakers deposit TAO, they receive alpha from the pool (SubnetAlphaIn decreases). SubnetAlphaOut tracks the cumulative alpha that has been distributed to stakers. Together with SubnetAlphaIn and TotalAlpha, this completes the alpha accounting picture for a subnet.
Why This Matters
How much alpha has left the pool? SubnetAlphaOut tells you the total alpha now in stakers' hands. This helps you understand the subnet's staking activity level.
Example Scenario
Query SubnetAlphaOut(netuid=1) returns 8000000000000 (8T alpha). This much alpha has been distributed to stakers on subnet 1. Compare to SubnetAlphaIn to see how much remains in the pool.
Common Questions
- How does this relate to TotalAlpha?
- TotalAlpha = SubnetAlphaIn + SubnetAlphaOut (conceptually). SubnetAlphaIn is in the pool, SubnetAlphaOut is distributed to stakers.
- Does this decrease when people unstake?
- Yes, when stakers unstake and convert alpha back to TAO, SubnetAlphaOut decreases as alpha returns to the pool.
Use Cases
- Understand how much alpha has been claimed by stakers
- Calculate the ratio of pooled vs distributed alpha
- Build alpha distribution analytics
- Track subnet economic activity
- Monitor staking adoption on a subnet
From Chain Metadata
MAP ( netuid ) --> alpha_supply_in_subnet | Returns the amount of alpha in the subnet.
Purpose & Usage
Purpose
Track alpha that has left the pool and is now held by stakers.
Common Query Patterns
- Query by netuid for total distributed alpha
- Calculate pool vs staked alpha ratio
- Monitor stake distribution over time
Query Keys
| # | Name | Type | Description |
|---|---|---|---|
| 1 | netuid | u16 | netuid (u16, hashed key component) |
Stored Value
Relationships
Modified By
Code Examples
import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443
const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);
// Query SubnetAlphaOut storage
const netuid = 1;
const result = await api.query.SubtensorModule.SubnetAlphaOut.getValue(netuid);
console.log("SubnetAlphaOut:", result);On-Chain Activity
1M–10M estimated writes
#11 most written storage item
Modified via user-submitted extrinsics
As of block 7,429,232
Version History
Runtime Info
View Source- Pallet
- SubtensorModule
- Storage Kind
- Map
- First Version
- v233
- Current Version
- v411