burned_register

Call v101 → current #7

Registers a neuron by paying TAO instead of solving POW.

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: minersvalidatorssubnet ownersdevelopers

The Big Picture

Registration is your entry ticket to a subnet. Despite the name, 'burned_register' doesn't actually burn TAO - it swaps your TAO into the subnet's liquidity pool, then burns the Alpha received. The TAO stays in the ecosystem (in SubnetTAO), while Alpha supply decreases. The cost adjusts based on demand - popular subnets cost more.

Why This Matters

You can't mine or validate without a UID. Burn registration gets you one immediately. The cost varies by subnet and demand - check the current burn cost before submitting.

Example Scenario

You want to run a miner on subnet 1. The current burn cost is 0.5 TAO. You call burned_register(netuid=1, hotkey=your_hotkey). Your 0.5 TAO goes into subnet 1's liquidity pool, and you get UID 47. Your miner can now participate.

Common Questions

When should I use burn vs POW registration?
Burn if you value your time over TAO, or if the subnet's POW difficulty is too high. POW is free but can take hours on competitive subnets.
What happens to the TAO I pay?
Despite the name, TAO isn't destroyed. It's swapped into the subnet's liquidity pool (SubnetTAO increases). The Alpha received from the swap is burned (SubnetAlphaOut decreases). So TAO stays in the ecosystem, but Alpha supply shrinks.
Is this deflationary?
For Alpha, yes - Alpha is burned. For TAO, no - TAO moves to the pool but isn't destroyed. TotalIssuance of TAO doesn't change from registration.

Use Cases

  • Quick registration when you don't want to wait for POW
  • Register on competitive subnets where POW is impractical
  • Start earning immediately on a new subnet
Part of: Neuron Registration

Input Parameters

#NameTypeDescription
0
netuid
u16 Subnet ID to register on
1
hotkey
AccountId Hot wallet for the neuron (hex -> SS58)

Permissions

Origin
Unknown
Required Role
Coldkey

Requirements

  • Subnet exists and accepts registrations
  • Hotkey not already registered on this subnet
  • Coldkey has sufficient balance for registration cost
  • Subnet has available UID slots or neuron can be pruned

Effects

Events Emitted

NeuronRegistered

Postconditions

  • Neuron registered with assigned UID
  • Registration cost deducted from coldkey
  • Hotkey-coldkey association recorded

Side Effects

  • May prune lowest-performing neuron if subnet is full
  • TAO added to subnet's liquidity pool (SubnetTAO)
  • Equivalent Alpha burned (SubnetAlphaOut decreased)

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

const call = api.tx[stringCamelCase("SubtensorModule")][stringCamelCase("burned_register")](
  netuid,
  hotkey
);

On-Chain Activity

Usage Frequency
●●●●●● Dominant >10M extrinsics

Highest-volume operations

#2 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
7
First Version
v101
Current Version
v393
Back to SubtensorModule Calls