@carrot-foundation/schemas 0.1.54 → 0.1.56

package/dist/index.cjs

@@ -28077,17 +28077,17 @@ var BlockchainChainIdSchema = zod.z.union([
   zod.z.literal(BLOCKCHAIN_NETWORK_CONFIG.testnet.chain_id)
 ]).meta({
   title: "Chain ID",
-  description: "Supported Polygon chain identifiers",
+  description: "Blockchain network chain identifier (e.g., 137 for Polygon mainnet, 80002 for Amoy testnet)",
   examples: BLOCKCHAIN_CHAIN_IDS
 });
 var BlockchainNetworkNameSchema = zod.z.enum(BLOCKCHAIN_NETWORK_NAMES).meta({
   title: "Blockchain Network Name",
-  description: "Supported Polygon network names",
+  description: "Blockchain network name. Supported values include Polygon and Amoy",
   examples: BLOCKCHAIN_NETWORK_NAMES
 });
 var SmartContractAddressSchema = EthereumAddressSchema.meta({
   title: "Smart Contract Address",
-  description: "Address of the smart contract"
+  description: "Ethereum-compatible address of the smart contract that mints and manages this NFT"
 });
 var SmartContractSchema = zod.z.strictObject({
   address: SmartContractAddressSchema,
@@ -28111,7 +28111,7 @@ var TokenIdSchema = NonEmptyStringSchema.regex(
   "Must be a numeric string (supports uint256)"
 ).meta({
   title: "Token ID",
-  description: "Numeric identifier for blockchain tokens as string",
+  description: "Unique token identifier for this NFT within the smart contract",
   examples: ["456789", "1000000"]
 });
 var StringifiedTokenIdSchema = NonEmptyStringSchema.regex(
@@ -28145,7 +28145,7 @@ var IpfsUriSchema = NonEmptyStringSchema.regex(
   title: "IPFS URI",
   description: "InterPlanetary File System URI pointing to distributed content",
   examples: [
-    "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm/mass-id-organic.png",
+    "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
     "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku"
   ]
 });
@@ -28480,7 +28480,7 @@ var BlockchainReferenceSchema = zod.z.strictObject({
   }
 }).meta({
   title: "Blockchain Information",
-  description: "Blockchain-specific information for the NFT"
+  description: "Blockchain deployment information including smart contract address, network, and token identifier"
 });
 var ExternalLinkSchema = zod.z.strictObject({
   label: NonEmptyStringSchema.max(50).meta({
@@ -28532,7 +28532,7 @@ var NftIpfsSchema = BaseIpfsSchema.safeExtend({
   blockchain: BlockchainReferenceSchema,
   name: NonEmptyStringSchema.max(100).meta({
     title: "NFT Name",
-    description: "Full display name for this NFT, including extra context",
+    description: "Full display name for this NFT, typically including token identifier, waste type, and weight",
     examples: [
       "MassID #123 \u2022 Organic \u2022 3.0t",
       "RecycledID #456 \u2022 Plastic \u2022 2.5t",
@@ -28541,12 +28541,12 @@ var NftIpfsSchema = BaseIpfsSchema.safeExtend({
   }),
   short_name: NonEmptyStringSchema.max(50).meta({
     title: "Short Name",
-    description: "Compact name for UI summaries, tables, or tooltips",
+    description: "Compact name for UI summaries, tables, or tooltips, typically including token identifier",
     examples: ["MassID #123", "RecycledID #456", "GasID #789"]
   }),
   description: NonEmptyStringSchema.max(500).meta({
     title: "Description",
-    description: "Human-readable summary of the NFT's role and context. Ideally, maximum 300 characters.",
+    description: "Human-readable summary describing the waste batch, origin, processing method, and chain of custody. Ideally, maximum 300 characters.",
     examples: [
       "This MassID represents 3 metric tons of organic food waste from Enlatados Produ\xE7\xE3o, 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."
@@ -28554,18 +28554,18 @@ var NftIpfsSchema = BaseIpfsSchema.safeExtend({
   }),
   image: IpfsUriSchema.meta({
     title: "Image URI",
-    description: "IPFS URI pointing to the preview image"
+    description: "IPFS URI pointing to the NFT preview image displayed in marketplaces and wallets"
   }),
   background_color: HexColorSchema.optional().meta({
     title: "Background Color",
-    description: "Hex color code for marketplace background display"
+    description: "Hexadecimal color code used as background color in NFT marketplace displays"
   }),
   animation_url: IpfsUriSchema.optional().meta({
     title: "Animation URL",
-    description: "IPFS URI pointing to an animated or interactive media file",
+    description: "IPFS URI pointing to an animated or interactive media file for enhanced NFT display",
     examples: [
-      "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm/mass-id-animation.mp4",
-      "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku/recycled-visualization.webm"
+      "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm",
+      "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku"
     ]
   }),
   external_links: uniqueBy(
@@ -28632,6 +28632,29 @@ function mergeSchemaMeta(schema, newMeta) {
   }
   return merged;
 }
+function extractTraitType(schema) {
+  try {
+    if (typeof schema === "object" && schema !== null && "shape" in schema && typeof schema.shape === "object" && schema.shape !== null && "trait_type" in schema.shape) {
+      const traitTypeSchema = schema.shape.trait_type;
+      const literalSchema = traitTypeSchema;
+      if (literalSchema.value !== void 0 && typeof literalSchema.value === "string") {
+        return literalSchema.value;
+      }
+    }
+    const meta = getSchemaMetadata(schema);
+    if (meta?.title) {
+      const title = meta.title;
+      if (title.endsWith(" Attribute")) {
+        const inferred = title.slice(0, -11);
+        if (inferred.length > 3) {
+          return inferred;
+        }
+      }
+    }
+  } catch {
+  }
+  return "";
+}
 function createDateAttributeSchema(params) {
   const { omitMaxValue = true } = params;
   const base = omitMaxValue ? NftAttributeSchema.omit({ max_value: true }) : NftAttributeSchema;
@@ -28682,6 +28705,71 @@ function createNumericAttributeSchema(params) {
     description: `${params.description} attribute with numeric display`
   });
 }
+function createOrderedAttributesSchema(params) {
+  const {
+    required,
+    optional = [],
+    title,
+    description,
+    uniqueBySelector,
+    maxItems,
+    requiredTraitTypes,
+    optionalTraitTypes
+  } = params;
+  const allSchemas = [...required, ...optional];
+  let unionSchema;
+  if (allSchemas.length === 0) {
+    unionSchema = zod.z.never();
+  } else if (allSchemas.length === 1) {
+    unionSchema = allSchemas[0];
+  } else {
+    unionSchema = zod.z.union(
+      allSchemas
+    );
+  }
+  const requiredTypes = requiredTraitTypes ?? required.map(extractTraitType).filter(Boolean);
+  const optionalTypes = optionalTraitTypes ?? optional.map(extractTraitType).filter(Boolean);
+  const isDynamic = description.includes("Dynamic attributes");
+  const descriptionParts = [description];
+  if (requiredTypes.length > 0) {
+    descriptionParts.push(
+      `
+
+Required attributes (${required.length}): ${requiredTypes.join(", ")}`
+    );
+  }
+  if (optionalTypes.length > 0 && !isDynamic) {
+    descriptionParts.push(
+      `
+Optional attributes (${optional.length}): ${optionalTypes.join(", ")}`
+    );
+  }
+  let arraySchema = uniqueBy(unionSchema, uniqueBySelector).min(
+    required.length
+  );
+  if (maxItems !== void 0) {
+    arraySchema = arraySchema.max(maxItems);
+  } else if (optional.length > 0 && !isDynamic) {
+    arraySchema = arraySchema.max(required.length + optional.length);
+  }
+  return arraySchema.superRefine((attributes, ctx) => {
+    const traitTypes = new Set(
+      attributes.map(uniqueBySelector)
+    );
+    for (const traitType of requiredTypes) {
+      if (traitType && !traitTypes.has(traitType)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `Required attribute '${traitType}' is missing`,
+          path: []
+        });
+      }
+    }
+  }).meta({
+    title,
+    description: descriptionParts.join("")
+  });
+}
 var MethodologyAttributeSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Methodology"),
   value: MethodologyNameSchema
@@ -28741,7 +28829,7 @@ var OriginCityAttributeSchema = NftAttributeSchema.safeExtend({
   value: CitySchema
 }).meta({
   title: "Origin City Attribute",
-  description: "Origin municipality attribute"
+  description: "City or municipality where waste was originally generated and picked up"
 });
 var AuditResultSchema = zod.z.enum(["PASSED", "FAILED"]).meta({
   title: "Audit Result",
@@ -29357,7 +29445,7 @@ function buildSchemaUrl(schemaPath) {
   return `${getSchemaBaseUrl()}/${cleanPath}`;
 }
 function getSchemaVersionOrDefault() {
-  return "0.1.54";
+  return "0.1.56";
 }
 
 // src/shared/schema-validation.ts
@@ -29534,7 +29622,7 @@ var MassIDAttributeWasteTypeSchema = NftAttributeSchema.safeExtend({
   value: WasteTypeSchema
 }).meta({
   title: "Waste Type Attribute",
-  description: "Primary waste material category (e.g., Organic, Paper, Glass, Metal)"
+  description: "Primary waste material category"
 });
 var MassIDAttributeWasteSubtypeSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Waste Subtype"),
@@ -29557,7 +29645,7 @@ var MassIDAttributePickUpVehicleTypeSchema = NftAttributeSchema.safeExtend({
   })
 }).meta({
   title: "Pick-up Vehicle Type Attribute",
-  description: "Vehicle type used during pick-up"
+  description: "Type of vehicle used to transport waste from the origin location during pick-up"
 });
 var MassIDAttributeRecyclingMethodSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Recycling Method"),
@@ -29568,14 +29656,14 @@ var MassIDAttributeRecyclingMethodSchema = NftAttributeSchema.safeExtend({
   })
 }).meta({
   title: "Recycling Method Attribute",
-  description: "Process applied to this mass (e.g., composting, mechanical recycling)"
+  description: "Processing or recycling method applied to transform the waste material"
 });
 var MassIDAttributeLocalWasteClassificationIdSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Local Waste Classification ID"),
   value: IbamaWasteClassificationSchema
 }).meta({
   title: "Local Waste Classification ID Attribute",
-  description: "Regulatory waste classification code (e.g., Ibama format NN NN NN[*])"
+  description: "Regulatory waste classification code in Ibama format (NN NN NN with optional trailing asterisk)"
 });
 var MassIDAttributeRecyclingManifestCodeSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Recycling Manifest Number"),
@@ -29586,7 +29674,7 @@ var MassIDAttributeRecyclingManifestCodeSchema = NftAttributeSchema.safeExtend({
   })
 }).meta({
   title: "Recycling Manifest Number Attribute",
-  description: "Official recycling manifest number issued by recycling authority (optional)"
+  description: "Official recycling manifest document number issued by regulatory authorities, linked to the Recycling event (optional)"
 });
 var MassIDAttributeTransportManifestCodeSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Transport Manifest Number"),
@@ -29597,58 +29685,79 @@ var MassIDAttributeTransportManifestCodeSchema = NftAttributeSchema.safeExtend({
   })
 }).meta({
   title: "Transport Manifest Number Attribute",
-  description: "Official transport manifest number issued by logistics/transport authority (optional)"
+  description: "Official transport manifest document number issued by logistics authorities, linked to transport events (optional)"
 });
 var MassIDAttributeWeighingCaptureMethodSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Weighing Capture Method"),
   value: WeighingCaptureMethodSchema
 }).meta({
   title: "Weighing Capture Method Attribute",
-  description: "Weighing capture method attribute (optional)"
+  description: "Method used to capture weight measurements during weighing operations (optional)"
 });
 var MassIDAttributeScaleTypeSchema = NftAttributeSchema.safeExtend({
   trait_type: zod.z.literal("Scale Type"),
   value: ScaleTypeSchema
 }).meta({
   title: "Scale Type Attribute",
-  description: "Scale type attribute (optional)"
+  description: "Type of weighing equipment used to measure waste weight (optional)"
 });
 var MassIDAttributePickUpDateSchema = createDateAttributeSchema({
   traitType: "Pick-up Date",
   title: "Pick-up Date",
-  description: "Unix timestamp in milliseconds when the waste was picked up from the source"
+  description: "Unix timestamp in milliseconds when waste was picked up from the origin location"
 });
 var MassIDAttributeDropOffDateSchema = createDateAttributeSchema({
   traitType: "Drop-off Date",
   title: "Drop-off Date",
-  description: "Unix timestamp in milliseconds when the waste was dropped off at the destination"
+  description: "Unix timestamp in milliseconds when waste was delivered to the destination location"
 });
 var MassIDAttributeRecyclingDateSchema = createDateAttributeSchema({
   traitType: "Recycling Date",
   title: "Recycling Date",
-  description: "Unix timestamp in milliseconds when the waste was recycled/processed"
+  description: "Unix timestamp in milliseconds when waste recycling or processing was completed"
 });
