From c1ca5df9e4f496e3efeb968ba516adde6a5b00b8 Mon Sep 17 00:00:00 2001
From: Gavin Wood <gavin@parity.io>
Date: Mon, 15 May 2023 16:47:44 +0100
Subject: [PATCH] Update docs (#7230)

---
 polkadot/xcm/xcm-builder/src/universal_exports.rs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/polkadot/xcm/xcm-builder/src/universal_exports.rs b/polkadot/xcm/xcm-builder/src/universal_exports.rs
index 81042a1ad4..a9868021c0 100644
--- a/polkadot/xcm/xcm-builder/src/universal_exports.rs
+++ b/polkadot/xcm/xcm-builder/src/universal_exports.rs
@@ -231,7 +231,15 @@ impl<Bridges: ExporterFor, Router: SendXcm, UniversalLocation: Get<InteriorMulti
 }
 
 pub trait DispatchBlob {
-	/// Dispatches an incoming blob and returns the unexpectable weight consumed by the dispatch.
+	/// Takes an incoming blob from over some point-to-point link (usually from some sort of
+	/// inter-consensus bridge) and then does what needs to be done with it. Usually this means
+	/// forwarding it on into some other location sharing our consensus or possibly just enqueuing
+	/// it for execution locally if it is destined for the local chain.
+	///
+	/// NOTE: The API does not provide for any kind of weight or fee management; the size of the
+	/// `blob` is known to the caller and so the operation must have a linear weight relative to
+	/// `blob`'s length. This means that you will generally only want to **enqueue** the blob, not
+	/// enact it. Fees must be handled by the caller.
 	fn dispatch_blob(blob: Vec<u8>) -> Result<(), DispatchBlobError>;
 }