Add page on sending ERC-20s via XCM

.snippets/code/xc20/retrieve-xc20s.js

@@ -0,0 +1,30 @@
+import { ApiPromise, WsProvider } from '@polkadot/api'; // Version 9.13.6
+
+const getXc20s = async () => {
+  // 1. Create API provider
+  const substrateProvider = new WsProvider(
+    'wss://wss.api.moonbase.moonbeam.network'
+  );
+  const api = await ApiPromise.create({ provider: substrateProvider });
+
+  // 2. Query the assets pallet for all assets
+  const assets = await api.query.assets.asset.entries();
+
+  // 3. Get metadata for each asset using the ID
+  assets.forEach(
+    async ([
+      {
+        args: [id],
+      },
+    ]) => {
+      const metadata = await api.query.assets.metadata(id);
+      console.log(`Asset ID: ${id}`);
+      console.log(`Metadata: ${metadata}`);
+      console.log('-----');
+    }
+  );
+
+  api.disconnect();
+};
+
+getXc20s();

.snippets/code/xtokens/ethers.js

@@ -0,0 +1,73 @@
+import abi from './xtokensABI.js'; // Import the x-tokens ABI
+import { ethers } from 'ethers'; // Import Ethers library
+const PRIVATE_KEY = 'YOUR_PRIVATE_KEY_HERE';
+
+// Create Ethers wallet & contract instance
+const provider = new ethers.providers.JsonRpcProvider(
+  'https://rpc.api.moonbase.moonbeam.network'
+);
+const signer = new ethers.Wallet(PRIVATE_KEY, provider);
+const xTokens = new ethers.Contract(
+  '0x0000000000000000000000000000000000000804',
+  abi,
+  signer
+);
+
+// xcUNIT address in Moonbase Alpha
+const xcUNIT_ADDRESS = '0xFfFFfFff1FcaCBd218EDc0EbA20Fc2308C778080';
+
+// Multilocation targeting Alice's account on the relay chain from Moonbase Alpha
+const ALICE_RELAY_ACC = [
+  1,
+  ['0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300'],
+];
+
+// Sends 1 xcUNIT to the relay chain using the transfer function
+async function transferToAlice() {
+  // Creates, signs, and sends the transfer transaction
+  const transaction = await xTokens.transfer(
+    xcUNIT_ADDRESS, // Asset
+    '1000000000000', // Amount
+    ALICE_RELAY_ACC, // Destination
+    '1000000000' // Weight
+  );
+
+  // Waits for the transaction to be included in a block
+  await transaction.wait();
+  console.log(transaction);
+}
+
+// Multilocation targeting the relay chain or its asset from a parachain
+const RELAY_CHAIN_ASSET = [1, []];
+
+// Sends 1 xcUNIT to the relay chain using the transferMultiasset function
+async function transferMultiassetToAlice() {
+  const transaction = await xTokens.transferMultiasset(
+    RELAY_CHAIN_ASSET, // Asset
+    '1000000000000', // Amount
+    ALICE_RELAY_ACC, // Destination
+    '1000000000' // Weight
+  );
+  await transaction.wait();
+  console.log(transaction);
+}
+
+transferToAlice();
+transferMultiassetToAlice();
+
+// Here are some additional multilocations for the Asset multilocation:
+const LOCAL_ASSET = [0, ['0x0424', '0x05FD9D0BF45A2947A519A741C4B9E99EB6']]; // Note that 0x0424 indicates the x-tokens pallet
+const DEV_FROM_OTHER_PARACHAIN = [1, ['0x00000003E8', '0x0403']]; // Use if you were targeting DEV from a non-Moonbeam network
+
+// Here are some additional multilocations for the Destination multilocation:
+const ADDRESS32_OF_PARACHAIN = [
+  1,
+  [
+    '0x00000007EF',
+    '0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300',
+  ],
+];
+const ADDRESS20_FROM_PARACHAIN_TO_MOONBASE = [
+  1,
+  ['0x00000003E8', '0x03f24FF3a9CF04c71Dbc94D0b566f7A27B94566cac00'],
+];

