BasketHoldingConverted

Event v441 → current #119

Emitted when a basket holding on a dissolving subnet is converted into the fund's root TAO slot.

View events on chain
Useful for: validatorsstakersanalyticsdevelopers

The Big Picture

Because a staker entitlement is a fraction of the whole fund and never a claim on specific alpha, holdings can be changed without touching anyone's claim. Subnet dissolution is the clearest case: the position is converted to TAO inside the fund, and every staker's share of the fund is exactly what it was before.

Why This Matters

When a subnet you were indirectly exposed to goes away, your entitlement does not. This event is the record that the position became TAO inside the fund instead of disappearing.

Example Scenario

A subnet the fund held 8% of its NAV in is dissolved. BasketHoldingConverted fires with that netuid and the TAO realized. The fund now carries that value in its root slot, and your share of the fund is unchanged.

Common Questions

Does this dilute me?
No. Shares and entitlements are untouched; only the composition of the holdings changes.
Can the validator redeploy that TAO?
Yes. The root slot is a normal fund position, and subsequent deposits follow the current weight vector.

Use Cases

  • Track forced fund rebalances driven by subnet dissolution
  • Explain NAV composition shifts that no validator initiated
  • Audit that entitlements survived a dissolution

How to Use This Event

  • → Correlate with NetworkRemoved to explain a fund composition change
  • → Track how much of a fund NAV sits in the root slot versus subnet alpha

From Chain Metadata

A validator's basket holding on a dissolving subnet was converted into the fund's root (TAO) slot. Fund shares and staker entitlements are unaffected.

Triggers

Preconditions

  • A subnet the fund holds alpha on is being dissolved

Effects

Postconditions

  • That subnet holding is realized to TAO and held as the fund root slot
  • Fund shares and staker entitlements are unchanged

Side Effects

  • The holding row for that subnet is removed from the fund

Event Data

#NameTypeDescription
0
hotkey
AccountId hotkey: Account address (32 bytes, SS58-encoded) (hex -> SS58)
1
netuid
NetUid netuid: Subnet ID (u16, 0-65535)
2
tao
TaoBalance tao: TAO amount in RAO (÷10⁹ for TAO)

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Subscribe to BasketHoldingConverted events
client.finalizedBlock$.subscribe(async (block) => {
  const events = await api.event.SubtensorModule.BasketHoldingConverted.get(block.hash);
  for (const evt of events) {
    console.log("BasketHoldingConverted:", evt.payload);
  }
});

On-Chain Activity

Emission Frequency
●○○○○○ Rare <10K emissions

Infrequent or specialized

#87 most emitted event

As of block 9,385,000

Runtime Info

View Source
Pallet Index
7
Event Index
119
First Version
v441
Current Version
v490