runtime-calls.md

Runtime calls

Calls are categorized according to the dispatch origin they require:

1. User calls: the dispatch origin for this kind of call must be signed by the transactor. This is the only call category that can be submitted with an extrinsic.
2. Root calls: This kind of call requires a special origin that can only be invoked through on-chain governance mechanisms.
3. Inherent calls: This kind of call is invoked by the author of the block itself (usually automatically by the node).
4. Disabled calls: These calls can not be called directly, they are reserved for internal use by other runtime calls.

We only document user calls below.

There are 65 user calls from 17 pallets.

Account - 1

unlink_identity - 0

unlink_identity()

Taking 0.0106 % of a block.

Unlink the identity associated with the account.

Balances - 6

transfer_allow_death - 0

transfer_allow_death(dest, value)

Taking 0.0186 % of a block.

dest: AccountIdLookupOf<T>
value: T::Balance

Transfer some liquid free balance to another account.

transfer_allow_death will set the FreeBalance of the sender and receiver. If the sender's account is below the existential deposit as a result of the transfer, the account will be reaped.

The dispatch origin for this call must be Signed by the transactor.

transfer_keep_alive - 3

transfer_keep_alive(dest, value)

Taking 0.0119 % of a block.

dest: AccountIdLookupOf<T>
value: T::Balance

Same as the transfer_allow_death call, but with a check that the transfer will not kill the origin account.

99% of the time you want transfer_allow_death instead.

transfer_all - 4

transfer_all(dest, keep_alive)

Taking 0.0122 % of a block.

dest: AccountIdLookupOf<T>
keep_alive: bool

Transfer the entire transferable balance from the caller account.

NOTE: This function only attempts to transfer transferable balances. This means that any locked, reserved, or existential deposits (when keep_alive is true), will not be transferred by this function. To ensure that this function results in a killed account, you might need to prepare the account by removing any reference counters, storage deposits, etc...

The dispatch origin of this call must be Signed.

• dest: The recipient of the transfer.
• keep_alive: A boolean to determine if the transfer_all operation should send all of the funds the account has, causing the sender account to be killed (false), or transfer everything except at least the existential deposit, which will guarantee to keep the sender account alive (true).

OneshotAccount - 7

create_oneshot_account - 0

create_oneshot_account(dest, value)

Taking 0.0115 % of a block.

dest: <T::Lookup as StaticLookup>::Source
value: BalanceOf<T>

Create an account that can only be consumed once

• dest: The oneshot account to be created.
• balance: The balance to be transfered to this oneshot account.

Origin account is kept alive.

consume_oneshot_account - 1

consume_oneshot_account(block_height, dest)

Taking 0.0182 % of a block.

block_height: BlockNumberFor<T>
dest: Account<<T::Lookup as StaticLookup>::Source>

Consume a oneshot account and transfer its balance to an account

• block_height: Must be a recent block number. The limit is BlockHashCount in the past. (this is to prevent replay attacks)
• dest: The destination account.
• dest_is_oneshot: If set to true, then a oneshot account is created at dest. Else, dest has to be an existing account.

consume_oneshot_account_with_remaining - 2

consume_oneshot_account_with_remaining(block_height, dest, remaining_to, balance)

Taking 0.0246 % of a block.

block_height: BlockNumberFor<T>
dest: Account<<T::Lookup as StaticLookup>::Source>
remaining_to: Account<<T::Lookup as StaticLookup>::Source>
balance: BalanceOf<T>

Consume a oneshot account then transfer some amount to an account, and the remaining amount to another account.

• block_height: Must be a recent block number. The limit is BlockHashCount in the past. (this is to prevent replay attacks)
• dest: The destination account.
• dest_is_oneshot: If set to true, then a oneshot account is created at dest. Else, dest has to be an existing account.
• dest2: The second destination account.
• dest2_is_oneshot: If set to true, then a oneshot account is created at dest2. Else, dest2 has to be an existing account.
• balance1: The amount transfered to dest, the leftover being transfered to dest2.

