// Copyright (C) Parity Technologies (UK) Ltd. // This file is part of Polkadot. // Substrate 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. // Substrate 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 . //! Tests for using both the XCM fee payment API and the dry-run API. use frame_support::sp_runtime::testing::H256; use frame_system::RawOrigin; use sp_api::ProvideRuntimeApi; use xcm::prelude::*; use xcm_runtime_apis::{dry_run::DryRunApi, fees::XcmPaymentApi}; mod mock; use mock::{ fake_message_hash, new_test_ext_with_balances, new_test_ext_with_balances_and_assets, DeliveryFees, ExistentialDeposit, HereLocation, OriginCaller, RuntimeCall, RuntimeEvent, TestClient, }; // Scenario: User `1` in the local chain (id 2000) wants to transfer assets to account `[0u8; 32]` // on "AssetHub". He wants to make sure he has enough for fees, so before he calls the // `transfer_asset` extrinsic to do the transfer, he decides to use the `XcmDryRunApi` and // `XcmPaymentApi` runtime APIs to estimate fees. This uses a teleport because we're dealing with // the native token of the chain, which is registered on "AssetHub". The fees are sent as a reserve // asset transfer, since they're paid in the relay token. // // Teleport Parachain(2000) Token // Reserve Asset Transfer Relay Token for fees // Parachain(2000) -------------------------------------------> Parachain(1000) #[test] fn fee_estimation_for_teleport() { sp_tracing::init_for_tests(); let who = 1; // AccountId = u64. let balances = vec![(who, 100 + DeliveryFees::get() + ExistentialDeposit::get())]; let assets = vec![(1, who, 50)]; new_test_ext_with_balances_and_assets(balances, assets).execute_with(|| { let client = TestClient; let runtime_api = client.runtime_api(); let call = RuntimeCall::XcmPallet(pallet_xcm::Call::transfer_assets { dest: Box::new(VersionedLocation::from((Parent, Parachain(1000)))), beneficiary: Box::new(VersionedLocation::from(AccountId32 { id: [0u8; 32], network: None, })), assets: Box::new(VersionedAssets::from(vec![ (Here, 100u128).into(), (Parent, 20u128).into(), ])), fee_asset_item: 1, // Fees are paid with the RelayToken weight_limit: Unlimited, }); let origin = OriginCaller::system(RawOrigin::Signed(who)); let dry_run_effects = runtime_api.dry_run_call(H256::zero(), origin, call).unwrap().unwrap(); assert_eq!( dry_run_effects.local_xcm, Some(VersionedXcm::from( Xcm::builder_unsafe() .withdraw_asset((Parent, 20u128)) .burn_asset((Parent, 20u128)) .withdraw_asset((Here, 100u128)) .burn_asset((Here, 100u128)) .build() )), ); let send_destination = Location::new(1, [Parachain(1000)]); let send_message = Xcm::<()>::builder_unsafe() .withdraw_asset((Parent, 20u128)) .buy_execution((Parent, 20u128), Unlimited) .receive_teleported_asset(((Parent, Parachain(2000)), 100u128)) .clear_origin() .deposit_asset(AllCounted(2), [0u8; 32]) .build(); assert_eq!( dry_run_effects.forwarded_xcms, vec![( VersionedLocation::from(send_destination.clone()), vec![VersionedXcm::from(send_message.clone())], ),], ); assert_eq!( dry_run_effects.emitted_events, vec![ RuntimeEvent::System(frame_system::Event::NewAccount { account: 8660274132218572653 // TODO: Why is this not `1`? }), RuntimeEvent::Balances(pallet_balances::Event::Endowed { account: 8660274132218572653, free_balance: 100 }), RuntimeEvent::Balances(pallet_balances::Event::Minted { who: 8660274132218572653, amount: 100 }), RuntimeEvent::AssetsPallet(pallet_assets::Event::Burned { asset_id: 1, owner: 1, balance: 20 }), RuntimeEvent::Balances(pallet_balances::Event::Burned { who: 1, amount: 100 }), RuntimeEvent::XcmPallet(pallet_xcm::Event::Attempted { outcome: Outcome::Complete { used: Weight::from_parts(400, 40) }, }), RuntimeEvent::Balances(pallet_balances::Event::Burned { who: 1, amount: 20 }), RuntimeEvent::XcmPallet(pallet_xcm::Event::FeesPaid { paying: AccountIndex64 { index: 1, network: None }.into(), fees: (Here, 20u128).into(), }), RuntimeEvent::XcmPallet(pallet_xcm::Event::Sent { origin: AccountIndex64 { index: 1, network: None }.into(), destination: (Parent, Parachain(1000)).into(), message: send_message.clone(), message_id: fake_message_hash(&send_message), }), ] ); // Weighing the local program is not relevant for extrinsics that already // take this weight into account. // In this case, we really only care about delivery fees. let local_xcm = dry_run_effects.local_xcm.unwrap(); // We get a double result since the actual call returns a result and the runtime api returns // results. let weight = runtime_api.query_xcm_weight(H256::zero(), local_xcm.clone()).unwrap().unwrap(); assert_eq!(weight, Weight::from_parts(400, 40)); let execution_fees = runtime_api .query_weight_to_asset_fee( H256::zero(), weight, VersionedAssetId::from(AssetId(HereLocation::get())), ) .unwrap() .unwrap(); assert_eq!(execution_fees, 440); let mut forwarded_xcms_iter = dry_run_effects.forwarded_xcms.into_iter(); let (destination, remote_messages) = forwarded_xcms_iter.next().unwrap(); let remote_message = &remote_messages[0]; let delivery_fees = runtime_api .query_delivery_fees(H256::zero(), destination.clone(), remote_message.clone()) .unwrap() .unwrap(); assert_eq!(delivery_fees, VersionedAssets::from((Here, 20u128))); // This would have to be the runtime API of the destination, // which we have the location for. // If I had a mock runtime configured for "AssetHub" then I would use the // runtime APIs from that. let remote_execution_weight = runtime_api .query_xcm_weight(H256::zero(), remote_message.clone()) .unwrap() .unwrap(); let remote_execution_fees = runtime_api .query_weight_to_asset_fee( H256::zero(), remote_execution_weight, VersionedAssetId::from(AssetId(HereLocation::get())), ) .unwrap() .unwrap(); assert_eq!(remote_execution_fees, 550); // Now we know that locally we need to use `execution_fees` and // `delivery_fees`. // On the message we forward to the destination, we need to // put `remote_execution_fees` in `BuyExecution`. // For the `transfer_assets` extrinsic, it just means passing the correct amount // of fees in the parameters. }); } // Same scenario as in `fee_estimation_for_teleport`, but the user in parachain 2000 wants // to send relay tokens over to parachain 1000. // // Reserve Asset Transfer Relay Token // Reserve Asset Transfer Relay Token for fees // Parachain(2000) -------------------------------------------> Parachain(1000) #[test] fn dry_run_reserve_asset_transfer() { sp_tracing::init_for_tests(); let who = 1; // AccountId = u64. // Native token used for fees. let balances = vec![(who, DeliveryFees::get() + ExistentialDeposit::get())]; // Relay token is the one we want to transfer. let assets = vec![(1, who, 100)]; // id, account_id, balance. new_test_ext_with_balances_and_assets(balances, assets).execute_with(|| { let client = TestClient; let runtime_api = client.runtime_api(); let call = RuntimeCall::XcmPallet(pallet_xcm::Call::transfer_assets { dest: Box::new(VersionedLocation::from((Parent, Parachain(1000)))), beneficiary: Box::new(VersionedLocation::from(AccountId32 { id: [0u8; 32], network: None, })), assets: Box::new(VersionedAssets::from((Parent, 100u128))), fee_asset_item: 0, weight_limit: Unlimited, }); let origin = OriginCaller::system(RawOrigin::Signed(who)); let dry_run_effects = runtime_api.dry_run_call(H256::zero(), origin, call).unwrap().unwrap(); assert_eq!( dry_run_effects.local_xcm, Some(VersionedXcm::from( Xcm::builder_unsafe() .withdraw_asset((Parent, 100u128)) .burn_asset((Parent, 100u128)) .build() )), ); // In this case, the transfer type is `DestinationReserve`, so the remote xcm just withdraws // the assets. let send_destination = Location::new(1, Parachain(1000)); let send_message = Xcm::<()>::builder_unsafe() .withdraw_asset((Parent, 100u128)) .clear_origin() .buy_execution((Parent, 100u128), Unlimited) .deposit_asset(AllCounted(1), [0u8; 32]) .build(); assert_eq!( dry_run_effects.forwarded_xcms, vec![( VersionedLocation::from(send_destination.clone()), vec![VersionedXcm::from(send_message.clone())], ),], ); assert_eq!( dry_run_effects.emitted_events, vec![ RuntimeEvent::AssetsPallet(pallet_assets::Event::Burned { asset_id: 1, owner: 1, balance: 100 }), RuntimeEvent::XcmPallet(pallet_xcm::Event::Attempted { outcome: Outcome::Complete { used: Weight::from_parts(200, 20) } }), RuntimeEvent::Balances(pallet_balances::Event::Burned { who: 1, amount: 20 }), RuntimeEvent::XcmPallet(pallet_xcm::Event::FeesPaid { paying: AccountIndex64 { index: 1, network: None }.into(), fees: (Here, 20u128).into() }), RuntimeEvent::XcmPallet(pallet_xcm::Event::Sent { origin: AccountIndex64 { index: 1, network: None }.into(), destination: send_destination.clone(), message: send_message.clone(), message_id: fake_message_hash(&send_message), }), ] ); }); } #[test] fn dry_run_xcm() { sp_tracing::init_for_tests(); let who = 1; // AccountId = u64. let transfer_amount = 100u128; // We need to build the XCM to weigh it and then build the real XCM that can pay for fees. let inner_xcm = Xcm::<()>::builder_unsafe() .buy_execution((Here, 1u128), Unlimited) // We'd need to query the destination chain for fees. .deposit_asset(AllCounted(1), [0u8; 32]) .build(); let xcm_to_weigh = Xcm::::builder_unsafe() .withdraw_asset((Here, transfer_amount)) .clear_origin() .buy_execution((Here, transfer_amount), Unlimited) .deposit_reserve_asset(AllCounted(1), (Parent, Parachain(2100)), inner_xcm.clone()) .build(); let client = TestClient; let runtime_api = client.runtime_api(); let xcm_weight = runtime_api .query_xcm_weight(H256::zero(), VersionedXcm::from(xcm_to_weigh.clone().into())) .unwrap() .unwrap(); let execution_fees = runtime_api .query_weight_to_asset_fee( H256::zero(), xcm_weight, VersionedAssetId::from(AssetId(Here.into())), ) .unwrap() .unwrap(); let xcm = Xcm::::builder_unsafe() .withdraw_asset((Here, transfer_amount + execution_fees)) .clear_origin() .buy_execution((Here, execution_fees), Unlimited) .deposit_reserve_asset(AllCounted(1), (Parent, Parachain(2100)), inner_xcm.clone()) .build(); let balances = vec![( who, transfer_amount + execution_fees + DeliveryFees::get() + ExistentialDeposit::get(), )]; new_test_ext_with_balances(balances).execute_with(|| { let dry_run_effects = runtime_api .dry_run_xcm( H256::zero(), VersionedLocation::from([AccountIndex64 { index: 1, network: None }]), VersionedXcm::from(xcm), ) .unwrap() .unwrap(); assert_eq!( dry_run_effects.forwarded_xcms, vec![( VersionedLocation::from((Parent, Parachain(2100))), vec![VersionedXcm::from( Xcm::<()>::builder_unsafe() .reserve_asset_deposited(( (Parent, Parachain(2000)), transfer_amount + execution_fees - DeliveryFees::get() )) .clear_origin() .buy_execution((Here, 1u128), Unlimited) .deposit_asset(AllCounted(1), [0u8; 32]) .build() )], ),] ); assert_eq!( dry_run_effects.emitted_events, vec![ RuntimeEvent::Balances(pallet_balances::Event::Burned { who: 1, amount: 540 }), RuntimeEvent::System(frame_system::Event::NewAccount { account: 2100 }), RuntimeEvent::Balances(pallet_balances::Event::Endowed { account: 2100, free_balance: 520 }), RuntimeEvent::Balances(pallet_balances::Event::Minted { who: 2100, amount: 520 }), ] ); }); }