Struct band::pallet::Pallet

pub struct Pallet<T, I = ()>(_);

Band pallet is used to relay data from BandChain oracles to Polkaswap. This data contains information about some symbols rates, like price of some cryptocurrencies, stocks, fiat and etc.

Some service will call relay extrinsic every period of time using trusted account. Governance (aka ROOT user) can add or remove such trusted accounts.

I generic argument is used to be able to instantiate this pallet multiple times. One per every asset category. This will prevent overlapping tickers.

Implementations

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn relay( origin: OriginFor<T>, rates: BoundedVec<(T::Symbol, u64), T::MaxRelaySymbols>, resolve_time: u64, request_id: u64 ) -> DispatchResultWithPostInfo

Relay a list of symbols and their associated rates along with the resolve time and request id on BandChain.

Checks if:

• The caller is a relayer;
• The resolve_time for a particular symbol is not lower than previous saved value, ignores this rate if so;

If rates contains duplicated symbols, then the last rate will be stored.

• origin: the relayer account on whose behalf the transaction is being executed,
• rates: symbols with rates in USD represented as fixed point with precision = 9,
• resolve_time: symbols which rates are provided,
• request_id: id of the request sent to the BandChain to retrieve this data.

pub fn force_relay( origin: OriginFor<T>, rates: BoundedVec<(T::Symbol, u64), T::MaxRelaySymbols>, resolve_time: u64, request_id: u64 ) -> DispatchResultWithPostInfo

Similar to [relay()] but without the resolve time guard.

Should be used in emergency situations i.e. then previous value was relayed by a faulty/malicious actor.

• origin: the relayer account on whose behalf the transaction is being executed,
• rates: symbols with rates in USD represented as fixed point with precision = 9,
• resolve_time: symbols which rates are provided,
• request_id: id of the request sent to the BandChain to retrieve this data.

pub fn add_relayers( origin: OriginFor<T>, account_ids: Vec<T::AccountId> ) -> DispatchResultWithPostInfo

Add account_ids to the list of trusted relayers.

Ignores repeated accounts in account_ids. If one of account is already a trusted relayer an Error::AlreadyATrustedRelayer will be returned.

• origin: the sudo account on whose behalf the transaction is being executed,
• account_ids: list of new trusted relayers to add.

pub fn remove_relayers( origin: OriginFor<T>, account_ids: Vec<T::AccountId> ) -> DispatchResultWithPostInfo

Remove account_ids from the list of trusted relayers.

Ignores repeated accounts in account_ids. If one of account is not a trusted relayer an Error::AlreadyATrustedRelayer will be returned.

• origin: the sudo account on whose behalf the transaction is being executed,
• account_ids: list of relayers to remove.

pub fn set_dynamic_fee_parameters( origin: OriginFor<T>, fee_parameters: FeeCalculationParameters ) -> DispatchResultWithPostInfo

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn trusted_relayers() -> Option<BTreeSet<T::AccountId>>

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn rates<KArg>(k: KArg) -> Option<BandRate<BlockNumberFor<T>>>where KArg: EncodeLike<T::Symbol>,

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn check_blocks<KArg1, KArg2>(k1: KArg1, k2: KArg2) -> boolwhere KArg1: EncodeLike<T::BlockNumber>, KArg2: EncodeLike<T::Symbol>,

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn dynamic_fee_parameters() -> FeeCalculationParameters

impl<T: Config<I>, I: 'static> Pallet<T, I>

pub fn raw_rate_into_balance(raw_rate: u64) -> Result<Balance, DispatchError>

pub fn calculate_dynamic_fee( prev_fee: Fixed, prev_rate: Balance, new_rate: Balance ) -> Result<Fixed, DispatchError>

pub fn update_rate_if_outdated( rate: &mut BandRate<T::BlockNumber>, new_rate: BandRate<T::BlockNumber>, symbol: &T::Symbol ) -> Result<(), DispatchError>

pub fn calc_expiration_block(block_number: T::BlockNumber) -> T::BlockNumber