SmithMembers - 10

invite_smith - 0

invite_smith(receiver)

Taking 0.0214 % of a block.

receiver: T::IdtyIndex

Invite a member of the Web of Trust to attempt becoming a Smith.

accept_invitation - 1

accept_invitation()

Taking 0.0119 % of a block.

Accept an invitation to become a Smith (must have been invited first).

certify_smith - 2

certify_smith(receiver)

Taking 0.0255 % of a block.

receiver: T::IdtyIndex

Certify an invited Smith, which can lead the certified to become a Smith.

AuthorityMembers - 11

go_offline - 0

go_offline()

Taking 0.0152 % of a block.

Request to leave the set of validators two sessions later.

go_online - 1

go_online()

Taking 0.0172 % of a block.

Request to join the set of validators two sessions later.

set_session_keys - 2

set_session_keys(keys)

Taking 0.0225 % of a block.

keys: T::Keys

Declare new session keys to replace current ones.

Preimage - 22

note_preimage - 0

note_preimage(bytes)

Taking 0.2846 % of a block.

bytes: Vec<u8>

Register a preimage on-chain.

If the preimage was previously requested, no fees or deposits are taken for providing the preimage. Otherwise, a deposit is taken proportional to the size of the preimage.

unnote_preimage - 1

unnote_preimage(hash)

Taking 0.0171 % of a block.

hash: T::Hash

Clear an unrequested preimage from the runtime storage.

If len is provided, then it will be a much cheaper operation.

• hash: The hash of the preimage to be removed from the store.
• len: The length of the preimage of hash.

request_preimage - 2

request_preimage(hash)

Taking 0.0121 % of a block.

hash: T::Hash

Request a preimage be uploaded to the chain without paying any fees or deposits.

If the preimage requests has already been provided on-chain, we unreserve any deposit a user may have paid, and take the control of the preimage out of their hands.

unrequest_preimage - 3

unrequest_preimage(hash)

Taking 0.0171 % of a block.

hash: T::Hash

Clear a previously made request for a preimage.

NOTE: THIS MUST NOT BE CALLED ON hash MORE TIMES THAN request_preimage.

ensure_updated - 4

ensure_updated(hashes)

Taking 17.5344 % of a block.

hashes: Vec<T::Hash>

Ensure that the a bulk of pre-images is upgraded.

The caller pays no fee if at least 90% of pre-images were successfully updated.

TechnicalCommittee - 23

execute - 1

execute(proposal, length_bound)

Taking 0.006 % of a block.

proposal: Box<<T as Config<I>>::Proposal>
length_bound: u32

Dispatch a proposal from a member using the Member origin.

Origin must be a member of the collective.

Complexity:

• O(B + M + P) where:
• B is proposal size in bytes (length-fee-bounded)
• M members-count (code-bounded)
• P complexity of dispatching proposal

propose - 2

propose(threshold, proposal, length_bound)

No weight available.

threshold: MemberCount
proposal: Box<<T as Config<I>>::Proposal>
length_bound: u32

Add a new proposal to either be voted on or executed directly.

Requires the sender to be member.

threshold determines whether proposal is executed directly (threshold < 2) or put up for voting.

Complexity

• O(B + M + P1) or O(B + M + P2) where:
  • B is proposal size in bytes (length-fee-bounded)
  • M is members-count (code- and governance-bounded)
  • branching is influenced by threshold where:
    • P1 is proposal execution complexity (threshold < 2)
    • P2 is proposals-count (code-bounded) (threshold >= 2)

vote - 3

vote(proposal, index, approve)

Taking 0.0121 % of a block.

proposal: T::Hash
index: ProposalIndex
approve: bool

Add an aye or nay vote for the sender to the given proposal.

Requires the sender to be a member.

Transaction fees will be waived if the member is voting on any particular proposal for the first time and the call is successful. Subsequent vote changes will charge a fee.

Complexity

• O(M) where M is members-count (code- and governance-bounded)

close - 6

