force_adjust_total_issuance

Call v151 → current #9

Adjusts TotalIssuance up or down (root only).

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: validators

The Big Picture

A powerful root-only call that directly modifies the total supply counter. Used for protocol-level corrections when actual token distribution does not match the recorded TotalIssuance.

Use Cases

  • Correcting accounting discrepancies
  • Protocol-level supply adjustments
  • Emergency fixes

From Chain Metadata

Adjust the total issuance in a saturating way. Can only be called by root and always needs a positive `delta`.

Input Parameters

#NameTypeDescription
0
direction
AdjustmentDirection direction (AdjustmentDirection)
1
delta
Compact<u64> Cptdelta (Compact<u64>) (SCALE compact -> integer)

Permissions

Origin
Unknown
Required Role

Permission data inferred from metadata. May be incomplete.

Requirements

  • Caller is root account
  • Delta is non-zero

Effects

Events Emitted

Storage Modified

Postconditions

  • TotalIssuance increased or decreased by delta
  • TotalIssuanceForced event emitted

Side Effects

  • Can inflate or deflate the token supply
  • Does not affect any individual account balances

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_adjust_total_issuance call
const direction = 0 as any /* AdjustmentDirection */;
const delta = 0;

const call = api.tx[stringCamelCase("Balances")][stringCamelCase("force_adjust_total_issuance")](
  direction,
  delta
);

Runtime Info

Pallet Index
5
Call Index
9
First Version
v151
Current Version
v393