BasketHoldingConverted
Event v441 → current #119Emitted when a basket holding on a dissolving subnet is converted into the fund's root TAO slot.
View events on chainThe 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
| # | Name | Type | Description |
|---|---|---|---|
| 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
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