close(proposal_hash, index, proposal_weight_bound, length_bound)

No weight available.

proposal_hash: T::Hash
index: ProposalIndex
proposal_weight_bound: Weight
length_bound: u32

Close a vote that is either approved, disapproved or whose voting period has ended.

May be called by any signed account in order to finish voting and close the proposal.

If called before the end of the voting period it will only close the vote if it is has enough votes to be approved or disapproved.

If called after the end of the voting period abstentions are counted as rejections unless there is a prime member set and the prime member cast an approval.

If the close operation completes successfully with disapproval, the transaction fee will be waived. Otherwise execution of the approved operation will be charged to the caller.

• proposal_weight_bound: The maximum amount of weight consumed by executing the closed proposal.
• length_bound: The upper bound for the length of the proposal in storage. Checked via storage::read so it is size_of::<u32>() == 4 larger than the pure length.

Complexity

• O(B + M + P1 + P2) where:
  • B is proposal size in bytes (length-fee-bounded)
  • M is members-count (code- and governance-bounded)
  • P1 is the complexity of proposal preimage.
  • P2 is proposal-count (code-bounded)

kill - 7

kill(proposal_hash)

Taking 0.0229 % of a block.

proposal_hash: T::Hash

Disapprove the proposal and burn the cost held for storing this proposal.

Parameters:

• origin: must be the KillOrigin.
• proposal_hash: The hash of the proposal that should be killed.

Emits Killed and ProposalCostBurned if any cost was held for a given proposal.

release_proposal_cost - 8

release_proposal_cost(proposal_hash)

Taking 0.0066 % of a block.

proposal_hash: T::Hash

Release the cost held for storing a proposal once the given proposal is completed.

If there is no associated cost for the given proposal, this call will have no effect.

Parameters:

• origin: must be Signed or Root.
• proposal_hash: The hash of the proposal.

Emits ProposalCostReleased if any cost held for a given proposal.

UniversalDividend - 30

claim_uds - 0

claim_uds()

Taking 0.02 % of a block.

Claim Universal Dividends.

transfer_ud - 1

transfer_ud(dest, value)

Taking 0.0194 % of a block.

dest: <T::Lookup as StaticLookup>::Source
value: BalanceOf<T>

Transfer some liquid free balance to another account, in milliUD.

transfer_ud_keep_alive - 2

transfer_ud_keep_alive(dest, value)

Taking 0.0129 % of a block.

dest: <T::Lookup as StaticLookup>::Source
value: BalanceOf<T>

Transfer some liquid free balance to another account in milliUD and keep the account alive.

Identity - 41

create_identity - 0

create_identity(owner_key)

Taking 0.0776 % of a block.

owner_key: T::AccountId

Create an identity for an existing account

• owner_key: the public key corresponding to the identity to be created

The origin must be allowed to create an identity.

confirm_identity - 1

confirm_identity(idty_name)

Taking 0.0298 % of a block.

idty_name: IdtyName

Confirm the creation of an identity and give it a name

• idty_name: the name uniquely associated to this identity. Must match the validation rules defined by the runtime.

The identity must have been created using create_identity before it can be confirmed.

change_owner_key - 3

change_owner_key(new_key, new_key_sig)

Taking 0.0388 % of a block.

new_key: T::AccountId
new_key_sig: T::Signature

Change identity owner key.

• new_key: the new owner key.
• new_key_sig: the signature of the encoded form of IdtyIndexAccountIdPayload. Must be signed by new_key.

The origin should be the old identity owner key.

revoke_identity - 4

revoke_identity(idty_index, revocation_key, revocation_sig)

Taking 0.0365 % of a block.

idty_index: T::IdtyIndex
revocation_key: T::AccountId
revocation_sig: T::Signature

Revoke an identity using a revocation signature

• idty_index: the index of the identity to be revoked.
• revocation_key: the key used to sign the revocation payload.
• revocation_sig: the signature of the encoded form of RevocationPayload. Must be signed by revocation_key.

Any signed origin can execute this call.

