@carrot-foundation/schemas 0.2.4 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrot-foundation/schemas",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "Carrot schema definitions and zod validation schemas",
   "license": "Apache-2.0",
   "private": false,

package/schemas/ipfs/collection/collection.example.json

@@ -1,9 +1,9 @@
 {
-  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/collection/collection.schema.json",
+  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/collection/collection.schema.json",
   "schema": {
-    "hash": "494bfbbd8e8721131571031aee97d23b825461e6c8c76de258b06c296ce30d60",
+    "hash": "2f8e7ae43fabfa0b8d4d18af1413fc375eca4622a4df75829b36492261a2a46d",
     "type": "Collection",
-    "version": "0.2.4",
+    "version": "0.3.0",
     "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm"
   },
   "environment": {

package/schemas/ipfs/collection/collection.schema.json

@@ -25,7 +25,7 @@
           "type": "string",
           "const": "Collection",
           "title": "Collection Schema Type",
-          "description": "Schema type identifier for this record"
+          "description": "Discriminator value identifying this record as a Collection grouping of credits and receipts"
         },
         "version": {
           "type": "string",
@@ -74,7 +74,7 @@
       "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})$",
       "title": "External ID",
-      "description": "UUID identifier for external system references",
+      "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
       "examples": [
         "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
       ]
@@ -180,7 +180,7 @@
         "BOLD Brazil"
       ],
       "title": "Collection Name",
-      "description": "Display name of the collection",
+      "description": "Human-readable display name for the environmental credit collection",
       "examples": [
         "BOLD Cold Start - Carazinho",
         "BOLD Brazil"
@@ -195,7 +195,7 @@
         "bold-brazil"
       ],
       "title": "Collection Slug",
-      "description": "URL-friendly identifier for a collection",
+      "description": "URL-friendly identifier for an environmental credit collection, used in URIs and API references",
       "examples": [
         "bold-cold-start-carazinho",
         "bold-brazil"
@@ -236,6 +236,6 @@
   "additionalProperties": false,
   "title": "Collection IPFS Record",
   "description": "Collection metadata stored in IPFS, extending the base schema with collection-specific fields used to group and organize credit purchases and retirements in Carrot's ecosystem",
-  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/collection/collection.schema.json",
-  "version": "0.2.4"
-}
+  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/collection/collection.schema.json",
+  "version": "0.3.0"
+}

package/schemas/ipfs/credit/credit.example.json

@@ -1,9 +1,9 @@
 {
-  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/credit/credit.schema.json",
+  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/credit/credit.schema.json",
   "schema": {
-    "hash": "e79bd7aba0a859d8c7c1864177629322603a105b8e68ad6c51d324ecc2c621b6",
+    "hash": "e043c3689a769dfad05f4d20a83821e659266a61d7bfa3a01462d24a91c26e5e",
     "type": "Credit",
-    "version": "0.2.4",
+    "version": "0.3.0",
     "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm"
   },
   "environment": {
@@ -19,5 +19,5 @@
   "name": "Carrot Carbon (CH₄)",
   "decimals": 18,
   "image": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
-  "description": "Carrot Carbon (C-CARB.CH4) represents verified carbon emissions reductions from organic waste composting projects. Each token equals one metric ton of CO2 equivalent prevented from entering the atmosphere through sustainable waste management practices. These credits are generated through the BOLD Carbon methodology and provide transparent, traceable environmental impact."
+  "description": "Carrot Carbon (C-CARB.CH4) represents verified prevented emissions from organic waste composting projects. Each token equals one metric ton of CO₂ equivalent (CO₂e) prevented from entering the atmosphere through sustainable waste management practices. These credits are generated through the BOLD Carbon methodology and provide transparent, traceable environmental impact."
 }

package/schemas/ipfs/credit/credit.schema.json

@@ -25,7 +25,7 @@
           "type": "string",
           "const": "Credit",
           "title": "Credit Schema Type",
-          "description": "Schema type identifier for this record"
+          "description": "Discriminator value identifying this record as a Credit environmental-impact token"
         },
         "version": {
           "type": "string",
@@ -74,7 +74,7 @@
       "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})$",
       "title": "External ID",
-      "description": "UUID identifier for external system references",
+      "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
       "examples": [
         "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
       ]
@@ -237,7 +237,7 @@
       "title": "Token Description",
       "description": "Comprehensive description of the credit token, its purpose, and impact",
       "examples": [
-        "Carrot Carbon (C-CARB.CH4) represents verified carbon emissions reductions from organic waste composting projects. Each token equals one metric ton of CO2 equivalent prevented from entering the atmosphere through sustainable waste management practices."
+        "Carrot Carbon (C-CARB.CH4) represents verified prevented emissions from organic waste composting projects. Each token equals one metric ton of CO₂ equivalent (CO₂e) prevented from entering the atmosphere through sustainable waste management practices."
       ]
     }
   },
