Crate pallet_asset_conversion

Substrate Asset Conversion pallet

Substrate Asset Conversion pallet based on the Uniswap V2 logic.

Overview

This pallet allows you to:

• create a liquidity pool for 2 assets
• provide the liquidity and receive back an LP token
• exchange the LP token back to assets
• swap a specific amount of assets for another if there is a pool created, or
• swap some assets for a specific amount of another.
• query for an exchange price via a runtime call endpoint
• query the size of a liquidity pool via a runtime api endpoint.

The quote_price_exact_tokens_for_tokens and quote_price_tokens_for_exact_tokens functions both take a path parameter of the route to take. If you want to swap from native asset to non-native asset 1, you would pass in a path of [DOT, 1] or [1, DOT]. If you want to swap from non-native asset 1 to non-native asset 2, you would pass in a path of [1, DOT, 2].

(For an example of configuring this pallet to use MultiLocation as an asset id, see the cumulus repo).

Here is an example state_call that asks for a quote of a pool of native versus asset 1:

curl -sS -H "Content-Type: application/json" -d \
'{"id":1, "jsonrpc":"2.0", "method": "state_call", "params": ["AssetConversionApi_quote_price_tokens_for_exact_tokens", "0x0101000000000000000000000011000000000000000000"]}' \
http://localhost:9933/

(This can be run against the kitchen sync node in the node folder of this repo.)

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

Macros

• _runtime_benchmarks_enabled
  Enable/disable the given code depending on feature = "runtime-benchmarks" being enabled for the crate or not.

Structs

• NativeOrAssetIdConverter
  Converts between a MultiAssetId and an AssetId (or the native currency).
• PoolInfo
  Stores the lp_token asset id a particular pool has been assigned.

Enums

• MultiAssetIdConversionResult
  Result of MultiAssetIdConverter::try_convert.
• NativeOrAssetId
  An implementation of MultiAssetId that can be either Native or an asset.

Traits

• AssetConversionApi
  This runtime api allows people to query the size of the liquidity pools and quote prices for swaps.
• BenchmarkHelper
  Benchmark Helper
• MultiAssetIdConverter
  A trait that converts between a MultiAssetId and either the native currency or an AssetId.
• Swap
  Trait for providing methods to swap between the various asset classes.