Merge pull request #88 from IntersectMBO/refactor/bytes

refactor/bytes

Author: solidsnakedev

.changeset/cold-cows-bake.md

@@ -0,0 +1,36 @@
+---
+"@evolution-sdk/evolution": minor
+---
+
+Add CIP-30 message signing support with modular architecture
+
+This release introduces comprehensive CIP-30 `signData` and `verifyData` support, implementing the complete COSE Sign1 specification with a clean, modular structure:
+
+**New Features:**
+- Full CIP-30 message signing (`signData`) and verification (`verifyData`) implementation
+- COSE (CBOR Object Signing and Encryption) primitives per RFC 8152
+- Support for Ed25519 signatures with proper COSE key structures
+- Message hashing with BLAKE2b-256 for payload integrity
+- CIP-8 compliant address field handling
+- Complete test coverage with CSL compatibility tests
+
+**Module Structure:**
+- `message-signing/SignData.ts` - Main CIP-30 signData/verifyData API
+- `message-signing/Header.ts` - COSE header structures and operations
+- `message-signing/Label.ts` - COSE label types and algorithm identifiers
+- `message-signing/CoseSign1.ts` - COSE_Sign1 structure implementation
+- `message-signing/CoseKey.ts` - COSE key format support
+- `message-signing/Ed25519Key.ts` - Ed25519 key operations
+- `message-signing/Utils.ts` - Encoding and conversion utilities
+
+**Breaking Changes:**
+- Refactored `Bytes` module API:
+  - Renamed `bytesEquals` to `equals` with stricter type signature (no longer accepts undefined)
+  - Removed `Bytes.FromHex` schema in favor of Effect's built-in `Schema.Uint8ArrayFromHex`
+  - Updated `fromHex`/`toHex` to use Effect's native schemas
+
+**Internal Improvements:**
+- Removed unused `Bytes` imports across 32 files
+- Updated all modules to use new Bytes API
+- Improved CBOR encoding/decoding with proper codec options
+- Enhanced type safety with Effect Schema compositions

docs/content/docs/modules/core/Address.mdx

@@ -147,7 +147,7 @@ Handles both BaseAddress (57 bytes) and EnterpriseAddress (29 bytes)
 
 ```ts
 export declare const FromBytes: Schema.transformOrFail<
-  Schema.Union<[Schema.filter<typeof Schema.Uint8ArrayFromSelf>, Schema.filter<typeof Schema.Uint8ArrayFromSelf>]>,
+  Schema.Union<[Schema.SchemaClass<Uint8Array, Uint8Array, never>, Schema.SchemaClass<Uint8Array, Uint8Array, never>]>,
   Schema.SchemaClass<Address, Address, never>,
   never
 >
@@ -163,9 +163,11 @@ Transform from hex string to AddressStructure
 
 ```ts
 export declare const FromHex: Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transformOrFail<
-    Schema.Union<[Schema.filter<typeof Schema.Uint8ArrayFromSelf>, Schema.filter<typeof Schema.Uint8ArrayFromSelf>]>,
+    Schema.Union<
+      [Schema.SchemaClass<Uint8Array, Uint8Array, never>, Schema.SchemaClass<Uint8Array, Uint8Array, never>]
+    >,
     Schema.SchemaClass<Address, Address, never>,
     never
   >
@@ -219,7 +221,7 @@ Added in v1.0.0
 **Signature**
 
 ```ts
-export declare const fromBytes: (i: any, overrideOptions?: ParseOptions) => Address
+export declare const fromBytes: (i: Uint8Array, overrideOptions?: ParseOptions) => Address
 ```
 
 ## fromHex
@@ -243,7 +245,7 @@ export declare const toBech32: (a: Address, overrideOptions?: ParseOptions) => s
 **Signature**
 
 ```ts
-export declare const toBytes: (a: Address, overrideOptions?: ParseOptions) => any
+export declare const toBytes: (a: Address, overrideOptions?: ParseOptions) => Uint8Array
 ```
 
 ## toHex

docs/content/docs/modules/core/AddressEras.mdx

