14 major breaking releases

17.0.0 Sep 26, 2024
16.0.0 Jul 18, 2024
15.0.0 Jul 12, 2024
14.0.0 Jun 21, 2024
0.0.0 Oct 16, 2023

#12 in #balance

Download history 1227/week @ 2024-07-29 935/week @ 2024-08-05 1348/week @ 2024-08-12 1562/week @ 2024-08-19 1234/week @ 2024-08-26 857/week @ 2024-09-02 1098/week @ 2024-09-09 1029/week @ 2024-09-16 1513/week @ 2024-09-23 1508/week @ 2024-09-30 1502/week @ 2024-10-07 1782/week @ 2024-10-14 1999/week @ 2024-10-21 1850/week @ 2024-10-28 1857/week @ 2024-11-04 21318/week @ 2024-11-11

27,202 downloads per month
Used in 64 crates (5 directly)

Apache-2.0

2.5MB
42K SLoC

Release

Polkadot SDK stable2409


lib.rs:

Asset Rate Pallet

Overview

The AssetRate pallet provides means of setting conversion rates for some asset to native balance.

The supported dispatchable functions are documented in the Call enum.

Terminology

  • Asset balance: The balance type of an arbitrary asset. The network might only know about the identifier of the asset and nothing more.
  • Native balance: The balance type of the network's native currency.

Goals

The asset-rate system in Substrate is designed to make the following possible:

  • Providing a soft conversion for the balance of supported assets to a default asset class.
  • Updating existing conversion rates.

Interface

Permissioned Functions

  • create: Creates a new asset conversion rate.
  • remove: Removes an existing asset conversion rate.
  • update: Overwrites an existing assert conversion rate.

Please refer to the Call enum and its associated variants for documentation on each function.

Assumptions

  • Conversion rates are only used as estimates, and are not designed to be precise or closely tracking real world values.
  • All conversion rates reflect the ration of some asset to native, e.g. native = asset * rate.

Dependencies

~18–33MB
~548K SLoC