force_unreserve
Call v101 → current #5Unreserves balance from an account (root only).
View calls on chainCall Workflow
This diagram shows the call execution flow: starting with force_unreserve, passing through validation
(signature, nonce, mortality, fee payment), then pre-dispatch checks, followed by dispatch which emits events: Unreserved and modifies storage: Account, 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: validators
The Big Picture
Reserved balance is locked for specific purposes (deposits, holds). This root-only call can forcibly release reserves without the normal release conditions being met.
Use Cases
- Releasing stuck reserves
- Emergency recovery
- Fixing broken reserve states
From Chain Metadata
Unreserve some balance from a user by force. Can only be called by ROOT.
Input Parameters
| # | Name | Type | Description |
|---|---|---|---|
| 0 | who | MultiAddress | who (MultiAddress) |
| 1 | amount | u64 | Amount in RAO (÷10⁹ for TAO) (RAO -> TAO (/ 10^9)) |
Permissions
Origin
Unknown
Required Role
Permission data inferred from metadata. May be incomplete.
Requirements
- Caller is root account
- Target account has reserved balance
Effects
Events Emitted
Storage Modified
Postconditions
- Reserved balance moved to free balance
- Unreserved event emitted
Side Effects
- May unreserve less than requested if insufficient reserved balance
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 force_unreserve call
const who = 0 as any /* MultiAddress */;
const amount = 1_000_000_000n;
const call = api.tx[stringCamelCase("Balances")][stringCamelCase("force_unreserve")](
who,
amount
);Runtime Info
- Pallet Index
- 5
- Call Index
- 5
- First Version
- v101
- Current Version
- v393