mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-07-09 18:47:28 +00:00
Francisco Aguirre
8428f678fe
# 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>
89 lines
2.8 KiB
Rust
89 lines
2.8 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/>.
|
|
|
|
//! Procedural macros used in XCM.
|
|
|
|
use proc_macro::TokenStream;
|
|
use syn::{parse_macro_input, DeriveInput};
|
|
|
|
mod builder_pattern;
|
|
mod v2;
|
|
mod v3;
|
|
mod v4;
|
|
mod weight_info;
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_multilocation_v2(input: TokenStream) -> TokenStream {
|
|
v2::multilocation::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_junctions_v2(input: TokenStream) -> TokenStream {
|
|
v2::junctions::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
#[proc_macro_derive(XcmWeightInfoTrait)]
|
|
pub fn derive_xcm_weight_info(item: TokenStream) -> TokenStream {
|
|
weight_info::derive(item)
|
|
}
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_multilocation_v3(input: TokenStream) -> TokenStream {
|
|
v3::multilocation::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_junctions_v3(input: TokenStream) -> TokenStream {
|
|
v3::junctions::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_location_v4(input: TokenStream) -> TokenStream {
|
|
v4::location::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
#[proc_macro]
|
|
pub fn impl_conversion_functions_for_junctions_v4(input: TokenStream) -> TokenStream {
|
|
v4::junctions::generate_conversion_functions(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|
|
|
|
/// This is called on the `Instruction` enum, not on the `Xcm` struct,
|
|
/// and allows for the following syntax for building XCMs:
|
|
/// let message = Xcm::builder()
|
|
/// .withdraw_asset(assets)
|
|
/// .buy_execution(fees, weight_limit)
|
|
/// .deposit_asset(assets, beneficiary)
|
|
/// .build();
|
|
#[proc_macro_derive(Builder, attributes(builder))]
|
|
pub fn derive_builder(input: TokenStream) -> TokenStream {
|
|
let input = parse_macro_input!(input as DeriveInput);
|
|
builder_pattern::derive(input)
|
|
.unwrap_or_else(syn::Error::into_compile_error)
|
|
.into()
|
|
}
|