Tokens

---

Events

---

BalanceSet

A balance was set by root.

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
free	T::Balance	u128
reserved	T::Balance	u128

---

Deposited

Deposited some balance into an account

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
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
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

Endowed

An account was created with some free balance.

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

LockRemoved

Some locked funds were unlocked

Attributes

Name	Type	Composition
lock_id	LockIdentifier	[u8; 8]
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId

---

LockSet

Some funds are locked

Attributes

Name	Type	Composition
lock_id	LockIdentifier	[u8; 8]
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

ReserveRepatriated

Some reserved balance was repatriated (moved from reserved to another account).

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
from	T::AccountId	AccountId
to	T::AccountId	AccountId
amount	T::Balance	u128
status	BalanceStatus	('Free', 'Reserved')

---

Reserved

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

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

Slashed

Some balances were slashed (e.g. due to mis-behavior)

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
free_amount	T::Balance	u128
reserved_amount	T::Balance	u128

---

TotalIssuanceSet

The total issuance of an currency has been set

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
amount	T::Balance	u128

---

Transfer

Transfer succeeded.

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
from	T::AccountId	AccountId
to	T::AccountId	AccountId
amount	T::Balance	u128

---

Unreserved

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

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

Withdrawn

Some balances were withdrawn (e.g. pay for transaction fee)

Attributes

Name	Type	Composition
currency_id	T::CurrencyId	{'NativeToken': 'u64', 'FungibleToken': 'u64', 'DEXShare': ('u64', 'u64'), 'MiningResource': 'u64', 'Stable': 'u64'}
who	T::AccountId	AccountId
amount	T::Balance	u128

---

Storage functions

---

Accounts

The balance of a token type under an account.

NOTE: If the total is ever zero, decrease account ref account.

NOTE: This is only used in the case that this module is used to store balances.

Python

result = substrate.query(
    'Tokens', 'Accounts', [
    'AccountId',
    {
        'DEXShare': ('u64', 'u64'),
        'FungibleToken': 'u64',
        'MiningResource': 'u64',
        'NativeToken': 'u64',
        'Stable': 'u64',
    },
]
)

Return value

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

---

Locks

Any liquidity locks of a token type under an account. NOTE: Should only be accessed when setting, changing and freeing a lock.

Python

result = substrate.query(
    'Tokens', 'Locks', [
    'AccountId',
    {
        'DEXShare': ('u64', 'u64'),
        'FungibleToken': 'u64',
        'MiningResource': 'u64',
        'NativeToken': 'u64',
        'Stable': 'u64',
    },
]
)

Return value

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

---

Reserves

Named reserves on some account balances.

Python

result = substrate.query(
    'Tokens', 'Reserves', [
    'AccountId',
    {
        'DEXShare': ('u64', 'u64'),
        'FungibleToken': 'u64',
        'MiningResource': 'u64',
        'NativeToken': 'u64',
        'Stable': 'u64',
    },
]
)

Return value

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

---

TotalIssuance

The total issuance of a token type.

Python

result = substrate.query(
    'Tokens', 'TotalIssuance', [
    {
        'DEXShare': ('u64', 'u64'),
        'FungibleToken': 'u64',
        'MiningResource': 'u64',
        'NativeToken': 'u64',
        'Stable': 'u64',
    },
]
)

Return value

'u128'

---

Constants

---

MaxLocks

Value

50

Python

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

---

MaxReserves

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

Value

0

Python

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

---

Errors

---

AmountIntoBalanceFailed

Cannot convert Amount into Balance type

---

BalanceTooLow

The balance is too low

---

DeadAccount

Beneficiary account must pre-exist

---

ExistentialDeposit

Value too low to create account due to existential deposit

---

KeepAlive

Transfer/payment would kill account

---

LiquidityRestrictions

Failed because liquidity restrictions due to locking

---

MaxLocksExceeded

Failed because the maximum locks was exceeded

---

TooManyReserves

---