Migrate Paraspell content and asset transfer tutorial (#1160)

* Updating Paraspell content.

Reducing duplicate text on variou pages

* Updating Paraspell asset transfer tutorial

change from bun to npm / tsx
fixing links

* fixing comments

adding installation and reference to tutorial
removing duplicate paragraph on ParaSpell

* minor formating fix

* Update reference/tools/paraspell.md

Co-authored-by: Erin Shaben <[email protected]>

* Update reference/tools/paraspell.md

Co-authored-by: Erin Shaben <[email protected]>

* feedback

---------

Co-authored-by: 0xlukem <[email protected]>
Co-authored-by: Lucas Malizia <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

Author: 3 people

.snippets/code/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/dry-run-output.html

@@ -1,5 +1,5 @@
 <div id="termynal" data-termynal>
-  <span data-ty="input"><span class="file-path"></span>bun run index.ts</span>
+  <span data-ty="input"><span class="file-path"></span>npx tsx index.ts</span>
   <span data-ty>{
   failureReason: undefined,
   failureChain: undefined,

.snippets/code/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/ed-verification-output.html

@@ -1,4 +1,4 @@
 <div id="termynal" data-termynal>
-  <span data-ty="input"><span class="file-path"></span>bun run index.ts</span>
+  <span data-ty="input"><span class="file-path"></span>npx tsx index.ts</span>
   <span data-ty>ED verification successful.</span>
 </div>

.snippets/code/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/transfer-info-output.html

@@ -1,5 +1,5 @@
 <div id="termynal" data-termynal>
-  <span data-ty="input"><span class="file-path"></span>bun run index.ts</span>
+  <span data-ty="input"><span class="file-path"></span>npx tsx index.ts</span>
   <span data-ty>Transfer Info: {
   chain: {
     origin: "AssetHubPaseo",

.snippets/code/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/transfer-output.html

@@ -1,5 +1,5 @@
 <div id="termynal" data-termynal>
-  <span data-ty="input"><span class="file-path"></span>bun run index.ts</span>
+  <span data-ty="input"><span class="file-path"></span>npx tsx index.ts</span>
   <span data-ty>...</span>
   <span data-ty>Built transaction: {
   getPaymentInfo: [AsyncFunction: getPaymentInfo],

chain-interactions/send-transactions/interoperability/transfer-assets-parachains.md

@@ -1,52 +1,58 @@
 ---
-title: Transfer Tokens Between Parachains
+title: Transfer Assets Between Parachains
 description: A step-by-step guide to using the ParaSpell XCM SDK to build, verify, and execute a transfer from one Parachain to another.
 ---
 
-# Transfer Tokens Between Parachains
+# Transfer Assets Between Parachains
 
 ## Introduction
 
-This guide walks you through transferring tokens between two parachains using the [ParaSpell XCM SDK](https://paraspell.github.io/docs/){target=\_blank}. This example utilizes [Asset Hub](/polkadot-protocol/architecture/system-chains/asset-hub/){target=\_blank} and the [People Chain](/polkadot-protocol/architecture/system-chains/people/){target=\_blank}. However, the same approach can be applied to transfers between other parachains.
+This guide walks you through transferring tokens between two parachains using the [ParaSpell XCM SDK](/reference/tools/paraspell/){target=\_blank}. This example utilizes [Asset Hub](/polkadot-protocol/architecture/system-chains/asset-hub/){target=\_blank} and the [People Chain](/polkadot-protocol/architecture/system-chains/people/){target=\_blank}. However, the same approach can be applied to transfers between other parachains.
 
 For development purposes, this guide will use the [Polkadot TestNet](/develop/networks/#paseo){target=\_blank}, so the transferred token will be PAS.
 
 In this guide, you will:
 
 - Build an XCM transfer transaction using ParaSpell XCM SDK.
 - Perform a dry run to validate the transfer.
-- Verify the [Existential Deposit (ED)](/polkadot-protocol/glossary/#existential-deposit){target=\_blank} requirement on the destination chain.
+- Verify the [Existential Deposit (ED)](/reference/glossary/#existential-deposit){target=\_blank} requirement on the destination chain.
 - Retrieve information regarding the transfer, along with fee estimates.
 - Submit the transaction.
 
 ### Prerequisites
 
 Before you begin, ensure you have the following:
 
-- Knowledge of the [fundamentals of Polkadot](/polkadot-protocol/parachain-basics/){target=\_blank}.
-- Basic understanding of [XCM](/develop/interoperability/intro-to-xcm/){target=\_blank}.
+- Knowledge of the [fundamentals of Polkadot](/parachains/get-started/){target=\_blank}.
+- Basic understanding of [XCM](/parachains/interoperability/get-started/){target=\_blank}.
 - Basic familiarity with JavaScript or TypeScript.
-- Installed [bun](https://bun.com/docs/installation){target=\_blank}, a JavaScript and TypeScript package manager.
+- Installed [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm){target=\_blank}, a JavaScript and TypeScript package manager.
 
 ## Initialize Your Project
 
 Create the project folder:
 
 ```bash
-mkdir paraspell-transfer
+mkdir paraspell-transfer && \
 cd paraspell-transfer
 ```
 
 Initialize the JavaScript project:
 
 ```bash
-bun init -y
+npm init -y
+```
+
+Install dev dependencies:
+
+```bash
+npm install --save-dev @types/node@^22.12.0 tsx@^4.20.6 typescript@^5.7.3
 ```
 
 Install the required dependencies:
 
 ```bash
-bun add @paraspell/sdk@11.3.2 polkadot-api@1.17.1 @polkadot-labs/[email protected].25 @polkadot-labs/[email protected].24
+npm install --save @paraspell/sdk@11.12.6 polkadot-api@1.20.0 @polkadot-labs/[email protected].26 @polkadot-labs/[email protected].25
 ```
 
 Now add the following setup code to `index.ts`:
@@ -88,7 +94,7 @@ Add the following dry run code to your `index.ts` script:
 Run the script using the following command:
 
 ```bash
-bun run index.ts
+npx tsx index.ts
 ```
 
 The result of the dry run will look similar to the following example output:
@@ -105,7 +111,7 @@ Check if the recipient account meets the [Existential Deposit (ED)](/polkadot-pr
 Comment out the `dryRunTransfer()` function so that it is not executed again. Then, execute the `verifyED()` by running the following command:
 
 ```bash
-bun run index.ts
+npx tsx index.ts
 ```
 
 After that, you will get output confirming the ED which will look similar to the following:
@@ -125,7 +131,7 @@ ParaSpell has a helpful function for this: [`getTransferInfo()`](https://paraspe
 Comment out the `verifyED()` function so it doesn't execute again. Then, execute the `XcmTransferInfo()` function by running the following command:
 
 ```bash
-bun run index.ts
+npx tsx index.ts
 ```
 
 You will see all the information for your transfer similar to the following example:
@@ -147,7 +153,7 @@ You can execute the transfer function by adding the following function call:
 Comment out the `XcmTransferInfo()` function so it doesn't execute again. Then, execute the transfer by running the following command: 
 
 ```bash
-bun run index.ts
+npx tsx index.ts
 ```
 
 Your `transfer` function will submit the transaction, and you will get the following output:
@@ -180,4 +186,4 @@ You have now successfully created and sent a cross-chain transfer using the Para
 
 - Read the Docs: Dive deeper into the features of the [ParaSpell XCM SDK](https://paraspell.github.io/docs/sdk/getting-started.html){target=\_blank} documentation.
 
-- Learn about XCM: Understand the underlying protocol by visiting the [Introduction to XCM page](/develop/interoperability/intro-to-xcm/) in the Polkadot Docs.
+- Learn about XCM: Understand the underlying protocol by visiting the [Introduction to XCM page](/parachains/interoperability/get-started/) in the Polkadot Docs.

reference/polkadot-hub/assets-and-smart-contracts.md

@@ -149,17 +149,6 @@ These public instances are primarily for ad-hoc testing and quick checks.
 
 `TxWrapper` provides the flexibility needed to integrate asset operations into custom applications while maintaining the security and efficiency of Polkadot's transaction model.
 
-### ParaSpell
-
-[ParaSpell](https://paraspell.xyz/){target=\_blank} is a collection of open-source XCM tools designed to streamline cross-chain asset transfers and interactions within the Polkadot and Kusama ecosystems. It equips developers with an intuitive interface to manage and optimize XCM-based functionalities. Some key points included by ParaSpell are:
-
-- **[XCM SDK](https://paraspell.xyz/#xcm-sdk){target=\_blank}**: Provides a unified layer to incorporate XCM into decentralized applications, simplifying complex cross-chain interactions.
-- **[XCM API](https://paraspell.xyz/#xcm-api){target=\_blank}**: Offers an efficient, package-free approach to integrating XCM functionality while offloading heavy computing tasks, minimizing costs and improving application performance.
-- **[XCM router](https://paraspell.xyz/#xcm-router){target=\_blank}**: Enables cross-chain asset swaps in a single command, allowing developers to send one asset type (such as DOT on Polkadot) and receive a different asset on another chain (like ASTR on Astar).
-- **[XCM analyser](https://paraspell.xyz/#xcm-analyser){target=\_blank}**: Decodes and translates complex XCM multilocation data into readable information, supporting easier troubleshooting and debugging.
-- **[XCM visualizator](https://paraspell.xyz/#xcm-visualizator){target=\_blank}**: A tool designed to give developers a clear, interactive view of XCM activity across the Polkadot ecosystem, providing insights into cross-chain communication flow.
-
-ParaSpell's tools make it simple for developers to build, test, and deploy cross-chain solutions without needing extensive knowledge of the XCM protocol. With features like message composition, decoding, and practical utility functions for parachain interactions, ParaSpell is especially useful for debugging and optimizing cross-chain communications.
 
 ### Parachain Node
 

reference/tools/paraspell.md

@@ -13,12 +13,12 @@ The primary goal of ParaSpell is to abstract away the complexities of the XCM pr
 
 The ParaSpell suite includes:
 
-- **[XCM SDK](https://paraspell.github.io/docs/sdk/getting-started.html){target=\_blank}**: A powerful library for integrating XCM interoperability into dApps.
-- **[XCM API](https://paraspell.github.io/docs/api/g-started.html){target=\_blank}**: A lightweight alternative to the SDK for package-less integration.
-- **[XCM Router](https://paraspell.github.io/docs/router/getting-strtd.html){target=\_blank}**: A tool for enabling cross-chain swaps of different assets in a single transaction.
-- **[XCM Analyser](https://paraspell.github.io/docs/analyser/getng-strtd.html){target=\_blank}**: A utility for decoding and translating complex XCM data into a human-readable format.
-- **[XCM Visualizator](https://paraspell.github.io/docs/visualizer/getting-start.html){target=\_blank}**: A tool for visualizing XCM activity across the Polkadot ecosystem.
-- **[XCM Playground](https://paraspell.github.io/docs/tools/playground.html){target=\_blank}**: A tool for testing different XCM scenarios.
+- **[XCM SDK](https://paraspell.xyz/#xcm-sdk){target=\_blank}**: Provides a unified layer to incorporate XCM into decentralized applications, simplifying complex cross-chain interactions.
+- **[XCM API](https://paraspell.xyz/#xcm-api){target=\_blank}**: Offers an efficient, package-free approach to integrating XCM functionality while offloading heavy computing tasks, minimizing costs and improving application performance.
+- **[XCM Router](https://paraspell.xyz/#xcm-router){target=\_blank}**: Enables cross-chain asset swaps in a single command, allowing developers to send one asset type (such as DOT on Polkadot) and receive a different asset on another chain (like ASTR on Astar).
+- **[XCM Analyser](https://paraspell.xyz/#xcm-analyser){target=\_blank}**: Decodes and translates complex XCM multilocation data into readable information, supporting easier troubleshooting and debugging.
+- **[XCM Visualizator](https://paraspell.xyz/#xcm-visualizator){target=\_blank}**: A tool designed to give developers a clear, interactive view of XCM activity across the Polkadot ecosystem, providing insights into cross-chain communication flow.
+- **[XCM Playground](https://paraspell.xyz/#try-it){target=\_blank}**: An interactive playground for testing different XCM scenarios.
 
 ### ParaSpell XCM SDK
 
@@ -27,3 +27,42 @@ The [ParaSpell XCM SDK](https://paraspell.github.io/docs/sdk/getting-started.htm
 The SDK simplifies the process of creating and sending XCM messages by providing a user-friendly builder pattern. This allows developers to construct complex XCM calls with just a few lines of code, reducing the likelihood of errors and ensuring that messages are constructed correctly.
 
 By using the ParaSpell XCM SDK, developers can significantly accelerate their development workflow and build powerful, interoperable dApps that take full advantage of the Polkadot network's cross-chain capabilities.
+
+## Install ParaSpell
+
+If you want to use ParaSpell in your project you can add it as a dependency with the following command:
+
+=== "npm"
+
+    ```bash
+    npm install --save @paraspell/[email protected]
+    ```
+
+=== "pnpm"
+
+    ```bash
+    pnpm add @paraspell/[email protected]
+    ```
+
+=== "yarn"
+
+    ```bash
+    yarn add @paraspell/[email protected]
+    ```
+
+
+## Where to Go Next
+
+Explore more about ParaSpell through these resources:
+
+<div class="grid cards" markdown>
+
+-   <span class="badge tutorial">Tutorial</span> __Transfer Assets Between Parachains__
+
+    ---
+
+    Learn how to transfer assets across chains with ParaSpell.
+
+    [:octicons-arrow-right-24: Get Started](/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/)
+
+</div>

reference/tools/xcm-tools.md

@@ -36,15 +36,7 @@ For a full overview of each script, visit the [scripts](https://github.com/Moons
 
 ### ParaSpell
 
-[ParaSpell](https://paraspell.xyz/){target=\_blank} is a collection of open-source XCM tools designed to streamline cross-chain asset transfers and interactions within the Polkadot and Kusama ecosystems. It equips developers with an intuitive interface to manage and optimize XCM-based functionalities. Some key points included by ParaSpell are:
-
-- **[XCM SDK](https://paraspell.xyz/#xcm-sdk){target=\_blank}**: Provides a unified layer to incorporate XCM into decentralized applications, simplifying complex cross-chain interactions.
-- **[XCM API](https://paraspell.xyz/#xcm-api){target=\_blank}**: Offers an efficient, package-free approach to integrating XCM functionality while offloading heavy computing tasks, minimizing costs and improving application performance.
-- **[XCM router](https://paraspell.xyz/#xcm-router){target=\_blank}**: Enables cross-chain asset swaps in a single command, allowing developers to send one asset type (such as DOT on Polkadot) and receive a different asset on another chain (like ASTR on Astar).
-- **[XCM analyser](https://paraspell.xyz/#xcm-analyser){target=\_blank}**: Decodes and translates complex XCM multilocation data into readable information, supporting easier troubleshooting and debugging.
-- **[XCM visualizator](https://paraspell.xyz/#xcm-visualizator){target=\_blank}**: A tool designed to give developers a clear, interactive view of XCM activity across the Polkadot ecosystem, providing insights into cross-chain communication flow.
-
-ParaSpell's tools make it simple for developers to build, test, and deploy cross-chain solutions without needing extensive knowledge of the XCM protocol. With features like message composition, decoding, and practical utility functions for parachain interactions, ParaSpell is especially useful for debugging and optimizing cross-chain communications.
+[ParaSpell](/reference/tools/paraspell/){target=\_blank} is a collection of open-source XCM tools that streamline cross-chain asset transfers and interactions across the Polkadot and Kusama ecosystems. It provides developers with an intuitive interface to build, test, and deploy interoperable dApps, featuring message composition, decoding, and practical utilities for parachain interactions that simplify debugging and cross-chain communication optimization.
 
 ### Astar XCM Tools