From 4bcec1ac929351946f7a531baf094a4b816ef1c3 Mon Sep 17 00:00:00 2001
From: "gilad.eth" <161574737+revelator-labs@users.noreply.github.com>
Date: Wed, 8 Jan 2025 12:25:36 +0200
Subject: [PATCH] Create OWN-main-flow.md

High level diagram to contextualize the different processes in the Original Works Network
---
 OWN-main-flow.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 OWN-main-flow.md

diff --git a/OWN-main-flow.md b/OWN-main-flow.md
new file mode 100644
index 0000000..db7bbd2
--- /dev/null
+++ b/OWN-main-flow.md
@@ -0,0 +1,75 @@
+```mermaid
+flowchart TB
+    subgraph Oracle["Oracle Layer"]
+        input1["DDEX.ERN or CWR Files"]
+        input2["Audio Streams"]
+        input3["Royalty Payouts"]
+        statements["User Statements"]
+        
+        subgraph RoyaltyClient["Royalty Pool Client"]
+            merkle["Merkle Tree\nSplit Information"]
+            pool["Royalty Pool\nUSDC Balance"]
+        end
+
+        input2 --> merkle
+        merkle --> statements
+        input3 --> pool
+    end
+
+    subgraph OWEN["OWEN Processing"]
+        parse["XML Parser"]
+        convert["JSON output"]
+        check["Validation Checks"]
+        generate["Generate ISCC (optional)"]
+        ipfs["IPFS Storage"]
+    
+        parse --> convert
+        convert --> check
+        check --> generate
+        generate --> ipfs
+    end
+
+    subgraph Storage["Distributed Storage"]
+        ipfsStore["IPFS\nStores BLOBs"]
+        blobContract["Blockchain Transaction\n- BLOB 18-day retention\n- Commitment mapping\n- Payment provider registry"]
+    end
+
+    subgraph ValidatorNetwork["L1 Validator Network"]
+        digest1["Digest BLOB Message"]
+        extract["Extract Key Data"]
+        zkproof["Generate ZK Proof"]
+        commit["Private Inputs BLOB KZG\nCommitment"]
+        output["Output Parsed Messages"]
+        digest2["Secondary Validator\nDigest BLOB Message"]
+    end
+
+    subgraph Index["Indexing Layer"]
+        registry["Registry of DDEX Relations"]
+        metadata["Index of registered Asset Metadata"]
+    end
+
+    subgraph RightsClaims["Rights Holder Claims"]
+        voucher["Voucher Wallet\nERC1155 Tokens"]
+        claim["Claim Process\n- Proof of Ownership\n- Σ[royalties]\n- Private 0x"]
+        payout["Payout Wallet\nNew address per claim"]
+    end
+
+    Oracle --> OWEN
+    OWEN --> Storage
+    Storage --> ValidatorNetwork
+    ValidatorNetwork --> Index
+    
+    merkle --> pool
+    pool --> claim
+    voucher --> claim
+    claim --> payout
+    
+    style Oracle fill:#f5f5f5
+    style OWEN fill:#e1f5fe
+    style Storage fill:#fff3e0
+    style ValidatorNetwork fill:#e8f5e9
+    style Index fill:#f3e5f5
+    style RightsClaims fill:#e1bee7
+
+
+```