@carrot-foundation/schemas 0.4.2 → 0.5.1

package/dist/index.d.cts

@@ -1943,18 +1943,18 @@ declare const CreditPurchaseReceiptAttributesSchema: z.ZodArray<z.ZodObject<{
 type CreditPurchaseReceiptAttributes = z.infer<typeof CreditPurchaseReceiptAttributesSchema>;
 
 declare const CreditPurchaseReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type CreditPurchaseReceiptIdentity = z.infer<typeof CreditPurchaseReceiptIdentitySchema>;
 declare const CreditPurchaseReceiptBuyerSchema: z.ZodObject<{
     wallet_address: z.ZodString;
     id: z.ZodOptional<z.ZodUUID>;
     identity: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditPurchaseReceiptBuyer = z.infer<typeof CreditPurchaseReceiptBuyerSchema>;
@@ -2044,9 +2044,9 @@ declare const CreditPurchaseReceiptDataSchema: z.ZodObject<{
         wallet_address: z.ZodString;
         id: z.ZodOptional<z.ZodUUID>;
         identity: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
     collections: z.ZodArray<z.ZodObject<{
@@ -2202,9 +2202,9 @@ declare const CreditPurchaseReceiptIpfsSchema: z.ZodObject<{
             wallet_address: z.ZodString;
             id: z.ZodOptional<z.ZodUUID>;
             identity: z.ZodOptional<z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
             }, z.core.$strict>>;
         }, z.core.$strict>;
         collections: z.ZodArray<z.ZodObject<{
@@ -2296,26 +2296,26 @@ declare const CreditRetirementReceiptAttributesSchema: z.ZodArray<z.ZodObject<{
 type CreditRetirementReceiptAttributes = z.infer<typeof CreditRetirementReceiptAttributesSchema>;
 
 declare const CreditRetirementReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type CreditRetirementReceiptIdentity = z.infer<typeof CreditRetirementReceiptIdentitySchema>;
 declare const CreditRetirementReceiptBeneficiarySchema: z.ZodObject<{
     beneficiary_id: z.ZodUUID;
-    identity: z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
-    }, z.core.$strict>;
+    identity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditRetirementReceiptBeneficiary = z.infer<typeof CreditRetirementReceiptBeneficiarySchema>;
 declare const CreditRetirementReceiptCreditHolderSchema: z.ZodObject<{
     wallet_address: z.ZodString;
     identity: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditRetirementReceiptCreditHolder = z.infer<typeof CreditRetirementReceiptCreditHolderSchema>;
@@ -2416,18 +2416,18 @@ declare const CreditRetirementReceiptDataSchema: z.ZodObject<{
     }, z.core.$strict>;
     beneficiary: z.ZodObject<{
         beneficiary_id: z.ZodUUID;
-        identity: z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
-        }, z.core.$strict>;
+        identity: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     credit_holder: z.ZodObject<{
         wallet_address: z.ZodString;
         identity: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
     collections: z.ZodArray<z.ZodObject<{
@@ -2514,7 +2514,7 @@ type CreditRetirementReceiptData = z.infer<typeof CreditRetirementReceiptDataSch
 
 declare const CreditRetirementReceiptIpfsSchemaMeta: {
     readonly title: "CreditRetirementReceipt NFT IPFS Record";
-    readonly description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details, credit breakdowns, certificate allocations, and NFT display attributes";
+    readonly description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details (identity optional), credit breakdowns, certificate allocations, and NFT display attributes";
     readonly $id: string;
     readonly version: string;
 };
@@ -2588,18 +2588,18 @@ declare const CreditRetirementReceiptIpfsSchema: z.ZodObject<{
         }, z.core.$strict>;
         beneficiary: z.ZodObject<{
             beneficiary_id: z.ZodUUID;
-            identity: z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
-            }, z.core.$strict>;
+            identity: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
         credit_holder: z.ZodObject<{
             wallet_address: z.ZodString;
             identity: z.ZodOptional<z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
             }, z.core.$strict>>;
         }, z.core.$strict>;
         collections: z.ZodArray<z.ZodObject<{
@@ -3926,9 +3926,9 @@ declare const CreditRetirementReceiptSummarySchema: z.ZodObject<{
 }, z.core.$strict>;
 type CreditRetirementReceiptSummary = z.infer<typeof CreditRetirementReceiptSummarySchema>;
 declare const ReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type ReceiptIdentity = z.infer<typeof ReceiptIdentitySchema>;
 declare function createReceiptCollectionSchema(params: {

package/dist/index.d.ts

@@ -1943,18 +1943,18 @@ declare const CreditPurchaseReceiptAttributesSchema: z.ZodArray<z.ZodObject<{
 type CreditPurchaseReceiptAttributes = z.infer<typeof CreditPurchaseReceiptAttributesSchema>;
 
 declare const CreditPurchaseReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type CreditPurchaseReceiptIdentity = z.infer<typeof CreditPurchaseReceiptIdentitySchema>;
 declare const CreditPurchaseReceiptBuyerSchema: z.ZodObject<{
     wallet_address: z.ZodString;
     id: z.ZodOptional<z.ZodUUID>;
     identity: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditPurchaseReceiptBuyer = z.infer<typeof CreditPurchaseReceiptBuyerSchema>;
@@ -2044,9 +2044,9 @@ declare const CreditPurchaseReceiptDataSchema: z.ZodObject<{
         wallet_address: z.ZodString;
         id: z.ZodOptional<z.ZodUUID>;
         identity: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
     collections: z.ZodArray<z.ZodObject<{
@@ -2202,9 +2202,9 @@ declare const CreditPurchaseReceiptIpfsSchema: z.ZodObject<{
             wallet_address: z.ZodString;
             id: z.ZodOptional<z.ZodUUID>;
             identity: z.ZodOptional<z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
             }, z.core.$strict>>;
         }, z.core.$strict>;
         collections: z.ZodArray<z.ZodObject<{
@@ -2296,26 +2296,26 @@ declare const CreditRetirementReceiptAttributesSchema: z.ZodArray<z.ZodObject<{
 type CreditRetirementReceiptAttributes = z.infer<typeof CreditRetirementReceiptAttributesSchema>;
 
 declare const CreditRetirementReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type CreditRetirementReceiptIdentity = z.infer<typeof CreditRetirementReceiptIdentitySchema>;
 declare const CreditRetirementReceiptBeneficiarySchema: z.ZodObject<{
     beneficiary_id: z.ZodUUID;
-    identity: z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
-    }, z.core.$strict>;
+    identity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditRetirementReceiptBeneficiary = z.infer<typeof CreditRetirementReceiptBeneficiarySchema>;
 declare const CreditRetirementReceiptCreditHolderSchema: z.ZodObject<{
     wallet_address: z.ZodString;
     identity: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        external_id: z.ZodUUID;
-        external_url: z.ZodURL;
+        name: z.ZodOptional<z.ZodString>;
+        external_id: z.ZodOptional<z.ZodUUID>;
+        external_url: z.ZodOptional<z.ZodURL>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 type CreditRetirementReceiptCreditHolder = z.infer<typeof CreditRetirementReceiptCreditHolderSchema>;
@@ -2416,18 +2416,18 @@ declare const CreditRetirementReceiptDataSchema: z.ZodObject<{
     }, z.core.$strict>;
     beneficiary: z.ZodObject<{
         beneficiary_id: z.ZodUUID;
-        identity: z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
-        }, z.core.$strict>;
+        identity: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     credit_holder: z.ZodObject<{
         wallet_address: z.ZodString;
         identity: z.ZodOptional<z.ZodObject<{
-            name: z.ZodString;
-            external_id: z.ZodUUID;
-            external_url: z.ZodURL;
+            name: z.ZodOptional<z.ZodString>;
+            external_id: z.ZodOptional<z.ZodUUID>;
+            external_url: z.ZodOptional<z.ZodURL>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
     collections: z.ZodArray<z.ZodObject<{
@@ -2514,7 +2514,7 @@ type CreditRetirementReceiptData = z.infer<typeof CreditRetirementReceiptDataSch
 
 declare const CreditRetirementReceiptIpfsSchemaMeta: {
     readonly title: "CreditRetirementReceipt NFT IPFS Record";
-    readonly description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details, credit breakdowns, certificate allocations, and NFT display attributes";
+    readonly description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details (identity optional), credit breakdowns, certificate allocations, and NFT display attributes";
     readonly $id: string;
     readonly version: string;
 };
@@ -2588,18 +2588,18 @@ declare const CreditRetirementReceiptIpfsSchema: z.ZodObject<{
         }, z.core.$strict>;
         beneficiary: z.ZodObject<{
             beneficiary_id: z.ZodUUID;
-            identity: z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
-            }, z.core.$strict>;
+            identity: z.ZodOptional<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
         credit_holder: z.ZodObject<{
             wallet_address: z.ZodString;
             identity: z.ZodOptional<z.ZodObject<{
-                name: z.ZodString;
-                external_id: z.ZodUUID;
-                external_url: z.ZodURL;
+                name: z.ZodOptional<z.ZodString>;
+                external_id: z.ZodOptional<z.ZodUUID>;
+                external_url: z.ZodOptional<z.ZodURL>;
             }, z.core.$strict>>;
         }, z.core.$strict>;
         collections: z.ZodArray<z.ZodObject<{
@@ -3926,9 +3926,9 @@ declare const CreditRetirementReceiptSummarySchema: z.ZodObject<{
 }, z.core.$strict>;
 type CreditRetirementReceiptSummary = z.infer<typeof CreditRetirementReceiptSummarySchema>;
 declare const ReceiptIdentitySchema: z.ZodObject<{
-    name: z.ZodString;
-    external_id: z.ZodUUID;
-    external_url: z.ZodURL;
+    name: z.ZodOptional<z.ZodString>;
+    external_id: z.ZodOptional<z.ZodUUID>;
+    external_url: z.ZodOptional<z.ZodURL>;
 }, z.core.$strict>;
 type ReceiptIdentity = z.infer<typeof ReceiptIdentitySchema>;
 declare function createReceiptCollectionSchema(params: {

package/dist/index.js

@@ -28604,7 +28604,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,
@@ -29409,22 +29409,27 @@ var CreditRetirementReceiptSummarySchema = SummaryBaseSchema.safeExtend({
   description: "Summary totals for the credit retirement including credit quantity, certificate count, and timestamp"
 });
 var ReceiptIdentitySchema = z.strictObject({
-  name: NonEmptyStringSchema.max(100).meta({
+  name: NonEmptyStringSchema.max(100).optional().meta({
     title: "Identity Name",
     description: "Display name of the buyer or beneficiary on the receipt",
     examples: ["EcoTech Solutions Inc.", "Climate Action Corp"]
   }),
-  external_id: ExternalIdSchema.meta({
+  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.meta({
+  external_url: ExternalUrlSchema.optional().meta({
     title: "Identity External URL",
     description: "Link to the buyer or beneficiary profile page on the Carrot platform"
   })
-}).meta({
+}).refine(
+  (value) => value.name !== void 0 || value.external_id !== void 0 || value.external_url !== void 0,
+  {
+    message: "identity must include at least one of: name, external_id, external_url"
+  }
+).meta({
   title: "Identity",
-  description: "Identity information for the buyer or beneficiary associated with this receipt"
+  description: "Identity information for the buyer or beneficiary associated with this receipt. All fields are optional, but at least one must be provided when the identity block is present."
 });
 function createReceiptCollectionSchema(params) {
   const { meta } = params;
@@ -29480,7 +29485,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.4.2";
+  return "0.5.1";
 }
 
 // src/shared/schema-validation.ts
@@ -30054,7 +30059,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({
@@ -30097,7 +30102,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",
@@ -31031,7 +31036,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"),
@@ -31473,11 +31478,11 @@ var CreditRetirementReceiptPurchaseReceiptAttributeSchema = NftAttributeSchema.s
 });
 var REQUIRED_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
   CreditRetirementReceiptTotalCreditsAttributeSchema,
-  CreditRetirementReceiptBeneficiaryAttributeSchema,
   CreditRetirementReceiptRetirementDateAttributeSchema,
   CreditRetirementReceiptCertificatesAttributeSchema
 ];
 var CONDITIONAL_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
+  CreditRetirementReceiptBeneficiaryAttributeSchema,
   CreditRetirementReceiptCreditHolderAttributeSchema,
   CreditRetirementReceiptPurchaseDateAttributeSchema,
   CreditRetirementReceiptPurchaseReceiptAttributeSchema
@@ -31492,11 +31497,10 @@ var CreditRetirementReceiptAttributesSchema = createOrderedAttributesSchema({
     ...DYNAMIC_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES
   ],
   title: "Credit Retirement Receipt NFT Attribute Array",
-  description: "Attributes for credit retirement receipts including per-credit breakdowns, totals, beneficiary, credit holder, retirement date, certificate count, and optional purchase info. Fixed required attributes: Total Credits Retired, Beneficiary, Retirement Date, Certificates Retired. Conditional attributes: Credit Holder (required when credit_holder.identity.name is provided), Purchase Date (optional, when purchase_receipt is present), Purchase Receipt (optional, when purchase_receipt is present). Dynamic attributes: Credit attributes (one per credit symbol in data.credits).",
+  description: "Attributes for credit retirement receipts including per-credit breakdowns, totals, beneficiary, credit holder, retirement date, certificate count, and optional purchase info. Fixed required attributes: Total Credits Retired, Retirement Date, Certificates Retired. Conditional attributes: Beneficiary (required when beneficiary.identity.name is provided), Credit Holder (required when credit_holder.identity.name is provided), Purchase Date (optional, when purchase_receipt is present), Purchase Receipt (optional, when purchase_receipt is present). Dynamic attributes: Credit attributes (one per credit symbol in data.credits).",
   uniqueBySelector: (attribute) => attribute.trait_type,
   requiredTraitTypes: [
     "Total Credits Retired",
-    "Beneficiary",
     "Retirement Date",
     "Certificates Retired"
   ]
@@ -31505,9 +31509,9 @@ 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)"
+    description: "UUID identifying the beneficiary of the retirement within the Carrot platform"
   }),
-  identity: CreditRetirementReceiptIdentitySchema
+  identity: CreditRetirementReceiptIdentitySchema.optional()
 }).meta({
   title: "Beneficiary",
   description: "Beneficiary receiving the retirement benefit"
@@ -31515,7 +31519,7 @@ var CreditRetirementReceiptBeneficiarySchema = z.strictObject({
 var CreditRetirementReceiptCreditHolderSchema = z.strictObject({
   wallet_address: EthereumAddressSchema.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({
@@ -31727,7 +31731,7 @@ var CreditRetirementReceiptDataSchema = z.strictObject({
 });
 var CreditRetirementReceiptIpfsSchemaMeta = {
   title: "CreditRetirementReceipt NFT IPFS Record",
-  description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details, credit breakdowns, certificate allocations, and NFT display attributes",
+  description: "Complete CreditRetirementReceipt NFT IPFS record including retirement summary, beneficiary and credit holder details (identity optional), credit breakdowns, certificate allocations, and NFT display attributes",
   $id: buildSchemaUrl(
     "credit-retirement-receipt/credit-retirement-receipt.schema.json"
   ),
@@ -31797,14 +31801,17 @@ var CreditRetirementReceiptIpfsSchema = NftIpfsSchema.safeExtend({
     missingMessage: 'Attribute "Certificates Retired" is required',
     mismatchMessage: 'Attribute "Certificates Retired" must match data.summary.total_certificates'
   });
-  validateAttributeValue({
-    ctx,
-    attributeByTraitType,
-    traitType: "Beneficiary",
-    expectedValue: String(data.beneficiary.identity.name),
-    missingMessage: 'Attribute "Beneficiary" is required',
-    mismatchMessage: 'Attribute "Beneficiary" must match beneficiary.identity.name'
-  });
+  const beneficiaryName = data.beneficiary.identity?.name;
+  if (beneficiaryName) {
+    validateAttributeValue({
+      ctx,
+      attributeByTraitType,
+      traitType: "Beneficiary",
+      expectedValue: String(beneficiaryName),
+      missingMessage: 'Attribute "Beneficiary" is required when beneficiary.identity.name is provided',
+      mismatchMessage: 'Attribute "Beneficiary" must match beneficiary.identity.name'
+    });
+  }
   const creditHolderName = data.credit_holder.identity?.name;
   if (creditHolderName) {
     validateAttributeValue({