mdBook generated from gitorial

Author: shawntabrizi

src/0/source/changes.diff

@@ -16,7 +16,18 @@
 
 <div id="Template" class="maintab tabcontent active">
 
-No files edited in this step.
+<div class="tab">
+<button class="subtab tablinks file-template file-modified active" onclick="switchSubTab(event, 'fundamentals/src/xcm_executor.rs')" data-id="fundamentals/src/xcm_executor.rs">fundamentals/src/xcm_executor.rs</button>
+</div>
+<div id="template/fundamentals/src/xcm_executor.rs" class="subtab tabcontent active" data-id="fundamentals/src/xcm_executor.rs">
+
+```rust
+{{#include ./template/fundamentals/src/xcm_executor.rs}}
+```
+
+</div>
+
+
 
 </div>
 

src/10/README.md

@@ -1,11 +1,20 @@
 diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
-index d50d85a..f03d79b 100644
+index 540086f..f03d79b 100644
 --- a/fundamentals/src/xcm_executor.rs
 +++ b/fundamentals/src/xcm_executor.rs
-@@ -132,14 +132,50 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+@@ -132,32 +132,50 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
  			// - `assets`: The asset(s) to remove from holding.
  			// - `beneficiary`: The new owner for the assets.
  			DepositAsset { assets, beneficiary } => {
+-				/* TODO:
+-					- Make a clone of `self.holding` into a variable `old_holding`.
+-					- Start a new `TransactionalProcessor`, storing the `result`.
+-						- `saturating_take` the `assets` into a variable `deposited.
+-						- For `asset` in `deposited`
+-							- Use `AssetTransactor` to `deposit_asset` to the `beneficiary`.
+-					- If anything goes wrong, we should reset `self.holding` to `old_holding`.
+-					- Return the `result`
+-				*/
 -				todo!("{:?} {:?}", assets, beneficiary)
 +				let old_holding = self.holding.clone();
 +				let result = Config::TransactionalProcessor::process(|| {
@@ -33,6 +42,15 @@ index d50d85a..f03d79b 100644
  			//
  			// - `assets`: The asset(s) that are minted into the Holding Register.
  			ReceiveTeleportedAsset(assets) => {
+-				/* TODO:
+-					- Process everything inside `TransactionalProcessor`.
+-						- Get the `origin` or return `XcmError::BadOrigin`.
+-						- For `asset` in `assets`:
+-							- Use `AssetTransactor` to see if we `can_check_in`.
+-							- Then actually `check_in` those assets.
+-					- `and_then`, if everything goes okay...
+-					- `subsume_assets` into the `self.holding`.
+-				*/
 -				todo!("{:?}", assets)
 +				Config::TransactionalProcessor::process(|| {
 +					let origin = self.origin_ref().ok_or(XcmError::BadOrigin)?;

src/10/solution/solution.diff

@@ -132,13 +132,31 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
 			// - `assets`: The asset(s) to remove from holding.
 			// - `beneficiary`: The new owner for the assets.
 			DepositAsset { assets, beneficiary } => {
+				/* TODO:
+					- Make a clone of `self.holding` into a variable `old_holding`.
+					- Start a new `TransactionalProcessor`, storing the `result`.
+						- `saturating_take` the `assets` into a variable `deposited.
+						- For `asset` in `deposited`
+							- Use `AssetTransactor` to `deposit_asset` to the `beneficiary`.
+					- If anything goes wrong, we should reset `self.holding` to `old_holding`.
+					- Return the `result`
+				*/
 				todo!("{:?} {:?}", assets, beneficiary)
 			},
 			// Asset(s) (`assets`) have been destroyed on the `origin` system and equivalent assets
 			// should be created and placed into the Holding Register.
 			//
 			// - `assets`: The asset(s) that are minted into the Holding Register.
 			ReceiveTeleportedAsset(assets) => {
+				/* TODO:
+					- Process everything inside `TransactionalProcessor`.
+						- Get the `origin` or return `XcmError::BadOrigin`.
+						- For `asset` in `assets`:
+							- Use `AssetTransactor` to see if we `can_check_in`.
+							- Then actually `check_in` those assets.
+					- `and_then`, if everything goes okay...
+					- `subsume_assets` into the `self.holding`.
+				*/
 				todo!("{:?}", assets)
 			},
 			// In this workshop, we won't be implementing every instruction, just the ones above...

src/10/template/fundamentals/src/xcm_executor.rs

@@ -0,0 +1,36 @@
+diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
+index d50d85a..540086f 100644
+--- a/fundamentals/src/xcm_executor.rs
++++ b/fundamentals/src/xcm_executor.rs
+@@ -132,6 +132,15 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			// - `assets`: The asset(s) to remove from holding.
+ 			// - `beneficiary`: The new owner for the assets.
+ 			DepositAsset { assets, beneficiary } => {
++				/* TODO:
++					- Make a clone of `self.holding` into a variable `old_holding`.
++					- Start a new `TransactionalProcessor`, storing the `result`.
++						- `saturating_take` the `assets` into a variable `deposited.
++						- For `asset` in `deposited`
++							- Use `AssetTransactor` to `deposit_asset` to the `beneficiary`.
++					- If anything goes wrong, we should reset `self.holding` to `old_holding`.
++					- Return the `result`
++				*/
+ 				todo!("{:?} {:?}", assets, beneficiary)
+ 			},
+ 			// Asset(s) (`assets`) have been destroyed on the `origin` system and equivalent assets
+@@ -139,6 +148,15 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			//
+ 			// - `assets`: The asset(s) that are minted into the Holding Register.
+ 			ReceiveTeleportedAsset(assets) => {
++				/* TODO:
++					- Process everything inside `TransactionalProcessor`.
++						- Get the `origin` or return `XcmError::BadOrigin`.
++						- For `asset` in `assets`:
++							- Use `AssetTransactor` to see if we `can_check_in`.
++							- Then actually `check_in` those assets.
++					- `and_then`, if everything goes okay...
++					- `subsume_assets` into the `self.holding`.
++				*/
+ 				todo!("{:?}", assets)
+ 			},
+ 			// In this workshop, we won't be implementing every instruction, just the ones above...

src/10/template/template.diff

@@ -16,7 +16,18 @@
 
 <div id="Template" class="maintab tabcontent active">
 
-No files edited in this step.
+<div class="tab">
+<button class="subtab tablinks file-template file-modified active" onclick="switchSubTab(event, 'fundamentals/src/xcm_executor.rs')" data-id="fundamentals/src/xcm_executor.rs">fundamentals/src/xcm_executor.rs</button>
+</div>
+<div id="template/fundamentals/src/xcm_executor.rs" class="subtab tabcontent active" data-id="fundamentals/src/xcm_executor.rs">
+
+```rust
+{{#include ./template/fundamentals/src/xcm_executor.rs}}
+```
+
+</div>
+
+
 
 </div>
 

src/7/README.md

@@ -1,17 +1,25 @@
 diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
-index 9e0647a..57e1bd4 100644
+index 08884c9..57e1bd4 100644
 --- a/fundamentals/src/xcm_executor.rs
 +++ b/fundamentals/src/xcm_executor.rs
-@@ -62,12 +62,17 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+@@ -62,20 +62,17 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
  			// the authority of the origin (e.g. if they are being relayed from an untrusted
  			// source, as often the case with `ReserveAssetDeposited`).
  			ClearOrigin => {
+-				/* TODO: Simply set `self.context.origin` to `None` */
 -				todo!()
 +				self.context.origin = None;
 +				Ok(())
  			},
  			// Appends `who` to the current XCM Executor `origin` location.
 -			DescendOrigin(who) => {
+-				/* TODO:
+-					- Get the `self.context.origin`.
+-					- Access it `as_mut()`.
+-					- If `origin` is `None`, return `XcmError::BadOrigin`.
+-					- Then `append_with` `who`
+-					- If the append fails, return `XcmError::LocationFull`.
+-				*/
 -				todo!("{:?}", who)
 -			}
 +			DescendOrigin(who) => self

src/7/solution/solution.diff

@@ -62,10 +62,18 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
 			// the authority of the origin (e.g. if they are being relayed from an untrusted
 			// source, as often the case with `ReserveAssetDeposited`).
 			ClearOrigin => {
+				/* TODO: Simply set `self.context.origin` to `None` */
 				todo!()
 			},
 			// Appends `who` to the current XCM Executor `origin` location.
 			DescendOrigin(who) => {
+				/* TODO:
+					- Get the `self.context.origin`.
+					- Access it `as_mut()`.
+					- If `origin` is `None`, return `XcmError::BadOrigin`.
+					- Then `append_with` `who`
+					- If the append fails, return `XcmError::LocationFull`.
+				*/
 				todo!("{:?}", who)
 			}
 			// Withdraw asset(s) (`assets`) from the ownership of `origin` and place equivalent

src/7/template/fundamentals/src/xcm_executor.rs

@@ -0,0 +1,23 @@
+diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
+index 9e0647a..08884c9 100644
+--- a/fundamentals/src/xcm_executor.rs
++++ b/fundamentals/src/xcm_executor.rs
+@@ -62,10 +62,18 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			// the authority of the origin (e.g. if they are being relayed from an untrusted
+ 			// source, as often the case with `ReserveAssetDeposited`).
+ 			ClearOrigin => {
++				/* TODO: Simply set `self.context.origin` to `None` */
+ 				todo!()
+ 			},
+ 			// Appends `who` to the current XCM Executor `origin` location.
+ 			DescendOrigin(who) => {
++				/* TODO:
++					- Get the `self.context.origin`.
++					- Access it `as_mut()`.
++					- If `origin` is `None`, return `XcmError::BadOrigin`.
++					- Then `append_with` `who`
++					- If the append fails, return `XcmError::LocationFull`.
++				*/
+ 				todo!("{:?}", who)
+ 			}
+ 			// Withdraw asset(s) (`assets`) from the ownership of `origin` and place equivalent

src/7/template/template.diff

@@ -16,7 +16,18 @@
 
 <div id="Template" class="maintab tabcontent active">
 
-No files edited in this step.
+<div class="tab">
+<button class="subtab tablinks file-template file-modified active" onclick="switchSubTab(event, 'fundamentals/src/xcm_executor.rs')" data-id="fundamentals/src/xcm_executor.rs">fundamentals/src/xcm_executor.rs</button>
+</div>
+<div id="template/fundamentals/src/xcm_executor.rs" class="subtab tabcontent active" data-id="fundamentals/src/xcm_executor.rs">
+
+```rust
+{{#include ./template/fundamentals/src/xcm_executor.rs}}
+```
+
+</div>
+
+
 
 </div>
 

src/8/README.md

@@ -1,11 +1,18 @@
 diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
-index 57e1bd4..f84c243 100644
+index 97ba170..f84c243 100644
 --- a/fundamentals/src/xcm_executor.rs
 +++ b/fundamentals/src/xcm_executor.rs
-@@ -79,7 +79,20 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+@@ -79,14 +79,20 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
  			// - `assets`: The asset(s) to be withdrawn.
  			// - `beneficiary`: The new owner for the assets.
  			TransferAsset { assets, beneficiary } => {
+-				/* TODO:
+-					- Process everything inside a `TransactionalProcessor`.
+-					- Get the `origin` from `self.origin_ref()`.
+-					- For each `asset` in `assets`
+-						- Use `AssetTransactor` and `transfer_asset` to the `beneficiary`.
+-					- If everything works well, return `Ok(())`
+-				*/
 -				todo!("{:?} {:?}", assets, beneficiary)
 +				Config::TransactionalProcessor::process(|| {
 +					// Take `assets` from the origin account (on-chain) and place into dest account.

src/8/solution/solution.diff

@@ -79,6 +79,13 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
 			// - `assets`: The asset(s) to be withdrawn.
 			// - `beneficiary`: The new owner for the assets.
 			TransferAsset { assets, beneficiary } => {
+				/* TODO:
+					- Process everything inside a `TransactionalProcessor`.
+					- Get the `origin` from `self.origin_ref()`.
+					- For each `asset` in `assets`
+						- Use `AssetTransactor` and `transfer_asset` to the `beneficiary`.
+					- If everything works well, return `Ok(())`
+				*/
 				todo!("{:?} {:?}", assets, beneficiary)
 			},
 			// Withdraw asset(s) (`assets`) from the ownership of `origin` and place them into the

src/8/template/fundamentals/src/xcm_executor.rs

@@ -0,0 +1,18 @@
+diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
+index 57e1bd4..97ba170 100644
+--- a/fundamentals/src/xcm_executor.rs
++++ b/fundamentals/src/xcm_executor.rs
+@@ -79,6 +79,13 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			// - `assets`: The asset(s) to be withdrawn.
+ 			// - `beneficiary`: The new owner for the assets.
+ 			TransferAsset { assets, beneficiary } => {
++				/* TODO:
++					- Process everything inside a `TransactionalProcessor`.
++					- Get the `origin` from `self.origin_ref()`.
++					- For each `asset` in `assets`
++						- Use `AssetTransactor` and `transfer_asset` to the `beneficiary`.
++					- If everything works well, return `Ok(())`
++				*/
+ 				todo!("{:?} {:?}", assets, beneficiary)
+ 			},
+ 			// Withdraw asset(s) (`assets`) from the ownership of `origin` and place them into the

src/8/template/template.diff

@@ -16,7 +16,18 @@
 
 <div id="Template" class="maintab tabcontent active">
 
-No files edited in this step.
+<div class="tab">
+<button class="subtab tablinks file-template file-modified active" onclick="switchSubTab(event, 'fundamentals/src/xcm_executor.rs')" data-id="fundamentals/src/xcm_executor.rs">fundamentals/src/xcm_executor.rs</button>
+</div>
+<div id="template/fundamentals/src/xcm_executor.rs" class="subtab tabcontent active" data-id="fundamentals/src/xcm_executor.rs">
+
+```rust
+{{#include ./template/fundamentals/src/xcm_executor.rs}}
+```
+
+</div>
+
+
 
 </div>
 

src/9/README.md

@@ -1,11 +1,19 @@
 diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
-index f84c243..d50d85a 100644
+index f97757d..d50d85a 100644
 --- a/fundamentals/src/xcm_executor.rs
 +++ b/fundamentals/src/xcm_executor.rs
-@@ -99,7 +99,23 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+@@ -99,15 +99,23 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
  			//
  			// - `assets`: The asset(s) to be withdrawn into holding.
  			WithdrawAsset(assets) => {
+-				/* TODO:
+-					- Process everything inside a `TransactionalProcessor`.
+-					- Get the `origin` or return `XcmError::BadOrigin`.
+-					- For each `asset` in `assets`
+-						- Use the `AssetTransactor` to `withdraw_asset`.
+-					- `and_then`, if everything goes okay...
+-					- `subsume_assets` into the `self.holding`
+-				*/
 -				todo!("{:?}", assets)
 +				Config::TransactionalProcessor::process(|| {
 +					let origin = self.origin_ref().ok_or(XcmError::BadOrigin)?;
@@ -27,10 +35,11 @@ index f84c243..d50d85a 100644
  			},
  			// Reduce Holding by up to the given assets.
  			//
-@@ -107,7 +123,8 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+@@ -115,8 +123,8 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
  			// not an error if the Holding does not contain the assets (to make this an error, use
  			// `ExpectAsset` prior).
  			BurnAsset(assets) => {
+-				/* TODO: Simply `saturating_take` `assets` from the `self.holding`. */
 -				todo!("{:?}", assets)
 +				self.holding.saturating_take(assets.into());
 +				Ok(())

src/9/solution/solution.diff

@@ -99,6 +99,14 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
 			//
 			// - `assets`: The asset(s) to be withdrawn into holding.
 			WithdrawAsset(assets) => {
+				/* TODO:
+					- Process everything inside a `TransactionalProcessor`.
+					- Get the `origin` or return `XcmError::BadOrigin`.
+					- For each `asset` in `assets`
+						- Use the `AssetTransactor` to `withdraw_asset`.
+					- `and_then`, if everything goes okay...
+					- `subsume_assets` into the `self.holding`
+				*/
 				todo!("{:?}", assets)
 			},
 			// Reduce Holding by up to the given assets.
@@ -107,6 +115,7 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
 			// not an error if the Holding does not contain the assets (to make this an error, use
 			// `ExpectAsset` prior).
 			BurnAsset(assets) => {
+				/* TODO: Simply `saturating_take` `assets` from the `self.holding`. */
 				todo!("{:?}", assets)
 			},
 			// Remove the asset(s) (`assets`) from the Holding Register and place equivalent assets

src/9/template/fundamentals/src/xcm_executor.rs

@@ -0,0 +1,27 @@
+diff --git a/fundamentals/src/xcm_executor.rs b/fundamentals/src/xcm_executor.rs
+index f84c243..f97757d 100644
+--- a/fundamentals/src/xcm_executor.rs
++++ b/fundamentals/src/xcm_executor.rs
+@@ -99,6 +99,14 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			//
+ 			// - `assets`: The asset(s) to be withdrawn into holding.
+ 			WithdrawAsset(assets) => {
++				/* TODO:
++					- Process everything inside a `TransactionalProcessor`.
++					- Get the `origin` or return `XcmError::BadOrigin`.
++					- For each `asset` in `assets`
++						- Use the `AssetTransactor` to `withdraw_asset`.
++					- `and_then`, if everything goes okay...
++					- `subsume_assets` into the `self.holding`
++				*/
+ 				todo!("{:?}", assets)
+ 			},
+ 			// Reduce Holding by up to the given assets.
+@@ -107,6 +115,7 @@ impl<Config: XcmConfig> XcmExecutor<Config> {
+ 			// not an error if the Holding does not contain the assets (to make this an error, use
+ 			// `ExpectAsset` prior).
+ 			BurnAsset(assets) => {
++				/* TODO: Simply `saturating_take` `assets` from the `self.holding`. */
+ 				todo!("{:?}", assets)
+ 			},
+ 			// Remove the asset(s) (`assets`) from the Holding Register and place equivalent assets