StakeThresholdSet

Event Re-added v216 → v219, v233 → v247, v252 → v265, v273 → v277, v290 → v315, v320 → current #52

Emitted when the minimum stake threshold for validators is updated.

Useful for: validatorssubnet ownersanalyticsdevelopers

The Big Picture

Not all registered hotkeys can set weights - validators need sufficient stake to participate in consensus. The stake threshold ensures validators have 'skin in the game' before they can influence miner rankings. Higher thresholds mean more serious commitment required to validate. This parameter affects who can be a validator and thus who shapes the network's consensus.

Why This Matters

If you're validating, you need to stay above this threshold or you lose the ability to set weights. Dropping below means you're still registered but can't participate in consensus - effectively demoted to a neuron without validator powers. Watch for threshold changes and ensure your stake stays above the minimum.

Example Scenario

The network increases the validator stake threshold from 1,000 TAO to 2,000 TAO. StakeThresholdSet fires with the new value. Validators with only 1,500 TAO staked suddenly can't set weights anymore. They need to add 500+ TAO to regain validator status.

Common Questions

What happens if I fall below the threshold?: You can't set weights until you're above it again. Your registration stays, but you're effectively inactive as a validator. Add more stake to restore your weight-setting ability.
Is the threshold the same for all subnets?: It can vary - some subnets may have their own thresholds. Check the specific subnet's WeightMinStake parameter.
Does meeting the threshold guarantee I can validate?: Meeting the stake threshold is necessary but may not be sufficient. You also need to be registered and have validator permits (if applicable) on the subnet.

Use Cases

Monitor stake requirements for validator eligibility
Plan stake levels to maintain validator status
Track network-wide validator threshold changes
Build validator qualification dashboards

How to Use This Event

→ Monitor threshold changes that affect your validator eligibility
→ Track stake requirements across subnets
→ Build alerts for threshold changes

From Chain Metadata

min stake is set for validators to set weights.

Triggers

Preconditions

Caller has admin/sudo privileges
New threshold is valid

May fail with

NotEnoughStaketoWithdraw NotEnoughStake NotEnoughStakeToWithdraw NotEnoughStakeToSetWeights StakeToWithdrawIsZero NotEnoughStakeToSetChildkeys NotEnoughBalanceToStake StakeAlreadyAdded StakeRateLimitExceeded UnstakeRateLimitExceeded StakeTooLowForRoot BelowStakeThreshold NomStakeBelowMinimumThreshold CannotUnstakeLock ZeroMaxStakeAmount SameAutoStakeHotkeyAlreadySet AddStakeBurnRateLimitExceeded

Effects

Postconditions

WeightMinStake updated to new value

Side Effects

Validators below threshold may lose weight-setting ability

Event Data

#	Name	Type	Description
0	arg0	u64	Event field #0 (u64)

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 });

// Subscribe to StakeThresholdSet events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "StakeThresholdSet"
    )
    .forEach(({ event }) => {
      console.log("StakeThresholdSet:", event.data.toHuman());
    });
});

Version History

Version:

v216 block 4,510,996 1 args

v233 block 4,920,350 1 args

v252 block 5,163,656 1 args

v273 block 5,659,032 1 args

v290 block 5,947,548 1 args

v320 block 6,523,566 1 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 52
First Version: v216
Current Version: v393

Back to SubtensorModule Events