revoke_identity_legacy - 9

revoke_identity_legacy(revocation_document)

Taking 0.04 % of a block.

revocation_document: Vec<u8>

Revoke an identity using a legacy (DUBP) revocation document

• revocation document: the full-length revocation document, signature included

Any signed origin can execute this call.

link_account - 8

link_account(account_id, payload_sig)

Taking 0.0144 % of a block.

account_id: T::AccountId
payload_sig: T::Signature

Link an account to an identity.

This function links a specified account to an identity, requiring both the account and the identity to sign the operation.

• origin - The origin of the call, which must have an associated identity index.
• account_id - The account ID to link, which must sign the payload.
• payload_sig - The signature with the linked identity.

Certification - 43

add_cert - 0

add_cert(receiver)

Taking 0.0324 % of a block.

receiver: T::IdtyIndex

Add a new certification.

renew_cert - 3

renew_cert(receiver)

Taking 0.0266 % of a block.

receiver: T::IdtyIndex

Renew an existing certification.

Distance - 44

request_distance_evaluation - 0

request_distance_evaluation()

Taking 0.0351 % of a block.

Request evaluation of the caller's identity distance.

This function allows the caller to request an evaluation of their distance. A positive evaluation will lead to claiming or renewing membership, while a negative evaluation will result in slashing for the caller.

request_distance_evaluation_for - 4

request_distance_evaluation_for(target)

Taking 0.036 % of a block.

target: T::IdtyIndex

Request evaluation of a target identity's distance.

This function allows the caller to request an evaluation of a specific target identity's distance. This action is only permitted for unvalidated identities.

AtomicSwap - 50

create_swap - 0

create_swap(target, hashed_proof, action, duration)

No weight available.

target: T::AccountId
hashed_proof: HashedProof
action: T::SwapAction
duration: BlockNumberFor<T>

Register a new atomic swap, declaring an intention to send funds from origin to target on the current blockchain. The target can claim the fund using the revealed proof. If the fund is not claimed after duration blocks, then the sender can cancel the swap.

The dispatch origin for this call must be Signed.

• target: Receiver of the atomic swap.
• hashed_proof: The blake2_256 hash of the secret proof.
• balance: Funds to be sent from origin.
• duration: Locked duration of the atomic swap. For safety reasons, it is recommended that the revealer uses a shorter duration than the counterparty, to prevent the situation where the revealer reveals the proof too late around the end block.

claim_swap - 1

claim_swap(proof, action)

No weight available.

proof: Vec<u8>
action: T::SwapAction

Claim an atomic swap.

The dispatch origin for this call must be Signed.

• proof: Revealed proof of the claim.
• action: Action defined in the swap, it must match the entry in blockchain. Otherwise the operation fails. This is used for weight calculation.

cancel_swap - 2

cancel_swap(target, hashed_proof)

No weight available.

target: T::AccountId
hashed_proof: HashedProof

Cancel an atomic swap. Only possible after the originally set duration has passed.

The dispatch origin for this call must be Signed.

• target: Target of the original atomic swap.
• hashed_proof: Hashed proof of the original atomic swap.

Multisig - 51

as_multi_threshold_1 - 0

as_multi_threshold_1(other_signatories, call)

Taking 0.0051 % of a block.

other_signatories: Vec<T::AccountId>
call: Box<<T as Config>::RuntimeCall>

Immediately dispatch a multi-signature call using a single approval from the caller.

The dispatch origin for this call must be Signed.

• other_signatories: The accounts (other than the sender) who are part of the multi-signature, but do not participate in the approval process.
• call: The call to be executed.

Result is equivalent to the dispatched result.

Complexity

O(Z + C) where Z is the length of the call and C its execution weight.

as_multi - 1

as_multi(threshold, other_signatories, maybe_timepoint, call, max_weight)

No weight available.

threshold: u16
other_signatories: Vec<T::AccountId>
maybe_timepoint: Option<Timepoint<BlockNumberFor<T>>>
call: Box<<T as Config>::RuntimeCall>
max_weight: Weight

