NeuronRegistered

Event Re-added v101 → v219, v233 → v265, v273 → v277, v290 → current #6

Emitted when a new neuron (miner or validator ) joins a subnet .

Useful for: minersvalidatorssubnet ownersanalyticsdevelopers

The Big Picture

Registration is how miners and validators join subnets to participate in consensus and earn emissions. Each subnet has limited UID slots, so registration can be competitive. You can register via proof-of-work (free but computational) or by burning TAO (fast but costs money).

Why This Matters

Before you can mine or validate on a subnet, you need a UID (unique identifier) on that subnet. This event confirms you've successfully claimed a spot and can now participate in consensus and earn emissions based on your performance.

Example Scenario

You want to run a miner on subnet 1. You call burned_register, paying the current burn cost (say 0.5 TAO). NeuronRegistered fires with your hotkey, subnet 1, and your new UID (say 47). Now your miner at UID 47 can receive queries from validators and earn emissions.

Common Questions

What's the difference between PoW and burn registration?: PoW is free but requires computing a hash solution (can take minutes to hours). Burn costs TAO but is instant. Both get you the same result - a UID on the subnet.
What if I get deregistered later?: Subnets have limited slots. If your performance is poor, you can be replaced by a better-performing neuron. Monitor your ranking to stay competitive.
Can I be on multiple subnets?: Yes! You can register the same hotkey on multiple subnets (one registration each).

Use Cases

Confirm your miner/validator registration succeeded
Track new participants joining your subnet
Monitor subnet growth and activity
Build subnet discovery and analytics tools

How to Use This Event

→ Subscribe to your hotkey to confirm registration
→ Monitor specific subnets for new registrations
→ Index all registrations to track network growth
→ Alert subnet owners when new neurons join

From Chain Metadata

a new neuron account has been registered to the chain.

Part of: Neuron Registration Neuron Pruning

Triggers

Emitted by

Preconditions

Subnet exists and is accepting registrations
Hotkey not already registered on this subnet
Registration fee/stake requirements met
Subnet has available UID slots

May fail with

NetworkDoesNotExist NotEnoughBalanceToStake HotKeyAlreadyRegisteredInSubNet MaxAllowedUIdsNotAllowed TooManyRegistrationsThisBlock NotEnoughStakeToSetWeights

Effects

Storage Modified

Postconditions

Neuron assigned a UID on the subnet
Hotkey now appears in subnet's Keys storage
Can participate in subnet consensus

Side Effects

May have burned TAO or used PoW
Registration count for subnet increased

Event Data

#	Name	Type	Description
0	arg0 → netuid	u16	Subnet ID where neuron registered
1	arg1 → uid	u16	Unique identifier within subnet
2	arg2 → hotkey	AccountId	Hotkey account of the neuron (hex -> SS58)

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

On-Chain Activity

Emission Frequency

●●●○○○ Active 100K–1M emissions

Regular feature-level activity

#27 most emitted event

As of block 7,429,232

Version History

Version:

v101 block 1 3 args

v233 block 4,920,350 3 args

v273 block 5,659,032 3 args

v290 block 5,947,548 3 args Current

Runtime Info

View Source

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

Back to SubtensorModule Events