Type Alias AssetRewards

pub type AssetRewards = Pallet<Runtime>;

Aliased Type

struct AssetRewards(/* private fields */);

Implementations

impl<T> Pallet<T>

where T: Config,

Pallet’s callable functions.

pub fn create_pool( origin: <T as Config>::RuntimeOrigin, staked_asset_id: Box<<T as Config>::AssetId>, reward_asset_id: Box<<T as Config>::AssetId>, reward_rate_per_block: <T as Config>::Balance, expiry: DispatchTime<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, admin: Option<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Create a new reward pool.

Parameters:

• origin: must be Config::CreatePoolOrigin;
• staked_asset_id: the asset to be staked in the pool;
• reward_asset_id: the asset to be distributed as rewards;
• reward_rate_per_block: the amount of reward tokens distributed per block;
• expiry: the block number at which the pool will cease to accumulate rewards. The DispatchTime::After variant evaluated at the execution time.
• admin: the account allowed to extend the pool expiration, increase the rewards rate and receive the unutilized reward tokens back after the pool completion. If None, the caller is set as an admin.

pub fn stake( origin: <T as Config>::RuntimeOrigin, pool_id: u32, amount: <T as Config>::Balance, ) -> Result<(), DispatchError>

Stake additional tokens in a pool.

A freeze is placed on the staked tokens.

pub fn unstake( origin: <T as Config>::RuntimeOrigin, pool_id: u32, amount: <T as Config>::Balance, staker: Option<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Unstake tokens from a pool.

Removes the freeze on the staked tokens.

Parameters:

• origin: must be the staker if the pool is still active. Otherwise, any account.
• pool_id: the pool to unstake from.
• amount: the amount of tokens to unstake.
• staker: the account to unstake from. If None, the caller is used.

pub fn harvest_rewards( origin: <T as Config>::RuntimeOrigin, pool_id: u32, staker: Option<<T as Config>::AccountId>, ) -> Result<(), DispatchError>

Harvest unclaimed pool rewards.

Parameters:

• origin: must be the staker if the pool is still active. Otherwise, any account.
• pool_id: the pool to harvest from.
• staker: the account for which to harvest rewards. If None, the caller is used.

pub fn set_pool_reward_rate_per_block( origin: <T as Config>::RuntimeOrigin, pool_id: u32, new_reward_rate_per_block: <T as Config>::Balance, ) -> Result<(), DispatchError>

Modify a pool reward rate.

Currently the reward rate can only be increased.

Only the pool admin may perform this operation.

pub fn set_pool_admin( origin: <T as Config>::RuntimeOrigin, pool_id: u32, new_admin: <T as Config>::AccountId, ) -> Result<(), DispatchError>

Modify a pool admin.

Only the pool admin may perform this operation.

pub fn set_pool_expiry_block( origin: <T as Config>::RuntimeOrigin, pool_id: u32, new_expiry: DispatchTime<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, ) -> Result<(), DispatchError>

Set when the pool should expire.

Currently the expiry block can only be extended.

Only the pool admin may perform this operation.

pub fn deposit_reward_tokens( origin: <T as Config>::RuntimeOrigin, pool_id: u32, amount: <T as Config>::Balance, ) -> Result<(), DispatchError>

Convenience method to deposit reward tokens into a pool.

This method is not strictly necessary (tokens could be transferred directly to the pool pot address), but is provided for convenience so manual derivation of the account id is not required.

pub fn cleanup_pool( origin: <T as Config>::RuntimeOrigin, pool_id: u32, ) -> Result<(), DispatchError>

Cleanup a pool.

Origin must be the pool admin.

Cleanup storage, release any associated storage cost and return the remaining reward tokens to the admin.

impl<T> Pallet<T>

where T: Config,

pub fn pool_creation_footprint() -> Footprint

The pool creation footprint.

The footprint specifically accounts for the storage footprint of the pool’s information itself, excluding any potential storage footprint related to the stakers.

pub fn pool_account_id(id: &u32) -> <T as Config>::AccountId

Derive a pool account ID from the pool’s ID.

pub fn update_pool_and_staker_rewards( pool_info: &PoolInfo<<T as Config>::AccountId, <T as Config>::AssetId, <T as Config>::Balance, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, staker_info: &PoolStakerInfo<<T as Config>::Balance>, ) -> Result<(PoolInfo<<T as Config>::AccountId, <T as Config>::AssetId, <T as Config>::Balance, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, PoolStakerInfo<<T as Config>::Balance>), DispatchError>

Computes update pool and staker reward state.

Should be called prior to any operation involving a staker.

Returns the updated pool and staker info.

NOTE: this function has no side-effects. Side-effects such as storage modifications are the responsibility of the caller.

pub fn update_pool_rewards( pool_info: &PoolInfo<<T as Config>::AccountId, <T as Config>::AssetId, <T as Config>::Balance, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, reward_per_token: <T as Config>::Balance, ) -> Result<PoolInfo<<T as Config>::AccountId, <T as Config>::AssetId, <T as Config>::Balance, <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number>, DispatchError>

Computes update pool reward state.

Should be called every time the pool is adjusted, and a staker is not involved.

Returns the updated pool and staker info.

NOTE: this function has no side-effects. Side-effects such as storage modifications are the responsibility of the caller.

Trait Implementations

impl<T> BeforeAllRuntimeMigrations for Pallet<T>

where T: Config,

fn before_all_runtime_migrations() -> Weight

Something that should happen before runtime migrations are executed.

impl<T> Benchmarking for Pallet<T>

where T: Config + Config, <T as Config>::Assets: Create<<T as Config>::AccountId> + Mutate<<T as Config>::AccountId>,

fn benchmarks(extra: bool) -> Vec<BenchmarkMetadata>

Get the benchmarks available for this pallet. Generally there is one benchmark per extrinsic, so these are sometimes just called “extrinsics”.

fn run_benchmark( extrinsic: &[u8], c: &[(BenchmarkParameter, u32)], whitelist: &[TrackedStorageKey], verify: bool, internal_repeats: u32, ) -> Result<Vec<BenchmarkResult>, BenchmarkError>

Run the benchmarks for this pallet.

impl<T> Callable<T> for Pallet<T>

where T: Config,

type RuntimeCall = Call<T>

impl<T> Clone for Pallet<T>

fn clone(&self) -> Pallet<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Debug for Pallet<T>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<T> DispatchViewFunction for Pallet<T>

where T: Config,

fn dispatch_view_function<O>( id: &ViewFunctionId, input: &mut &[u8], output: &mut O, ) -> Result<(), ViewFunctionDispatchError>

where O: Output,

impl<T> GetStorageVersion for Pallet<T>

where T: Config,

type InCodeStorageVersion = NoStorageVersionSet

This type is generated by the pallet macro.

fn in_code_storage_version() -> <Pallet<T> as GetStorageVersion>::InCodeStorageVersion

Returns the in-code storage version as specified in the storage_version attribute, or NoStorageVersionSet if the attribute is missing.

fn on_chain_storage_version() -> StorageVersion

Returns the storage version of the pallet as last set in the actual on-chain storage.

fn current_storage_version() -> Self::InCodeStorageVersion

👎Deprecated: This method has been renamed to in_code_storage_version and will be removed after March 2024.

DEPRECATED: Use Self::current_storage_version instead.

impl<T> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn integrity_test()

Check the integrity of this pallet’s configuration.

fn on_initialize(_n: BlockNumber) -> Weight

Block initialization hook. This is called at the very beginning of block execution.

fn on_finalize(_n: BlockNumber)

Block finalization hook. This is called at the very end of block execution.

fn on_idle(_n: BlockNumber, _remaining_weight: Weight) -> Weight

Hook to consume a block’s idle time. This will run when the block is being finalized (before Hooks::on_finalize).

fn on_poll(_n: BlockNumber, _weight: &mut WeightMeter)

A hook to run logic after inherent application.

fn on_runtime_upgrade() -> Weight

Hook executed when a code change (aka. a “runtime upgrade”) is detected by the FRAME Executive pallet.

fn try_state(_n: BlockNumber) -> Result<(), DispatchError>

Execute the sanity checks of this pallet, per block.

fn pre_upgrade() -> Result<Vec<u8>, DispatchError>

Execute some pre-checks prior to a runtime upgrade.

fn post_upgrade(_state: Vec<u8>) -> Result<(), DispatchError>

Execute some post-checks after a runtime upgrade.

fn offchain_worker(_n: BlockNumber)

Implementing this function on a pallet allows you to perform long-running tasks that are dispatched as separate threads, and entirely independent of the main blockchain execution.

impl<T> IntegrityTest for Pallet<T>

where T: Config,

fn integrity_test()

See Hooks::integrity_test.

impl<T> OffchainWorker<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn offchain_worker( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )

This function is being called after every block import (when fully synced).

impl<T> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn on_finalize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )

See Hooks::on_finalize.

impl<T> OnGenesis for Pallet<T>

where T: Config,

fn on_genesis()

Something that should happen at genesis.

impl<T> OnIdle<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn on_idle( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, remaining_weight: Weight, ) -> Weight

See Hooks::on_idle.

impl<T> OnInitialize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn on_initialize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Weight

See Hooks::on_initialize.

impl<T> OnPoll<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn on_poll( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, weight: &mut WeightMeter, )

Code to execute every now and then at the beginning of the block after inherent application.

impl<T> OnRuntimeUpgrade for Pallet<T>

where T: Config,

fn on_runtime_upgrade() -> Weight

See Hooks::on_runtime_upgrade.

fn pre_upgrade() -> Result<Vec<u8>, DispatchError>

See Hooks::pre_upgrade.

fn post_upgrade(state: Vec<u8>) -> Result<(), DispatchError>

See Hooks::post_upgrade.

fn try_on_runtime_upgrade(checks: bool) -> Result<Weight, DispatchError>

The expected and default behavior of this method is to handle executing pre_upgrade -> on_runtime_upgrade -> post_upgrade hooks for a migration.

impl<T> PalletInfoAccess for Pallet<T>

where T: Config,

fn index() -> usize

Index of the pallet as configured in the runtime.

fn name() -> &'static str

Name of the pallet as configured in the runtime.

fn name_hash() -> [u8; 16]

Two128 hash of name.

fn module_name() -> &'static str

Name of the Rust module containing the pallet.

fn crate_version() -> CrateVersion

Version of the crate containing the pallet.

impl<T> PalletsInfoAccess for Pallet<T>

where T: Config,

fn count() -> usize

The number of pallets’ information that this type represents.

fn infos() -> Vec<PalletInfoData>

All of the pallets’ information that this type represents.

impl<T> PartialEq for Pallet<T>

fn eq(&self, other: &Pallet<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> StorageInfoTrait for Pallet<T>

where T: Config,

fn storage_info() -> Vec<StorageInfo>

impl<T> TryDecodeEntireStorage for Pallet<T>

where T: Config,

fn try_decode_entire_state() -> Result<usize, Vec<TryDecodeEntireStorageError>>

Decode the entire data under the given storage, returning Ok(bytes_decoded) if success.

impl<T> TryState<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>

where T: Config,

fn try_state( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, _s: Select, ) -> Result<(), DispatchError>

Execute the state checks.

impl<T> ViewFunctionIdPrefix for Pallet<T>

where T: Config,

fn prefix() -> [u8; 16]

impl<T> WhitelistedStorageKeys for Pallet<T>

where T: Config,

fn whitelisted_storage_keys() -> Vec<TrackedStorageKey>

Returns a Vec<TrackedStorageKey> indicating the storage keys that should be whitelisted during benchmarking. This means that those keys will be excluded from the benchmarking performance calculation.

impl<T> Eq for Pallet<T>