Register approval for a dispatch to be made from a deterministic composite account if approved by a total of threshold - 1 of other_signatories.

If there are enough, then dispatch the call.

Payment: DepositBase will be reserved if this is the first approval, plus threshold times DepositFactor. It is returned once this dispatch happens or is cancelled.

The dispatch origin for this call must be Signed.

• threshold: The total number of approvals for this dispatch before it is executed.
• other_signatories: The accounts (other than the sender) who can approve this dispatch. May not be empty.
• maybe_timepoint: If this is the first approval, then this must be None. If it is not the first approval, then it must be Some, with the timepoint (block number and transaction index) of the first approval transaction.
• call: The call to be executed.

NOTE: Unless this is the final approval, you will generally want to use approve_as_multi instead, since it only requires a hash of the call.

Result is equivalent to the dispatched result if threshold is exactly 1. Otherwise on success, result is Ok and the result from the interior call, if it was executed, may be found in the deposited MultisigExecuted event.

Complexity

• O(S + Z + Call).
• Up to one balance-reserve or unreserve operation.
• One passthrough operation, one insert, both O(S) where S is the number of signatories. S is capped by MaxSignatories, with weight being proportional.
• One call encode & hash, both of complexity O(Z) where Z is tx-len.
• One encode & hash, both of complexity O(S).
• Up to one binary search and insert (O(logS + S)).
• I/O: 1 read O(S), up to 1 mutate O(S). Up to one remove.
• One event.
• The weight of the call.
• Storage: inserts one item, value size bounded by MaxSignatories, with a deposit taken for its lifetime of DepositBase + threshold * DepositFactor.

approve_as_multi - 2

approve_as_multi(threshold, other_signatories, maybe_timepoint, call_hash, max_weight)

No weight available.

threshold: u16
other_signatories: Vec<T::AccountId>
maybe_timepoint: Option<Timepoint<BlockNumberFor<T>>>
call_hash: [u8; 32]
max_weight: Weight

Register approval for a dispatch to be made from a deterministic composite account if approved by a total of threshold - 1 of other_signatories.

Payment: DepositBase will be reserved if this is the first approval, plus threshold times DepositFactor. It is returned once this dispatch happens or is cancelled.

The dispatch origin for this call must be Signed.

• threshold: The total number of approvals for this dispatch before it is executed.
• other_signatories: The accounts (other than the sender) who can approve this dispatch. May not be empty.
• maybe_timepoint: If this is the first approval, then this must be None. If it is not the first approval, then it must be Some, with the timepoint (block number and transaction index) of the first approval transaction.
• call_hash: The hash of the call to be executed.

NOTE: If this is the final approval, you will want to use as_multi instead.

Complexity

• O(S).
• Up to one balance-reserve or unreserve operation.
• One passthrough operation, one insert, both O(S) where S is the number of signatories. S is capped by MaxSignatories, with weight being proportional.
• One encode & hash, both of complexity O(S).
• Up to one binary search and insert (O(logS + S)).
• I/O: 1 read O(S), up to 1 mutate O(S). Up to one remove.
• One event.
• Storage: inserts one item, value size bounded by MaxSignatories, with a deposit taken for its lifetime of DepositBase + threshold * DepositFactor.

cancel_as_multi - 3

cancel_as_multi(threshold, other_signatories, timepoint, call_hash)

Taking 0.0117 % of a block.

threshold: u16
other_signatories: Vec<T::AccountId>
timepoint: Timepoint<BlockNumberFor<T>>
call_hash: [u8; 32]

Cancel a pre-existing, on-going multisig transaction. Any deposit reserved previously for this operation will be unreserved on success.

The dispatch origin for this call must be Signed.

• threshold: The total number of approvals for this dispatch before it is executed.
• other_signatories: The accounts (other than the sender) who can approve this dispatch. May not be empty.
• timepoint: The timepoint (block number and transaction index) of the first approval transaction for this dispatch.
• call_hash: The hash of the call to be executed.

