Balances¶

Calls¶

force_set_balance¶

See [Pallet::force_set_balance].

Attributes¶

Name	Type
who	`AccountIdLookupOf<T>`
new_free	`T::Balance`

Python¶

call = substrate.compose_call(
    'Balances', 'force_set_balance', {
    'new_free': 'u128',
    'who': '[u8; 20]',
}
)

force_transfer¶

See [Pallet::force_transfer].

Attributes¶

Name	Type
source	`AccountIdLookupOf<T>`
dest	`AccountIdLookupOf<T>`
value	`T::Balance`

Python¶

call = substrate.compose_call(
    'Balances', 'force_transfer', {
    'dest': '[u8; 20]',
    'source': '[u8; 20]',
    'value': 'u128',
}
)

force_unreserve¶

See [Pallet::force_unreserve].

Attributes¶

Name	Type
who	`AccountIdLookupOf<T>`
amount	`T::Balance`

Python¶

call = substrate.compose_call(
    'Balances', 'force_unreserve', {'amount': 'u128', 'who': '[u8; 20]'}
)

transfer_all¶

See [Pallet::transfer_all].

Attributes¶

Name	Type
dest	`AccountIdLookupOf<T>`
keep_alive	`bool`

Python¶

call = substrate.compose_call(
    'Balances', 'transfer_all', {
    'dest': '[u8; 20]',
    'keep_alive': 'bool',
}
)

transfer_allow_death¶

See [Pallet::transfer_allow_death].

Attributes¶

Name	Type
dest	`AccountIdLookupOf<T>`
value	`T::Balance`

Python¶

call = substrate.compose_call(
    'Balances', 'transfer_allow_death', {'dest': '[u8; 20]', 'value': 'u128'}
)

transfer_keep_alive¶

See [Pallet::transfer_keep_alive].

Attributes¶

Name	Type
dest	`AccountIdLookupOf<T>`
value	`T::Balance`

Python¶

call = substrate.compose_call(
    'Balances', 'transfer_keep_alive', {'dest': '[u8; 20]', 'value': 'u128'}
)

upgrade_accounts¶

See [Pallet::upgrade_accounts].

Attributes¶

Name	Type
who	`Vec<T::AccountId>`

Python¶

call = substrate.compose_call(
    'Balances', 'upgrade_accounts', {'who': ['[u8; 20]']}
)

Events¶

BalanceSet¶

A balance was set by root.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
free	`T::Balance`	`u128`

Burned¶

Some amount was burned from an account.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Deposit¶

Some amount was deposited (e.g. for transaction fees).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

DustLost¶

An account was removed whose balance was non-zero but below ExistentialDeposit, resulting in an outright loss.

Attributes¶

Name	Type	Composition
account	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Endowed¶

An account was created with some free balance.

Attributes¶

Name	Type	Composition
account	`T::AccountId`	`[u8; 20]`
free_balance	`T::Balance`	`u128`

Frozen¶

Some balance was frozen.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Issued¶

Total issuance was increased by amount, creating a credit to be balanced.

Attributes¶

Name	Type	Composition
amount	`T::Balance`	`u128`

Locked¶

Some balance was locked.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Minted¶

Some amount was minted into an account.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Rescinded¶

Total issuance was decreased by amount, creating a debt to be balanced.

Attributes¶

Name	Type	Composition
amount	`T::Balance`	`u128`

ReserveRepatriated¶

Some balance was moved from the reserve of the first account to the second account. Final argument indicates the destination balance type.

Attributes¶

Name	Type	Composition
from	`T::AccountId`	`[u8; 20]`
to	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`
destination_status	`Status`	`('Free', 'Reserved')`

Reserved¶

Some balance was reserved (moved from free to reserved).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Restored¶

Some amount was restored into an account.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Slashed¶

Some amount was removed from the account (e.g. for misbehavior).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Suspended¶

Some amount was suspended from an account (it can be restored later).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Thawed¶

Some balance was thawed.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Transfer¶

Transfer succeeded.

Attributes¶

Name	Type	Composition
from	`T::AccountId`	`[u8; 20]`
to	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Unlocked¶

Some balance was unlocked.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Unreserved¶

Some balance was unreserved (moved from reserved to free).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Upgraded¶

An account was upgraded.

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`

Withdraw¶

Some amount was withdrawn from the account (e.g. for transaction fees).

