From f360760bffb7af7722d85ce73db5f88dfe0ebd03 Mon Sep 17 00:00:00 2001
From: Joe Andrieu <joe@legreq.com>
Date: Tue, 1 Mar 2022 09:22:48 -0800
Subject: [PATCH] Updated read flow

Added autonumbering and used language referenced in the cosmos-cash discussion at https://github.com/allinbits/cosmos-cash/issues/339
---
 README.md | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index acfafa0..f2dc637 100644
--- a/README.md
+++ b/README.md
@@ -447,18 +447,19 @@ WriteRequest{
 ```
 
 #### Read DID (Resolve and Verify)
-
+Example flow for `did:earth:ixo:nft:12345`, an asset hosted by the NFT module on the ixo application chain.
 ```mermaid
 sequenceDiagram
-User->>DID Registry: Resolve DID for did:earth:ixo:nft:12345
-DID Registry->>Chain Registry: Lookup correct 'chainspace' value for DID did:earth:ixo:nft:12345
-Chain Registry->>DID Registry: Return correct 'chainspace' value for DID as ixo
-DID Registry->>Application Chain: Lookup 'internal-namespace-identifier' for DID did:earth:ixo:nft
-Application Chain->> DID Registry: Return 'internal-namespace-identifier' for DID asset module nft including metadata
-DID Registry->>DID Registry: Verify metadata 'active=True' to ensure DID is not in deactivated state
-DID Registry->>Asset Module: Lookup 'unique-asset-id' for DID did:earth:ixo:nft:12345
-Asset Module->>DID Registry: Return 'unique-asset-id' for DID from NFT asset module for 'unique-asset-id'=12345
-DID Registry->>User: Return DID Document for DID did:earth:ixo:nft:12345
+autonumber
+User->>Cosmos DID Registry: Resolve `did:earth:ixo:nft:12345`
+Cosmos DID Registry->>Chain Registry: Lookup correct 'chainspace' value for `did:earth:ixo:nft:12345`
+Chain Registry->>Cosmos DID Registry: Return route to ixo DID Registry 
+Cosmos DID Registry->>User: Route to ixo DID Registry
+User->>Ixo DID Registry:  Resolve DID for `did:earth:ixo:nft:12345`
+Ixo DID Registry->>User : Return route to ixo NFT module
+User->>ixo NFT Module: Resolve DID for `did:earth:ixo:nft:12345`
+ixo NFT Module->>ixo NFT Module: Construct DID Document based on current chain state
+ixo NFT Module->>User: Return DID Document for DID `did:earth:ixo:nft:12345`
 ```
 
 To resolve DID earth method DID Documents the `QueryIdentifierDocument` operation fetch a response from the ledger. The integrity of the DID documents stored on the ledger is guaranteed by the underlying Cosmos blockchain protocol. DID resolution requests can be sent to the gRPC IID resolver interface for a node by passing the fully-qualified DID.