Complexity

• O(S).
• Up to one balance-reserve or unreserve operation.
• One passthrough operation, one insert, both O(S) where S is the number of signatories. S is capped by MaxSignatories, with weight being proportional.
• One encode & hash, both of complexity O(S).
• One event.
• I/O: 1 read O(S), one remove.
• Storage: removes one item.

ProvideRandomness - 52

request - 0

request(randomness_type, salt)

Taking 0.0367 % of a block.

randomness_type: RandomnessType
salt: H256

Request randomness.

Proxy - 53

proxy - 0

proxy(real, force_proxy_type, call)

Taking 0.0061 % of a block.

real: AccountIdLookupOf<T>
force_proxy_type: Option<T::ProxyType>
call: Box<<T as Config>::RuntimeCall>

Dispatch the given call from an account that the sender is authorised for through add_proxy.

The dispatch origin for this call must be Signed.

Parameters:

• real: The account that the proxy will make a call on behalf of.
• force_proxy_type: Specify the exact proxy type to be used and checked for this call.
• call: The call to be made by the real account.

add_proxy - 1

add_proxy(delegate, proxy_type, delay)

Taking 0.0114 % of a block.

delegate: AccountIdLookupOf<T>
proxy_type: T::ProxyType
delay: BlockNumberFor<T>

Register a proxy account for the sender that is able to make calls on its behalf.

The dispatch origin for this call must be Signed.

Parameters:

• proxy: The account that the caller would like to make a proxy.
• proxy_type: The permissions allowed for this proxy account.
• delay: The announcement period required of the initial proxy. Will generally be zero.

remove_proxy - 2

remove_proxy(delegate, proxy_type, delay)

Taking 0.0114 % of a block.

delegate: AccountIdLookupOf<T>
proxy_type: T::ProxyType
delay: BlockNumberFor<T>

Unregister a proxy account for the sender.

The dispatch origin for this call must be Signed.

Parameters:

• proxy: The account that the caller would like to remove as a proxy.
• proxy_type: The permissions currently enabled for the removed proxy account.

remove_proxies - 3

remove_proxies()

Taking 0.0113 % of a block.

Unregister all proxy accounts for the sender.

The dispatch origin for this call must be Signed.

WARNING: This may be called on accounts created by pure, however if done, then the unreserved fees will be inaccessible. All access to this account will be lost.

create_pure - 4

create_pure(proxy_type, delay, index)

Taking 0.0114 % of a block.

proxy_type: T::ProxyType
delay: BlockNumberFor<T>
index: u16

Spawn a fresh new account that is guaranteed to be otherwise inaccessible, and initialize it with a proxy of proxy_type for origin sender.

Requires a Signed origin.

• proxy_type: The type of the proxy that the sender will be registered as over the new account. This will almost always be the most permissive ProxyType possible to allow for maximum flexibility.
• index: A disambiguation index, in case this is called multiple times in the same transaction (e.g. with utility::batch). Unless you're using batch you probably just want to use 0.
• delay: The announcement period required of the initial proxy. Will generally be zero.

Fails with Duplicate if this has already been called in this transaction, from the same sender, with the same parameters.

Fails if there are insufficient funds to pay for deposit.

kill_pure - 5

kill_pure(spawner, proxy_type, index, height, ext_index)

Taking 0.0114 % of a block.

spawner: AccountIdLookupOf<T>
proxy_type: T::ProxyType
index: u16
height: BlockNumberFor<T>
ext_index: u32

Removes a previously spawned pure proxy.

WARNING: All access to this account will be lost. Any funds held in it will be inaccessible.

Requires a Signed origin, and the sender account must have been created by a call to pure with corresponding parameters.

• spawner: The account that originally called pure to create this account.
• index: The disambiguation index originally passed to pure. Probably 0.
• proxy_type: The proxy type originally passed to pure.
• height: The height of the chain when the call to pure was processed.
• ext_index: The extrinsic index in which the call to pure was processed.

