From 943bff4b3d8c9d09f054035924e780a2a887dac2 Mon Sep 17 00:00:00 2001
From: Jeremy Wall <Jeremy@marzhillstudios.com>
Date: Sun, 30 Mar 2025 15:11:26 -0400
Subject: [PATCH] docs: update design notes

---
 DESIGN.md | 33 +++++++++++++++++++++++++--------
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/DESIGN.md b/DESIGN.md
index bab44ab..981549f 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -21,11 +21,20 @@ Resource reference paths are rooted at `/api/v1/ref/<path>`.
 
 ```json
 {
-    "objectId": <content-hash>,
+    "objectId": <merkle-hash>,
+    "content_address": <content-hash>,
     "path": "/path/name0",
     "dependents": [
-        { "path": "path/name1", "objectId": <content-hash>, content: <payload> },
-        { "path": "path/name2", "objectId": <content-hash>, content: <payload> }
+        {
+            "path": "path/name1",
+            "content_address": <content-hash>,
+            "objectId": <merkle-hash>, content: <payload>
+        },
+        {
+            "path": "path/name2",
+            "content_address": <content-hash>,
+            "objectId": <merkle-hash>, content: <payload>
+        }
     ],
 }
 ```
@@ -49,17 +58,25 @@ content key.
 
 ```json
 {
-    "objectId": <content-hash>,
+    "objectId": <merkle-hash>,
     "path": "/path/name0",
     "dependents": [
         {
-            "objectId": <content-hash>,
+            "objectId": <merkle-hash>,
             "path": "path/name1",
             "content": {
-                "objectId": <content-hash>,
+                "objectId": <merkle-hash>,
                 "dependents": [
-                    { "path": "path/name1", "objectId": <content-hash>, content: <payload> },
-                    { "path": "path/name2", "objectId": <content-hash>, content: <payload> }
+                    {
+                        "path": "path/name1",
+                        "content_address": <content-hash>,
+                        "objectId": <merkle-hash>, content: <payload>
+                    },
+                    {
+                        "path": "path/name2",
+                        "content_address": <content-hash>,
+                        "objectId": <merkle-hash>, content: <payload>
+                    }
                 ],
             }
         }