62 releases (38 major breaking)

new 40.0.0 Apr 3, 2025
39.1.0 Mar 27, 2025
39.0.0 Jan 13, 2025
38.0.2 Dec 20, 2024
2.0.0-alpha.5 Mar 24, 2020

#678 in Magic Beans

Download history 24934/week @ 2024-12-17 8382/week @ 2024-12-24 15976/week @ 2024-12-31 26466/week @ 2025-01-07 40297/week @ 2025-01-14 33349/week @ 2025-01-21 29258/week @ 2025-01-28 33821/week @ 2025-02-04 40240/week @ 2025-02-11 34722/week @ 2025-02-18 9939/week @ 2025-02-25 6429/week @ 2025-03-04 9908/week @ 2025-03-11 6792/week @ 2025-03-18 8193/week @ 2025-03-25 5308/week @ 2025-04-01

31,307 downloads per month
Used in 156 crates (48 directly)

Apache-2.0

3MB
50K SLoC

Transaction Payment Pallet

This pallet provides the basic logic needed to pay the absolute minimum amount needed for a transaction to be included. This includes:

  • base fee: This is the minimum amount a user pays for a transaction. It is declared as a base weight in the runtime and converted to a fee using WeightToFee.
  • weight fee: A fee proportional to amount of weight a transaction consumes.
  • length fee: A fee proportional to the encoded length of the transaction.
  • tip: An optional tip. Tip increases the priority of the transaction, giving it a higher chance to be included by the transaction queue.

The base fee and adjusted weight and length fees constitute the inclusion fee, which is the minimum fee for a transaction to be included in a block.

The formula of final fee:

inclusion_fee = base_fee + length_fee + [targeted_fee_adjustment * weight_fee];
final_fee = inclusion_fee + tip;
  • targeted_fee_adjustment: This is a multiplier that can tune the final fee based on the congestion of the network.

Additionally, this pallet allows one to configure:


Transaction Payment Pallet

This pallet provides the basic logic needed to pay the absolute minimum amount needed for a transaction to be included. This includes:

  • weight fee: A fee proportional to amount of weight a transaction consumes.
  • length fee: A fee proportional to the encoded length of the transaction.
  • tip: An optional tip. Tip increases the priority of the transaction, giving it a higher chance to be included by the transaction queue.

Additionally, this pallet allows one to configure:

  • The mapping between one unit of weight to one unit of fee via Config::WeightToFee.
  • A means of updating the fee for the next block, via defining a multiplier, based on the final state of the chain at the end of the previous block. This can be configured via Config::FeeMultiplierUpdate

License: Apache-2.0

Dependencies

~20–34MB
~582K SLoC