From 24cc6b0db8ef9c718925d14b329f21938e5d2b1b Mon Sep 17 00:00:00 2001
From: Rasmus Dahlberg <rasmus.dahlberg@kau.se>
Date: Tue, 20 Apr 2021 12:28:28 +0200
Subject: started on our in-progress (re)design documents

---
 doc/schema/leaves.schema.json | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 doc/schema/leaves.schema.json

(limited to 'doc/schema/leaves.schema.json')

diff --git a/doc/schema/leaves.schema.json b/doc/schema/leaves.schema.json
new file mode 100644
index 0000000..74d7454
--- /dev/null
+++ b/doc/schema/leaves.schema.json
@@ -0,0 +1,38 @@
+{
+	"$schema": "https://json-schema.org/draft-07/schema#",
+	"title": "list of tree_leaf",
+	"description": "JSON-formatted tree leaf list, version 0.",
+
+	"type": "array",
+	"description": "A list Merkle tree leaves",
+	"items": {
+		"type": "object",
+		"required": [ "checksum", "signature_scheme", "signature", "key_hash" ],
+		"properties": {
+			"checksum": {
+				"description": "A cryptographic hash that is computed over some data of opaque type.  The result is base64-encoded.",
+				"type": "string",
+				"minLength": 44,
+				"maxLength": 44
+			},
+			"signature_scheme": {
+				"description": "An integer that identifies the signature scheme used by the submitter.  See API documentation.",
+				"type": "integer",
+				"enum": [ 1, 2, 3 ]
+			},
+			"signature": {
+				"description": "The submitter's signature over the checksum in base64",
+				"type": "string",
+				"minLength": 44,
+				"maxLength": 684
+			},
+			"key_hash": {
+				"description": "A public verification-key hash that identifies the signer.",
+				"type": "string",
+				"minLength": 44,
+				"maxLength": 44
+			}
+		}
+	},
+	"minItems": 1
+}
-- 
cgit v1.2.3