@carrot-foundation/schemas 0.1.36 → 0.1.37

package/schemas/ipfs/mass-id-audit/mass-id-audit.schema.json

@@ -1,26 +1,647 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/heads/main/schemas/ipfs/mass-id-audit/mass-id-audit.schema.json",
   "title": "MassID Audit IPFS Record",
-  "unevaluatedProperties": false,
-  "allOf": [
-    {
-      "$ref": "../shared/base/base.schema.json"
+  "description": "MassID audit metadata stored in IPFS, extending the base schema with audit results and references",
+  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.1.37/schemas/ipfs/mass-id-audit/mass-id-audit.schema.json",
+  "version": "0.1.37",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "title": "JSON Schema URI",
+      "description": "URI of the JSON Schema used to validate this record",
+      "example": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/heads/main/schemas/ipfs/shared/base/base.schema.json",
+      "type": "string",
+      "format": "uri"
     },
-    {
+    "schema": {
       "type": "object",
       "properties": {
-        "schema": {
-          "properties": {
-            "type": {
-              "const": "MassID Audit"
+        "hash": {
+          "title": "Schema Hash",
+          "description": "Keccak256 hash of the JSON Schema this record was validated against",
+          "examples": [
+            "ac08c3cf2e175e55961d6affdb38bc24591b84ceef7f3707c69ae3d52c148b2f",
+            "0xac08c3cf2e175e55961d6affdb38bc24591b84ceef7f3707c69ae3d52c148b2f"
+          ],
+          "anyOf": [
+            {
+              "title": "Keccak256 Hash",
+              "description": "Keccak256 cryptographic hash as hexadecimal string",
+              "examples": [
+                "ac08c3cf2e175e55961d6affdb38bc24591b84ceef7f3707c69ae3d52c148b2f",
+                "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2"
+              ],
+              "type": "string",
+              "pattern": "^[0-9a-fA-F]{64}$"
+            },
+            {
+              "type": "string",
+              "pattern": "^0x[a-fA-F0-9]{64}$"
             }
-          }
+          ]
+        },
+        "type": {
+          "title": "MassID Audit Schema Type",
+          "description": "MassID Audit schema type",
+          "type": "string",
+          "const": "MassID Audit"
+        },
+        "version": {
+          "title": "Schema Version",
+          "description": "Version of the schema, using semantic versioning",
+          "examples": [
+            "0.1.0",
+            "1.0.0",
+            "2.1.3"
+          ],
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^v?\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$"
+        }
+      },
+      "required": [
+        "hash",
+        "type",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "created_at": {
+      "title": "Created At",
+      "description": "ISO 8601 creation timestamp for this record",
+      "examples": [
+        "2024-12-05T11:02:47.000Z",
+        "2025-02-22T10:35:12.000Z"
+      ],
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+    },
+    "external_id": {
+      "title": "External ID",
+      "description": "Off-chain reference ID (UUID from Carrot backend)",
+      "examples": [
+        "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+        "b2c4e6f8-a1b3-4c5d-9e8f-123456789abc"
+      ],
+      "type": "string",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
+    },
+    "external_url": {
+      "title": "External URL",
+      "description": "External URL of the content",
+      "examples": [
+        "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+        "https://carrot.eco/whitepaper.pdf"
+      ],
+      "type": "string",
+      "format": "uri"
+    },
+    "original_content_hash": {
+      "title": "Original Content Hash",
+      "description": "SHA-256 hash of the original JSON content including private data before schema validation",
+      "examples": [
+        "87f633634cc4b02f628685651f0a29b7bfa22a0bd841f725c6772dd00a58d489",
+        "6e83b8e6373847bbdc056549bedda38dc88854ce41ba4fca11e0fc6ce3e07ef6"
+      ],
+      "type": "string",
+      "pattern": "^[0-9a-fA-F]{64}$"
+    },
+    "content_hash": {
+      "title": "Content Hash",
+      "description": "SHA-256 hash of RFC 8785 canonicalized JSON after schema validation",
+      "examples": [
+        "87f633634cc4b02f628685651f0a29b7bfa22a0bd841f725c6772dd00a58d489",
+        "6e83b8e6373847bbdc056549bedda38dc88854ce41ba4fca11e0fc6ce3e07ef6"
+      ],
+      "type": "string",
+      "pattern": "^[0-9a-fA-F]{64}$"
+    },
+    "creator": {
+      "title": "Creator",
+      "description": "Entity that created this record",
+      "type": "object",
+      "properties": {
+        "name": {
+          "title": "Creator Name",
+          "description": "Company or individual name that created this record",
+          "examples": [
+            "Carrot Foundation"
+          ],
+          "type": "string"
         },
-        "data": {
-          "$ref": "./mass-id-audit.data.schema.json"
+        "id": {
+          "title": "Creator ID",
+          "description": "Unique identifier for the creator",
+          "examples": [
+            "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+            "6f520d88-864d-432d-bf9f-5c3166c4818f",
+            "f77afa89-1c58-40fd-9bf5-8a86703a8af4"
+          ],
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
         }
+      },
+      "required": [
+        "name",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    "relationships": {
+      "title": "Relationships",
+      "description": "References to other IPFS records this record relates to",
+      "type": "array",
+      "items": {
+        "title": "Relationship",
+        "description": "Relationship to another IPFS record",
+        "type": "object",
+        "properties": {
+          "target_uri": {
+            "title": "Target IPFS URI",
+            "description": "Target IPFS URI of the referenced record",
+            "examples": [
+              "ipfs://QmTy8w65yBXgyfG2ZBg5TrfB2hPjrDQH3RCQFJGkARStJb/mass-id-organic.png",
+              "ipfs://QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o"
+            ],
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+          },
+          "type": {
+            "title": "Relationship Type",
+            "description": "Type of relationship to the referenced record",
+            "examples": [
+              "mass-id",
+              "collection",
+              "credit-purchase-receipt"
+            ],
+            "type": "string",
+            "enum": [
+              "collection",
+              "credit",
+              "gas-id",
+              "mass-id",
+              "mass-id-audit",
+              "methodology",
+              "credit-purchase-receipt",
+              "recycled-id"
+            ]
+          },
+          "description": {
+            "title": "Relationship Description",
+            "description": "Human-readable description of the relationship",
+            "examples": [
+              "This record supersedes the previous version",
+              "Related carbon credit batch",
+              "Source document for this verification",
+              "Child record derived from this parent",
+              "Updated version of original record"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "target_uri",
+          "type"
+        ],
+        "additionalProperties": false
       }
+    },
+    "environment": {
+      "title": "Environment",
+      "description": "Environment information",
+      "type": "object",
+      "properties": {
+        "blockchain_network": {
+          "title": "Blockchain Network",
+          "description": "Blockchain Network Environment",
+          "type": "string",
+          "enum": [
+            "mainnet",
+            "testnet"
+          ]
+        },
+        "deployment": {
+          "title": "Deployment Environment",
+          "description": "System environment where this record was generated",
+          "type": "string",
+          "enum": [
+            "production",
+            "development",
+            "testing"
+          ]
+        },
+        "data_set_name": {
+          "title": "Data Set Name",
+          "description": "Name of the data set for this record",
+          "type": "string",
+          "enum": [
+            "TEST",
+            "PROD"
+          ]
+        }
+      },
+      "required": [
+        "blockchain_network",
+        "deployment",
+        "data_set_name"
+      ],
+      "additionalProperties": false
+    },
+    "data": {
+      "title": "MassID Audit Data",
+      "description": "Complete data structure for MassID Audit records",
+      "type": "object",
+      "properties": {
+        "methodology": {
+          "title": "Methodology Reference",
+          "description": "Reference to a methodology record",
+          "type": "object",
+          "properties": {
+            "external_id": {
+              "title": "Methodology External ID",
+              "description": "Unique identifier for the methodology",
+              "examples": [
+                "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "b2c4e6f8-a1b3-4c5d-9e8f-123456789abc"
+              ],
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
+            },
+            "name": {
+              "title": "Methodology Name",
+              "description": "Human-readable name of the methodology",
+              "examples": [
+                "BOLD Carbon (CH₄)",
+                "BOLD Recycling"
+              ],
+              "type": "string",
+              "minLength": 5,
+              "maxLength": 150
+            },
+            "version": {
+              "title": "Methodology Version",
+              "description": "Version of the methodology",
+              "examples": [
+                "0.1.0",
+                "1.0.0",
+                "2.1.3"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^v?\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.-]+)?(\\+[a-zA-Z0-9.-]+)?$"
+            },
+            "external_url": {
+              "title": "Methodology External URL",
+              "description": "URL to view the methodology on Carrot Explorer",
+              "examples": [
+                "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "https://carrot.eco/whitepaper.pdf"
+              ],
+              "type": "string",
+              "format": "uri"
+            },
+            "uri": {
+              "title": "Methodology IPFS URI",
+              "description": "IPFS URI to the methodology record",
+              "examples": [
+                "ipfs://QmTy8w65yBXgyfG2ZBg5TrfB2hPjrDQH3RCQFJGkARStJb/mass-id-organic.png",
+                "ipfs://QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+            }
+          },
+          "required": [
+            "external_id",
+            "name",
+            "version",
+            "external_url"
+          ],
+          "additionalProperties": false
+        },
+        "mass_id": {
+          "title": "MassID Reference",
+          "description": "Reference to a MassID record",
+          "type": "object",
+          "properties": {
+            "external_id": {
+              "title": "MassID External ID",
+              "description": "Unique identifier for the MassID",
+              "examples": [
+                "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "b2c4e6f8-a1b3-4c5d-9e8f-123456789abc"
+              ],
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
+            },
+            "token_id": {
+              "title": "MassID Token ID",
+              "description": "NFT token ID of the MassID",
+              "examples": [
+                "123",
+                "456789",
+                "1000000"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^\\d+$"
+            },
+            "external_url": {
+              "title": "MassID External URL",
+              "description": "URL to view the MassID on Carrot Explorer",
+              "examples": [
+                "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "https://carrot.eco/whitepaper.pdf"
+              ],
+              "type": "string",
+              "format": "uri"
+            },
+            "uri": {
+              "title": "MassID IPFS URI",
+              "description": "IPFS URI of the MassID record",
+              "examples": [
+                "ipfs://QmTy8w65yBXgyfG2ZBg5TrfB2hPjrDQH3RCQFJGkARStJb/mass-id-organic.png",
+                "ipfs://QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+            }
+          },
+          "required": [
+            "external_id",
+            "token_id",
+            "external_url",
+            "uri"
+          ],
+          "additionalProperties": false
+        },
+        "gas_id": {
+          "title": "GasID Reference",
+          "description": "Reference to a GasID record",
+          "type": "object",
+          "properties": {
+            "external_id": {
+              "title": "GasID External ID",
+              "description": "Unique identifier for the GasID",
+              "examples": [
+                "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "b2c4e6f8-a1b3-4c5d-9e8f-123456789abc"
+              ],
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
+            },
+            "token_id": {
+              "title": "GasID Token ID",
+              "description": "NFT token ID of the GasID",
+              "examples": [
+                "123",
+                "456789",
+                "1000000"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^\\d+$"
+            },
+            "external_url": {
+              "title": "GasID External URL",
+              "description": "URL to view the GasID on Carrot Explorer",
+              "examples": [
+                "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                "https://carrot.eco/whitepaper.pdf"
+              ],
+              "type": "string",
+              "format": "uri"
+            },
+            "uri": {
+              "title": "GasID IPFS URI",
+              "description": "IPFS URI of the GasID record",
+              "examples": [
+                "ipfs://QmTy8w65yBXgyfG2ZBg5TrfB2hPjrDQH3RCQFJGkARStJb/mass-id-organic.png",
+                "ipfs://QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+            }
+          },
+          "required": [
+            "external_id",
+            "token_id",
+            "external_url",
+            "uri"
+          ],
+          "additionalProperties": false
+        },
+        "audit_summary": {
+          "title": "Audit Summary",
+          "description": "Summary of audit execution results",
+          "type": "object",
+          "properties": {
+            "audit_date": {
+              "title": "Audit Date",
+              "description": "Date when the audit was completed",
+              "examples": [
+                "2024-12-05",
+                "2025-02-22",
+                "2024-02-10"
+              ],
+              "type": "string",
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
+            },
+            "methodology_compliance": {
+              "title": "Methodology Compliance",
+              "description": "Overall outcome of the audit process",
+              "examples": [
+                "PASSED",
+                "FAILED"
+              ],
+              "type": "string",
+              "enum": [
+                "PASSED",
+                "FAILED"
+              ]
+            },
+            "total_rules_executed": {
+              "title": "Total Rules Executed",
+              "description": "Total number of audit rules executed",
+              "examples": [
+                0,
+                123,
+                4126
+              ],
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "passed_rules": {
+              "title": "Passed Rules Count",
+              "description": "Number of rules that passed verification",
+              "examples": [
+                0,
+                123,
+                4126
+              ],
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "failed_rules": {
+              "title": "Failed Rules Count",
+              "description": "Number of rules that failed verification",
+              "examples": [
+                0,
+                123,
+                4126
+              ],
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "audit_date",
+            "methodology_compliance",
+            "total_rules_executed",
+            "passed_rules",
+            "failed_rules"
+          ],
+          "additionalProperties": false
+        },
+        "rules_execution_results": {
+          "title": "Audit Rule Execution Results",
+          "description": "Detailed results of each audit rule execution",
+          "type": "array",
+          "items": {
+            "title": "Audit Rule Execution Result",
+            "description": "Detailed result of an audit rule execution",
+            "type": "object",
+            "properties": {
+              "rule_name": {
+                "title": "Rule Name",
+                "description": "Human-readable name of the audit rule",
+                "examples": [
+                  "Example text",
+                  "Sample value",
+                  "Test string"
+                ],
+                "type": "string",
+                "minLength": 1
+              },
+              "rule_id": {
+                "title": "Rule ID",
+                "description": "Unique identifier for the rule",
+                "examples": [
+                  "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+                  "6f520d88-864d-432d-bf9f-5c3166c4818f",
+                  "f77afa89-1c58-40fd-9bf5-8a86703a8af4"
+                ],
+                "type": "string",
+                "format": "uuid",
+                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
+              },
+              "rule_slug": {
+                "title": "Rule Slug",
+                "description": "URL-friendly identifier for the rule",
+                "examples": [
+                  "mass-id-123",
+                  "recycled-plastic",
+                  "organic-waste"
+                ],
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 100,
+                "pattern": "^[a-z0-9-]+$"
+              },
+              "execution_order": {
+                "title": "Rule Execution Order",
+                "description": "Sequential order in which this rule was executed",
+                "examples": [
+                  1,
+                  123,
+                  456
+                ],
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 9007199254740991
+              },
+              "result": {
+                "title": "Rule Execution Result",
+                "description": "Result of the rule execution",
+                "examples": [
+                  "PASSED",
+                  "FAILED"
+                ],
+                "type": "string",
+                "enum": [
+                  "PASSED",
+                  "FAILED"
+                ]
+              },
+              "description": {
+                "title": "Rule Description",
+                "description": "Detailed description of what this rule validates",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 2000
+              },
+              "rule_processor_checksum": {
+                "title": "Rule Processor Checksum",
+                "description": "Checksum for rule processor integrity verification",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              "rule_source_code_version": {
+                "title": "Rule Source Code Version",
+                "description": "Version identifier for the rule source code",
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            },
+            "required": [
+              "rule_name",
+              "rule_id",
+              "rule_slug",
+              "execution_order",
+              "result",
+              "description",
+              "rule_processor_checksum",
+              "rule_source_code_version"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "methodology",
+        "mass_id",
+        "gas_id",
+        "audit_summary",
+        "rules_execution_results"
+      ],
+      "additionalProperties": false
     }
-  ]
-}
+  },
+  "required": [
+    "$schema",
+    "schema",
+    "created_at",
+    "external_id",
+    "external_url",
+    "original_content_hash",
+    "content_hash",
+    "data"
+  ],
+  "additionalProperties": false
+}