Alpha

Storage Map v233 → current

Alpha stake for a coldkey -hotkey pair on a subnet .

Queried by: stakersvalidatorsdelegatorsanalyticswallets

The Big Picture

Each subnet has its own 'alpha' token representing stake on that specific subnet. When you stake TAO to a subnet, you receive alpha proportional to the current exchange rate. Alpha stake determines your share of that subnet's emissions. It's like having a stake position denominated in subnet-specific units.

Why This Matters

Your stake on subnet X isn't just TAO - it's converted to alpha at the current rate. Alpha tracks your proportional ownership of stake on that subnet. Check Alpha to see your actual position.

Example Scenario

Query Alpha(coldkey=you, hotkey=validator_X, netuid=1) returns 1500000000000. You hold 1.5T alpha (1.5 trillion units) on subnet 1. Your share of emissions depends on this vs TotalAlpha(netuid=1).

Common Questions

How does alpha relate to TAO?: When you stake TAO, it's converted to alpha at the current pool rate (SubnetTAO/SubnetAlphaIn). When you unstake, alpha converts back to TAO at the current rate - which may differ.
Why alpha instead of just tracking TAO?: Alpha enables dynamic pricing. As more TAO enters a subnet, alpha becomes relatively more valuable. This creates economic incentives around subnet performance and demand.
Can I lose alpha?: Alpha is your stake. It doesn't decrease unless you unstake. But its TAO value fluctuates based on the subnet's liquidity pool dynamics.
Is alpha transferable?: Alpha is stake, not a transferable token. You can unstake (converting to TAO) and restake elsewhere, but can't directly send alpha to another account.

Use Cases

Check your alpha stake on a specific subnet
Calculate portfolio value in subnet-specific terms
Track alpha accumulation from staking
Build subnet-specific staking dashboards
Analyze alpha distribution across coldkeys

Purpose & Usage

Purpose

Track subnet-specific stake in alpha tokens - the subnet's native staking currency.

Common Query Patterns

Query alpha by coldkey-hotkey-netuid
Calculate subnet-specific stake position
Compare alpha holdings across validators

Part of: Yuma Consensus Stake Operations Alpha Token Conversion

Query Keys

#	Name	Type	Description
1	key1	AccountId	key1 (AccountId) (hex -> SS58)
2	key2	AccountId	key2 (AccountId) (hex -> SS58)
3	key3	u16	key3 (u16)

Stored Value

FixedU128

value (FixedU128)

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Query Alpha storage
const key1 = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
const key2 = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
const key3 = 0;

const result = await api.query
  [stringCamelCase("SubtensorModule")]
  [stringCamelCase("Alpha")](
  key1,
  key2,
  key3
);

console.log("Alpha:", result.toHuman());

On-Chain Activity

Write Frequency

●●●●●● Ultra-High >10M est. writes

>10M estimated writes

#3 most written storage item

Write Source User Extrinsics

Modified via user-submitted extrinsics

As of block 7,429,232

Runtime Info

View Source

Pallet: SubtensorModule
Storage Kind: Map
First Version: v233
Current Version: v393

Back to SubtensorModule Storage