@@ -257,6 +257,6 @@
   "additionalProperties": false,
   "title": "Credit IPFS Record",
   "description": "Credit token metadata stored in IPFS, extending the base schema with ERC20-specific details",
-  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/credit/credit.schema.json",
-  "version": "0.2.4"
-}
+  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/credit/credit.schema.json",
+  "version": "0.3.0"
+}

package/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.example.json

@@ -1,9 +1,9 @@
 {
-  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.schema.json",
+  "$schema": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.schema.json",
   "schema": {
-    "hash": "4c2acfb482d73246fc6bead2cbe0fe45c37d51ef6058eaba8da95501ec9a02e4",
+    "hash": "e8fb945c092cd457a352949a3aa2a12a8788ee9cc74d9196f17bd692c17121f1",
     "type": "CreditPurchaseReceipt",
-    "version": "0.2.4",
+    "version": "0.3.0",
     "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm"
   },
   "environment": {
@@ -12,7 +12,7 @@
     "data_set_name": "TEST"
   },
   "blockchain": {
-    "token_id": "987",
+    "token_id": "500001",
     "smart_contract_address": "0x742d35cc6634c0532925a3b8d8b5c2d4c7f8e1a9",
     "chain_id": 80002,
     "network_name": "Amoy"
@@ -20,13 +20,13 @@
   "created_at": "2025-02-03T12:45:30.000Z",
   "external_id": "f1a2b3c4-d5e6-4789-9012-34567890abcd",
   "external_url": "https://explore.carrot.eco/document/f1a2b3c4-d5e6-4789-9012-34567890abcd",
-  "audit_data_hash": "c49a39d9a4a265669682b8a147e5ecb439e8f31a304298db05b14497f064691b",
+  "audit_data_hash": "f0e1cc98d3ea5cb40e526e0ab601551c142f495609a6ac6c575a9c5550dfca03",
   "viewer_reference": {
     "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
     "integrity_hash": "87f633634cc4b02f628685651f0a29b7bfa22a0bd841f725c6772dd00a58d489"
   },
-  "name": "Credit Purchase Receipt #987 • 8.5 Credits Purchased",
-  "short_name": "Purchase Receipt #987",
+  "name": "Credit Purchase Receipt #500001 • 8.5 Credits Purchased",
+  "short_name": "Purchase Receipt #500001",
   "description": "Receipt for purchasing 8.5 credits (C-CARB.CH4 and C-BIOW) across 3 certificates, with 3.0 credits retired immediately on behalf of Climate Action Corp. Credits delivered to EcoTech Solutions Inc.",
   "image": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
   "background_color": "#2D5A27",
@@ -79,7 +79,7 @@
     },
     {
       "trait_type": "Retirement Receipt",
-      "value": "#1200"
+      "value": "#600001"
     }
   ],
   "data": {
@@ -127,7 +127,7 @@
         "slug": "biowaste",
         "symbol": "C-BIOW",
         "external_id": "e710790f-5909-4a54-ab89-6a59819472ee",
-        "external_url": "https://explore.carrot.eco/credit/9f3c4556-fg90-5ef8-9e06-8d925e6d9bg0",
+        "external_url": "https://explore.carrot.eco/credit/e710790f-5909-4a54-ab89-6a59819472ee",
         "ipfs_uri": "ipfs://bafybeicnuw2ytgukpr5uzmdyt6gdsbkq2xvula4odrqpnbx2ens4qfoywm",
         "smart_contract_address": "0xfedcba0987654321fedcba0987654321fedcba09"
       }
