Refine lexicon

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["slicesnetwork.lexicon-intellisense"]
+}

lexicons/com/germnetwork/declaration.json

@@ -4,25 +4,36 @@
   "defs": {
     "main": {
       "type": "record",
-      "description": "A delegate messaging id",
+      "description": "A declaration of a Germ Network account",
       "key": "literal:self",
       "record": {
         "type": "object",
         "required": ["version", "currentKey"],
         "properties": {
           "version": {
-            "type": "string"
+            "type": "string",
+            "description": "Semver version number, without pre-release or build information, for the format of opaque content",
+            "minLength": 5,
+            "maxLength": 14
           },
           "currentKey": {
-            "type": "bytes"
+            "type": "bytes",
+            "description": "Opaque value, an ed25519 public key prefixed with a byte enum"
+          },
+          "messageMe": {
+            "type": "ref",
+            "ref": "#messageMe",
+            "description": "Controls who can message this account"
           },
-          "messageMe": { "type": "ref", "ref": "#messageMe" },
           "keyPackage": {
-            "type": "bytes"
+            "type": "bytes",
+            "description": "Opaque value, contains MLS KeyPackage(s), and other signature data, and is signed by the currentKey"
           },
           "continuityProofs": {
             "type": "array",
-            "items": { "type": "bytes" }
+            "items": { "type": "bytes" },
+            "maxLength": 1000,
+            "description": "Array of opaque values to allow for key rolling"
           }
         }
       }
@@ -33,13 +44,19 @@
       "properties": {
         "messageMeUrl": {
           "type": "string",
-          "format": "uri"
+          "format": "uri",
+          "minLength": 1,
+          "maxLength": 2047,
+          "description": "A URL to present to an account that does not have its own com.germnetwork.declaration record, must have an empty fragment component, where the app should fill in the fragment component with the DIDs of the two accounts who wish to message each other"
         },
         "showButtonTo": {
           "type": "string",
-          "knownValues": ["usersIFollow", "everyone"]
+          "minLength": 1,
+          "maxLength": 100,
+          "knownValues": ["usersIFollow", "everyone"],
+          "description": "The policy of who can message the account, this value is included in the keyPackage, but is duplicated here to allow applications to decide if they should show a 'Message on Germ' button to the viewer."
         }
       }
     }
   }
-}
+}