root_register

Call v133 → current #62

Registers a validator on the root network (subnet 0).

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: validatorssubnet ownersdevelopers

The Big Picture

The root network (subnet 0) is Bittensor's meta-layer. Root validators don't mine - they vote on how emissions are distributed across all subnets. Getting on root means you're influential enough to shape the entire network's incentives. It's the senate of Bittensor.

Why This Matters

Subnet emissions come from root network votes. Root validators collectively decide which subnets are valuable and deserve TAO. If you believe in Bittensor's decentralization, participating in root helps steer the network responsibly.

Example Scenario

You've built up 100,000 TAO in stake and want network influence. Call root_register(hotkey=your_validator). Once registered, you can set_root_weights to vote on subnet emissions. Your 100k TAO gives you proportional influence over where ~72k TAO/day gets distributed.

Common Questions

What's the minimum stake for root?
It's competitive - root has limited slots. You need enough stake to not get pruned. Check current root validator stakes; you'll need to be in a similar range.
How do root emissions work?
Root validators earn emissions too, based on their weights aligning with consensus. Set weights honestly, earn more. Set outlier weights, earn less.

Use Cases

  • Participate in network-wide emission allocation
  • Vote on which subnets receive TAO emissions
  • Gain governance influence over Bittensor's direction
  • Support subnets you believe in with root weights

Input Parameters

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

Permissions

Origin
Unknown
Required Role
Any

Permission data inferred from metadata. May be incomplete.

Requirements

  • Root network exists
  • Hotkey not already registered on root
  • Hotkey meets minimum stake requirement for root
  • Senate membership requirements met (if applicable)

Effects

Events Emitted

NeuronRegistered

Postconditions

  • Validator registered on root network
  • Can now set root weights
  • May participate in governance

Side Effects

  • Affects global emission distribution

Possible Errors

HotKeyNotRegisteredInSubNetNotRegisteredHotKeyNotRegisteredInNetworkAlreadyRegisteredHotKeyAlreadyRegisteredInSubNet

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 root_register call
const hotkey = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";

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

On-Chain Activity

Usage Frequency
●●●○○○ Moderate 10K–100K extrinsics

Occasional use

#44 most used call

Success Rate Highly competitive

Under 5% succeed — vast majority fail due to competition

As of block 7,429,232

Runtime Info

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