@@ -135,7 +135,7 @@
     "certificates": [
       {
         "type": "GasID",
-        "token_id": "456",
+        "token_id": "200001",
         "total_amount": 10,
         "credit_slug": "carbon-methane",
         "external_id": "d2a7f8e4-9c61-4e35-b8f2-a5c9e7d1b4f6",
@@ -150,7 +150,7 @@
           }
         ],
         "mass_id": {
-          "token_id": "1034",
+          "token_id": "100001",
           "external_id": "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "external_url": "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
@@ -159,7 +159,7 @@
       },
       {
         "type": "RecycledID",
-        "token_id": "789",
+        "token_id": "300001",
         "total_amount": 6,
         "credit_slug": "biowaste",
         "external_id": "f47ac10b-58cc-4372-a567-0e02b2c3d489",
@@ -174,7 +174,7 @@
           }
         ],
         "mass_id": {
-          "token_id": "1034",
+          "token_id": "100001",
           "external_id": "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "external_url": "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
@@ -198,7 +198,7 @@
           }
         ],
         "mass_id": {
-          "token_id": "1034",
+          "token_id": "100001",
           "external_id": "ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "external_url": "https://explore.carrot.eco/document/ad44dd3f-f176-4b98-bf78-5ee6e77d0530",
           "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
@@ -207,7 +207,7 @@
       }
     ],
     "retirement_receipt": {
-      "token_id": "1200",
+      "token_id": "600001",
       "external_id": "b2c3d4e5-f6a7-4c89-8a01-234567890abc",
       "external_url": "https://explore.carrot.eco/document/b2c3d4e5-f6a7-4c89-8a01-234567890abc",
       "ipfs_uri": "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",

package/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.schema.json

@@ -25,7 +25,7 @@
           "type": "string",
           "const": "CreditPurchaseReceipt",
           "title": "CreditPurchaseReceipt Schema Type",
-          "description": "Schema type identifier for this record"
+          "description": "Discriminator value identifying this record as a CreditPurchaseReceipt transaction proof"
         },
         "version": {
           "type": "string",
@@ -74,7 +74,7 @@
       "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})$",
       "title": "External ID",
-      "description": "UUID identifier for external system references",
+      "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
       "examples": [
         "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
       ]
@@ -173,7 +173,7 @@
               "minimum": 1,
               "maximum": 9007199254740991,
               "title": "Total Certificates",
-              "description": "Total number of certificates represented in the receipt",
+              "description": "Total number of certificates (GasID or RecycledID) included in this receipt",
               "examples": [
                 1,
                 123,
@@ -184,7 +184,7 @@
               "type": "number",
               "minimum": 0,
               "title": "Total Amount (USDC)",
-              "description": "Total amount paid in USDC for the purchase",
+              "description": "Total amount paid in USDC stablecoin for the credit purchase",
               "examples": [
                 0,
                 100.5,
@@ -196,11 +196,11 @@
               "type": "number",
               "minimum": 0,
               "title": "Total Credits",
-              "description": "Total amount of credits purchased",
+              "description": "Total number of environmental impact credits purchased in this transaction",
               "examples": [
-                0,
-                45.2,
-                72.5
+                1.5,
+                100,
+                2500.75
               ]
             },
             "purchased_at": {
@@ -222,7 +222,7 @@
           ],
           "additionalProperties": false,
           "title": "Credit Purchase Receipt Summary",
-          "description": "Summary totals for the credit purchase including amounts and collections represented"
+          "description": "Summary totals for the credit purchase including payment amount, credit quantity, certificate count, and timestamp"
         },
         "buyer": {
           "type": "object",
@@ -254,7 +254,7 @@
                   "minLength": 1,
                   "maxLength": 100,
                   "title": "Identity Name",
-                  "description": "Display name for the participant",
+                  "description": "Display name of the buyer or beneficiary on the receipt",
                   "examples": [
                     "EcoTech Solutions Inc.",
                     "Climate Action Corp"
@@ -265,7 +265,7 @@
                   "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})$",
                   "title": "Identity External ID",
-                  "description": "External identifier for the participant",
+                  "description": "Unique identifier for the buyer or beneficiary in the Carrot platform",
                   "examples": [
                     "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
                   ]
@@ -274,7 +274,7 @@
                   "type": "string",
                   "format": "uri",
                   "title": "Identity External URL",
-                  "description": "External URL for the participant profile",
+                  "description": "Link to the buyer or beneficiary profile page on the Carrot platform",
                   "examples": [
                     "https://explore.carrot.eco/",
                     "https://whitepaper.carrot.eco/"
@@ -288,7 +288,7 @@
               ],
               "additionalProperties": false,
               "title": "Identity",
-              "description": "Participant identity information"
+              "description": "Identity information for the buyer or beneficiary associated with this receipt"
             }
           },
           "required": [
@@ -313,7 +313,7 @@
                   "bold-brazil"
                 ],
                 "title": "Collection Slug",
-                "description": "URL-friendly identifier for a collection",
+                "description": "URL-friendly identifier for an environmental credit collection, used in URIs and API references",
                 "examples": [
                   "bold-cold-start-carazinho",
                   "bold-brazil"
@@ -324,7 +324,7 @@
                 "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})$",
                 "title": "Collection External ID",
-                "description": "External identifier for the collection",
+                "description": "Unique identifier for the collection in the Carrot platform",
                 "examples": [
                   "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
                 ]
@@ -338,7 +338,7 @@
                   "BOLD Brazil"
                 ],
                 "title": "Collection Name",
-                "description": "Display name of the collection",
+                "description": "Human-readable display name for the environmental credit collection",
                 "examples": [
                   "BOLD Cold Start - Carazinho",
                   "BOLD Brazil"
@@ -348,7 +348,7 @@
                 "type": "string",
                 "format": "uri",
                 "title": "Collection External URL",
-                "description": "External URL for the collection",
+                "description": "Link to the collection page on the Carrot platform",
                 "examples": [
                   "https://explore.carrot.eco/",
                   "https://whitepaper.carrot.eco/"
@@ -359,7 +359,7 @@
                 "minLength": 1,
                 "pattern": "^ipfs:\\/\\/(?:Qm[1-9A-HJ-NP-Za-km-z]{44}|[bB][a-z2-7]{58,}|[zZ][1-9A-HJ-NP-Za-km-z]{48,})(?:\\/[^\\s]*)?$",
                 "title": "Collection IPFS URI",
-                "description": "IPFS URI for the collection metadata",
+                "description": "IPFS URI pointing to the immutable collection metadata record",
                 "examples": [
                   "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
                   "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku"
@@ -378,7 +378,7 @@
             "description": "Collection included in the purchase"
           },
           "title": "Collections",
-          "description": "Collections included in the purchase"
+          "description": "Impact collections referenced by this purchase, each identified by a unique slug"
         },
         "credits": {
           "minItems": 1,
@@ -391,7 +391,7 @@
                 "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})$",
                 "title": "External ID",
-                "description": "UUID identifier for external system references",
+                "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
                 "examples": [
                   "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
                 ]
@@ -466,7 +466,7 @@
             "description": "Credit token included in the purchase"
           },
           "title": "Credits",
-          "description": "Credits included in the purchase"
+          "description": "Credit token types involved in this purchase, each identified by a unique slug and symbol"
         },
         "certificates": {
           "minItems": 1,
@@ -479,7 +479,7 @@
                 "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})$",
                 "title": "External ID",
-                "description": "UUID identifier for external system references",
+                "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
                 "examples": [
                   "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
                 ]
@@ -532,7 +532,7 @@
                   "RecycledID"
                 ],
                 "title": "Certificate Type",
-                "description": "Type of certificate (e.g., GasID, RecycledID)",
+                "description": "Type of certificate — GasID for methane prevention, RecycledID for waste recycling",
                 "examples": [
                   "GasID",
                   "RecycledID"
@@ -544,9 +544,9 @@
                 "title": "Certificate Total Amount",
                 "description": "Total credits available in this certificate",
                 "examples": [
-                  0,
-                  45.2,
-                  72.5
+                  1.5,
+                  100,
+                  2500.75
                 ]
               },
               "mass_id": {
@@ -557,7 +557,7 @@
                     "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})$",
                     "title": "External ID",
-                    "description": "UUID identifier for external system references",
+                    "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
                     "examples": [
                       "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
                     ]
@@ -643,7 +643,7 @@
                         "bold-brazil"
                       ],
                       "title": "Collection Slug",
-                      "description": "Slug of the collection",
+                      "description": "URL-friendly identifier of the collection this certificate belongs to",
                       "examples": [
                         "bold-cold-start-carazinho",
                         "bold-brazil"
@@ -652,12 +652,12 @@
                     "purchased_amount": {
                       "type": "number",
                       "minimum": 0,
-                      "title": "Collection Purchased Amount",
-                      "description": "Credits purchased from this collection for this certificate",
+                      "title": "Purchased Amount",
+                      "description": "Number of credits purchased from this collection for this certificate",
                       "examples": [
-                        0,
-                        45.2,
-                        72.5
+                        1.5,
+                        100,
+                        2500.75
                       ]
                     },
                     "retired_amount": {
@@ -666,9 +666,9 @@
                       "title": "Collection Retired Amount",
                       "description": "Credits retired from this collection for this certificate (0 if none)",
                       "examples": [
-                        0,
-                        45.2,
-                        72.5
+                        1.5,
+                        100,
+                        2500.75
                       ]
                     }
                   },
@@ -702,7 +702,7 @@
             "description": "Certificate associated with the purchase"
           },
           "title": "Certificates",
