sudo_trim_to_max_allowed_uids
Call v320 → current #78Trims a subnet 's neurons to a new maximum UID limit.
View calls on chainCall Workflow
This diagram shows the call execution flow: starting with sudo_trim_to_max_allowed_uids, passing through validation
(signature, nonce, mortality, fee payment), then pre-dispatch checks, followed by dispatch and modifies storage: SubtensorModule.SubnetworkN, SubtensorModule.MaxAllowedUids, and finally post-dispatch where ExtrinsicSuccess is emitted and fees are settled.
Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Click items to navigate. Pan and zoom to explore.
Used by: subnet owners
The Big Picture
Forcibly reduces subnet size by removing excess neurons. Use with extreme caution.
Use Cases
- Emergency subnet shrinking
- Resource reclamation
From Chain Metadata
Trims the maximum number of UIDs for a subnet. The trimming is done by sorting the UIDs by emission descending and then trimming the lowest emitters while preserving temporally and owner immune UIDs. The UIDs are then compressed to the left and storage is migrated to the new compressed UIDs.
Input Parameters
Permissions
Origin
Root
Required Role
Permission data inferred from metadata. May be incomplete.
Requirements
- Caller is root account
- Subnet exists
- Valid max_n
Effects
Storage Modified
Postconditions
- Subnet trimmed to max_n neurons
Side Effects
- Excess neurons are deregistered
- May cause significant state changes
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 sudo_trim_to_max_allowed_uids call
const netuid = 1;
const max_n = 0;
const call = api.tx[stringCamelCase("AdminUtils")][stringCamelCase("sudo_trim_to_max_allowed_uids")](
netuid,
max_n
);Runtime Info
View Source- Pallet Index
- 19
- Call Index
- 78
- First Version
- v320
- Current Version
- v393