@@ -275,7 +275,7 @@ Schema for encoding/decoding addresses as hex strings.
 
 ```ts
 export declare const FromHex: Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transformOrFail<
     typeof Schema.Uint8ArrayFromSelf,
     Schema.SchemaClass<

docs/content/docs/modules/core/Anchor.mdx

@@ -191,7 +191,7 @@ CBOR hex transformation schema for Anchor.
 export declare const FromCBORHex: (
   options?: CBOR.CodecOptions
 ) => Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transform<
     Schema.transformOrFail<
       typeof Schema.Uint8ArrayFromSelf,

docs/content/docs/modules/core/Assets.mdx

@@ -448,7 +448,7 @@ CBOR hex transformation schema for Assets.
 export declare const FromCBORHex: (
   options?: CBOR.CodecOptions
 ) => Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transform<
     Schema.transformOrFail<
       typeof Schema.Uint8ArrayFromSelf,

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

@@ -515,7 +515,7 @@ Transforms between CBOR hex string and AuxiliaryData using CDDL format.
 export declare const FromCBORHex: (
   options?: CBOR.CodecOptions
 ) => Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transform<
     Schema.transformOrFail<
       typeof Schema.Uint8ArrayFromSelf,

docs/content/docs/modules/core/BaseAddress.mdx

@@ -53,7 +53,7 @@ Convert a BaseAddress to bytes.
 **Signature**
 
 ```ts
-export declare const toBytes: (data: BaseAddress) => any
+export declare const toBytes: (data: BaseAddress) => Uint8Array
 ```
 
 Added in v2.0.0
@@ -150,7 +150,7 @@ toString(): string
 
 ```ts
 export declare const FromBytes: Schema.transformOrFail<
-  Schema.filter<typeof Schema.Uint8ArrayFromSelf>,
+  Schema.SchemaClass<Uint8Array, Uint8Array, never>,
   Schema.SchemaClass<BaseAddress, BaseAddress, never>,
   never
 >
@@ -162,9 +162,9 @@ export declare const FromBytes: Schema.transformOrFail<
 
 ```ts
 export declare const FromHex: Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transformOrFail<
-    Schema.filter<typeof Schema.Uint8ArrayFromSelf>,
+    Schema.SchemaClass<Uint8Array, Uint8Array, never>,
     Schema.SchemaClass<BaseAddress, BaseAddress, never>,
     never
   >

docs/content/docs/modules/core/Bech32.mdx

@@ -54,7 +54,7 @@ export declare const FromBytes: (
 export declare const FromHex: (
   prefix?: string
 ) => Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transformOrFail<typeof Schema.Uint8ArrayFromSelf, typeof Schema.String, never>
 >
 ```

docs/content/docs/modules/core/Bip32PrivateKey.mdx

@@ -164,7 +164,7 @@ Convert a Bip32PrivateKey to raw bytes.
 **Signature**
 
 ```ts
-export declare const toBytes: (a: Bip32PrivateKey, overrideOptions?: ParseOptions) => any
+export declare const toBytes: (a: Bip32PrivateKey, overrideOptions?: ParseOptions) => Uint8Array
 ```
 
 Added in v2.0.0
@@ -204,7 +204,7 @@ Parse a Bip32PrivateKey from raw bytes.
 **Signature**
 
 ```ts
-export declare const fromBytes: (i: any, overrideOptions?: ParseOptions) => Bip32PrivateKey
+export declare const fromBytes: (i: Uint8Array, overrideOptions?: ParseOptions) => Bip32PrivateKey
 ```
 
 Added in v2.0.0
@@ -285,8 +285,8 @@ Schema for transforming between Uint8Array and Bip32PrivateKey.
 
 ```ts
 export declare const FromBytes: Schema.transform<
-  Schema.filter<typeof Schema.Uint8ArrayFromSelf>,
-  typeof Bip32PrivateKey
+  Schema.SchemaClass<Uint8Array, Uint8Array, never>,
+  Schema.SchemaClass<Bip32PrivateKey, Bip32PrivateKey, never>
 >
 ```
 
@@ -300,8 +300,11 @@ Schema for transforming between hex string and Bip32PrivateKey.
 
 ```ts
 export declare const FromHex: Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
-  Schema.transform<Schema.filter<typeof Schema.Uint8ArrayFromSelf>, typeof Bip32PrivateKey>
+  Schema.filter<Schema.Schema<Uint8Array, string, never>>,
+  Schema.transform<
+    Schema.SchemaClass<Uint8Array, Uint8Array, never>,
+    Schema.SchemaClass<Bip32PrivateKey, Bip32PrivateKey, never>
+  >
 >
 ```
 

docs/content/docs/modules/core/BootstrapWitness.mdx

@@ -130,7 +130,7 @@ Transforms between hex string and BootstrapWitness using CBOR encoding.
 export declare const FromCBORHex: (
   options?: CBOR.CodecOptions
 ) => Schema.transform<
-  Schema.transform<Schema.Schema<string, string, never>, Schema.Schema<Uint8Array, Uint8Array, never>>,
+  Schema.Schema<Uint8Array, string, never>,
   Schema.transform<
     Schema.transformOrFail<
       typeof Schema.Uint8ArrayFromSelf,