Trait Implementations

impl<T: Config<I>, I: 'static> Callable<T> for Pallet<T, I>

type RuntimeCall = Call<T, I>

impl<T, I> Clone for Pallet<T, I>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Config<I>, I: 'static> DataFeed<<T as Config<I>>::Symbol, Rate, u64> for Pallet<T, I>

fn quote(symbol: &T::Symbol) -> Result<Option<Rate>, DispatchError>

Get rate for the specified symbol

fn list_enabled_symbols() -> Result<Vec<(T::Symbol, u64)>, DispatchError>

Get all supported symbols and their last update time

fn quote_unchecked(symbol: &T::Symbol) -> Option<Rate>

Get rate for the specified symbol without any checks

impl<T, I> Debug for Pallet<T, I>

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

Formats the value using the given formatter.

impl<T: Config<I>, I: 'static> GetStorageVersion for Pallet<T, I>

fn current_storage_version() -> StorageVersion

Returns the current storage version as supported by the pallet.

fn on_chain_storage_version() -> StorageVersion

Returns the on-chain storage version of the pallet as stored in the storage.

impl<T: Config<I>, I: 'static> Hooks<<T as Config>::BlockNumber> for Pallet<T, I>

fn on_initialize(now: T::BlockNumber) -> Weight

The block is being initialized. Implement to have something happen.

fn on_finalize(_n: BlockNumber)

The block is being finalized. Implement to have something happen.

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

This will be run when the block is being finalized (before on_finalize). Implement to have something happen using the remaining weight. Will not fire if the remaining weight is 0. Return the weight used, the hook will subtract it from current weight used and pass the result to the next on_idle hook if it exists.

fn on_runtime_upgrade() -> Weight

Perform a module upgrade.

fn offchain_worker(_n: BlockNumber)

Implementing this function on a module allows you to perform long-running tasks that make (by default) validators generate transactions that feed results of those long-running computations back on chain.

fn integrity_test()

Run integrity test.

impl<T: Config<I>, I: 'static> IntegrityTest for Pallet<T, I>

fn integrity_test()

Run integrity test.

impl<T: Config<I>, I: 'static> OffchainWorker<<T as Config>::BlockNumber> for Pallet<T, I>

fn offchain_worker(n: <T as Config>::BlockNumber)

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

impl<T: Config<I>, I: 'static> OnFinalize<<T as Config>::BlockNumber> for Pallet<T, I>

fn on_finalize(n: <T as Config>::BlockNumber)

The block is being finalized. Implement to have something happen.

impl<T: Config<I>, I: 'static> OnGenesis for Pallet<T, I>

fn on_genesis()

Something that should happen at genesis.

impl<T: Config<I>, I: 'static> OnIdle<<T as Config>::BlockNumber> for Pallet<T, I>

fn on_idle(n: <T as Config>::BlockNumber, remaining_weight: Weight) -> Weight

The block is being finalized. Implement to have something happen in case there is leftover weight. Check the passed remaining_weight to make sure it is high enough to allow for your pallet’s extra computation.

impl<T: Config<I>, I: 'static> OnInitialize<<T as Config>::BlockNumber> for Pallet<T, I>

fn on_initialize(n: <T as Config>::BlockNumber) -> Weight

The block is being initialized. Implement to have something happen.

impl<T: Config<I>, I: 'static> OnRuntimeUpgrade for Pallet<T, I>

fn on_runtime_upgrade() -> Weight

Perform a module upgrade.

impl<T: Config<I>, I: 'static> PalletInfoAccess for Pallet<T, I>

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 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: Config<I>, I: 'static> PalletsInfoAccess for Pallet<T, I>

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, I> PartialEq<Pallet<T, I>> for Pallet<T, I>

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<T: Config<I>, I: 'static> StorageInfoTrait for Pallet<T, I>

fn storage_info() -> Vec<StorageInfo>

impl<T: Config<I>, I: 'static> WhitelistedStorageKeys for Pallet<T, I>

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, I> Eq for Pallet<T, I>