-          "description": "Certificates involved in the purchase"
+          "description": "Environmental certificates allocated in this purchase, each linking a credit type to collection-level purchased and retired amounts"
         },
         "retirement_receipt": {
           "type": "object",
@@ -712,7 +712,7 @@
               "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})$",
               "title": "External ID",
-              "description": "UUID identifier for external system references",
+              "description": "UUID v4 identifier linking this IPFS record to its counterpart in the Carrot platform and other consuming systems",
               "examples": [
                 "ad44dd3f-f176-4b98-bf78-5ee6e77d0530"
               ]
@@ -938,8 +938,8 @@
             "title": "Link Label",
             "description": "Display name for the external link",
             "examples": [
-              "Example text",
-              "Sample value"
+              "example-value",
+              "Hello World"
             ]
           },
           "url": {
@@ -987,9 +987,9 @@
                 "title": "Total Credits Purchased",
                 "description": "Total number of credits purchased across all tokens",
                 "examples": [
-                  0,
-                  45.2,
-                  72.5
+                  1.5,
+                  100,
+                  2500.75
                 ]
               },
               "display_type": {
@@ -1030,9 +1030,9 @@
                 "title": "Total Amount (USDC)",
                 "description": "Total USDC amount paid for the purchase",
                 "examples": [
-                  0,
-                  45.2,
-                  72.5
+                  1.5,
+                  100,
+                  2500.75
                 ]
               },
               "display_type": {
@@ -1206,10 +1206,10 @@
                 "title": "Retirement Receipt Token ID",
                 "description": "Token ID of the retirement receipt NFT as #<token_id> (if retirement occurred)",
                 "examples": [
-                  "Example text",
-                  "Sample value"
+                  "#456789",
+                  "#1000000"
                 ],
-                "example": "#123"
+                "example": "#456789"
               },
               "display_type": {
                 "title": "Display Type",
@@ -1264,9 +1264,9 @@
                 "title": "Credit Amount",
                 "description": "Amount of credits purchased for the token symbol",
                 "examples": [
-                  0,
-                  45.2,
-                  72.5
+                  1.5,
+                  100,
+                  2500.75
                 ]
               },
               "display_type": {
@@ -1319,7 +1319,7 @@
   ],
   "additionalProperties": false,
   "title": "CreditPurchaseReceipt NFT IPFS Record",
-  "description": "Complete CreditPurchaseReceipt NFT IPFS record including attributes and credit purchase data",
-  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.2.4/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.schema.json",
-  "version": "0.2.4"
-}
+  "description": "Complete CreditPurchaseReceipt NFT IPFS record including purchase summary, buyer details, credit breakdowns, certificate allocations, and NFT display attributes",
+  "$id": "https://raw.githubusercontent.com/carrot-foundation/schemas/refs/tags/0.3.0/schemas/ipfs/credit-purchase-receipt/credit-purchase-receipt.schema.json",
+  "version": "0.3.0"
+}