SubnetOwnerHotkeySet

Event Re-added v252 → v265, v273 → v277, v290 → v315, v320 → v326, v334 → v367, v372 → v377, v385 → current #92

Emitted when a subnet 's owner hotkey is changed.

Useful for: subnet ownersvalidatorsstakersanalytics

The Big Picture

Subnet owners receive a cut of all emissions on their subnet. The owner hotkey is where these emissions land. Changing the owner hotkey redirects that income stream. This might happen for operational reasons, security (key rotation), or actual ownership transfers.

Why This Matters

If the owner hotkey changes, subnet owner emissions go somewhere new. For participants, this might signal ownership changes or just operational updates. For owners, this is how you redirect your income to a new or more secure hotkey.

Example Scenario

You own subnet 20 and want owner emissions to go to your new hardware wallet's hotkey. You set the new owner hotkey. SubnetOwnerHotkeySet fires. Future owner cut emissions go to your new hotkey. Your operational setup is updated.

Common Questions

Does this change subnet ownership?: Not necessarily. The coldkey still owns the subnet. This changes which hotkey receives owner emissions. Actual ownership transfer would involve coldkey changes.
What happens to pending emissions?: Emissions after this event go to the new hotkey. Already-received emissions stay where they are. There's no clawback.
Can the owner hotkey be any registered hotkey?: It's typically owned by the same coldkey that owns the subnet. Check your runtime for specific requirements.

Use Cases

Track subnet ownership operational key changes
Monitor where subnet owner emissions go
Detect subnet control transitions
Build subnet governance tracking tools

How to Use This Event

→ Track owner hotkey changes on subnets you monitor
→ Monitor emission destination changes
→ Build subnet ownership tracking tools

From Chain Metadata

The owner hotkey for a subnet has been set. Parameters: (netuid, new_hotkey)

Triggers

Preconditions

Caller is current subnet owner
New hotkey is valid

Effects

Postconditions

SubnetOwner hotkey updated

Side Effects

New hotkey receives subnet owner emissions

Event Data

#	Name	Type	Description
0	arg0	u16	Event field #0 (u16)
1	arg1	AccountId	Event field #1 (AccountId) (hex -> SS58)

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

Version History

Version:

v252 block 5,163,656 2 args

v273 block 5,659,032 2 args

v290 block 5,947,548 2 args

v320 block 6,523,566 2 args

v334 block 6,811,690 2 args

v372 block 7,430,358 2 args

v385 block 7,782,670 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 92
First Version: v252
Current Version: v393

Back to SubtensorModule Events