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
Copy file name to clipboardExpand all lines: llms-full.txt
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -30885,8 +30885,8 @@ This guide explains how to **trace, correlate, and debug XCMs** reliably using o
30885
30885
30886
30886
You will learn how to:
30887
30887
30888
-
- Use the `SetTopic` instruction and `message_id` to track XCMs across chains
30889
-
- Understand the relationship between `PolkadotXcm.Sent` and `MessageQueue.Processed` events for message correlation
30888
+
- Use the [`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank} instruction and `message_id` to track XCMs across chains
30889
+
- Understand the relationship between [`PolkadotXcm.Sent`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/enum.Event.html#variant.Sent){target=\_blank} and [`MessageQueue.Processed`](https://paritytech.github.io/polkadot-sdk/master/pallet_message_queue/pallet/enum.Event.html#variant.Processed){target=\_blank} events for message correlation
30890
30890
- Apply manual topic tagging for multi-hop tracing when needed
30891
30891
- Use workarounds for older runtimes with derived message IDs
30892
30892
- Debug failed or incomplete XCMs using indexers and Chopsticks replay
@@ -30919,7 +30919,7 @@ If you're new to XCM replay or dry-run, see [Replay and Dry Run XCMs Using Chops
30919
30919
npm install -g @acala-network/chopsticks@latest
30920
30920
```
30921
30921
30922
-
3. Download 1.6.0 (or later) runtime:
30922
+
3. Download 1.6.0 runtime, which is built from **`stable2503-5` or later**:
30923
30923
30924
30924
```bash
30925
30925
mkdir -p wasms
@@ -30980,7 +30980,7 @@ If you're new to XCM replay or dry-run, see [Replay and Dry Run XCMs Using Chops
30980
30980
30981
30981
### What is `SetTopic`?
30982
30982
30983
-
When executing XCMs using `limited_reserve_transfer_assets`, other extrinsics, or raw XCM calls from the `PolkadotXcm` pallet, a `SetTopic` instruction is automatically appended to the end of the message if it is not already present.
30983
+
When executing XCMs using [`limited_reserve_transfer_assets`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.limited_reserve_transfer_assets){target=\_blank}, other extrinsics, or raw XCM calls from the [`PolkadotXcm` pallet](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html){target=\_blank}, a [`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank} instruction is automatically appended to the end of the message if it is not already present.
30984
30984
30985
30985
- **[`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank}** is an XCM instruction that sets a 32-byte topic register inside the message.
30986
30986
- The topic acts as a **logical identifier** (`message_id`) for the XCM, allowing you to group and trace related messages across chains.
@@ -31011,7 +31011,7 @@ Matching these IDs lets you **correlate** an origin message with its destination
31011
31011
31012
31012
- The runtime **automatically appends a `SetTopic` instruction** if one is missing at the end of an XCM.
31013
31013
- When using high-level extrinsics such as `limited_reserve_transfer_assets`, **you do not need to set a topic manually**; the runtime handles it for you.
31014
-
- If you **manually craft an XCM** (e.g., via `execute` or `send`), you **can supply your own `SetTopic`**, but it **must be the final instruction** to be respected.
31014
+
- If you **manually craft an XCM** (e.g., via [`execute`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.execute){target=\_blank} or [`send`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.send){target=\_blank}), you **can supply your own `SetTopic`**, but it **must be the final instruction** to be respected.
31015
31015
- In **multi-hop XCM flows**, manually setting the topic ensures **consistent tracing across all hops**. Any **remote XCM calls** embedded inside the XCM must also include a `SetTopic` at the end to preserve the same `message_id` throughout the cross-chain flow.
Copy file name to clipboardExpand all lines: tutorials/interoperability/xcm-observability.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,8 +13,8 @@ This guide explains how to **trace, correlate, and debug XCMs** reliably using o
13
13
14
14
You will learn how to:
15
15
16
-
- Use the `SetTopic` instruction and `message_id` to track XCMs across chains
17
-
- Understand the relationship between `PolkadotXcm.Sent` and `MessageQueue.Processed` events for message correlation
16
+
- Use the [`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank} instruction and `message_id` to track XCMs across chains
17
+
- Understand the relationship between [`PolkadotXcm.Sent`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/enum.Event.html#variant.Sent){target=\_blank} and [`MessageQueue.Processed`](https://paritytech.github.io/polkadot-sdk/master/pallet_message_queue/pallet/enum.Event.html#variant.Processed){target=\_blank} events for message correlation
18
18
- Apply manual topic tagging for multi-hop tracing when needed
19
19
- Use workarounds for older runtimes with derived message IDs
20
20
- Debug failed or incomplete XCMs using indexers and Chopsticks replay
@@ -47,7 +47,7 @@ If you're new to XCM replay or dry-run, see [Replay and Dry Run XCMs Using Chops
47
47
npm install -g @acala-network/chopsticks@latest
48
48
```
49
49
50
-
3. Download 1.6.0 (or later) runtime:
50
+
3. Download 1.6.0 runtime, which is built from **`stable2503-5`or later**:
51
51
52
52
```bash
53
53
mkdir -p wasms
@@ -108,7 +108,7 @@ If you're new to XCM replay or dry-run, see [Replay and Dry Run XCMs Using Chops
108
108
109
109
### What is `SetTopic`?
110
110
111
-
When executing XCMs using `limited_reserve_transfer_assets`, other extrinsics, or raw XCM calls from the `PolkadotXcm` pallet, a `SetTopic` instruction is automatically appended to the end of the message if it is not already present.
111
+
When executing XCMs using [`limited_reserve_transfer_assets`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.limited_reserve_transfer_assets){target=\_blank}, other extrinsics, or raw XCM calls from the [`PolkadotXcm` pallet](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html){target=\_blank}, a [`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank} instruction is automatically appended to the end of the message if it is not already present.
112
112
113
113
- **[`SetTopic([u8; 32])`](https://github.com/polkadot-fellows/xcm-format#settopic){target=\_blank}** is an XCM instruction that sets a 32-byte topic register inside the message.
114
114
- The topic acts as a **logical identifier** (`message_id`) for the XCM, allowing you to group and trace related messages across chains.
@@ -139,7 +139,7 @@ Matching these IDs lets you **correlate** an origin message with its destination
139
139
140
140
- The runtime **automatically appends a `SetTopic` instruction**if one is missing at the end of an XCM.
141
141
- When using high-level extrinsics such as `limited_reserve_transfer_assets`, **you do not need to set a topic manually**; the runtime handles it for you.
142
-
- If you **manually craft an XCM** (e.g., via `execute` or `send`), you **can supply your own `SetTopic`**, but it **must be the final instruction** to be respected.
142
+
- If you **manually craft an XCM** (e.g., via [`execute`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.execute){target=\_blank} or [`send`](https://paritytech.github.io/polkadot-sdk/master/pallet_xcm/pallet/struct.Pallet.html#method.send){target=\_blank}), you **can supply your own `SetTopic`**, but it **must be the final instruction** to be respected.
143
143
- In **multi-hop XCM flows**, manually setting the topic ensures **consistent tracing across all hops**. Any **remote XCM calls** embedded inside the XCM must also include a `SetTopic` at the end to preserve the same `message_id` throughout the cross-chain flow.
0 commit comments