Attributes¶

Name	Type	Composition
who	`T::AccountId`	`[u8; 20]`
amount	`T::Balance`	`u128`

Storage functions¶

Account¶

The Balances pallet example of storing the balance of an account.

# Example

nocompile impl pallet_balances::Config for Runtime { type AccountStore = StorageMapShim<Self::Account<Runtime>, frame_system::Provider<Runtime>, AccountId, Self::AccountData<Balance>> }

You can also store the balance of an account in the System pallet.

# Example

nocompile impl pallet_balances::Config for Runtime { type AccountStore = System }

But this comes with tradeoffs, storing account balances in the system pallet stores frame_system data alongside the account data contrary to storing account balances in the Balances pallet, which uses a StorageMap to store balances data only. NOTE: This is only used in the case that this pallet is used to store balances.

Python¶

result = substrate.query(
    'Balances', 'Account', ['[u8; 20]']
)

Return value¶

{'flags': 'u128', 'free': 'u128', 'frozen': 'u128', 'reserved': 'u128'}

Freezes¶

Freeze locks on account balances.

Python¶

result = substrate.query(
    'Balances', 'Freezes', ['[u8; 20]']
)

Return value¶

[{'amount': 'u128', 'id': ()}]

Holds¶

Holds on account balances.

Python¶

result = substrate.query(
    'Balances', 'Holds', ['[u8; 20]']
)

Return value¶

[{'amount': 'u128', 'id': {None: None, 'Preimage': ('Preimage', )}}]

InactiveIssuance¶

The total units of outstanding deactivated balance in the system.

Python¶

result = substrate.query(
    'Balances', 'InactiveIssuance', []
)

Return value¶

'u128'

Locks¶

Any liquidity locks on some account balances. NOTE: Should only be accessed when setting, changing and freeing a lock.

Python¶

result = substrate.query(
    'Balances', 'Locks', ['[u8; 20]']
)

Return value¶

[{'amount': 'u128', 'id': '[u8; 8]', 'reasons': ('Fee', 'Misc', 'All')}]

Reserves¶

Named reserves on some account balances.

Python¶

result = substrate.query(
    'Balances', 'Reserves', ['[u8; 20]']
)

Return value¶

[{'amount': 'u128', 'id': '[u8; 4]'}]

TotalIssuance¶

The total units issued in the system.

Python¶

result = substrate.query(
    'Balances', 'TotalIssuance', []
)

Return value¶

'u128'

Constants¶

ExistentialDeposit¶

The minimum amount required to keep an account open. MUST BE GREATER THAN ZERO!

If you really need it to be zero, you can enable the feature insecure_zero_ed for this pallet. However, you do so at your own risk: this will open up a major DoS vector. In case you have multiple sources of provider references, you may also get unexpected behaviour if you set this to zero.

Bottom line: Do yourself a favour and make it at least one!

Value¶

Python¶

constant = substrate.get_constant('Balances', 'ExistentialDeposit')

MaxFreezes¶

The maximum number of individual freeze locks that can exist on an account at any time.

Value¶

Python¶

constant = substrate.get_constant('Balances', 'MaxFreezes')

MaxHolds¶

The maximum number of holds that can exist on an account at any time.

Value¶

Python¶

constant = substrate.get_constant('Balances', 'MaxHolds')

MaxLocks¶

The maximum number of locks that should exist on an account. Not strictly enforced, but used for weight estimation.

Value¶

Python¶

constant = substrate.get_constant('Balances', 'MaxLocks')

MaxReserves¶

The maximum number of named reserves that can exist on an account.

Value¶

Python¶

constant = substrate.get_constant('Balances', 'MaxReserves')

Errors¶

DeadAccount¶

Beneficiary account must pre-exist.

ExistentialDeposit¶

Value too low to create account due to existential deposit.

ExistingVestingSchedule¶

A vesting schedule already exists for this account.

Expendability¶

Transfer/payment would kill account.

InsufficientBalance¶

Balance too low to send value.

LiquidityRestrictions¶

Account liquidity restrictions prevent withdrawal.

TooManyFreezes¶

Number of freezes exceed MaxFreezes.

TooManyHolds¶

Number of holds exceed MaxHolds.

TooManyReserves¶

Number of named reserves exceed MaxReserves.

VestingBalance¶

Vesting balance too high to send value.