NetworkRemoved

Event v101 → current #1

Emitted when a subnet is removed from the network.

Useful for: subnet ownersminersvalidatorsanalytics

The Big Picture

Subnets can be removed either voluntarily (owner dissolves it) or involuntarily (poor performance, expired immunity). When a subnet dies, all neurons are deregistered and emissions stop. Locked TAO returns to the owner (if voluntary) or may be partially forfeited. This is the end of a subnet's life.

Why This Matters

If you're mining or validating on a subnet that gets removed, you need to find a new home. Your UID on that subnet is gone. This event gives you (or your automation) the signal to re-register elsewhere before your infrastructure sits idle.

Example Scenario

You're mining on subnet 47. The owner decides to dissolve it (maybe low emissions or strategic pivot). NetworkRemoved fires with netuid 47. Your miner no longer has a valid registration. Time to check bd list for other subnets to join.

Common Questions

What happens to my stake on a removed subnet?: Staked Alpha on that subnet gets converted based on the removal conditions. Check your balance after removal - the TAO should be available or redistributed.
Can a removed subnet netuid be reused?: Yes, subnet IDs can be recycled. A new subnet might get the same netuid later, but it's a completely different subnet with new registrations.

Use Cases

Get notified when a subnet shuts down
Track subnet lifecycle and mortality rates
Detect when to move your neurons elsewhere
Monitor ecosystem churn

How to Use This Event

→ Monitor subnets you participate in
→ Alert when subnet you're on gets removed
→ Track subnet survival rates over time

Part of: Subnet Management

Triggers

Emitted by

dissolve_network root_dissolve_network

Preconditions

Subnet exists
Removal authorized (owner dissolve or immunity expired)

May fail with

NetworkDoesNotExist SubNetworkDoesNotExist RootNetworkDoesNotExist NetworkExist HotKeyNotRegisteredInNetwork EmissionValuesDoesNotMatchNetworks DidNotPassConnectedNetworkRequirement NetworkTxRateLimitExceeded IncorrectNetworkVersionKey AllNetworksInImmunity CanNotSetRootNetworkWeights

Effects

Storage Modified

ColdkeySwapScheduled NetworksAdded SubnetOwner TotalNetworks

Postconditions

Subnet no longer exists
All neurons deregistered
NetworksAdded set to false for this netuid

Side Effects

Locked stake may be returned or redistributed
Emission share redistributed to remaining subnets

Event Data

#	Name	Type	Description
0	arg0 → netuid	u16	Network/subnet ID that was removed

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

Runtime Info

View Source

Pallet Index: 7
Event Index: 1
First Version: v101
Current Version: v393

Back to SubtensorModule Events