Add chain interactions overview (#1182)

* add chain interactions overview

* apply feedback, minor edits

* update names to be action-oriented

* add links to pages within each section

* update psi link and remove target blank from unnecessary links

* llms

---------

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

Author: brunopgalvao

.ai/categories/basics.md

@@ -7459,7 +7459,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/dapps.md

@@ -10489,7 +10489,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/infrastructure.md

@@ -10672,7 +10672,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/networks.md

@@ -8699,7 +8699,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/parachains.md

@@ -16599,7 +16599,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/polkadot-protocol.md

@@ -9655,7 +9655,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/smart-contracts.md

@@ -13818,7 +13818,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/categories/tooling.md

@@ -18984,7 +18984,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)

.ai/pages/chain-interactions.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.

.ai/pages/parachains-launch-a-parachain-set-up-the-parachain-template.md

@@ -189,7 +189,7 @@ When running the template node, it's accessible by default at `ws://localhost:99
 
     1. Scroll to the bottom and select **Development**.
     2. Choose **Custom**.
-    3. Enter `ws: //localhost:9944` in the **custom endpoint** input field.
+    3. Enter `ws://localhost:9944` in the **custom endpoint** input field.
     4. Click the **Switch** button.
 
     ![](/images/parachains/launch-a-parachain/set-up-the-parachain-template/parachain-template-02.webp)