mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-07-19 21:35:44 +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>
61 lines
2.1 KiB
Rust
61 lines
2.1 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 xcm::prelude::*;
|
|
|
|
/// Handle stuff to do with taking fees in certain XCM instructions.
|
|
pub trait FeeManager {
|
|
/// Determine if a fee should be waived.
|
|
fn is_waived(origin: Option<&Location>, r: FeeReason) -> bool;
|
|
|
|
/// Do something with the fee which has been paid. Doing nothing here silently burns the
|
|
/// fees.
|
|
fn handle_fee(fee: Assets, context: Option<&XcmContext>, r: FeeReason);
|
|
}
|
|
|
|
/// Context under which a fee is paid.
|
|
#[derive(Clone, Debug, Eq, PartialEq)]
|
|
pub enum FeeReason {
|
|
/// When a reporting instruction is called.
|
|
Report,
|
|
/// When the `TransferReserveAsset` instruction is called.
|
|
TransferReserveAsset,
|
|
/// When the `DepositReserveAsset` instruction is called.
|
|
DepositReserveAsset,
|
|
/// When the `InitiateReserveWithdraw` instruction is called.
|
|
InitiateReserveWithdraw,
|
|
/// When the `InitiateTeleport` instruction is called.
|
|
InitiateTeleport,
|
|
/// When the `QueryPallet` instruction is called.
|
|
QueryPallet,
|
|
/// When the `ExportMessage` instruction is called (and includes the network ID).
|
|
Export { network: NetworkId, destination: InteriorLocation },
|
|
/// The `charge_fees` API.
|
|
ChargeFees,
|
|
/// When the `LockAsset` instruction is called.
|
|
LockAsset,
|
|
/// When the `RequestUnlock` instruction is called.
|
|
RequestUnlock,
|
|
}
|
|
|
|
impl FeeManager for () {
|
|
fn is_waived(_: Option<&Location>, _: FeeReason) -> bool {
|
|
false
|
|
}
|
|
|
|
fn handle_fee(_: Assets, _: Option<&XcmContext>, _: FeeReason) {}
|
|
}
|