.snippets/code/xtokens/transfer.js

@@ -0,0 +1,40 @@
+import { ApiPromise, WsProvider, Keyring } from '@polkadot/api'; // Version 9.13.6
+
+// 1. Provide input data
+const providerWsURL = 'wss://wss.api.moonbase.moonbeam.network';
+const RELAY_ACC_ADDRESS =
+  '0xc4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a063'; // Alice's relay account address
+const currencyId = { 
+  ForeignAsset: { 
+    ForeignAsset: 42259045809535163221576417993425387648n 
+  }
+};
+const amount = 1000000000000n;
+const dest = {
+  V3: {
+    parents: 1,
+    interior: { X1: { AccountId32: { id: RELAY_ACC_ADDRESS } } },
+  },
+};
+const destWeightLimit = { Unlimited: null };
+
+// 2. Create Keyring instance
+const keyring = new Keyring({ type: 'ethereum' });
+const alice = keyring.addFromUri(PRIVATE_KEY);
+
+const sendXc20 = async () => {
+  // 3. Create Substrate API provider
+  const substrateProvider = new WsProvider(providerWsURL);
+  const api = await ApiPromise.create({ provider: substrateProvider });
+
+  // 4. Craft the extrinsic
+  const tx = api.tx.xTokens.transfer(currencyId, amount, dest, destWeightLimit);
+
+  // 5. Send the transaction
+  const txHash = await tx.signAndSend(alice);
+  console.log(`Submitted with hash ${txHash}`);
+
+  api.disconnect();
+};
+
+sendXc20();

.snippets/code/xtokens/transferMultiAsset.js

@@ -0,0 +1,47 @@
+import { ApiPromise, WsProvider, Keyring } from '@polkadot/api'; // Version 9.13.6
+
+// 1. Provide input data
+const providerWsURL = 'wss://wss.api.moonbase.moonbeam.network';
+const RELAY_ACC_ADDRESS =
+  '0xc4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a063'; // Alice's relay account address
+const asset = {
+  V3: {
+    id: {
+      Concrete: {
+        parents: 1,
+        interior: null,
+      },
+    },
+    fun: {
+      Fungible: { Fungible: 1000000000000n },
+    },
+  },
+};
+const dest = {
+  V3: {
+    parents: 1,
+    interior: { X1: { AccountId32: { id: RELAY_ACC_ADDRESS } } },
+  },
+};
+const destWeightLimit = { Unlimited: null };
+
+// 2. Create Keyring instance
+const keyring = new Keyring({ type: 'ethereum' });
+const alice = keyring.addFromUri(PRIVATE_KEY);
+
+const sendXc20 = async () => {
+  // 3. Create Substrate API provider
+  const substrateProvider = new WsProvider(providerWsURL);
+  const api = await ApiPromise.create({ provider: substrateProvider });
+
+  // 4. Craft the extrinsic
+  const tx = api.tx.xTokens.transferMultiasset(asset, dest, destWeightLimit);
+
+  // 5. Send the transaction
+  const txHash = await tx.signAndSend(alice);
+  console.log(`Submitted with hash ${txHash}`);
+
+  api.disconnect();
+};
+
+sendXc20();

.snippets/code/xtokens/web3js.md → .snippets/code/xtokens/web3.js

