mirror of https://github.com/pezkuwichain/pezkuwi-subxt.git synced 2026-07-06 13:47:22 +00:00

Files

T

Keith Yeung 769595eea5 Create a README for XCMv1 detailing notable changes (#4058 )

* Create a README for XCMv1 detailing notable changes

* Update xcm/src/v1/README.md

Co-authored-by: Gavin Wood <gavin@parity.io>

* Update xcm/src/v1/README.md

Co-authored-by: David <dvdplm@gmail.com>

* Update xcm/src/v1/README.md

Co-authored-by: David <dvdplm@gmail.com>

* Update xcm/src/v1/README.md

Co-authored-by: David <dvdplm@gmail.com>

* Update xcm/src/v1/README.md

Co-authored-by: David <dvdplm@gmail.com>

* Link to relevant PR for a full list of changes

* Typo

* Add notable changes to top-level XCM rustdoc

* Appease spellchecker

Co-authored-by: Gavin Wood <gavin@parity.io>
Co-authored-by: David <dvdplm@gmail.com>

2021-10-13 11:17:30 +00:00

junction.rs

Companion for #8615 : enrich metadata with type information (#3336 )

2021-09-15 15:38:45 -05:00

mod.rs

Create a README for XCMv1 detailing notable changes (#4058 )

2021-10-13 11:17:30 +00:00

multiasset.rs

Companion for #8615 : enrich metadata with type information (#3336 )

2021-09-15 15:38:45 -05:00

multilocation.rs

Make most XCM APIs accept an Into<MultiLocation> where MultiLocation is accepted (#3627 )

2021-09-29 23:24:49 +00:00

order.rs

Companion for #8615 : enrich metadata with type information (#3336 )

2021-09-15 15:38:45 -05:00

README.md

Create a README for XCMv1 detailing notable changes (#4058 )

2021-10-13 11:17:30 +00:00

traits.rs

Make most XCM APIs accept an Into<MultiLocation> where MultiLocation is accepted (#3627 )

2021-09-29 23:24:49 +00:00

README.md

XCM Version 1

The comprehensive list of changes can be found in this PR description.

Changes to be aware of

Most changes should automatically be resolved via the conversion traits (i.e. TryFrom and From). The list here is mostly for incompatible changes that result in an Err(()) when attempting to convert XCM objects from v0.

Junction

v0::Junction::Parent cannot be converted to v1, because the way we represent parents in v1 has changed - instead of being a property of the junction, v1 MultiLocations now have an extra field representing the number of parents that the MultiLocation contains.

MultiLocation

The try_from conversion method will always canonicalize the v0 MultiLocation before attempting to do the proper conversion. Since canonicalization is not a fallible operation, we do not expect v0 MultiLocation to ever fail to be upgraded to v1.

MultiAsset

Stronger typing to differentiate between a single class of MultiAsset and several classes of MultiAssets is introduced. As the name suggests, a Vec<MultiAsset> that is used on all APIs will instead be using a new type called MultiAssets (note the s).
All MultiAsset variants whose name contains "All" in it, namely v0::MultiAsset::All, v0::MultiAsset::AllFungible, v0::MultiAsset::AllNonFungible, v0::MultiAsset::AllAbstractFungible, v0::MultiAsset::AllAbstractNonFungible, v0::MultiAsset::AllConcreteFungible and v0::MultiAsset::AllConcreteNonFungible, will fail to convert to v1 MultiAsset, since v1 does not contain these variants.
Similarly, all MultiAsset variants whose name contains "All" in it can be converted into a WildMultiAsset.
v0::MultiAsset::None is not represented at all in v1.

XCM

No special attention necessary

Order

v1::Order::DepositAsset and v1::Order::DepositReserveAsset both introduced a new max_asset field that limits the maximum classes of assets that can be deposited. During conversion from v0, the max_asset field defaults to 1.
v1 Orders that contain MultiAsset as argument(s) will need to explicitly specify the amount and details of assets. This is to prevent accidental misuse of All to possibly transfer, spend or otherwise perform unintended operations on All assets.
v1 Orders that do allow the notion of All to be used as wildcards, will instead use a new type called MultiAssetFilter.