Crate pallet_asset_conversion_tx_payment

Asset Conversion Transaction Payment Pallet

This pallet allows runtimes that include it to pay for transactions in assets other than the chain’s native asset.

Overview

This pallet provides a TransactionExtension with an optional AssetId that specifies the asset to be used for payment (defaulting to the native token on None). It expects an OnChargeAssetTransaction implementation analogous to [pallet-transaction-payment]. The included SwapAssetAdapter (implementing OnChargeAssetTransaction) determines the fee amount by converting the fee calculated by [pallet-transaction-payment] in the native asset into the amount required of the specified asset.

Pallet API

This pallet does not have any dispatchable calls or storage. It wraps FRAME’s Transaction Payment pallet and functions as a replacement. This means you should include both pallets in your construct_runtime macro, but only include this pallet’s [TransactionExtension] (ChargeAssetTxPayment).

Terminology

• Native Asset or Native Currency: The asset that a chain considers native, as in its default for transaction fee payment, deposits, inflation, etc.
• Other assets: Other assets that may exist on chain, for example under the Assets pallet.

Re-exports

pub use weights::WeightInfo;

pub use pallet::*;

Modules

pallet

The pallet module in each FRAME pallet hosts the most important items needed to construct this pallet.

weights

Autogenerated weights for pallet_asset_conversion_tx_payment

Structs

ChargeAssetTxPayment

Require payment for transaction inclusion and optionally include a tip to gain additional priority in the queue.

SwapAssetAdapter

Means to withdraw, correct and deposit fees in the asset accepted by the system.

Enums

InitialPayment

Used to pass the initial payment info from pre- to post-dispatch.

Pre

The info passed between the prepare and post-dispatch steps for the ChargeAssetTxPayment extension.

Val

The info passed between the validate and prepare steps for the ChargeAssetTxPayment extension.

Traits

OnChargeAssetTransaction

Handle withdrawing, refunding and depositing of transaction fees.