You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
27824
27824
---
27825
27825
27826
27826
# XCM Observability
27827
27827
27828
27828
## Introduction
27829
27829
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.
27831
27831
27832
27832
You will learn how to:
27833
27833
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
27839
27839
27840
27840
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.
27841
27841
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
+
27842
27844
## Prerequisites
27843
27845
27844
-
To follow this tutorial, you should have:
27846
+
Before you begin, make sure you have:
27845
27847
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
27851
27852
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.
27853
27854
27854
27855
## Define a Scenario: DOT to Acala Transfer with Tracing
Copy file name to clipboardExpand all lines: tutorials/interoperability/xcm-observability.md
+15-14Lines changed: 15 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,35 +1,36 @@
1
1
---
2
2
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.
4
4
---
5
5
6
6
# XCM Observability
7
7
8
8
## Introduction
9
9
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.
11
11
12
12
You will learn how to:
13
13
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
19
19
20
20
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.
21
21
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
+
22
24
## Prerequisites
23
25
24
-
To follow this tutorial, you should have:
26
+
Before you begin, make sure you have:
25
27
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
31
32
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.
33
34
34
35
## Define a Scenario: DOT to Acala Transfer with Tracing
0 commit comments