Skip to content

Commit 322a0e3

Browse files
Add links to Rust docs
1 parent ad1c41c commit 322a0e3

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

llms-full.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -30885,8 +30885,8 @@ This guide explains how to **trace, correlate, and debug XCMs** reliably using o
3088530885

3088630886
You will learn how to:
3088730887

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
3089030890
- Apply manual topic tagging for multi-hop tracing when needed
3089130891
- Use workarounds for older runtimes with derived message IDs
3089230892
- 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
3091930919
npm install -g @acala-network/chopsticks@latest
3092030920
```
3092130921

30922-
3. Download 1.6.0 (or later) runtime:
30922+
3. Download 1.6.0 runtime, which is built from **`stable2503-5` or later**:
3092330923

3092430924
```bash
3092530925
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
3098030980

3098130981
### What is `SetTopic`?
3098230982

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.
3098430984

3098530985
- **[`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.
3098630986
- 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
3101131011

3101231012
- The runtime **automatically appends a `SetTopic` instruction** if one is missing at the end of an XCM.
3101331013
- 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.
3101531015
- 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.
3101631016

3101731017
## Message Lifecycle

tutorials/interoperability/xcm-observability.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@ This guide explains how to **trace, correlate, and debug XCMs** reliably using o
1313

1414
You will learn how to:
1515

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
1818
- Apply manual topic tagging for multi-hop tracing when needed
1919
- Use workarounds for older runtimes with derived message IDs
2020
- 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
4747
npm install -g @acala-network/chopsticks@latest
4848
```
4949

50-
3. Download 1.6.0 (or later) runtime:
50+
3. Download 1.6.0 runtime, which is built from **`stable2503-5` or later**:
5151

5252
```bash
5353
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
108108

109109
### What is `SetTopic`?
110110

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.
112112

113113
- **[`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.
114114
- 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
139139

140140
- The runtime **automatically appends a `SetTopic` instruction** if one is missing at the end of an XCM.
141141
- 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.
143143
- 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.
144144

145145
## Message Lifecycle

0 commit comments

Comments
 (0)