@carrot-foundation/schemas 0.1.6

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

@@ -0,0 +1,1325 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MassID NFT IPFS Record",
+  "description": "Complete MassID NFT IPFS record including fixed attributes and detailed waste tracking data",
+  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/heads/main/schemas/ipfs/mass-id/mass-id.schema.json",
+  "version": "1.0.0",
+  "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": {
+        "hash": {
+          "title": "Schema Hash",
+          "description": "Keccak256 hash of the JSON Schema this record was validated against",
+          "examples": [
+            "ac08c3cf2e175e55961d6affdb38bc24591b84ceef7f3707c69ae3d52c148b2f",
+            "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2"
+          ],
+          "type": "string",
+          "pattern": "^[0-9a-fA-F]{64}$"
+        },
+        "type": {
+          "title": "MassID Schema Type",
+          "description": "MassID NFT schema type",
+          "type": "string",
+          "const": "MassID"
+        },
+        "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", "Alice", "Bob"],
+          "type": "string"
+        },
+        "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", "audit", "collection"],
+            "type": "string",
+            "enum": [
+              "collection",
+              "credit",
+              "gas-id",
+              "mass-id",
+              "mass-id-audit",
+              "methodology",
+              "purchase-id",
+              "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 Data",
+      "description": "MassID-specific data containing waste tracking and chain of custody information",
+      "type": "object",
+      "properties": {
+        "waste_classification": {
+          "title": "Waste Classification",
+          "description": "Standardized waste material classification and regulatory information",
+          "type": "object",
+          "properties": {
+            "primary_type": {
+              "title": "Primary Waste Type",
+              "description": "Primary waste material category",
+              "examples": ["Organic", "Plastic", "Metal"],
+              "type": "string",
+              "minLength": 1
+            },
+            "subtype": {
+              "title": "Waste Subtype",
+              "description": "Specific subcategory of waste material",
+              "examples": [
+                "Food, Food Waste and Beverages",
+                "PET Bottles",
+                "Aluminum Cans"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 100
+            },
+            "local_classification": {
+              "title": "Local Classification",
+              "description": "Local or regional waste classification codes and descriptions",
+              "type": "object",
+              "properties": {
+                "code": {
+                  "title": "Classification Code",
+                  "description": "Local waste classification code",
+                  "examples": ["20 01 01", "D001", "EWC-150101", "IBAMA-A001"],
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 20
+                },
+                "description": {
+                  "title": "Classification Description",
+                  "description": "Local waste classification description",
+                  "examples": [
+                    "Paper and cardboard packaging",
+                    "Ignitable waste",
+                    "Paper and cardboard packaging waste",
+                    "Municipal solid waste - organic fraction"
+                  ],
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "system": {
+                  "title": "Classification System",
+                  "description": "Classification system name (e.g., \"Ibama Waste Code\", \"European Waste Catalogue\", \"US EPA Codes\")",
+                  "examples": [
+                    "European Waste Catalogue",
+                    "US EPA Codes",
+                    "Ibama Waste Code",
+                    "Brazilian ABNT Classification"
+                  ],
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 50
+                }
+              },
+              "required": ["code", "description", "system"],
+              "additionalProperties": false
+            },
+            "measurement_unit": {
+              "title": "Measurement Unit",
+              "description": "Unit of measurement for the waste quantity",
+              "examples": ["kg", "ton"],
+              "type": "string",
+              "enum": ["kg", "ton"]
+            },
+            "net_weight": {
+              "title": "Net Weight",
+              "description": "Net weight of the waste batch in the specified measurement unit",
+              "examples": [0, 45.2, 72.5],
+              "type": "number",
+              "minimum": 0
+            },
+            "contamination_level": {
+              "title": "Contamination Level",
+              "description": "Level of contamination in the waste batch",
+              "examples": ["Low", "Medium", "None"],
+              "type": "string",
+              "enum": ["None", "Low", "Medium", "High"]
+            }
+          },
+          "required": [
+            "primary_type",
+            "subtype",
+            "measurement_unit",
+            "net_weight"
+          ],
+          "additionalProperties": false
+        },
+        "locations": {
+          "title": "Locations",
+          "description": "All locations referenced in this MassID, indexed by ID",
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "title": "Location",
+            "description": "Geographic location with address and coordinate information",
+            "type": "object",
+            "properties": {
+              "id": {
+                "title": "Location ID",
+                "description": "Unique identifier for the location",
+                "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})$"
+              },
+              "municipality": {
+                "title": "Municipality",
+                "description": "Municipality or city name",
+                "examples": ["New York", "São Paulo", "London", "Tokyo"],
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 50
+              },
+              "administrative_division": {
+                "title": "Administrative Division",
+                "description": "State, province, or administrative region",
+                "examples": ["California", "Ontario", "Bavaria", "Queensland"],
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 50
+              },
+              "administrative_division_code": {
+                "title": "Administrative Division Code",
+                "description": "ISO 3166-2 administrative division code",
+                "examples": ["BR-AP", "BR-ES", "US-CA"],
+                "type": "string",
+                "pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$"
+              },
+              "country": {
+                "title": "Country",
+                "description": "Full country name in English",
+                "examples": ["United States", "Canada", "Germany", "Australia"],
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 50
+              },
+              "country_code": {
+                "title": "Country Code",
+                "description": "ISO 3166-1 alpha-2 country code",
+                "examples": ["BR", "US", "DE"],
+                "type": "string",
+                "pattern": "^[A-Z]{2}$"
+              },
+              "responsible_participant_id": {
+                "title": "Responsible Participant ID",
+                "description": "ID of the participant responsible for this location",
+                "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})$"
+              },
+              "coordinates": {
+                "title": "Coordinates",
+                "description": "GPS coordinates of the location",
+                "type": "object",
+                "properties": {
+                  "latitude": {
+                    "title": "Latitude",
+                    "description": "GPS latitude coordinate",
+                    "examples": [-0.02, -20.38, 40.7128],
+                    "type": "number",
+                    "minimum": -90,
+                    "maximum": 90
+                  },
+                  "longitude": {
+                    "title": "Longitude",
+                    "description": "GPS longitude coordinate",
+                    "examples": [-51.06, -40.34, -74.006],
+                    "type": "number",
+                    "minimum": -180,
+                    "maximum": 180
+                  },
+                  "precision_level": {
+                    "title": "Precision Level",
+                    "description": "Level of coordinate precision",
+                    "examples": ["city", "exact", "neighborhood"],
+                    "type": "string",
+                    "enum": [
+                      "exact",
+                      "neighborhood",
+                      "city",
+                      "region",
+                      "country"
+                    ]
+                  }
+                },
+                "required": ["latitude", "longitude", "precision_level"],
+                "additionalProperties": false
+              },
+              "facility_type": {
+                "title": "Facility Type",
+                "description": "Type of facility at this location",
+                "examples": [
+                  "Waste Generation",
+                  "Recycling Facility",
+                  "Collection Point"
+                ],
+                "type": "string",
+                "enum": [
+                  "Waste Generation",
+                  "Collection Point",
+                  "Transfer Station",
+                  "Sorting Facility",
+                  "Composting Facility",
+                  "Recycling Facility",
+                  "Processing Facility",
+                  "Disposal Facility",
+                  "Administrative Office"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "municipality",
+              "administrative_division",
+              "administrative_division_code",
+              "country",
+              "country_code",
+              "responsible_participant_id",
+              "coordinates",
+              "facility_type"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "participants": {
+          "title": "Participants",
+          "description": "All participants referenced in this MassID, indexed by ID",
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "title": "Participant",
+            "description": "A participant in the waste management supply chain",
+            "type": "object",
+            "properties": {
+              "id": {
+                "title": "Participant ID",
+                "description": "Unique identifier for the participant",
+                "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})$"
+              },
+              "name": {
+                "title": "Participant Name",
+                "description": "Name of the participant",
+                "examples": [
+                  "Enlatados Produção",
+                  "Eco Reciclagem",
+                  "Green Tech Corp"
+                ],
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 100
+              },
+              "roles": {
+                "title": "Participant Roles",
+                "description": "Roles of the participant in the waste management supply chain",
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "title": "Participant Role",
+                  "description": "Role that a participant plays in the waste management supply chain",
+                  "examples": ["Waste Generator", "Hauler", "Recycler"],
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 100
+                }
+              }
+            },
+            "required": ["id", "name", "roles"],
+            "additionalProperties": false
+          }
+        },
+        "chain_of_custody": {
+          "title": "Chain of Custody",
+          "description": "Complete chain of custody tracking from waste generation to final processing",
+          "type": "object",
+          "properties": {
+            "events": {
+              "title": "Custody Events",
+              "description": "Chronological sequence of custody transfer and processing events",
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "title": "Chain of Custody Event",
+                "description": "Chain of custody event",
+                "type": "object",
+                "properties": {
+                  "event_id": {
+                    "title": "Event ID",
+                    "description": "Unique event identifier",
+                    "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})$"
+                  },
+                  "event_name": {
+                    "title": "Event Name",
+                    "description": "Name of custody or processing event",
+                    "examples": [
+                      "Sorting",
+                      "Processing",
+                      "Recycling",
+                      "Weighing"
+                    ],
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 50
+                  },
+                  "description": {
+                    "title": "Event Description",
+                    "description": "Detailed description of what happened during this event",
+                    "examples": [
+                      "Waste collected from residential area using collection truck",
+                      "Material sorted into recyclable and non-recyclable fractions",
+                      "Plastic waste processed through shredding and washing",
+                      "Waste transferred to authorized recycling facility",
+                      "Final disposal at licensed landfill site",
+                      "Quality inspection and contamination assessment completed"
+                    ],
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                  },
+                  "timestamp": {
+                    "title": "Event Timestamp",
+                    "description": "ISO 8601 timestamp when the event occurred",
+                    "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))$"
+                  },
+                  "participant_id": {
+                    "title": "Participant ID",
+                    "description": "Reference to participant in the participants array",
+                    "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})$"
+                  },
+                  "location_id": {
+                    "title": "Location ID",
+                    "description": "Reference to location in the locations array",
+                    "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})$"
+                  },
+                  "weight": {
+                    "title": "Event Weight",
+                    "description": "Mass weight after this event",
+                    "examples": [0, 45.2, 72.5],
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "attributes": {
+                    "title": "Event Attributes",
+                    "description": "Additional attributes specific to this event",
+                    "type": "array",
+                    "items": {
+                      "title": "Event Attribute",
+                      "description": "Additional attribute specific to an event",
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "title": "Attribute Name",
+                          "description": "Event attribute name",
+                          "examples": [
+                            "temperature",
+                            "humidity",
+                            "contamination_percentage",
+                            "quality_grade",
+                            "batch_number",
+                            "operator_id",
+                            "equipment_used",
+                            "processing_cost"
+                          ],
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 100
+                        },
+                        "value": {
+                          "title": "Attribute Value",
+                          "description": "Event attribute value",
+                          "examples": [
+                            25.5,
+                            "Grade A",
+                            true,
+                            "BATCH-2024-001",
+                            12.75,
+                            "Shredder-X200",
+                            false,
+                            "OP-456"
+                          ],
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            }
+                          ]
+                        },
+                        "format": {
+                          "title": "Event Attribute Format",
+                          "description": "Data format hint for proper display",
+                          "examples": ["KILOGRAM", "DATE", "PERCENTAGE"],
+                          "type": "string",
+                          "enum": [
+                            "KILOGRAM",
+                            "DATE",
+                            "CURRENCY",
+                            "PERCENTAGE",
+                            "COORDINATE"
+                          ]
+                        }
+                      },
+                      "required": ["name", "value"],
+                      "additionalProperties": false
+                    }
+                  },
+                  "documentation": {
+                    "title": "Event Documentation",
+                    "description": "Associated documentation for this event",
+                    "type": "array",
+                    "items": {
+                      "title": "Event Document",
+                      "description": "Supporting event document",
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "title": "Document Type",
+                          "description": "Type of supporting documentation",
+                          "examples": [
+                            "Waste Transfer Note",
+                            "Certificate of Disposal",
+                            "Certificate of Final Destination",
+                            "Quality Assessment Report",
+                            "Transport Manifest",
+                            "Processing Receipt",
+                            "Environmental Permit",
+                            "Invoice"
+                          ],
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 50
+                        },
+                        "document_number": {
+                          "title": "Document Number",
+                          "description": "Official document number if applicable",
+                          "examples": [
+                            "WTN-2024-001234",
+                            "CD-ENV-456789",
+                            "INV-2024-QTR1-789",
+                            "PERMIT-EPA-2024-001",
+                            "MANIFEST-DOT-567890"
+                          ],
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 50
+                        },
+                        "reference": {
+                          "title": "Document Reference",
+                          "description": "Reference to document (IPFS hash, file name, or external URL)",
+                          "examples": [
+                            "QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o",
+                            "waste_transfer_note_2024_001.pdf",
+                            "https://docs.example.com/certificates/disposal_cert_456.pdf",
+                            "bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi",
+                            "processing_receipt_20240315.jpg"
+                          ],
+                          "type": "string",
+                          "minLength": 1
+                        },
+                        "issue_date": {
+                          "title": "Issue Date",
+                          "description": "Date the document was issued",
+                          "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])))$"
+                        },
+                        "issuer": {
+                          "title": "Document Issuer",
+                          "description": "Entity that issued the document",
+                          "examples": [
+                            "Environmental Protection Agency",
+                            "Waste Management Solutions Ltd",
+                            "Green Recycling Corp",
+                            "City Waste Authority",
+                            "EcoProcess Industries",
+                            "Regional Environmental Office"
+                          ],
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 100
+                        }
+                      },
+                      "required": ["type", "reference"],
+                      "additionalProperties": false
+                    }
+                  },
+                  "notes": {
+                    "title": "Event Notes",
+                    "description": "Additional notes or comments about this event",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 500
+                  }
+                },
+                "required": [
+                  "event_id",
+                  "event_name",
+                  "description",
+                  "timestamp",
+                  "participant_id",
+                  "location_id"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "total_distance_km": {
+              "title": "Total Distance (km)",
+              "description": "Total distance traveled across all transport events",
+              "examples": [0, 45.2, 72.5],
+              "type": "number",
+              "minimum": 0
+            },
+            "total_duration_hours": {
+              "title": "Total Duration (hours)",
+              "description": "Total time from first to last event in hours",
+              "examples": [72.5, 24, 168.5],
+              "type": "number",
+              "minimum": 0,
+              "multipleOf": 0.1
+            }
+          },
+          "required": ["events", "total_distance_km", "total_duration_hours"],
+          "additionalProperties": false
+        },
+        "geographic_data": {
+          "title": "Geographic Data",
+          "description": "Geographic information about waste origin and processing locations",
+          "type": "object",
+          "properties": {
+            "origin_location_id": {
+              "title": "Origin Location ID",
+              "description": "Reference to origin location in the locations array",
+              "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})$"
+            },
+            "processing_location_ids": {
+              "title": "Processing Location IDs",
+              "description": "Locations where the waste was processed or handled",
+              "type": "array",
+              "items": {
+                "title": "UUID",
+                "description": "A universally unique identifier version 4",
+                "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})$"
+              }
+            },
+            "final_destination_id": {
+              "title": "Final Destination ID",
+              "description": "Reference to final destination in the locations array",
+              "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})$"
+            },
+            "transport_routes": {
+              "title": "Transport Routes",
+              "description": "Detailed transport route information",
+              "type": "array",
+              "items": {
+                "title": "Transport Route",
+                "description": "Transport route segment information",
+                "type": "object",
+                "properties": {
+                  "from_location_id": {
+                    "title": "From Location ID",
+                    "description": "Reference to the origin location in the locations array",
+                    "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})$"
+                  },
+                  "to_location_id": {
+                    "title": "To Location ID",
+                    "description": "Reference to the destination location in the locations array",
+                    "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})$"
+                  },
+                  "distance_km": {
+                    "title": "Distance (km)",
+                    "description": "Distance for this route segment in kilometers",
+                    "examples": [0, 45.2, 72.5],
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "transport_method": {
+                    "title": "Transport Method",
+                    "description": "Method of transportation for this segment",
+                    "examples": [
+                      "Truck",
+                      "Rail",
+                      "Barge",
+                      "Container Ship",
+                      "Conveyor Belt",
+                      "Pipeline",
+                      "Walking",
+                      "Forklift"
+                    ],
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 50
+                  },
+                  "duration_hours": {
+                    "title": "Duration (hours)",
+                    "description": "Time taken for this route segment in hours",
+                    "examples": [72.5, 24, 168.5],
+                    "type": "number",
+                    "minimum": 0,
+                    "multipleOf": 0.1
+                  }
+                },
+                "required": [
+                  "from_location_id",
+                  "to_location_id",
+                  "distance_km",
+                  "transport_method",
+                  "duration_hours"
+                ],
+                "additionalProperties": false
+              }
+            }
+          },
+          "required": [
+            "origin_location_id",
+            "final_destination_id",
+            "transport_routes"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "waste_classification",
+        "locations",
+        "participants",
+        "chain_of_custody",
+        "geographic_data"
+      ],
+      "additionalProperties": false
+    },
+    "blockchain": {
+      "title": "Blockchain Information",
+      "description": "Blockchain-specific information for the NFT",
+      "type": "object",
+      "properties": {
+        "smart_contract_address": {
+          "title": "Smart Contract Address",
+          "description": "A valid Ethereum address in hexadecimal format",
+          "examples": [
+            "0x1234567890abcdef1234567890abcdef12345678",
+            "0xabcdef1234567890abcdef1234567890abcdef12"
+          ],
+          "type": "string",
+          "pattern": "^0x[a-fA-F0-9]{40}$"
+        },
+        "chain_id": {
+          "title": "Chain ID",
+          "description": "Blockchain chain ID",
+          "examples": [1, 137, 11155111],
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "network_name": {
+          "title": "Network Name",
+          "description": "Name of the blockchain network",
+          "type": "string",
+          "minLength": 5,
+          "maxLength": 100
+        },
+        "token_id": {
+          "title": "Token ID",
+          "description": "NFT token ID",
+          "examples": ["123", "456789", "1000000"],
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^\\d+$"
+        }
+      },
+      "required": [
+        "smart_contract_address",
+        "chain_id",
+        "network_name",
+        "token_id"
+      ],
+      "additionalProperties": false
+    },
+    "name": {
+      "title": "NFT Name",
+      "description": "Full display name for this NFT, including extra context",
+      "examples": [
+        "MassID #123 • Organic • 3.0t",
+        "RecycledID #456 • Plastic • 2.5t",
+        "GasID #789 • Methane • 1000 m³"
+      ],
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "short_name": {
+      "title": "Short Name",
+      "description": "Compact name for UI summaries, tables, or tooltips",
+      "examples": ["MassID #123", "RecycledID #456", "GasID #789"],
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50
+    },
+    "description": {
+      "title": "Description",
+      "description": "Human-readable summary of the NFT's role and context. Ideally, maximum 300 characters.",
+      "examples": [
+        "This MassID represents 3 metric tons of organic food waste from Enlatados Produção, tracked through complete chain of custody from generation to composting.",
+        "This RecycledID represents 2.5 metric tons of recycled plastic bottles processed by Green Solutions Ltd."
+      ],
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 500
+    },
+    "image": {
+      "title": "Image URI",
+      "description": "IPFS URI pointing to the preview image",
+      "examples": [
+        "ipfs://QmTy8w65yBXgyfG2ZBg5TrfB2hPjrDQH3RCQFJGkARStJb/mass-id-organic.png",
+        "ipfs://QmYjtig7VJQ6XsnUjqqJvj7QaMcCAwtrgNdahSiFofrE7o"
+      ],
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+    },
+    "background_color": {
+      "title": "Background Color",
+      "description": "Hex color code for marketplace background display",
+      "examples": ["#2D5A27", "#FF5733", "#1E90FF"],
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^#[0-9A-F]{6}$"
+    },
+    "animation_url": {
+      "title": "Animation URL",
+      "description": "IPFS URI pointing to an animated or interactive media file",
+      "examples": [
+        "ipfs://QmAnimation123/mass-id-animation.mp4",
+        "ipfs://QmInteractive456/recycled-visualization.webm"
+      ],
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^ipfs:\\/\\/[a-zA-Z0-9]+(\\/.*)?$"
+    },
+    "external_links": {
+      "title": "External Links",
+      "description": "Optional list of public resource links with labels",
+      "examples": [
+        [
+          {
+            "label": "Carrot Explorer",
+            "url": "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
+            "description": "Complete chain of custody and audit trail"
+          },
+          {
+            "label": "Carrot White Paper",
+            "url": "https://carrot.eco/whitepaper.pdf",
+            "description": "Carrot Foundation technical and impact white paper"
+          }
+        ]
+      ],
+      "maxItems": 10,
+      "type": "array",
+      "items": {
+        "title": "External Link",
+        "description": "External link with label and description",
+        "type": "object",
+        "properties": {
+          "label": {
+            "title": "Link Label",
+            "description": "Display name for the external link",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          "url": {
+            "title": "Link URL",
+            "description": "Direct URI to the linked resource",
+            "type": "string",
+            "format": "uri"
+          },
+          "description": {
+            "title": "Link Description",
+            "description": "Optional context about what the link provides",
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 100
+          }
+        },
+        "required": ["label", "url"],
+        "additionalProperties": false
+      }
+    },
+    "attributes": {
+      "type": "array",
+      "prefixItems": [
+        {
+          "title": "Waste Type Attribute",
+          "description": "Waste type attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Waste Type"
+            },
+            "value": {
+              "title": "Waste Type",
+              "description": "Category or type of waste material",
+              "examples": ["Organic", "Plastic", "Metal"],
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Waste Subtype Attribute",
+          "description": "Waste subtype attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Waste Subtype"
+            },
+            "value": {
+              "title": "Waste Subtype",
+              "description": "Specific subcategory of waste within a waste type",
+              "examples": [
+                "Food, Food Waste and Beverages",
+                "PET Bottles",
+                "Aluminum Cans"
+              ],
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Weight Attribute",
+          "description": "Weight attribute with numeric display",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Weight (kg)"
+            },
+            "value": {
+              "title": "Weight (kg)",
+              "description": "Weight measurement in kilograms",
+              "examples": [3000, 1500, 500],
+              "type": "number",
+              "minimum": 0
+            },
+            "display_type": {
+              "type": "string",
+              "const": "number"
+            }
+          },
+          "required": ["trait_type", "value", "display_type"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Origin Country Attribute",
+          "description": "Origin country attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Origin Country"
+            },
+            "value": {
+              "title": "Origin Country Value",
+              "description": "Country where the waste was generated",
+              "type": "string",
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Origin Municipality Attribute",
+          "description": "Origin municipality attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Origin Municipality"
+            },
+            "value": {
+              "title": "Origin Municipality Value",
+              "description": "Municipality where the waste was generated",
+              "type": "string",
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Origin Administrative Division Attribute",
+          "description": "Origin administrative division attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Origin Administrative Division"
+            },
+            "value": {
+              "title": "Origin Division Value",
+              "description": "Administrative division (state/province) where the waste was generated",
+              "type": "string",
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Recycler Attribute",
+          "description": "Recycler attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Recycler"
+            },
+            "value": {
+              "title": "Recycler Value",
+              "description": "Organization that processed the waste",
+              "type": "string",
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Integrator Attribute",
+          "description": "Integrator attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Integrator"
+            },
+            "value": {
+              "title": "Integrator Value",
+              "description": "Organization that integrated the waste into the Carrot network",
+              "type": "string",
+              "maxLength": 100
+            }
+          },
+          "required": ["trait_type", "value"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Pick-up Date Attribute",
+          "description": "Pick-up date attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Pick-up Date"
+            },
+            "value": {
+              "title": "Pick-up Date Value",
+              "description": "Date when the waste was picked up from the source",
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+            },
+            "display_type": {
+              "type": "string",
+              "const": "date"
+            }
+          },
+          "required": ["trait_type", "value", "display_type"],
+          "additionalProperties": false
+        },
+        {
+          "title": "Recycling Date Attribute",
+          "description": "Recycling date attribute",
+          "type": "object",
+          "properties": {
+            "trait_type": {
+              "type": "string",
+              "const": "Recycling Date"
+            },
+            "value": {
+              "title": "Recycling Date Value",
+              "description": "Date when the waste was recycled/processed",
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+            },
+            "display_type": {
+              "type": "string",
+              "const": "date"
+            }
+          },
+          "required": ["trait_type", "value", "display_type"],
+          "additionalProperties": false
+        }
+      ],
+      "minItems": 10,
+      "maxItems": 10
+    }
+  },
+  "required": [
+    "$schema",
+    "schema",
+    "created_at",
+    "external_id",
+    "external_url",
+    "original_content_hash",
+    "content_hash",
+    "data",
+    "blockchain",
+    "name",
+    "short_name",
+    "description",
+    "image",
+    "attributes"
+  ],
+  "additionalProperties": false
+}