@@ -1,4 +1,3 @@
-```javascript
 import abi from './xtokensABI.js'; // Import the x-tokens ABI
 import Web3 from 'web3'; // Import Web3 library
 const PRIVATE_KEY = 'YOUR_PRIVATE_KEY_HERE';
@@ -15,24 +14,27 @@ const xTokens = new web3.eth.Contract(
 const xcUNIT_ADDRESS = '0xFfFFfFff1FcaCBd218EDc0EbA20Fc2308C778080';
 
 // Multilocation targeting Alice's account on the relay chain from Moonbase Alpha
-const ALICE_RELAY_ACC = [1, ['0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300']];
+const ALICE_RELAY_ACC = [
+  1,
+  ['0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300'],
+];
 
 // Sends 1 xcUNIT to the relay chain using the transfer function
 async function transferToAlice() {
   // Create transaction
   const transferTx = xTokens.methods.transfer(
-    xcUNIT_ADDRESS,         // Asset
-    '1000000000000',        // Amount
-    ALICE_RELAY_ACC,        // Destination
-    '1000000000'            // Weight
+    xcUNIT_ADDRESS, // Asset
+    '1000000000000', // Amount
+    ALICE_RELAY_ACC, // Destination
+    '1000000000' // Weight
   );
 
   // Sign transaction
   const signedTx = await web3.eth.accounts.signTransaction(
     {
       to: '0x0000000000000000000000000000000000000804',
       data: transferTx.encodeABI(),
-      gas: await transferTx.estimateGas()
+      gas: await transferTx.estimateGas(),
     },
     PRIVATE_KEY
   );
@@ -48,16 +50,16 @@ const RELAY_CHAIN_ASSET = [1, []];
 // Sends 1 xcUNIT to the relay chain using the transferMultiasset function
 async function transferMultiassetToAlice() {
   const transferTx = xTokens.methods.transferMultiasset(
-    RELAY_CHAIN_ASSET,      // Asset
-    '1000000000000',        // Amount
-    ALICE_RELAY_ACC,        // Destination
-    '1000000000'            // Weight
+    RELAY_CHAIN_ASSET, // Asset
+    '1000000000000', // Amount
+    ALICE_RELAY_ACC, // Destination
+    '1000000000' // Weight
   );
   const signedTx = await web3.eth.accounts.signTransaction(
     {
       to: '0x0000000000000000000000000000000000000804',
       data: transferTx.encodeABI(),
-      gas: await transferTx.estimateGas()
+      gas: await transferTx.estimateGas(),
     },
     PRIVATE_KEY
   );
@@ -69,10 +71,18 @@ transferToAlice();
 transferMultiassetToAlice();
 
 // Here are some additional multilocations for the Asset multilocation:
-const LOCAL_ASSET = [0, ["0x0424", "0x05FD9D0BF45A2947A519A741C4B9E99EB6"]]; // Note that 0x0424 indicates the x-tokens pallet
-const DEV_FROM_OTHER_PARACHAIN = [1, ["0x00000003E8", "0x0403"]]; // Use if you were targeting DEV from a non-Moonbeam network
+const LOCAL_ASSET = [0, ['0x0424', '0x05FD9D0BF45A2947A519A741C4B9E99EB6']]; // Note that 0x0424 indicates the x-tokens pallet
+const DEV_FROM_OTHER_PARACHAIN = [1, ['0x00000003E8', '0x0403']]; // Use if you were targeting DEV from a non-Moonbeam network
 
 // Here are some additional multilocations for the Destination multilocation:
-const ADDRESS32_OF_PARACHAIN = [1, ["0x00000007EF", "0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300"]];
-const ADDRESS20_FROM_PARACHAIN_TO_MOONBASE = [1, ["0x00000003E8", "0x03f24FF3a9CF04c71Dbc94D0b566f7A27B94566cac00"]];
-```
+const ADDRESS32_OF_PARACHAIN = [
+  1,
+  [
+    '0x00000007EF',
+    '0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300',
+  ],
+];
+const ADDRESS20_FROM_PARACHAIN_TO_MOONBASE = [
+  1,
+  ['0x00000003E8', '0x03f24FF3a9CF04c71Dbc94D0b566f7A27B94566cac00'],
+];

.snippets/code/xtokens/web3py.md → .snippets/code/xtokens/web3.py

