diff --git a/DONS.md b/DONS.md new file mode 100644 index 0000000..31d1b90 --- /dev/null +++ b/DONS.md @@ -0,0 +1,22 @@ +# DON Composition + +`p2pmq` enables to compose a network of peers cross DONs (Decentralized Oracles Network), acting as a decentralized message bus for DON to DON communication. + +The following diagram illustrates the composition of a network of `p2pmq` peers across DONs: + +![p2pmq DON Composition](./resources/img/composer-p2pmq.png) + +
+ +## Messaging + +DONs communication is based on OCR reports, which are broadcasted over some topic rather than on-chain transmission. + +The reports MUST be signed by a quorum of the DON's nodes, otherwise they are considered invalid and any nodes that broadcast them are penalized. + +**NOTE** `p2pmq` enables to aid in a custom validation before processing and propagating messages to the network. + +**TBD** signature validation cross DONs. + +
+ diff --git a/resources/img/composer-p2pmq.png b/resources/img/composer-p2pmq.png new file mode 100644 index 0000000..c1a8367 Binary files /dev/null and b/resources/img/composer-p2pmq.png differ