Skip to content

Commit 6c21d85

Browse files
Update Prerequisites
1 parent 59b8f27 commit 6c21d85

File tree

2 files changed

+30
-28
lines changed

2 files changed

+30
-28
lines changed

llms.txt

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -27820,36 +27820,37 @@ Doc-Content: https://docs.polkadot.com/tutorials/interoperability/xcm-observabil
2782027820
--- BEGIN CONTENT ---
2782127821
---
2782227822
title: XCM Observability
27823-
description: This guide explains how to trace, correlate and debug cross-chain XCMs using observability features introduced in the Polkadot SDK.
27823+
description: This guide explains how to trace, correlate and debug cross-chain XCMs using observability features enhanced in the Polkadot SDK.
2782427824
---
2782527825

2782627826
# XCM Observability
2782727827

2782827828
## Introduction
2782927829

27830-
This guide explains how to **trace, correlate and debug cross-chain XCMs** using observability features introduced in the Polkadot SDK.
27830+
This guide explains how to **trace, correlate and debug cross-chain XCMs** using observability features enhanced in the Polkadot SDK.
2783127831

2783227832
You will learn how to:
2783327833

27834-
* Use `SetTopic` and `message_id` to track XCMs across multiple chains
27835-
* Match `PolkadotXcm.Sent` and `MessageQueue.Processed` events to understand message flow
27836-
* Interpret and handle failed or incomplete messages
27837-
* Apply manual topic tagging for reliable tracking across hops
27838-
* Use the workaround for older runtimes that emit derived message identifiers
27834+
- Use `SetTopic` and `message_id` to track XCMs across multiple chains
27835+
- Match `PolkadotXcm.Sent` and `MessageQueue.Processed` events to understand message flow
27836+
- Interpret and handle failed or incomplete messages
27837+
- Apply manual topic tagging for reliable tracking across hops
27838+
- Use the workaround for older runtimes that emit derived message identifiers
2783927839

2784027840
To demonstrate these techniques, the guide introduces a complete example scenario involving a multi-chain XCM transfer. This scenario will serve as the foundation for explaining message lifecycle, event tracking and failure debugging in context.
2784127841

27842+
Here is a revised **Prerequisites** section that matches your requirements, using British English, avoiding dash-separated clauses, and aligning with the tone and structure of your updated guide:
27843+
2784227844
## Prerequisites
2784327845

27844-
To follow this tutorial, you should have:
27846+
Before you begin, make sure you have:
2784527847

27846-
* Basic knowledge of Polkadot SDK and XCM
27847-
* [Chopsticks](https://github.com/AcalaNetwork/chopsticks) installed (`npm i -g @acala-network/chopsticks`)
27848-
* A working local development environment (NodeJS, TypeScript)
27849-
* [Polkadot API (PAPI)](https://github.com/polkadot-js/api) installed
27850-
* Access to the Wasm runtimes of the relevant parachains (e.g., Asset Hub, Acala)
27848+
- [Chopsticks](/develop/toolkit/parachains/fork-chains/chopsticks/get-started/){target=\_blank} installed (`npm i -g @acala-network/chopsticks`)
27849+
- Access to the endpoint or genesis file of the parachain you want to fork
27850+
- The block number or hash where the XCM was sent
27851+
- (Optional) A Chopsticks config file for repeated setups
2785127852

27852-
You should also be familiar with forking chains using Chopsticks. If not, see [Fork a Chain with Chopsticks](https://docs.polkadot.com/tutorials/polkadot-sdk/testing/fork-live-chains/).
27853+
If you haven't replayed or dry-run XCMs before, see the [Replay and Dry Run XCMs Using Chopsticks](/tutorials/interoperability/replay-and-dry-run-xcms/){target=\_blank} tutorial for step-by-step guidance.
2785327854

2785427855
## Define a Scenario: DOT to Acala Transfer with Tracing
2785527856

tutorials/interoperability/xcm-observability.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,36 @@
11
---
22
title: XCM Observability
3-
description: This guide explains how to trace, correlate and debug cross-chain XCMs using observability features introduced in the Polkadot SDK.
3+
description: This guide explains how to trace, correlate and debug cross-chain XCMs using observability features enhanced in the Polkadot SDK.
44
---
55

66
# XCM Observability
77

88
## Introduction
99

10-
This guide explains how to **trace, correlate and debug cross-chain XCMs** using observability features introduced in the Polkadot SDK.
10+
This guide explains how to **trace, correlate and debug cross-chain XCMs** using observability features enhanced in the Polkadot SDK.
1111

1212
You will learn how to:
1313

14-
* Use `SetTopic` and `message_id` to track XCMs across multiple chains
15-
* Match `PolkadotXcm.Sent` and `MessageQueue.Processed` events to understand message flow
16-
* Interpret and handle failed or incomplete messages
17-
* Apply manual topic tagging for reliable tracking across hops
18-
* Use the workaround for older runtimes that emit derived message identifiers
14+
- Use `SetTopic` and `message_id` to track XCMs across multiple chains
15+
- Match `PolkadotXcm.Sent` and `MessageQueue.Processed` events to understand message flow
16+
- Interpret and handle failed or incomplete messages
17+
- Apply manual topic tagging for reliable tracking across hops
18+
- Use the workaround for older runtimes that emit derived message identifiers
1919

2020
To demonstrate these techniques, the guide introduces a complete example scenario involving a multi-chain XCM transfer. This scenario will serve as the foundation for explaining message lifecycle, event tracking and failure debugging in context.
2121

22+
Here is a revised **Prerequisites** section that matches your requirements, using British English, avoiding dash-separated clauses, and aligning with the tone and structure of your updated guide:
23+
2224
## Prerequisites
2325

24-
To follow this tutorial, you should have:
26+
Before you begin, make sure you have:
2527

26-
* Basic knowledge of Polkadot SDK and XCM
27-
* [Chopsticks](https://github.com/AcalaNetwork/chopsticks) installed (`npm i -g @acala-network/chopsticks`)
28-
* A working local development environment (NodeJS, TypeScript)
29-
* [Polkadot API (PAPI)](https://github.com/polkadot-js/api) installed
30-
* Access to the Wasm runtimes of the relevant parachains (e.g., Asset Hub, Acala)
28+
- [Chopsticks](/develop/toolkit/parachains/fork-chains/chopsticks/get-started/){target=\_blank} installed (`npm i -g @acala-network/chopsticks`)
29+
- Access to the endpoint or genesis file of the parachain you want to fork
30+
- The block number or hash where the XCM was sent
31+
- (Optional) A Chopsticks config file for repeated setups
3132

32-
You should also be familiar with forking chains using Chopsticks. If not, see [Fork a Chain with Chopsticks](https://docs.polkadot.com/tutorials/polkadot-sdk/testing/fork-live-chains/).
33+
If you haven't replayed or dry-run XCMs before, see the [Replay and Dry Run XCMs Using Chopsticks](/tutorials/interoperability/replay-and-dry-run-xcms/){target=\_blank} tutorial for step-by-step guidance.
3334

3435
## Define a Scenario: DOT to Acala Transfer with Tracing
3536

0 commit comments

Comments
 (0)