@@ -1,4 +1,3 @@
-```python
 from web3 import Web3
 
 abi = 'XTOKENS_ABI_HERE' # Paste or import the x-tokens ABI
@@ -36,7 +35,7 @@ def transferToAlice():
     # Sign transaction
     signedTx = web3.eth.account.sign_transaction(transferTx, privateKey)
 
-    # 7. Send tx and wait for receipt
+    # Send tx and wait for receipt
     hash = web3.eth.send_raw_transaction(signedTx.rawTransaction)
     receipt = web3.eth.wait_for_transaction_receipt(hash)
     print(f'Tx successful with hash: { receipt.transactionHash.hex() }')
@@ -72,4 +71,3 @@ def transferMultiassetToAlice():
 # Here are some additional multilocations for the Destination multilocation:
 ADDRESS32_OF_PARACHAIN = [1, ["0x00000007EF", "0x01c4db7bcb733e117c0b34ac96354b10d47e84a006b9e7e66a229d174e8ff2a06300"]]
 ADDRESS20_FROM_PARACHAIN_TO_MOONBASE = [1, ["0x00000003E8", "0x03f24FF3a9CF04c71Dbc94D0b566f7A27B94566cac00"]]
-```

.snippets/text/erc20-interface/erc20-interface.md

@@ -5,13 +5,13 @@ The interface includes the following functions:
 - **decimals()** — read-only function that returns the decimals of the token
 - **totalSupply()** — read-only function that returns the total number of tokens in existence
 - **balanceOf**(*address* who) — read-only function that returns the balance of the specified address
-- **allowance**(*address* owner, *address* spender) —  read-only function that checks and returns the amount of tokens that an owner is allowed to a spender
-- **transfer**(*address* to, *uint256* value) — transfers a given amount of tokens to a specified address and returns true if the transfer was successful
-- **approve**(*address* spender, *uint256* value) — approves the provided address to spend a specified amount of tokens on behalf of `msg.sender`. Returns true if successful
-- **transferFrom**(*address* from, *address* to, *uint256* value) — transfers tokens from one given address to another given address and returns true if successful
+- **allowance**(*address* owner, *address* spender) —  read-only function that checks and returns the amount of tokens that a spender is allowed to spend on behalf of the owner
+- **transfer**(*address* to, *uint256* value) — transfers a given amount of tokens to a specified address and returns `true` if the transfer was successful
+- **approve**(*address* spender, *uint256* value) — approves the provided address to spend a specified amount of tokens on behalf of `msg.sender`. Returns `true` if successful
+- **transferFrom**(*address* from, *address* to, *uint256* value) — transfers tokens from one given address to another given address and returns `true` if successful
 
 !!! note
-    The ERC-20 standard does not specify the implications of multiple calls to `approve`. Changing an allowance with this function numerous times enables a possible attack vector. To avoid incorrect or unintended transaction ordering, you can first reduce the `spender` allowance to `0` and then set the desired allowance afterward. For more details on the attack vector, you can check out the [ERC-20 API: An Attack Vector on Approve/TransferFrom Methods](https://docs.google.com/document/d/1YLPtQxZu1UAvO9cZ1O2RPXBbT0mooh4DYKjA_jp-RLM/edit#){target=_blank} overview
+    The ERC-20 standard does not specify the implications of multiple calls to `approve`. Changing an allowance with this function numerous times enables a possible attack vector. To avoid incorrect or unintended transaction ordering, you can first reduce the `spender` allowance to `0` and then set the desired allowance afterward. For more details on the attack vector, you can check out the [ERC-20 API: An Attack Vector on Approve/TransferFrom Methods](https://docs.google.com/document/d/1YLPtQxZu1UAvO9cZ1O2RPXBbT0mooh4DYKjA_jp-RLM/edit#){target=_blank} overview.
 
 The interface also includes the following required events: