NetworkAdded

Event v101 → v277, v290 → current #0

Emitted when a new subnet is created on Bittensor.

Useful for: subnet ownersdevelopersanalyticsvalidatorsminers

The Big Picture

Subnets are the core of Bittensor - each one is a specialized AI network with its own incentive mechanism. Creating a subnet lets you build a decentralized AI application where miners compete to provide value and validators rank their work. This event marks the birth of a new subnet.

Why This Matters

Launching a subnet is a significant commitment - you're creating a new AI marketplace. This event confirms your subnet is live and ready for miners and validators to join. As subnet owner, you'll earn a portion of all emissions on your subnet.

Example Scenario

You've built an image generation validation mechanism. You call register_network, locking 1000 TAO as collateral. NetworkAdded fires with netuid 47 - your subnet is live. Now you can configure hyperparameters and invite miners to join.

Common Questions

How much does it cost to create a subnet?: The cost varies based on demand - check NetworkMinLockCost. It's locked, not burned, so you get it back if you dissolve the subnet (after immunity period).
What happens after my subnet is created?: Configure hyperparameters (tempo, weights limit, etc.), set up your validation mechanism, then promote your subnet to attract miners and validators.

Use Cases

Confirm your subnet creation succeeded
Discover new subnets to participate in
Track subnet ecosystem growth
Build subnet directory/explorer

How to Use This Event

→ Subscribe to track new subnet launches
→ Index to build subnet discovery tools
→ Alert when competitors launch subnets

From Chain Metadata

a new network is added.

Part of: Subnet Management

Triggers

Emitted by

register_network register_network_with_identity register_leased_network

Preconditions

Network registration fee paid (locked TAO)
Total subnet count below maximum
Valid network parameters provided

May fail with

NetworkAlreadyExists (removed)NotEnoughBalanceToStakeTooManySubnets (removed)

Effects

Storage Modified

Postconditions

New subnet exists with assigned netuid
Subnet owner set to creator
Subnet parameters initialized to defaults

Side Effects

TAO locked as collateral (not burned)
TotalNetworks counter increased

Event Data

#	Name	Type	Description
0	arg0 → netuid	u16 NetUid	Unique identifier for the new subnet (0-65535)
1	arg1 → modality	u16	Network modality type (legacy field, typically 0)

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Subscribe to NetworkAdded events
client.finalizedBlock$.subscribe(async (block) => {
  const events = await api.event.SubtensorModule.NetworkAdded.get(block.hash);
  for (const evt of events) {
    console.log("NetworkAdded:", evt.payload);
  }
});

Version History

Version:

v101 block 1 2 args

v290 block 5,947,548 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 0
First Version: v101
Current Version: v411

Back to SubtensorModule Events