Merge pull request #113 from IntersectMBO/feat/add-tx-metadata

feat/add tx metadata

Author: solidsnakedev

.changeset/yummy-shoes-double.md

@@ -0,0 +1,26 @@
+---
+"@evolution-sdk/evolution": patch
+---
+
+Add `attachMetadata()` operation to TransactionBuilder for attaching transaction metadata according to CIP-10 standard.
+
+**Changes:**
+- Added `attachMetadata()` method to attach metadata with custom labels
+- Metadata labels are now bigint (unbounded positive integers) supporting CIP-20 messages (label 674) and custom labels
+- Automatic computation of auxiliaryDataHash in transaction body when metadata is present
+- Proper fee calculation accounting for auxiliary data size
+- TransactionMetadatum refactored to simple union type: `string | bigint | Uint8Array | Map | Array`
+- Added `NonNegativeInteger` schema to Numeric module for unbounded non-negative integers
+
+**Example:**
+```typescript
+await client
+  .newTx()
+  .attachMetadata({
+    label: 674n,  // CIP-20 message label
+    metadata: "Hello Cardano!"
+  })
+  .payToAddress({ address, assets })
+  .build()
+  .then(tx => tx.sign().submit())
+```

docs/content/docs/modules/core/AuxiliaryData.mdx

@@ -489,7 +489,22 @@ export declare const FromCBORBytes: (
           }
         >,
         Schema.Array$<Schema.suspend<CBOR.CBOR, CBOR.CBOR, never>>,
-        Schema.MapFromSelf<typeof Schema.BigIntFromSelf, Schema.Schema<CDDLSchema, CDDLSchema, never>>
+        Schema.MapFromSelf<
+          typeof Schema.BigIntFromSelf,
+          Schema.suspend<
+            | string
+            | bigint
+            | Uint8Array
+            | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+            | readonly TransactionMetadatum.TransactionMetadatum[],
+            | string
+            | bigint
+            | Uint8Array
+            | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+            | readonly TransactionMetadatum.TransactionMetadatum[],
+            never
+          >
+        >
       ]
     >,
     Schema.SchemaClass<
@@ -533,7 +548,22 @@ export declare const FromCBORHex: (
             }
           >,
           Schema.Array$<Schema.suspend<CBOR.CBOR, CBOR.CBOR, never>>,
-          Schema.MapFromSelf<typeof Schema.BigIntFromSelf, Schema.Schema<CDDLSchema, CDDLSchema, never>>
+          Schema.MapFromSelf<
+            typeof Schema.BigIntFromSelf,
+            Schema.suspend<
+              | string
+              | bigint
+              | Uint8Array
+              | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+              | readonly TransactionMetadatum.TransactionMetadatum[],
+              | string
+              | bigint
+              | Uint8Array
+              | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+              | readonly TransactionMetadatum.TransactionMetadatum[],
+              never
+            >
+          >
         ]
       >,
       Schema.SchemaClass<
@@ -567,7 +597,22 @@ export declare const FromCDDL: Schema.transformOrFail<
         }
       >,
       Schema.Array$<Schema.suspend<CBOR.CBOR, CBOR.CBOR, never>>,
-      Schema.MapFromSelf<typeof Schema.BigIntFromSelf, Schema.Schema<CDDLSchema, CDDLSchema, never>>
+      Schema.MapFromSelf<
+        typeof Schema.BigIntFromSelf,
+        Schema.suspend<
+          | string
+          | bigint
+          | Uint8Array
+          | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+          | readonly TransactionMetadatum.TransactionMetadatum[],
+          | string
+          | bigint
+          | Uint8Array
+          | Map<TransactionMetadatum.TransactionMetadatum, TransactionMetadatum.TransactionMetadatum>
+          | readonly TransactionMetadatum.TransactionMetadatum[],
+          never
+        >
+      >
     ]
   >,
   Schema.SchemaClass<