@storagehub-sdk/core 0.3.1 → 0.3.3

package/dist/types.d.ts

@@ -9,4 +9,15 @@ export interface FileInfo {
     location: string;
     /** File size in bytes (using bigint for blockchain compatibility) */
     size: bigint;
+    /**
+     * Block hash where the file was created (32-byte hex string).
+     * Contains the block hash where the NewStorageRequest event was emitted.
+     */
+    blockHash: `0x${string}`;
+    /**
+     * EVM transaction hash that created this file (32-byte hex string).
+     * Only present for files created via EVM transactions on EVM-enabled runtimes.
+     * Will be undefined for files created via native Substrate extrinsics.
+     */
+    txHash?: `0x${string}`;
 }

package/dist/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Utility functions for StorageHub SDK
+ */
+/**
+ * Ensures a hex string has the '0x' prefix
+ * @param hex - The hex string to process
+ * @returns The hex string with '0x' prefix
+ */
+export declare function ensure0xPrefix(hex: string): `0x${string}`;
+/**
+ * Removes the '0x' prefix from a hex string if present
+ * @param hex - The hex string to process
+ * @returns The hex string without '0x' prefix
+ */
+export declare function removeHexPrefix(hex: string): string;
+/**
+ * Converts a hex string to Uint8Array
+ * @param hex - The hex string to convert (with or without 0x prefix)
+ * @returns Uint8Array representation
+ */
+/**
+ * Safely parse a date string, validating that it results in a valid Date object.
+ * @param dateString - The date string to parse (expected to be an ISO timestamp)
+ * @returns A valid Date object
+ * @throws Error if the date string is invalid or results in an Invalid Date
+ */
+export declare function parseDate(dateString: string): Date;
+export declare function hexToBytes(hex: string): Uint8Array;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storagehub-sdk/core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Core primitives for StorageHub SDK (types, crypto, filemanager, storage, wasm bindings)",
   "type": "module",
   "main": "./dist/index.node.js",
@@ -26,11 +26,14 @@
   "dependencies": {
     "@polkadot/types": "^16.4.7",
     "abitype": "^1.0.0",
-    "ethers": "^6.15.0",
-    "viem": "^2.37.6"
+    "ethers": "^6.15.0"
+  },
+  "peerDependencies": {
+    "viem": ">=2.38.3"
   },
   "devDependencies": {
     "@types/node": "^20.11.19",
+    "viem": ">=2.38.3",
     "solc": "^0.8.26"
   },
   "engines": {

package/wasm/pkg/storagehub_wasm.d.ts

@@ -24,6 +24,12 @@ export class FileTrie {
   free(): void;
   constructor();
   push_chunk(bytes: Uint8Array): void;
+  /**
+   * Push many chunks at once. The input buffer is split into FILE_CHUNK_SIZE-sized
+   * windows, and any remainder (< FILE_CHUNK_SIZE) is pushed as the final chunk.
+   * This preserves the canonical chunking while dramatically reducing JS→WASM calls.
+   */
+  push_chunks_batched(bytes: Uint8Array): void;
   /**
    * Current Merkle root as a hex string.
    */
@@ -34,18 +40,19 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
   readonly memory: WebAssembly.Memory;
-  readonly __wbg_filemetadata_free: (a: number, b: number) => void;
-  readonly filemetadata_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number) => [number, number, number];
-  readonly filemetadata_getFileKey: (a: number) => [number, number];
-  readonly filemetadata_encode: (a: number) => [number, number];
   readonly __wbg_filetrie_free: (a: number, b: number) => void;
   readonly filetrie_new: () => number;
   readonly filetrie_push_chunk: (a: number, b: number, c: number) => void;
+  readonly filetrie_push_chunks_batched: (a: number, b: number, c: number) => void;
   readonly filetrie_get_root: (a: number) => [number, number];
+  readonly __wbg_filemetadata_free: (a: number, b: number) => void;
+  readonly filemetadata_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number) => [number, number, number];
+  readonly filemetadata_getFileKey: (a: number) => [number, number];
+  readonly filemetadata_encode: (a: number) => [number, number];
   readonly __wbindgen_export_0: WebAssembly.Table;
   readonly __wbindgen_malloc: (a: number, b: number) => number;
-  readonly __externref_table_dealloc: (a: number) => void;
   readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+  readonly __externref_table_dealloc: (a: number) => void;
   readonly __wbindgen_start: () => void;
 }
 

package/wasm/pkg/storagehub_wasm.js

@@ -27,17 +27,17 @@ function passArray8ToWasm0(arg, malloc) {
     return ptr;
 }
 
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
 function takeFromExternrefTable0(idx) {
     const value = wasm.__wbindgen_export_0.get(idx);
     wasm.__externref_table_dealloc(idx);
     return value;
 }
 
-function getArrayU8FromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
-}
-
 const FileMetadataFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_filemetadata_free(ptr >>> 0, 1));
@@ -138,6 +138,17 @@ export class FileTrie {
         const len0 = WASM_VECTOR_LEN;
         wasm.filetrie_push_chunk(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * Push many chunks at once. The input buffer is split into FILE_CHUNK_SIZE-sized
+     * windows, and any remainder (< FILE_CHUNK_SIZE) is pushed as the final chunk.
+     * This preserves the canonical chunking while dramatically reducing JS→WASM calls.
+     * @param {Uint8Array} bytes
+     */
+    push_chunks_batched(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.filetrie_push_chunks_batched(this.__wbg_ptr, ptr0, len0);
+    }
     /**
      * Current Merkle root as a hex string.
      * @returns {Uint8Array}

package/wasm/pkg/storagehub_wasm_bg.wasm.d.ts

@@ -1,16 +1,17 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const __wbg_filemetadata_free: (a: number, b: number) => void;
-export const filemetadata_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number) => [number, number, number];
-export const filemetadata_getFileKey: (a: number) => [number, number];
-export const filemetadata_encode: (a: number) => [number, number];
 export const __wbg_filetrie_free: (a: number, b: number) => void;
 export const filetrie_new: () => number;
 export const filetrie_push_chunk: (a: number, b: number, c: number) => void;
+export const filetrie_push_chunks_batched: (a: number, b: number, c: number) => void;
 export const filetrie_get_root: (a: number) => [number, number];
+export const __wbg_filemetadata_free: (a: number, b: number) => void;
+export const filemetadata_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number) => [number, number, number];
+export const filemetadata_getFileKey: (a: number) => [number, number];
+export const filemetadata_encode: (a: number) => [number, number];
 export const __wbindgen_export_0: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;
-export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_start: () => void;