From fe5ffb504b828905c8c57c79441c1309b9458c47 Mon Sep 17 00:00:00 2001 From: Dan Forbes Date: Tue, 11 Aug 2020 13:23:46 -0700 Subject: [PATCH 1/3] Augment Implementer's Guide XCMP docs --- roadmap/implementers-guide/src/messaging.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/roadmap/implementers-guide/src/messaging.md b/roadmap/implementers-guide/src/messaging.md index 3795db37710e..9bc5f8663437 100644 --- a/roadmap/implementers-guide/src/messaging.md +++ b/roadmap/implementers-guide/src/messaging.md @@ -3,7 +3,8 @@ Polkadot has a few mechanisms that are responsible for message passing. They can be generally divided on two categories: Horizontal and Vertical. Horizontal Message Passing (HMP) refers to mechanisms that are responsible for exchanging messages between parachains. Vertical Message Passing (VMP) is -used for communication between the relay chain and parachains. +used for communication between the relay chain and parachains. A third category, which is still under +construction, is also described by this document: Cross-Chain Message Passing (XCMP). ## Vertical Message Passing @@ -61,6 +62,8 @@ digraph { } ``` +## Cross-Chain Message Passing + The most important member of this family is XCMP. > ℹ️ XCMP is currently under construction and details are subject for change. @@ -81,8 +84,10 @@ candidate authoring time. The proof stems from the relay parent storage that con Since not all messages are required to be processed by the receiver's candidate, only the processed messages are supplied (i.e. preimages), rest are provided as hashes. -Further details can be found at the [W3F research website](https://research.web3.foundation/en/latest/polkadot/XCMP.html) -and [this blogpost](https://medium.com/web3foundation/polkadots-messaging-scheme-b1ec560908b7). +Further details can be found at the official repository for the +[Cross-Consensus Message Format (XCM)](https://github.com/paritytech/xcm-format/blob/master/README.md), as well as +at the [W3F research website](https://research.web3.foundation/en/latest/polkadot/XCMP.html) and +[this blogpost](https://medium.com/web3foundation/polkadots-messaging-scheme-b1ec560908b7). HRMP (Horizontally Relay-routed Message Passing) is a stop gap that predates XCMP. Semantically, it mimics XCMP's interface. The crucial difference from XCMP though is that all the messages are stored in the relay-chain storage. That makes From abb1abd7625c28651510be87f7006c27516ba25c Mon Sep 17 00:00:00 2001 From: Sergei Shulepov Date: Wed, 12 Aug 2020 11:43:22 +0200 Subject: [PATCH 2/3] Remove the note about the third category --- roadmap/implementers-guide/src/messaging.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/roadmap/implementers-guide/src/messaging.md b/roadmap/implementers-guide/src/messaging.md index 9bc5f8663437..3f7b24b7871b 100644 --- a/roadmap/implementers-guide/src/messaging.md +++ b/roadmap/implementers-guide/src/messaging.md @@ -3,8 +3,7 @@ Polkadot has a few mechanisms that are responsible for message passing. They can be generally divided on two categories: Horizontal and Vertical. Horizontal Message Passing (HMP) refers to mechanisms that are responsible for exchanging messages between parachains. Vertical Message Passing (VMP) is -used for communication between the relay chain and parachains. A third category, which is still under -construction, is also described by this document: Cross-Chain Message Passing (XCMP). +used for communication between the relay chain and parachains. ## Vertical Message Passing From bbba9aeebdbfb16762d0c71f76ea0fb9b20a1925 Mon Sep 17 00:00:00 2001 From: Sergei Shulepov Date: Wed, 12 Aug 2020 11:44:18 +0200 Subject: [PATCH 3/3] Make Cross-Chain Message Passing a h3 --- roadmap/implementers-guide/src/messaging.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roadmap/implementers-guide/src/messaging.md b/roadmap/implementers-guide/src/messaging.md index 3f7b24b7871b..e9e228f30f57 100644 --- a/roadmap/implementers-guide/src/messaging.md +++ b/roadmap/implementers-guide/src/messaging.md @@ -61,7 +61,7 @@ digraph { } ``` -## Cross-Chain Message Passing +### Cross-Chain Message Passing The most important member of this family is XCMP.