Files
pezkuwi-subxt/polkadot/xcm/src/tests.rs
T
Francisco Aguirre 8428f678fe XCMv4 (#1230)
# Note for reviewer

Most changes are just syntax changes necessary for the new version.
Most important files should be the ones under the `xcm` folder.

# Description 

Added XCMv4.

## Removed `Multi` prefix
The following types have been renamed:
- MultiLocation -> Location
- MultiAsset -> Asset
- MultiAssets -> Assets
- InteriorMultiLocation -> InteriorLocation
- MultiAssetFilter -> AssetFilter
- VersionedMultiAsset -> VersionedAsset
- WildMultiAsset -> WildAsset
- VersionedMultiLocation -> VersionedLocation

In order to fix a name conflict, the `Assets` in `xcm-executor` were
renamed to `HoldingAssets`, as they represent assets in holding.

## Removed `Abstract` asset id

It was not being used anywhere and this simplifies the code.

Now assets are just constructed as follows:

```rust
let asset: Asset = (AssetId(Location::new(1, Here)), 100u128).into();
```

No need for specifying `Concrete` anymore.

## Outcome is now a named fields struct

Instead of

```rust
pub enum Outcome {
  Complete(Weight),
  Incomplete(Weight, Error),
  Error(Error),
}
```

we now have

```rust
pub enum Outcome {
  Complete { used: Weight },
  Incomplete { used: Weight, error: Error },
  Error { error: Error },
}
```

## Added Reanchorable trait

Now both locations and assets implement this trait, making it easier to
reanchor both.

## New syntax for building locations and junctions

Now junctions are built using the following methods:

```rust
let location = Location {
    parents: 1,
    interior: [Parachain(1000), PalletInstance(50), GeneralIndex(1984)].into()
};
```

or

```rust
let location = Location::new(1, [Parachain(1000), PalletInstance(50), GeneralIndex(1984)]);
```

And they are matched like so:

```rust
match location.unpack() {
  (1, [Parachain(id)]) => ...
  (0, Here) => ...,
  (1, [_]) => ...,
}
```

This syntax is mandatory in v4, and has been also implemented for v2 and
v3 for easier migration.

This was needed to make all sizes smaller.

# TODO
- [x] Scaffold v4
- [x] Port github.com/paritytech/polkadot/pull/7236
- [x] Remove `Multi` prefix
- [x] Remove `Abstract` asset id

---------

Co-authored-by: command-bot <>
Co-authored-by: Keith Yeung <kungfukeith11@gmail.com>
2024-01-16 18:18:04 +00:00

195 lines
6.4 KiB
Rust

// Copyright (C) Parity Technologies (UK) Ltd.
// This file is part of Polkadot.
// Polkadot is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// Polkadot is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with Polkadot. If not, see <http://www.gnu.org/licenses/>.
use crate::*;
use alloc::vec;
#[test]
fn encode_decode_versioned_asset_id_v3() {
let asset_id = VersionedAssetId::V3(v3::AssetId::Abstract([1; 32]));
let encoded = asset_id.encode();
assert_eq!(
encoded,
hex_literal::hex!("03010101010101010101010101010101010101010101010101010101010101010101"),
"encode format changed"
);
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedAssetId::decode(&mut &encoded[..]).unwrap();
assert_eq!(asset_id, decoded);
}
#[test]
fn encode_decode_versioned_response_v2() {
let response = VersionedResponse::V2(v2::Response::Null);
let encoded = response.encode();
assert_eq!(encoded, hex_literal::hex!("0200"), "encode format changed");
assert_eq!(encoded[0], 2, "bad version number");
let decoded = VersionedResponse::decode(&mut &encoded[..]).unwrap();
assert_eq!(response, decoded);
}
#[test]
fn encode_decode_versioned_response_v3() {
let response = VersionedResponse::V3(v3::Response::Null);
let encoded = response.encode();
assert_eq!(encoded, hex_literal::hex!("0300"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedResponse::decode(&mut &encoded[..]).unwrap();
assert_eq!(response, decoded);
}
#[test]
fn encode_decode_versioned_multi_location_v2() {
let location = VersionedLocation::V2(v2::MultiLocation::new(0, v2::Junctions::Here));
let encoded = location.encode();
assert_eq!(encoded, hex_literal::hex!("010000"), "encode format changed");
assert_eq!(encoded[0], 1, "bad version number"); // this is introduced in v1
let decoded = VersionedLocation::decode(&mut &encoded[..]).unwrap();
assert_eq!(location, decoded);
}
#[test]
fn encode_decode_versioned_multi_location_v3() {
let location = VersionedLocation::V3(v3::MultiLocation::new(0, v3::Junctions::Here));
let encoded = location.encode();
assert_eq!(encoded, hex_literal::hex!("030000"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedLocation::decode(&mut &encoded[..]).unwrap();
assert_eq!(location, decoded);
}
#[test]
fn encode_decode_versioned_interior_multi_location_v2() {
let location = VersionedInteriorLocation::V2(v2::InteriorMultiLocation::Here);
let encoded = location.encode();
assert_eq!(encoded, hex_literal::hex!("0200"), "encode format changed");
assert_eq!(encoded[0], 2, "bad version number");
let decoded = VersionedInteriorLocation::decode(&mut &encoded[..]).unwrap();
assert_eq!(location, decoded);
}
#[test]
fn encode_decode_versioned_interior_multi_location_v3() {
let location = VersionedInteriorLocation::V3(v3::InteriorMultiLocation::Here);
let encoded = location.encode();
assert_eq!(encoded, hex_literal::hex!("0300"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedInteriorLocation::decode(&mut &encoded[..]).unwrap();
assert_eq!(location, decoded);
}
#[test]
fn encode_decode_versioned_multi_asset_v2() {
let asset = VersionedAsset::V2(v2::MultiAsset::from(((0, v2::Junctions::Here), 1)));
let encoded = asset.encode();
assert_eq!(encoded, hex_literal::hex!("010000000004"), "encode format changed");
assert_eq!(encoded[0], 1, "bad version number");
let decoded = VersionedAsset::decode(&mut &encoded[..]).unwrap();
assert_eq!(asset, decoded);
}
#[test]
fn encode_decode_versioned_multi_asset_v3() {
let asset = VersionedAsset::V3(v3::MultiAsset::from((v3::MultiLocation::default(), 1)));
let encoded = asset.encode();
assert_eq!(encoded, hex_literal::hex!("030000000004"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedAsset::decode(&mut &encoded[..]).unwrap();
assert_eq!(asset, decoded);
}
#[test]
fn encode_decode_versioned_multi_assets_v2() {
let assets = VersionedAssets::V2(v2::MultiAssets::from(vec![v2::MultiAsset::from((
(0, v2::Junctions::Here),
1,
))]));
let encoded = assets.encode();
assert_eq!(encoded, hex_literal::hex!("01040000000004"), "encode format changed");
assert_eq!(encoded[0], 1, "bad version number");
let decoded = VersionedAssets::decode(&mut &encoded[..]).unwrap();
assert_eq!(assets, decoded);
}
#[test]
fn encode_decode_versioned_multi_assets_v3() {
let assets = VersionedAssets::V3(v3::MultiAssets::from(vec![
(v3::MultiAsset::from((v3::MultiLocation::default(), 1))),
]));
let encoded = assets.encode();
assert_eq!(encoded, hex_literal::hex!("03040000000004"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedAssets::decode(&mut &encoded[..]).unwrap();
assert_eq!(assets, decoded);
}
#[test]
fn encode_decode_versioned_xcm_v2() {
let xcm = VersionedXcm::V2(v2::Xcm::<()>::new());
let encoded = xcm.encode();
assert_eq!(encoded, hex_literal::hex!("0200"), "encode format changed");
assert_eq!(encoded[0], 2, "bad version number");
let decoded = VersionedXcm::decode(&mut &encoded[..]).unwrap();
assert_eq!(xcm, decoded);
}
#[test]
fn encode_decode_versioned_xcm_v3() {
let xcm = VersionedXcm::V3(v3::Xcm::<()>::new());
let encoded = xcm.encode();
assert_eq!(encoded, hex_literal::hex!("0300"), "encode format changed");
assert_eq!(encoded[0], 3, "bad version number");
let decoded = VersionedXcm::decode(&mut &encoded[..]).unwrap();
assert_eq!(xcm, decoded);
}
// With the renaming of the crate to `staging-xcm` the naming in the metadata changed as well and
// this broke downstream users. This test ensures that the name in the metadata isn't changed.
#[test]
fn ensure_type_info_is_correct() {
let type_info = VersionedXcm::<()>::type_info();
assert_eq!(type_info.path.segments, vec!["xcm", "VersionedXcm"]);
let type_info = VersionedAssetId::type_info();
assert_eq!(type_info.path.segments, vec!["xcm", "VersionedAssetId"]);
}