register_network

Call Re-added v133 → v219, v233 → current #59

Creates a new subnet on the Bittensor network.

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: subnet ownersdevelopers

The Big Picture

Creating a subnet is launching your own decentralized AI network. You design the validation mechanism, set hyperparameters, and attract miners/validators. Your subnet competes with others for TAO emissions based on root network voting. As owner, you earn a portion of all subnet emissions.

Why This Matters

Subnets are the innovation layer of Bittensor. Each one solves a different AI problem with its own validation logic. Creating one lets you build something unique and capture value from it.

Example Scenario

You've built an image generation validator. Call register_network to create your subnet. The lock cost (say 1000 TAO) is locked as collateral. You get netuid 47 and can now configure hyperparameters, set identity, and invite miners.

Common Questions

How much does it cost to create a subnet?
The lock cost varies based on demand. Check NetworkMinLockCost. It's locked, not burned - you can get it back by dissolving the subnet after the immunity period.
How do I get emissions for my subnet?
Root network validators vote on subnet emissions. Build something valuable, attract stake, and root voters will allocate emissions to you.

Use Cases

  • Launch a new AI marketplace with custom incentive mechanism
  • Create a specialized network for your validation logic
  • Build a decentralized AI application on Bittensor

From Chain Metadata

User register a new subnetwork

Part of: Subnet Management

Input Parameters

#NameTypeDescription
0
hotkey
AccountId Hot wallet address (active operations) (hex -> SS58)

Permissions

Origin
Unknown
Required Role
Coldkey

Requirements

  • Network registration cost paid (burned or locked)
  • Total subnet count below maximum
  • Valid network parameters provided

Effects

Events Emitted

NetworkAdded

Postconditions

  • New subnet created with assigned netuid
  • Caller set as subnet owner
  • Default network parameters applied

Side Effects

  • Registration cost burned
  • May affect emission distribution across subnets

Possible Errors

NetworkDoesNotExistSubNetworkDoesNotExistRootNetworkDoesNotExistNetworkExistHotKeyNotRegisteredInSubNetNotRegisteredHotKeyNotRegisteredInNetworkAlreadyRegisteredHotKeyAlreadyRegisteredInSubNetEmissionValuesDoesNotMatchNetworksDidNotPassConnectedNetworkRequirementNetworkTxRateLimitExceededIncorrectNetworkVersionKeyAllNetworksInImmunityCanNotSetRootNetworkWeights

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 });

// Build register_network call
const hotkey = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";

const call = api.tx[stringCamelCase("SubtensorModule")][stringCamelCase("register_network")](
  hotkey
);

On-Chain Activity

Usage Frequency
●●●●○○ Active 100K–1M extrinsics

Significant regular use

#24 most used call

Success Rate Highly competitive

Under 5% succeed — vast majority fail due to competition

As of block 7,429,232

Version History

v133 block 1,404,224 0 args
v233 block 4,920,350 1 args Current

Runtime Info

View Source
Pallet Index
7
Call Index
59
First Version
v133
Current Version
v393
Back to SubtensorModule Calls