Treasury¶

Calls¶

approve_proposal¶

See [Pallet::approve_proposal].

Attributes¶

Name	Type
proposal_id	`ProposalIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'approve_proposal', {'proposal_id': 'u32'}
)

check_status¶

See [Pallet::check_status].

Attributes¶

Name	Type
index	`SpendIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'check_status', {'index': 'u32'}
)

payout¶

See [Pallet::payout].

Attributes¶

Name	Type
index	`SpendIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'payout', {'index': 'u32'}
)

propose_spend¶

See [Pallet::propose_spend].

Attributes¶

Name	Type
value	`BalanceOf<T, I>`
beneficiary	`AccountIdLookupOf<T>`

Python¶

call = substrate.compose_call(
    'Treasury', 'propose_spend', {
    'beneficiary': {
        'Address20': '[u8; 20]',
        'Address32': '[u8; 32]',
        'Id': 'AccountId',
        'Index': (),
        'Raw': 'Bytes',
    },
    'value': 'u128',
}
)

reject_proposal¶

See [Pallet::reject_proposal].

Attributes¶

Name	Type
proposal_id	`ProposalIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'reject_proposal', {'proposal_id': 'u32'}
)

remove_approval¶

See [Pallet::remove_approval].

Attributes¶

Name	Type
proposal_id	`ProposalIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'remove_approval', {'proposal_id': 'u32'}
)

spend¶

See [Pallet::spend].

Attributes¶

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

Python¶

call = substrate.compose_call(
    'Treasury', 'spend', {
    'amount': 'u128',
    'asset_kind': (),
    'beneficiary': 'AccountId',
    'valid_from': (None, 'u32'),
}
)

spend_local¶

See [Pallet::spend_local].

Attributes¶

Name	Type
amount	`BalanceOf<T, I>`
beneficiary	`AccountIdLookupOf<T>`

Python¶

call = substrate.compose_call(
    'Treasury', 'spend_local', {
    'amount': 'u128',
    'beneficiary': {
        'Address20': '[u8; 20]',
        'Address32': '[u8; 32]',
        'Id': 'AccountId',
        'Index': (),
        'Raw': 'Bytes',
    },
}
)

void_spend¶

See [Pallet::void_spend].

Attributes¶

Name	Type
index	`SpendIndex`

Python¶

call = substrate.compose_call(
    'Treasury', 'void_spend', {'index': 'u32'}
)

Events¶

AssetSpendApproved¶

A new asset spend proposal has been approved.

Attributes¶

Name	Type	Composition
index	`SpendIndex`	`u32`
asset_kind	`T::AssetKind`	`()`
amount	`AssetBalanceOf<T, I>`	`u128`
beneficiary	`T::Beneficiary`	`AccountId`
valid_from	`BlockNumberFor<T>`	`u32`
expire_at	`BlockNumberFor<T>`	`u32`

AssetSpendVoided¶

An approved spend was voided.

Attributes¶

Name	Type	Composition
index	`SpendIndex`	`u32`

Awarded¶

Some funds have been allocated.

Attributes¶

Name	Type	Composition
proposal_index	`ProposalIndex`	`u32`
award	`BalanceOf<T, I>`	`u128`
account	`T::AccountId`	`AccountId`

Burnt¶

Some of our funds have been burnt.

Attributes¶

Name	Type	Composition
burnt_funds	`BalanceOf<T, I>`	`u128`

Deposit¶

Some funds have been deposited.

Attributes¶

Name	Type	Composition
value	`BalanceOf<T, I>`	`u128`

Paid¶

A payment happened.

Attributes¶

Name	Type	Composition
index	`SpendIndex`	`u32`
payment_id	`<T::Paymaster as Pay>::Id`	`()`

PaymentFailed¶

A payment failed and can be retried.

Attributes¶

Name	Type	Composition
index	`SpendIndex`	`u32`
payment_id	`<T::Paymaster as Pay>::Id`	`()`

Proposed¶

New proposal.

Attributes¶

Name	Type	Composition
proposal_index	`ProposalIndex`	`u32`

Rejected¶

A proposal was rejected; funds were slashed.

Attributes¶

Name	Type	Composition
proposal_index	`ProposalIndex`	`u32`
slashed	`BalanceOf<T, I>`	`u128`

Rollover¶

Spending has finished; this is the amount that rolls over until next spend.

Attributes¶

Name	Type	Composition
rollover_balance	`BalanceOf<T, I>`	`u128`

SpendApproved¶

A new spend proposal has been approved.

Attributes¶

Name	Type	Composition
proposal_index	`ProposalIndex`	`u32`
amount	`BalanceOf<T, I>`	`u128`
beneficiary	`T::AccountId`	`AccountId`

SpendProcessed¶

A spend was processed and removed from the storage. It might have been successfully paid or it may have expired.

Attributes¶

Name	Type	Composition
index	`SpendIndex`	`u32`

Spending¶

We have ended a spend period and will now allocate funds.

Attributes¶

Name	Type	Composition
budget_remaining	`BalanceOf<T, I>`	`u128`

UpdatedInactive¶

The inactive funds of the pallet have been updated.

Attributes¶

Name	Type	Composition
reactivated	`BalanceOf<T, I>`	`u128`
deactivated	`BalanceOf<T, I>`	`u128`

Storage functions¶

Approvals¶

Proposal indices that have been approved but not yet awarded.

Python¶

result = substrate.query(
    'Treasury', 'Approvals', []
)

Return value¶

['u32']

Deactivated¶

The amount which has been reported as inactive to Currency.

Python¶

result = substrate.query(
    'Treasury', 'Deactivated', []
)

Return value¶

'u128'

ProposalCount¶

Number of proposals that have been made.

Python¶

result = substrate.query(
    'Treasury', 'ProposalCount', []
)

Return value¶

'u32'

Proposals¶

Proposals that have been made.

Python¶

result = substrate.query(
    'Treasury', 'Proposals', ['u32']
)

Return value¶

{
    'beneficiary': 'AccountId',
    'bond': 'u128',
    'proposer': 'AccountId',
    'value': 'u128',
}

SpendCount¶

The count of spends that have been made.

Python¶

result = substrate.query(
    'Treasury', 'SpendCount', []
)

Return value¶

'u32'

Spends¶

Spends that have been approved and being processed.

Python¶

result = substrate.query(
    'Treasury', 'Spends', ['u32']
)

Return value¶

{
    'amount': 'u128',
    'asset_kind': (),
    'beneficiary': 'AccountId',
    'expire_at': 'u32',
    'status': {'Attempted': {'id': ()}, 'Failed': None, 'Pending': None},
    'valid_from': 'u32',
}

Constants¶

Burn¶

Percentage of spare funds (if any) that are burnt per spend period.

Value¶

Python¶

constant = substrate.get_constant('Treasury', 'Burn')

MaxApprovals¶

The maximum number of approvals that can wait in the spending queue.

NOTE: This parameter is also used within the Bounties Pallet extension if enabled.

Value¶

Python¶

constant = substrate.get_constant('Treasury', 'MaxApprovals')

PalletId¶

The treasury's pallet id, used for deriving its sovereign account ID.

Value¶

'0x616a2f7472737279'

Python¶

constant = substrate.get_constant('Treasury', 'PalletId')

PayoutPeriod¶

The period during which an approved treasury spend has to be claimed.

Value¶

Python¶

constant = substrate.get_constant('Treasury', 'PayoutPeriod')

ProposalBond¶

Fraction of a proposal's value that should be bonded in order to place the proposal. An accepted proposal gets these back. A rejected proposal does not.

Value¶

Python¶

constant = substrate.get_constant('Treasury', 'ProposalBond')

ProposalBondMaximum¶

Maximum amount of funds that should be placed in a deposit for making a proposal.

Value¶

None

Python¶

constant = substrate.get_constant('Treasury', 'ProposalBondMaximum')

ProposalBondMinimum¶

Minimum amount of funds that should be placed in a deposit for making a proposal.

Value¶

1000000000000

Python¶

constant = substrate.get_constant('Treasury', 'ProposalBondMinimum')

SpendPeriod¶

Period between successive spends.

Value¶

Python¶

constant = substrate.get_constant('Treasury', 'SpendPeriod')

Errors¶

AlreadyAttempted¶

The payment has already been attempted.

EarlyPayout¶

The spend is not yet eligible for payout.

FailedToConvertBalance¶

The balance of the asset kind is not convertible to the balance of the native asset.

Inconclusive¶

The payment has neither failed nor succeeded yet.

InsufficientPermission¶

The spend origin is valid but the amount it is allowed to spend is lower than the amount to be spent.

InsufficientProposersBalance¶

Proposer's balance is too low.

InvalidIndex¶

No proposal, bounty or spend at that index.

NotAttempted¶

The payout was not yet attempted/claimed.

PayoutError¶

There was some issue with the mechanism of payment.

ProposalNotApproved¶

Proposal has not been approved.

SpendExpired¶

The spend has expired and cannot be claimed.

TooManyApprovals¶

Too many approvals in the queue.