Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions chain-interactions/accounts/create-account.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Create an Account
description: Step-by-step guide to creating Polkadot accounts using different programming languages and libraries, including JavaScript, Python, and Rust examples.
short_description: Generate accounts using various SDKs in Rust, Python, and JavaScript.
categories: Basics, Chain Interactions
page_badges:
tutorial_badge: Beginner
Expand Down
1 change: 1 addition & 0 deletions chain-interactions/accounts/query-accounts.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Query Account Information with SDKs
description: Learn how to query account information using five popular SDKs—Polkadot API (PAPI), Polkadot.js API, Dedot, Python Substrate Interface, and Subxt.
short_description: Retrieve account information including balances, nonces, and metadata.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Beginner
Expand Down
77 changes: 38 additions & 39 deletions chain-interactions/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,69 +26,68 @@ Whether you're building a frontend application, a backend service, or integratin

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.
<!-- INDEX TABLE START
dir: query-data
flat: true
columns: [title, description]
-->
<!-- INDEX TABLE END -->

### 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.
<!-- INDEX TABLE START
dir: send-transactions
flat: true
columns: [title, description]
-->
<!-- INDEX TABLE END -->

### 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/) and [Polkadot API (PAPI)](/reference/tools/papi/).
- **[Transfer assets into Polkadot](/chain-interactions/send-transactions/interoperability/transfer-assets-into-polkadot/)**: A step-by-step guide to bridging assets from Ethereum to Polkadot using the [ParaSpell XCM SDK](/reference/tools/paraspell/) and [Snowbridge](https://wiki.polkadot.com/learn/learn-snowbridge/){target=\_blank}.
<!-- INDEX TABLE START
dir: send-transactions/interoperability
flat: true
columns: [title, description]
-->
<!-- INDEX TABLE END -->

### 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}.
<!-- INDEX TABLE START
dir: token-operations
flat: true
columns: [title, description]
-->
<!-- INDEX TABLE END -->

### 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.
<!-- INDEX TABLE START
dir: accounts
flat: true
columns: [title, description]
-->
<!-- INDEX TABLE END -->

## 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.
| Tool | Description |
|------|-------------|
| [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.
1 change: 1 addition & 0 deletions chain-interactions/query-data/query-rest.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Query On-Chain State with Sidecar REST API
description: Learn how to query on-chain state on Polkadot using the Sidecar REST API with curl, including account balances, asset data, and block information.
short_description: Query chain data through standardized REST endpoints for simpler integration.
categories: Chain Interactions, Tooling
---

Expand Down
1 change: 1 addition & 0 deletions chain-interactions/query-data/query-sdks.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Query On-Chain State with SDKs
description: Learn how to query on-chain storage data on Polkadot Hub using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
short_description: Programmatically read blockchain state using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Intermediate
Expand Down
1 change: 1 addition & 0 deletions chain-interactions/query-data/runtime-api-calls.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Runtime API Calls
description: Learn how to call Polkadot runtime APIs to access the Wasm runtime and retrieve computed results using PAPI, Polkadot.js, Dedot, Python, and Subxt.
short_description: Execute runtime APIs directly for specialized queries and operations.
categories: Polkadot Protocol, Tooling
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Calculate Transaction Fees
description: Learn how to calculate transaction fees on Polkadot using Polkadot-API, Polkadot.js API, and the Polkadot.js Apps UI to estimate transfer costs.
short_description: Calculate transaction fees to ensure sufficient balance and optimize costs.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Beginner
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Replay and Dry Run XCMs
description: Replay and dry-run XCMs using Chopsticks with full logging enabled. Diagnose issues, trace message flow, and debug complex cross-chain interactions.
short_description: Replay and dry-run XCMs using Chopsticks to diagnose issues and debug cross-chain interactions.
categories: Interoperability, Tooling
page_badges:
tutorial_badge: Advanced
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: XCM Fee Estimation
description: This tutorial demonstrates how to estimate the fees for teleporting assets from the Polkadot Hub TestNet to the Paseo People Chain.
short_description: Estimate fees for teleporting assets between chains on the Polkadot network.
categories: Interoperability, Chain Interactions
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Transfer Assets from Ethereum into Polkadot
description: A step-by-step guide to bridging assets from Ethereum to Polkadot using the ParaSpell XCM SDK and Snowbridge.
short_description: Bridge assets from Ethereum to Polkadot using the ParaSpell XCM SDK and Snowbridge.
categories: Interoperability
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
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.
short_description: Construct and send XCM messages using ParaSpell XCM SDK and Polkadot API (PAPI).
categories: Interoperability, Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Pay Transaction Fees with Different Tokens
description: Learn how to send a DOT transfer transaction while paying the fees using a different token on Polkadot Hub using multiple SDKs.
short_description: Pay transaction fees with different tokens on supported chains.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Intermediate
Expand Down
1 change: 1 addition & 0 deletions chain-interactions/send-transactions/with-sdks.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Send Transactions with SDKs
description: Learn how to construct, sign, and submit transactions using PAPI, Polkadot.js, Dedot, Python Substrate Interface, and Subxt.
short_description: Build transactions using various SDKs with proper encoding and formatting.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Intermediate
Expand Down
1 change: 1 addition & 0 deletions chain-interactions/token-operations/convert-assets.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Convert Assets on Asset Hub
description: A guide detailing the step-by-step process of converting assets on Asset Hub, helping users efficiently navigate asset management on the platform.
short_description: Convert, swap, and manage assets on-chain using the Asset Conversion pallet.
categories: Chain Interactions, Tooling
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Register a Foreign Asset
description: Learn step-by-step how to register a foreign asset on Polkadot Hub and the origin parachain to enable cross-chain token transfers.
short_description: Register assets created outside of Asset Hub on Polkadot Hub.
categories: Interoperability, Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Register a Local Asset
description: Learn how to register a local asset on Polkadot Hub, including prerequisites, deposits, and step-by-step instructions using Polkadot.js Apps.
short_description: Register assets created in Asset Hub on Polkadot Hub.
categories: Basics, Chain Interactions
page_badges:
tutorial_badge: Beginner
Expand Down
1 change: 1 addition & 0 deletions parachains/customize-runtime/add-existing-pallets.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Add an Existing Pallet to the Runtime
description: Learn how to include and configure pallets in a Polkadot SDK-based runtime, from adding dependencies to implementing necessary traits.
short_description: Integrate pre-built pallets from the FRAME ecosystem.
categories: Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
1 change: 1 addition & 0 deletions parachains/customize-runtime/add-pallet-instances.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Add Multiple Pallet Instances
description: Learn how to implement multiple instances of the same pallet in your Polkadot SDK-based runtime, from adding dependencies to configuring unique instances.
short_description: Configure and use multiple instances of the same pallet.
categories: Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Add Smart Contract Functionality
description: Add smart contract capabilities to your Polkadot SDK-based blockchain. Explore PVM, EVM, and Wasm integration for enhanced chain functionality.
short_description: Enable smart contract capabilities using Contracts or EVM pallets.
categories: Parachains
---

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Benchmark Your Pallet
description: Learn how to benchmark extrinsics in your custom pallet to generate precise weight calculations suitable for production use.
short_description: Measure and optimize pallet performance with benchmarking.
categories: Parachains
page_badges:
tutorial_badge: Advanced
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Create a Custom Pallet
description: Learn how to create custom pallets using FRAME, allowing for flexible, modular, and scalable blockchain development. Follow the step-by-step guide.
short_description: Build a pallet from scratch with custom logic.
categories: Parachains
page_badges:
tutorial_badge: Beginner
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Mock Your Runtime
description: Learn how to create a mock runtime environment for testing your custom pallets in isolation, enabling comprehensive unit testing before runtime integration.
short_description: Set up a mock runtime environment for testing.
categories: Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Unit Test Pallets
description: Learn how to efficiently test pallets in the Polkadot SDK, ensuring the reliability and security of your pallets operations.
short_description: Write comprehensive tests for your pallet logic.
categories: Parachains
page_badges:
tutorial_badge: Intermediate
Expand Down
Loading
Loading