Merge branch 'staging/product-ia' into nhussein11/add-remix-ide

Author: dawnkelly09

.ai/categories/basics.md

@@ -1,53 +1,59 @@
 ---
-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.
 url: https://docs.polkadot.com/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/
 ---
 
-# 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`:
@@ -154,13 +160,13 @@ dryRunTransfer();
 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:
 
 <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,
@@ -313,13 +319,13 @@ verifyED();
 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:
 
 <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>
 ## Get Transfer Info and Fee Estimates
@@ -351,13 +357,13 @@ XcmTransferInfo();
 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:
 
 <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",
@@ -420,13 +426,13 @@ transfer();
 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:
 
 <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],
@@ -873,4 +879,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.

.ai/categories/dapps.md

@@ -1,5 +1,95 @@
 ---
+title: Chain Interactions Overview
+description: Learn how to query data, send transactions, enable cross-chain communication, and manage accounts across the Polkadot ecosystem.
+categories: Chain Interactions
 url: https://docs.polkadot.com/chain-interactions/
 ---
 
-TODO
+# Chain Interactions
+
+## Introduction
+
+Chain interactions form the foundation of building applications on Polkadot. Whether you're querying on-chain data, executing transactions, enabling cross-chain communication, or managing accounts, understanding how to interact with Polkadot-based chains is essential for application developers.
+
+This section provides comprehensive guidance on the various ways to interact with Polkadot chains, from basic queries to complex cross-chain operations. You'll learn how to:
+
+- Query on-chain state and subscribe to blockchain events.
+- Send transactions and manage their lifecycle.
+- Enable interoperability between parachains through XCM.
+- Manage tokens and perform token operations.
+- Create and manage accounts programmatically.
+
+Whether you're building a frontend application, a backend service, or integrating with the Polkadot ecosystem, these guides will equip you with the knowledge and tools to effectively interact with chains across the network.
+
+## Core Interaction Patterns
+
+### Query On-Chain Data
+
+Accessing blockchain state is fundamental to building responsive applications. Polkadot offers several methods to query on-chain data, each suited for different use cases.
+
+- **[SDK integration](/chain-interactions/query-data/query-sdks/)**: Programmatically read blockchain state using:
+
+    - [Polkadot API (PAPI)](/reference/tools/papi/)
+    - [Polkadot.js](/reference/tools/polkadot-js-api/)
+    - [Dedot](/reference/tools/dedot/)
+    - [Python Substrate Interface](/reference/tools/py-substrate-interface/)
+    - [Subxt](/reference/tools/subxt/)
+
+- **[REST API access](/chain-interactions/query-data/query-rest/)**: Query chain data through standardized REST endpoints for simpler integration.
+- **[Runtime API calls](/chain-interactions/query-data/runtime-api-calls/)**: Execute runtime APIs directly for specialized queries and operations.
+
+### Send Transactions
+
+Transactions are the primary mechanism for modifying blockchain state. Understanding transaction construction, signing, and submission is crucial for building interactive applications.
+
+- **[Transaction construction](/chain-interactions/send-transactions/with-sdks/)**: Build transactions using various SDKs with proper encoding and formatting.
+- **[Fee estimation](/chain-interactions/send-transactions/calculate-transaction-fees/)**: Calculate transaction fees to ensure sufficient balance and optimize costs.
+- **[Multi-token fees](/chain-interactions/send-transactions/pay-fees-with-different-tokens/)**: Learn how to pay transaction fees with different tokens on supported chains.
+
+### Send Cross-Chain Transactions
+
+Polkadot enables native cross-chain capabilities through Cross-Consensus Messaging (XCM), allowing chains to securely communicate and transfer assets across the ecosystem.
+
+- **[Transfer assets between parachains](/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/)**: Understand how to construct and send XCM messages using [ParaSpell XCM SDK](/reference/tools/paraspell/){target=\_blank} and [Polkadot API (PAPI)](/reference/tools/papi/){target=\_blank}.
+- **[Transfer assets out of Polkadot](/chain-interactions/send-transactions/interoperability/transfer-assets-out-of-polkadot/)**: Connect to blockchains outside the Polkadot ecosystem using [Snowbridge](https://wiki.polkadot.com/learn/learn-snowbridge/){target=\_blank} and other bridge solutions.
+
+### Manage Tokens
+
+Polkadot Hub provides a unified platform for managing assets across the ecosystem. Understanding token operations is essential for DeFi applications and multi-chain asset management.
+
+- **[Local asset registration](/chain-interactions/token-operations/register-local-asset/)**: Learn how assets created in Asset Hub are registered on the network.
+- **[Foregin asset registration](/chain-interactions/token-operations/register-foreign-asset/)**: Learn how assets created outside of Asset Hub are registered on the network.
+- **[Convert assets](/chain-interactions/token-operations/convert-assets/)**: Convert, swap, and manage assets on-chain using the Asset Conversion pallet.
+- **Asset Hub integration**: Interact with Polkadot's central asset management hub using [Polkadot.js Apps](https://polkadot.js.org/apps/){target=\_blank}.
+
+### Manage Accounts
+
+Account management forms the basis of user identity and authentication in blockchain applications. Learn how to create, manage, and query accounts programmatically.
+
+- **[Account creation](/chain-interactions/accounts/create-account/)**: Generate accounts using various SDKs in Rust, Python, and JavaScript.
+- **[Account queries](/chain-interactions/accounts/query-accounts/)**: Retrieve account information including balances, nonces, and metadata.
+
+## Development Tools and SDKs
+
+The Polkadot ecosystem offers a rich set of tools and libraries to facilitate chain interactions:
+
+- **[Polkadot API (PAPI)](/reference/tools/papi/)**: Modern, type-safe TypeScript library with full metadata support.
+- **[Polkadot.js](/reference/tools/polkadot-js-api/)**: Comprehensive JavaScript library with extensive ecosystem support.
+- **[Dedot](/reference/tools/dedot/)**: Lightweight TypeScript library optimized for performance.
+- **[Python Substrate Interface](/reference/tools/py-substrate-interface/)**: Polkadot Substrate Interface for streamlined development.
+- **[Subxt](/reference/tools/subxt/)**: Rust library for building robust substrate-based applications.
+- **[Polkadot.js Apps](https://polkadot.js.org/apps/)**: Web-based interface for exploring and interacting with chains.
+
+Each tool has its strengths, and choosing the right one depends on your project requirements, programming language preference, and specific use cases.
+
+## Next Steps
+
+Explore the sections below to dive deeper into specific chain interaction patterns:
+
+- **[Query On-Chain Data](/chain-interactions/query-data/query-sdks/)**: Learn to read blockchain state efficiently.
+- **[Send Transactions](/chain-interactions/send-transactions/with-sdks/)**: Master transaction construction and submission.
+- **[Send Cross-Chain Transactions](/chain-interactions/send-transactions/interoperability/transfer-assets-parachains/)**: Enable cross-chain communication with XCM.
+- **[Manage Tokens](/chain-interactions/token-operations/register-local-asset/)**: Manage assets across the Polkadot ecosystem.
+- **[Manage Accounts](/chain-interactions/accounts/create-account/)**: Create and query accounts programmatically.
+
+Each section provides practical examples, code snippets, and comprehensive guides to help you build production-ready applications on Polkadot.