Fails with NoPermission in case the caller is not a previously created pure account whose pure call has corresponding parameters.

announce - 6

announce(real, call_hash)

Taking 0.0185 % of a block.

real: AccountIdLookupOf<T>
call_hash: CallHashOf<T>

Publish the hash of a proxy-call that will be made in the future.

This must be called some number of blocks before the corresponding proxy is attempted if the delay associated with the proxy relationship is greater than zero.

No more than MaxPending announcements may be made at any one time.

This will take a deposit of AnnouncementDepositFactor as well as AnnouncementDepositBase if there are no other pending announcements.

The dispatch origin for this call must be Signed and a proxy of real.

Parameters:

• real: The account that the proxy will make a call on behalf of.
• call_hash: The hash of the call to be made by the real account.

remove_announcement - 7

remove_announcement(real, call_hash)

Taking 0.0173 % of a block.

real: AccountIdLookupOf<T>
call_hash: CallHashOf<T>

Remove a given announcement.

May be called by a proxy account to remove a call they previously announced and return the deposit.

The dispatch origin for this call must be Signed.

Parameters:

• real: The account that the proxy will make a call on behalf of.
• call_hash: The hash of the call to be made by the real account.

reject_announcement - 8

reject_announcement(delegate, call_hash)

Taking 0.0173 % of a block.

delegate: AccountIdLookupOf<T>
call_hash: CallHashOf<T>

Remove the given announcement of a delegate.

May be called by a target (proxied) account to remove a call that one of their delegates (delegate) has announced they want to execute. The deposit is returned.

The dispatch origin for this call must be Signed.

Parameters:

• delegate: The account that previously announced the call.
• call_hash: The hash of the call to be made.

proxy_announced - 9

proxy_announced(delegate, real, force_proxy_type, call)

Taking 0.0187 % of a block.

delegate: AccountIdLookupOf<T>
real: AccountIdLookupOf<T>
force_proxy_type: Option<T::ProxyType>
call: Box<<T as Config>::RuntimeCall>

Dispatch the given call from an account that the sender is authorized for through add_proxy.

Removes any corresponding announcement(s).

The dispatch origin for this call must be Signed.

Parameters:

• real: The account that the proxy will make a call on behalf of.
• force_proxy_type: Specify the exact proxy type to be used and checked for this call.
• call: The call to be made by the real account.

Utility - 54

batch - 0

batch(calls)

Taking 0.1152 % of a block.

calls: Vec<<T as Config>::RuntimeCall>

Send a batch of dispatch calls.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatched without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

This will return Ok in all circumstances. To determine the success of the batch, an event is deposited. If a call failed and the batch was interrupted, then the BatchInterrupted event is deposited, along with the number of successful calls made and the error of the failed call. If all were successful, then the BatchCompleted event is deposited.

as_derivative - 1

as_derivative(index, call)

Taking 0.0048 % of a block.

index: u16
call: Box<<T as Config>::RuntimeCall>

Send a call through an indexed pseudonym of the sender.

Filter from origin are passed along. The call will be dispatched with an origin which use the same filter as the origin of this call.

NOTE: If you need to ensure that any account-based filtering is not honored (i.e. because you expect proxy to have been used prior in the call stack and you do not want the call restrictions to apply to any sub-accounts), then use as_multi_threshold_1 in the Multisig pallet instead.

NOTE: Prior to version *12, this was called as_limited_sub.

The dispatch origin for this call must be Signed.

batch_all - 2

batch_all(calls)

Taking 0.123 % of a block.

calls: Vec<<T as Config>::RuntimeCall>

Send a batch of dispatch calls and atomically execute them. The whole transaction will rollback and fail if any of the calls failed.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatched without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

force_batch - 4

force_batch(calls)

Taking 0.1152 % of a block.

calls: Vec<<T as Config>::RuntimeCall>

Send a batch of dispatch calls. Unlike batch, it allows errors and won't interrupt.

May be called from any origin except None.

