@carrot-foundation/schemas 0.5.0 → 1.0.0

package/dist/index.js

@@ -28136,12 +28136,11 @@ var StringifiedTokenIdSchema = NonEmptyStringSchema.regex(
   examples: ["#456789", "#1000000"],
   example: "#456789"
 });
-var Sha256HashSchema = z.hash("sha256", {
-  error: "Must be a SHA256 hash as 32-byte hex string"
+var Sha256HashSchema = z.string().regex(/^[a-f0-9]{64}$/, {
+  error: "Must be a SHA-256 hash as 32-byte lowercase hex string (no 0x prefix)"
 }).meta({
-  format: void 0,
   title: "SHA-256 Hash",
-  description: "SHA-256 cryptographic hash as hexadecimal string",
+  description: "SHA-256 cryptographic hash as canonical lowercase hexadecimal string",
   examples: [
     "87f633634cc4b02f628685651f0a29b7bfa22a0bd841f725c6772dd00a58d489"
   ]
@@ -28604,7 +28603,7 @@ var NftIpfsSchema = BaseIpfsSchema.safeExtend({
     "External link URLs must be unique"
   ).optional().meta({
     title: "External Links",
-    description: "Optional list of public resource links with labels"
+    description: "Supplementary reference links (label, URL, optional description) displayed on the NFT page"
   }),
   attributes: uniqueBy(
     NftAttributeSchema,
@@ -29416,7 +29415,7 @@ var ReceiptIdentitySchema = z.strictObject({
   }),
   external_id: ExternalIdSchema.optional().meta({
     title: "Identity External ID",
-    description: "Unique identifier for the buyer or beneficiary in the Carrot platform"
+    description: "Unique identifier of the associated entity in the Carrot platform"
   }),
   external_url: ExternalUrlSchema.optional().meta({
     title: "Identity External URL",
@@ -29485,7 +29484,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.5.0";
+  return "1.0.0";
 }
 
 // src/shared/schema-validation.ts
@@ -30059,7 +30058,7 @@ var MassIDWastePropertiesSchema = z.strictObject({
   local_classification: MassIDLocalClassificationSchema.optional(),
   weight_kg: WeightKgSchema.meta({
     title: "Net Weight",
-    description: "Net weight of the waste batch in kilograms (kg)",
+    description: "Weight in kilograms of the entire waste batch tracked through the chain of custody",
     examples: [3e3]
   })
 }).meta({
@@ -30102,7 +30101,7 @@ var MassIDBaseEventSchema = z.strictObject({
   participant_id_hash: ParticipantIdHashSchema,
   location_id_hash: Sha256HashSchema.meta({
     title: "Location ID Hash",
-    description: "Reference to location in the locations array"
+    description: "Hash reference to the geographic location where this event occurred; matches an entry in `data.locations`"
   })
 }).meta({
   title: "MassID Base Event",
@@ -31036,7 +31035,7 @@ var CreditPurchaseReceiptBuyerAttributeSchema = NftAttributeSchema.omit({
 var CreditPurchaseReceiptRetirementDateAttributeSchema = createDateAttributeSchema({
   traitType: "Retirement Date",
   title: "Retirement Date",
-  description: "Unix timestamp in milliseconds when credits were retired (if retirement occurred)"
+  description: "Unix timestamp in milliseconds when credits were retired; present in the attributes array only when the purchase has been retired (data.retirement_receipt is set)"
 });
 var CreditPurchaseReceiptRetirementReceiptAttributeSchema = NftAttributeSchema.safeExtend({
   trait_type: z.literal("Retirement Receipt"),
@@ -31080,18 +31079,18 @@ var CreditPurchaseReceiptAttributesSchema = createOrderedAttributesSchema({
 });
 var CreditPurchaseReceiptIdentitySchema = ReceiptIdentitySchema;
 var CreditPurchaseReceiptBuyerSchema = z.strictObject({
-  wallet_address: EthereumAddressSchema.meta({
+  id_hash: Sha256HashSchema.meta({
+    title: "Buyer ID Hash",
+    description: "Anonymized pseudonymous identifier linking this buyer to off-chain records via a keyed hash"
+  }),
+  wallet_address: EthereumAddressSchema.optional().meta({
     title: "Buyer Wallet Address",
     description: "Ethereum address receiving the credits"
   }),
-  id: ExternalIdSchema.optional().meta({
-    title: "Buyer ID",
-    description: "Unique identifier for the buyer"
-  }),
   identity: CreditPurchaseReceiptIdentitySchema.optional()
 }).meta({
   title: "Buyer",
-  description: "Buyer information including wallet address, optional ID, and optional identity"
+  description: "Buyer information including hashed identifier, optional wallet address, and optional identity"
 });
 var CreditPurchaseReceiptCollectionSchema = createReceiptCollectionSchema({
   meta: {
@@ -31507,24 +31506,32 @@ var CreditRetirementReceiptAttributesSchema = createOrderedAttributesSchema({
 });
 var CreditRetirementReceiptIdentitySchema = ReceiptIdentitySchema;
 var CreditRetirementReceiptBeneficiarySchema = z.strictObject({
-  beneficiary_id: ExternalIdSchema.meta({
-    title: "Retirement Beneficiary ID",
-    description: "UUID identifying the beneficiary of the retirement (bytes16 normalized to UUID)"
+  id_hash: Sha256HashSchema.meta({
+    title: "Beneficiary ID Hash",
+    description: "Anonymized pseudonymous identifier linking this beneficiary to off-chain records via a keyed hash"
+  }),
+  wallet_address: EthereumAddressSchema.optional().meta({
+    title: "Beneficiary Wallet Address",
+    description: "Ethereum address associated with the beneficiary, when available"
   }),
   identity: CreditRetirementReceiptIdentitySchema.optional()
 }).meta({
   title: "Beneficiary",
-  description: "Beneficiary receiving the retirement benefit"
+  description: "Beneficiary receiving the retirement benefit, identified by a hashed identifier with optional wallet address and identity"
 });
 var CreditRetirementReceiptCreditHolderSchema = z.strictObject({
-  wallet_address: EthereumAddressSchema.meta({
+  id_hash: Sha256HashSchema.meta({
+    title: "Credit Holder ID Hash",
+    description: "Anonymized pseudonymous identifier linking this credit holder to off-chain records via a keyed hash"
+  }),
+  wallet_address: EthereumAddressSchema.optional().meta({
     title: "Credit Holder Wallet Address",
-    description: "Ethereum address of the credit holder surrendering credits"
+    description: "Ethereum address of the wallet that held and surrendered the credits"
   }),
   identity: CreditRetirementReceiptIdentitySchema.optional()
 }).meta({
   title: "Credit Holder",
-  description: "Credit holder wallet and optional identity information"
+  description: "Credit holder information including hashed identifier, optional wallet address, and optional identity"
 });
 var CreditRetirementReceiptCollectionSchema = createReceiptCollectionSchema({
   meta: {