MinNonImmuneUidsSet

Event Re-added v365 → v367, v372 → v377, v385 → current #111

Emitted when minimum non-immune UIDs is changed.

View events on chain
Useful for: minersvalidatorssubnet ownersanalyticsdevelopers

The Big Picture

Immune neurons (newly registered, protected period) can't be pruned. MinNonImmuneUids ensures there are always enough non-immune neurons that CAN be pruned. Without this, a subnet could become all immune neurons with no one eligible for replacement. This maintains healthy turnover mechanics.

Why This Matters

If too many neurons are immune, no one can be pruned to make room for new registrations. MinNonImmuneUids ensures there's always a pool of pruneable neurons. This affects registration dynamics - new entrants need pruneable neurons to replace.

Example Scenario

Subnet 10 had many immune neurons blocking new registrations. They increase MinNonImmuneUids from 4 to 12. MinNonImmuneUidsSet fires. Now at least 12 neurons must be past their immunity period, ensuring there are always pruneable targets for new registrations.

Common Questions

How does this affect my immunity?
If you're within immunity period, you're protected. But the subnet needs MinNonImmuneUids neurons past immunity. Your immunity isn't shortened; rather, the subnet needs enough to have passed immunity.
What if there aren't enough non-immune neurons?
New registrations might be blocked until enough neurons exit immunity. The subnet protects itself from becoming unpruneable.
Does this affect pruning priority?
It affects eligibility, not priority. Non-immune neurons CAN be pruned; priority among them is determined by other factors (performance, stake, etc.).

Use Cases

  • Track pruning eligibility requirements
  • Understand immunity vs non-immunity dynamics
  • Monitor subnet pruning policies
  • Build pruning risk analysis tools

How to Use This Event

  • Monitor non-immune requirements on competitive subnets
  • Track changes affecting pruning dynamics
  • Build pruning risk models

From Chain Metadata

The minimum allowed non-Immune UIDs has been set.

Triggers

Preconditions

  • Caller has admin/sudo privileges

Effects

Postconditions

  • MinNonImmuneUids updated

Side Effects

  • Affects pruning behavior

Event Data

#NameTypeDescription
0
arg0
u16 Event field #0 (u16)
1
arg1
u16 Event field #1 (u16)

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 MinNonImmuneUidsSet events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "MinNonImmuneUidsSet"
    )
    .forEach(({ event }) => {
      console.log("MinNonImmuneUidsSet:", event.data.toHuman());
    });
});

Version History

v365 block 7,135,419 2 args
v372 block 7,430,358 2 args
v385 block 7,782,670 2 args Current

Runtime Info

View Source
Pallet Index
7
Event Index
111
First Version
v365
Current Version
v393