• calls: The calls to be dispatched from the same origin. The number of call must not exceed the constant: batched_calls_limit (available in constant metadata).

If origin is root then the calls are dispatch without checking origin filter. (This includes bypassing frame_system::Config::BaseCallFilter).

Complexity

• O(C) where C is the number of calls to be batched.

Treasury - 55

spend_local - 3

spend_local(amount, beneficiary)

Taking 0.0046 % of a block.

amount: BalanceOf<T, I>
beneficiary: AccountIdLookupOf<T>

Propose and approve a spend of treasury funds.

Dispatch Origin

Must be [Config::SpendOrigin] with the Success value being at least amount.

Details

NOTE: For record-keeping purposes, the proposer is deemed to be equivalent to the beneficiary.

Parameters

• amount: The amount to be transferred from the treasury to the beneficiary.
• beneficiary: The destination account for the transfer.

Events

Emits [Event::SpendApproved] if successful.

remove_approval - 4

remove_approval(proposal_id)

Taking 0.0056 % of a block.

proposal_id: ProposalIndex

Force a previously approved proposal to be removed from the approval queue.

Dispatch Origin

Must be [Config::RejectOrigin].

Details

The original deposit will no longer be returned.

Parameters

• proposal_id: The index of a proposal

Complexity

• O(A) where A is the number of approvals

Errors

• [Error::ProposalNotApproved]: The proposal_id supplied was not found in the approval queue, i.e., the proposal has not been approved. This could also mean the proposal does not exist altogether, thus there is no way it would have been approved in the first place.

spend - 5

spend(asset_kind, amount, beneficiary, valid_from)

Taking 0.0046 % of a block.

asset_kind: Box<T::AssetKind>
amount: AssetBalanceOf<T, I>
beneficiary: Box<BeneficiaryLookupOf<T, I>>
valid_from: Option<BlockNumberFor<T>>

Propose and approve a spend of treasury funds.

Dispatch Origin

Must be [Config::SpendOrigin] with the Success value being at least amount of asset_kind in the native asset. The amount of asset_kind is converted for assertion using the [Config::BalanceConverter].

Details

Create an approved spend for transferring a specific amount of asset_kind to a designated beneficiary. The spend must be claimed using the payout dispatchable within the [Config::PayoutPeriod].

Parameters

• asset_kind: An indicator of the specific asset class to be spent.
• amount: The amount to be transferred from the treasury to the beneficiary.
• beneficiary: The beneficiary of the spend.
• valid_from: The block number from which the spend can be claimed. It can refer to the past if the resulting spend has not yet expired according to the [Config::PayoutPeriod]. If None, the spend can be claimed immediately after approval.

Events

Emits [Event::AssetSpendApproved] if successful.

payout - 6

payout(index)

Taking 0.0056 % of a block.

index: SpendIndex

Claim a spend.

Dispatch Origin

Must be signed

Details

Spends must be claimed within some temporal bounds. A spend may be claimed within one [Config::PayoutPeriod] from the valid_from block. In case of a payout failure, the spend status must be updated with the check_status dispatchable before retrying with the current function.

Parameters

• index: The spend index.

Events

Emits [Event::Paid] if successful.

check_status - 7

check_status(index)

Taking 0.0056 % of a block.

index: SpendIndex

Check the status of the spend and remove it from the storage if processed.

Dispatch Origin

Must be signed.

Details

The status check is a prerequisite for retrying a failed payout. If a spend has either succeeded or expired, it is removed from the storage by this function. In such instances, transaction fees are refunded.

Parameters

• index: The spend index.

Events

Emits [Event::PaymentFailed] if the spend payout has failed. Emits [Event::SpendProcessed] if the spend payout has succeed.

void_spend - 8

void_spend(index)

Taking 0.0056 % of a block.

index: SpendIndex

Void previously approved spend.

Dispatch Origin

Must be [Config::RejectOrigin].

Details

A spend void is only possible if the payout has not been attempted yet.

Parameters

• index: The spend index.

Events

Emits [Event::AssetSpendVoided] if successful.