BondsResetOnSet

Event Re-added v273 → v277, v290 → current #26

Emitted when bonds reset behavior is toggled.

Useful for: validatorsminerssubnet ownersanalyticsdevelopers

The Big Picture

Bonds can optionally reset under certain conditions (like registration changes). When enabled, bonds reset to zero when the trigger occurs, wiping historical relationships. When disabled, bonds persist through changes. This affects how much history matters on the subnet.

Why This Matters

If bonds reset is enabled, certain events (like UID reassignment) can wipe your carefully built validator-miner relationships. If disabled, bonds persist through changes. Understanding this helps you evaluate the stability of your position.

Example Scenario

Subnet 7 always preserved bonds through registrations, but this let deregistered/reregistered miners keep their bonds unfairly. BondsResetOnSet fires enabling resets. Now when miners lose and regain UIDs, their bonds start fresh - a level playing field.

Common Questions

When do bonds reset if this is enabled?: Typically on UID changes - when neurons deregister and re-register, or when UIDs are reassigned. The specific trigger depends on implementation.
Is bond reset good or bad?: Depends. Reset prevents unfair bond carryover but erases legitimate history. No reset preserves history but might let deregistered miners game the system. Trade-offs either way.
Do all my bonds reset at once?: Only the bonds for the affected UIDs/relationships. If you bond with 50 miners and one re-registers, only that one relationship resets.

Use Cases

Track bond reset policies on subnets
Understand when bonds may be wiped
Monitor consensus mechanism changes
Build bond management strategies

How to Use This Event

→ Monitor bond reset policies on subnets you operate
→ Track changes affecting your bond preservation
→ Build bond management tools

From Chain Metadata

bonds reset is set for a subnet.

Triggers

Preconditions

Caller has admin/sudo privileges

Effects

Postconditions

BondsResetOn flag updated

Side Effects

Changes when/if bonds are reset

Event Data

#	Name	Type	Description
0	arg0	u16	Event field #0 (u16)
1	arg1	bool	Event field #1 (bool)

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

Version History

Version:

v273 block 5,659,032 2 args

v290 block 5,947,548 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 26
First Version: v273
Current Version: v393

Back to SubtensorModule Events