-var MassIDAttributesSchema = uniqueBy(
-  zod.z.union([
-    MassIDAttributeWasteTypeSchema,
-    MassIDAttributeWasteSubtypeSchema,
-    MassIDAttributeWeightSchema,
-    MassIDAttributeOriginCitySchema,
-    MassIDAttributePickUpVehicleTypeSchema,
-    MassIDAttributeRecyclingMethodSchema,
-    MassIDAttributeLocalWasteClassificationIdSchema,
-    MassIDAttributeRecyclingManifestCodeSchema,
-    MassIDAttributeTransportManifestCodeSchema,
-    MassIDAttributeWeighingCaptureMethodSchema,
-    MassIDAttributeScaleTypeSchema,
-    MassIDAttributePickUpDateSchema,
-    MassIDAttributeDropOffDateSchema,
-    MassIDAttributeRecyclingDateSchema
-  ]),
-  (attr) => attr.trait_type
-).min(9).max(14).meta({
+var REQUIRED_MASS_ID_ATTRIBUTES = [
+  MassIDAttributeWasteTypeSchema,
+  MassIDAttributeWasteSubtypeSchema,
+  MassIDAttributeWeightSchema,
+  MassIDAttributeOriginCitySchema,
+  MassIDAttributePickUpVehicleTypeSchema,
+  MassIDAttributeRecyclingMethodSchema,
+  MassIDAttributePickUpDateSchema,
+  MassIDAttributeDropOffDateSchema,
+  MassIDAttributeRecyclingDateSchema
+];
+var OPTIONAL_MASS_ID_ATTRIBUTES = [
+  MassIDAttributeLocalWasteClassificationIdSchema,
+  MassIDAttributeRecyclingManifestCodeSchema,
+  MassIDAttributeTransportManifestCodeSchema,
+  MassIDAttributeWeighingCaptureMethodSchema,
+  MassIDAttributeScaleTypeSchema
+];
+var MassIDAttributesSchema = createOrderedAttributesSchema({
+  required: REQUIRED_MASS_ID_ATTRIBUTES,
+  optional: OPTIONAL_MASS_ID_ATTRIBUTES,
   title: "MassID Attributes",
-  description: "Array of NFT attributes describing waste characteristics, origin, logistics, and lifecycle events."
+  description: "Array of NFT attributes describing waste characteristics, origin, logistics, and lifecycle events.",
+  uniqueBySelector: (attr) => attr.trait_type,
+  requiredTraitTypes: [
+    "Waste Type",
+    "Waste Subtype",
+    "Weight (kg)",
+    "Origin City",
+    "Pick-up Vehicle Type",
+    "Recycling Method",
+    "Pick-up Date",
+    "Drop-off Date",
+    "Recycling Date"
+  ],
+  optionalTraitTypes: [
+    "Local Waste Classification ID",
+    "Recycling Manifest Number",
+    "Transport Manifest Number",
+    "Weighing Capture Method",
+    "Scale Type"
+  ]
 });
 var MassIDLocalClassificationSchema = zod.z.strictObject({
   code: IbamaWasteClassificationSchema,
@@ -29678,7 +29787,7 @@ var MassIDWastePropertiesSchema = zod.z.strictObject({
   })
 }).meta({
   title: "Waste Properties",
-  description: "Standardized waste material properties and regulatory information"
+  description: "Waste material classification, regulatory codes, and net weight for the tracked batch"
 });
 var MassIDAttachmentTypeSchema = zod.z.enum(["Recycling Manifest", "Transport Manifest"]).meta({
   title: "Attachment Type",
@@ -29689,7 +29798,7 @@ var MassIDAttachmentSchema = zod.z.strictObject({
   type: MassIDAttachmentTypeSchema,
   document_number: NonEmptyStringSchema.max(50).optional().meta({
     title: "Document Number",
-    description: "Official document number if applicable",
+    description: "Official regulatory document number issued by authorities, when applicable",
     examples: ["2353", "12345"]
   }),
   issued_at: IsoDateTimeSchema.optional().meta({
@@ -29728,7 +29837,7 @@ var MassIDBaseEventSchema = zod.z.strictObject({
 var buildMassIDEventSchema = (eventName, description) => MassIDBaseEventSchema.safeExtend({
   event_name: zod.z.literal(eventName).meta({
     title: "Event Name",
-    description: `${eventName} event discriminator`,
+    description: `Type of event, indicating this is a ${eventName} event`,
     examples: [eventName]
   })
 }).meta({
@@ -29737,7 +29846,7 @@ var buildMassIDEventSchema = (eventName, description) => MassIDBaseEventSchema.s
 });
 var PickUpEventSchema = buildMassIDEventSchema(
   "Pick-up",
-  "Waste picked up from the origin location"
+  "Waste collected from the origin location"
 ).safeExtend({
   data: zod.z.strictObject({
     vehicle_type: VehicleTypeSchema.optional().meta({
@@ -29745,7 +29854,7 @@ var PickUpEventSchema = buildMassIDEventSchema(
     }),
     weight_kg: WeightKgSchema.optional().meta({
       title: "Pick-up Waste Weight",
-      description: "Weight of the waste picked up at the origin location in kilograms (kg)"
+      description: "Weight of waste collected at the origin location, measured in kilograms (kg)"
     })
   }).optional().meta({
     title: "Pick-up Event Data",
@@ -29760,7 +29869,7 @@ var WeighingEventSchema = buildMassIDEventSchema(
     weighing_capture_method: WeighingCaptureMethodSchema.optional(),
     scale_type: ScaleTypeSchema.optional(),
     container_type: ContainerTypeSchema.optional().meta({
-      description: "Type of container holding the waste during weighing"
+      description: "Type of container or vehicle holding the waste material during the weighing operation"
     }),
     vehicle_type: VehicleTypeSchema.optional().meta({
       description: "Type of vehicle used during weighing"
@@ -29779,12 +29888,12 @@ var WeighingEventSchema = buildMassIDEventSchema(
     })
   }).optional().meta({
     title: "Weighing Event Data",
-    description: "Weighing operational details including capture method, equipment, and weights"
+    description: "Weighing operational details including capture method, scale type, container or vehicle information, and weight measurements"
   })
 });
 var DropOffEventSchema = buildMassIDEventSchema(
   "Drop-off",
-  "Waste delivered to a destination location"
+  "Waste delivered to the destination location"
 );
 var SortingEventSchema = buildMassIDEventSchema(
   "Sorting",
@@ -29801,12 +29910,12 @@ var SortingEventSchema = buildMassIDEventSchema(
     })
   }).optional().meta({
     title: "Sorting Event Data",
-    description: "Weights associated with sorting, including initial and deducted amounts"
+    description: "Weight measurements for sorting operations: initial weight entering the process and weight deducted (contaminants, moisture, etc.)"
   })
 });
 var RecyclingEventSchema = buildMassIDEventSchema(
   "Recycling",
-  "Waste processed or recycled at the destination"
+  "Waste processing or recycling completion event, marking the final transformation of waste material"
 );
 var MassIDEventSchema = zod.z.discriminatedUnion("event_name", [
   PickUpEventSchema,
@@ -29834,7 +29943,7 @@ var MassIDEventsSchema = zod.z.array(MassIDEventSchema).min(1).superRefine((even
   });
 }).meta({
   title: "MassID Events",
-  description: "Chronological sequence of custody transfer, processing, and recycling events"
+  description: "Chronological sequence of waste lifecycle events: Pick-up, Weighing, Drop-off, Sorting, and Recycling operations"
 });
 var MassIDDataSchema = zod.z.strictObject({
   waste_properties: MassIDWastePropertiesSchema,
@@ -29844,7 +29953,7 @@ var MassIDDataSchema = zod.z.strictObject({
     "Location ID hashes must be unique"
   ).min(1).meta({
     title: "Locations",
-    description: "All locations referenced in this MassID, indexed by ID"
+    description: "Geographic locations involved in the waste chain of custody, including origin, processing, and destination sites"
   }),
   participants: uniqueBy(
     ParticipantSchema,
@@ -29852,12 +29961,12 @@ var MassIDDataSchema = zod.z.strictObject({
     "Participant ID hashes must be unique"
   ).min(1).meta({
     title: "Participants",
-    description: "All participants referenced in this MassID, indexed by ID"
+    description: "Supply chain participants involved in waste management operations. Roles include Waste Generator, Hauler, Processor, Recycler, Network Integrator, Methodology Author, Methodology Developer, Network, and Community Impact Pool"
   }),
   events: MassIDEventsSchema,
   attachments: zod.z.array(MassIDAttachmentSchema).optional().meta({
     title: "Attachments",
-    description: "Supporting documents associated with events, linked by event_id"
+    description: "Official regulatory documents linked to specific chain of custody events via event_id. Document types include Transport Manifest and Recycling Manifest"
   })
 }).refine((data) => {
   const participantIdSet = new Set(
@@ -29904,7 +30013,7 @@ var isDropOffEvent = (event) => event.event_name === "Drop-off";
 var isRecyclingEvent = (event) => event.event_name === "Recycling";
 var MassIDIpfsSchemaMeta = {
   title: "MassID NFT IPFS Record",
-  description: "Complete MassID NFT IPFS record including fixed attributes and detailed waste tracking data",
+  description: "Complete MassID NFT IPFS record schema defining waste tracking metadata, chain of custody events, and NFT display attributes",
   $id: buildSchemaUrl("mass-id/mass-id.schema.json"),
   version: getSchemaVersionOrDefault()
 };
@@ -29912,7 +30021,7 @@ var MassIDIpfsSchema = NftIpfsSchema.safeExtend({
   schema: NftIpfsSchema.shape.schema.safeExtend({
     type: zod.z.literal("MassID").meta({
       title: "MassID Schema Type",
-      description: "MassID NFT schema type"
+      description: "Schema type identifier for this record"
     })
   }),
   attributes: MassIDAttributesSchema,
@@ -30082,7 +30191,7 @@ var GasIDAttributesSchema = zod.z.tuple([
   GasIDAttributeCertificateIssuanceDateSchema
 ]).meta({
   title: "GasID NFT Attribute Array",
-  description: "Schema for the fixed set of GasID NFT attributes, enforcing order and type for each trait"
+  description: "Schema for the fixed set of GasID NFT attributes, enforcing order and type for each trait.\n\nRequired attributes (11, in order): Methodology, Gas Type, CO\u2082e Prevented (kg), Credit Amount, Credit Type, Source Waste Type, Source Weight (kg), Origin City, MassID, MassID Recycling Date, Certificate Issuance Date."
 });
 var GasIDSummarySchema = zod.z.strictObject({
   gas_type: GasTypeSchema,
@@ -30176,17 +30285,8 @@ var GasIDIpfsSchema = NftIpfsSchema.safeExtend({
       description: "GasID NFT schema type"
     })
   }),
+  attributes: GasIDAttributesSchema,
   data: GasIDDataSchema
-}).superRefine((value, ctx) => {
-  const attributesResult = GasIDAttributesSchema.safeParse(value.attributes);
-  if (!attributesResult.success) {
-    attributesResult.error.issues.forEach((issue) => {
-      ctx.addIssue({
-        ...issue,
-        path: ["attributes", ...issue.path]
-      });
-    });
-  }
 }).meta(GasIDIpfsSchemaMeta);
 var RecycledIDAttributeMethodologySchema = MethodologyAttributeSchema;
 var RecycledIDAttributeRecycledMassWeightSchema = createWeightAttributeSchema(
@@ -30217,7 +30317,7 @@ var RecycledIDAttributesSchema = zod.z.tuple([
   RecycledIDAttributeCertificateIssuanceDateSchema
 ]).meta({
   title: "RecycledID NFT Attribute Array",
-  description: "Schema for the fixed set of RecycledID NFT attributes, enforcing order and type for each trait"
+  description: "Schema for the fixed set of RecycledID NFT attributes, enforcing order and type for each trait.\n\nRequired attributes (10, in order): Methodology, Recycled Mass Weight (kg), Credit Amount, Credit Type, Source Waste Type, Source Weight (kg), Origin City, MassID, MassID Recycling Date, Certificate Issuance Date."
 });
 var RecycledIDSummarySchema = zod.z.strictObject({
   recycled_mass_kg: WeightKgSchema.meta({
@@ -30262,19 +30362,8 @@ var RecycledIDIpfsSchema = NftIpfsSchema.safeExtend({
       description: "RecycledID NFT schema type"
     })
   }),
+  attributes: RecycledIDAttributesSchema,
   data: RecycledIDDataSchema
-}).superRefine((value, ctx) => {
-  const attributesResult = RecycledIDAttributesSchema.safeParse(
-    value.attributes
-  );
-  if (!attributesResult.success) {
-    attributesResult.error.issues.forEach((issue) => {
-      ctx.addIssue({
-        ...issue,
-        path: ["attributes", ...issue.path]
-      });
-    });
-  }
 }).meta(RecycledIDIpfsSchemaMeta);
 var CreditPurchaseReceiptCreditAttributeSchema = NftAttributeSchema.safeExtend({
   trait_type: CreditTokenSymbolSchema,
@@ -30335,21 +30424,34 @@ var CreditPurchaseReceiptCollectionAttributeSchema = NftAttributeSchema.safeExte
   title: "Collection Attribute",
   description: "Attribute representing the amount of credits purchased from a collection"
 });
-var CreditPurchaseReceiptAttributesSchema = uniqueBy(
-  zod.z.union([
-    CreditPurchaseReceiptCreditAttributeSchema,
-    CreditPurchaseReceiptTotalCreditsAttributeSchema,
-    CreditPurchaseReceiptTotalUsdcAttributeSchema,
-    CreditPurchaseReceiptPurchaseDateAttributeSchema,
-    CreditPurchaseReceiptCertificatesAttributeSchema,
-    CreditPurchaseReceiptReceiverAttributeSchema,
-    CreditPurchaseReceiptCollectionAttributeSchema
-  ]),
-  (attribute) => attribute.trait_type,
-  "Attribute trait_type values must be unique"
-).min(5).meta({
+var REQUIRED_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES = [
+  CreditPurchaseReceiptTotalCreditsAttributeSchema,
+  CreditPurchaseReceiptTotalUsdcAttributeSchema,
+  CreditPurchaseReceiptPurchaseDateAttributeSchema,
+  CreditPurchaseReceiptCertificatesAttributeSchema
+];
+var CONDITIONAL_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES = [
+  CreditPurchaseReceiptReceiverAttributeSchema
+];
+var DYNAMIC_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES = [
+  CreditPurchaseReceiptCreditAttributeSchema,
+  CreditPurchaseReceiptCollectionAttributeSchema
+];
+var CreditPurchaseReceiptAttributesSchema = createOrderedAttributesSchema({
+  required: REQUIRED_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES,
+  optional: [
+    ...CONDITIONAL_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES,
+    ...DYNAMIC_CREDIT_PURCHASE_RECEIPT_ATTRIBUTES
+  ],
   title: "Credit Purchase Receipt NFT Attribute Array",
-  description: "Attributes for credit purchase receipts including per-credit breakdowns, totals, receiver, purchase date, and per-collection amounts. Attributes must have unique trait types."
+  description: "Attributes for credit purchase receipts including per-credit breakdowns, totals, receiver, purchase date, and per-collection amounts. Fixed required attributes: Total Credits Purchased, Total USDC Amount, Purchase Date, Certificates Purchased. Conditional attributes: Receiver (required when receiver.identity.name is provided). Dynamic attributes: Credit attributes (one per credit symbol in data.credits), Collection attributes (one per collection name in data.collections).",
+  uniqueBySelector: (attribute) => attribute.trait_type,
+  requiredTraitTypes: [
+    "Total Credits Purchased",
+    "Total USDC Amount",
+    "Purchase Date",
+    "Certificates Purchased"
+  ]
 });
 var CreditPurchaseReceiptIdentitySchema = ReceiptIdentitySchema;
 var CreditPurchaseReceiptReceiverSchema = zod.z.strictObject({
@@ -30860,21 +30962,34 @@ var CreditRetirementReceiptCollectionAttributeSchema = NftAttributeSchema.safeEx
   title: "Collection Attribute",
   description: "Attribute representing the amount of credits retired from a collection"
 });
-var CreditRetirementReceiptAttributesSchema = uniqueBy(
-  zod.z.union([
-    CreditRetirementReceiptCreditAttributeSchema,
-    CreditRetirementReceiptTotalCreditsAttributeSchema,
-    CreditRetirementReceiptBeneficiaryAttributeSchema,
-    CreditRetirementReceiptCreditHolderAttributeSchema,
-    CreditRetirementReceiptRetirementDateAttributeSchema,
-    CreditRetirementReceiptCertificatesAttributeSchema,
-    CreditRetirementReceiptCollectionAttributeSchema
-  ]),
-  (attribute) => attribute.trait_type,
-  "Attribute trait_type values must be unique"
-).min(6).meta({
+var REQUIRED_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
+  CreditRetirementReceiptTotalCreditsAttributeSchema,
+  CreditRetirementReceiptBeneficiaryAttributeSchema,
+  CreditRetirementReceiptRetirementDateAttributeSchema,
+  CreditRetirementReceiptCertificatesAttributeSchema
+];
+var CONDITIONAL_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
+  CreditRetirementReceiptCreditHolderAttributeSchema
+];
+var DYNAMIC_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES = [
+  CreditRetirementReceiptCreditAttributeSchema,
+  CreditRetirementReceiptCollectionAttributeSchema
+];
+var CreditRetirementReceiptAttributesSchema = createOrderedAttributesSchema({
+  required: REQUIRED_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES,
+  optional: [
+    ...CONDITIONAL_CREDIT_RETIREMENT_RECEIPT_ATTRIBUTES,
+    ...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 per-collection amounts. Attributes must have unique trait types."
+  description: "Attributes for credit retirement receipts including per-credit breakdowns, totals, beneficiary, credit holder, retirement date, certificate count, and per-collection amounts. Fixed required attributes: Total Credits Retired, Beneficiary, Retirement Date, Certificates Retired. Conditional attributes: Credit Holder (required when credit_holder.identity.name is provided). Dynamic attributes: Credit attributes (one per credit symbol in data.credits), Collection attributes (one per collection name in data.collections).",
+  uniqueBySelector: (attribute) => attribute.trait_type,
+  requiredTraitTypes: [
+    "Total Credits Retired",
+    "Beneficiary",
+    "Retirement Date",
+    "Certificates Retired"
+  ]
 });
 var CreditRetirementReceiptIdentitySchema = ReceiptIdentitySchema;
 var CreditRetirementReceiptBeneficiarySchema = zod.z.strictObject({
@@ -31323,7 +31438,7 @@ var CollectionSchema = BaseIpfsSchema.safeExtend({
     title: "Collection Image",
     description: "IPFS URI pointing to the collection's visual representation",
     examples: [
-      "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku/collection-icon.png"
+      "ipfs://bafybeihdwdcefgh4dqkjv67uzcmw7ojee6xedzdetojuzjevtenxquvyku"
     ]
   }),
   description: zod.z.string().min(50).max(1e3).meta({
@@ -31359,7 +31474,7 @@ var CreditSchema = BaseIpfsSchema.safeExtend({
     title: "Token Image",
     description: "IPFS URI pointing to the token's visual representation image",
     examples: [
-      "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm/credit-icon.png"
+      "ipfs://bafybeigdyrztvzl5cceubvaxob7iqh6f3f7s36c74ojav2xsz2uib2g3vm"
     ]
   }),
   description: zod.z.string().min(50).max(1e3).meta({
@@ -31473,7 +31588,7 @@ var MassIDAuditSchema = BaseIpfsSchema.safeExtend({
   }),
   data: MassIDAuditDataSchema
 }).meta(MassIDAuditSchemaMeta);
-/* v8 ignore next -- @preserve */
+/* v8 ignore file -- @preserve */
 
 exports.ALLOWED_BLOCKCHAIN_NETWORKS = ALLOWED_BLOCKCHAIN_NETWORKS;
 exports.AuditReferenceSchema = AuditReferenceSchema;
@@ -31607,6 +31722,7 @@ exports.canonicalizeForHash = canonicalizeForHash;
 exports.createAttributeMap = createAttributeMap;
 exports.createDateAttributeSchema = createDateAttributeSchema;
 exports.createNumericAttributeSchema = createNumericAttributeSchema;
+exports.createOrderedAttributesSchema = createOrderedAttributesSchema;
 exports.createReceiptCertificateSchema = createReceiptCertificateSchema;
 exports.createReceiptCollectionSchema = createReceiptCollectionSchema;
 exports.createReceiptCreditSchema = createReceiptCreditSchema;