BulkNeuronsRegistered

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

Emitted when multiple neurons are registered in a single operation.

Useful for: subnet ownersvalidatorsminersanalyticsdevelopers

The Big Picture

Bulk registration is an administrative operation that registers many neurons at once. This might happen during subnet launches, migrations, or special events. Unlike individual registrations (which go through burn/PoW), bulk registration is typically an admin privilege used for coordinated onboarding. This event signals large-scale population changes.

Why This Matters

Bulk registrations change subnet dynamics quickly. If 50 new neurons suddenly appear, competition changes overnight. This event helps you understand when and why subnet populations shift, distinguishing organic growth from administrative action.

Example Scenario

A new subnet is launching with pre-vetted validators. The subnet owner bulk registers 20 validators to bootstrap the network. BulkNeuronsRegistered fires with 20 UIDs assigned. The subnet now has its initial validator set without each needing to register individually.

Common Questions

Who can do bulk registration?: Typically only subnet owners or network admins. It's not a public function - requires special privileges.
Does bulk registration bypass burn/PoW costs?: Usually yes - that's part of why it's admin-only. The admin decides who gets in, not the market mechanism.
Can existing neurons be pruned by bulk registration?: If the subnet is full, bulk registration might prune poor performers to make room. Check if this affects you if you're on a nearly-full subnet.

Use Cases

Track bulk onboarding of neurons to subnets
Monitor administrative registration events
Detect unusual bulk registration activity
Build subnet population tracking tools

How to Use This Event

→ Monitor for sudden subnet population changes
→ Track administrative activity on subnets
→ Build alerts for unusual bulk operations

From Chain Metadata

multiple uids have been concurrently registered.

Triggers

Emitted by

Preconditions

Bulk registration authorized (admin operation)
All hotkeys valid and unregistered on subnet
Subnet has capacity

May fail with

HotKeyNotRegisteredInSubNet NotRegistered HotKeyNotRegisteredInNetwork AlreadyRegistered HotKeyAlreadyRegisteredInSubNet

Effects

Storage Modified

Active BlockAtRegistration Consensus Dividends Emission Incentive IsNetworkMember Keys POWRegistrationsThisInterval PruningScores Rank RegistrationsThisBlock RegistrationsThisInterval SubnetworkN Trust Uids ValidatorPermit ValidatorTrust

Postconditions

Multiple UIDs assigned
All hotkey-coldkey associations recorded

Side Effects

SubnetworkN increased by count
May prune multiple existing neurons if full

Event Data

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

Version History

Version:

v101 block 1 2 args

v233 block 4,920,350 2 args

v273 block 5,659,032 2 args

v290 block 5,947,548 2 args Current

Runtime Info

View Source

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

Back to SubtensorModule Events