@storagehub-sdk/core 0.0.1

package/README.md

@@ -0,0 +1,85 @@
+## StorageHub SDK — Core
+
+Foundational, backend-agnostic building blocks for StorageHub. This package contains StorageHub-specific logic that does not depend on the MSP backend implementation: wallet utilities, blockchain interaction helpers, precompile bindings, Merkle tooling, cryptography/WASM helpers, low-level HTTP utilities, and shared types. Its goal is to let developers integrate StorageHub without needing to understand network implementation details (nodes, pallets, EVM precompiles), by exposing stable, typed primitives and adapters.
+
+### What this package is
+- **Wallet and signing**: Local wallet utilities and EIP-1193 adapter for injected wallets.
+- **Blockchain interaction**: Helpers for StorageHub chain types/encodings with EVM account types.
+- **Precompile helpers**: Bridge Substrate and EVM via precompiles to enable smart‑contract flows (issue storage requests, create buckets, etc.).
+- **Merkle utilities**: Build/verify trees and proofs used by StorageHub.
+- **Crypto/WASM helpers**: Performance-critical primitives via WASM (e.g., FileManager's Merkle/trie and hashing).
+- **HTTP utilities**: Minimal `HttpClient` and types for consistent networking.
+- **Shared types/constants**: Common shapes used across SDK packages.
+
+### What this package is not
+- **Not an MSP client**: No MSP auth, upload/download, or REST contracts. See `@storagehub-sdk/msp-client`.
+- **Not app-specific**: No UI/product code; only reusable SDK primitives.
+
+### Install
+```bash
+pnpm add @storagehub-sdk/core
+# or
+npm i @storagehub-sdk/core
+# or
+yarn add @storagehub-sdk/core
+```
+
+### Quick start
+```ts
+import { HttpClient, type HttpClientConfig } from '@storagehub-sdk/core';
+
+const http = new HttpClient({
+  baseUrl: 'https://example.invalid',
+} satisfies HttpClientConfig);
+
+```
+
+### Local wallet
+```ts
+import { LocalWallet } from '@storagehub-sdk/core';
+
+const wallet = LocalWallet.fromPrivateKey('0xYourPrivateKey');
+const address = await wallet.getAddress();
+const signature = await wallet.signMessage('hello');
+```
+
+### EIP-1193 wallet (browser)
+```ts
+import { Eip1193Wallet } from '@storagehub-sdk/core';
+
+const wallet = await Eip1193Wallet.connect(); // prompts injected wallet (e.g., MetaMask)
+const address = await wallet.getAddress();
+const signature = await wallet.signMessage('hello');
+```
+
+### FileManager (WASM-backed)
+```ts
+import { FileManager } from '@storagehub-sdk/core';
+import { createReadStream, statSync } from 'node:fs';
+import { Readable } from 'node:stream';
+
+const path = './path/to/file.bin';
+const size = statSync(path).size;
+const webStream = Readable.toWeb(createReadStream(path)) as unknown as ReadableStream<Uint8Array>;
+
+const fm = new FileManager({ size, stream: () => webStream });
+const fingerprint = await fm.getFingerprint(); // H256
+```
+
+### Design principles
+- **Backend-agnostic**: No MSP-specific behavior here.
+- **Composable and typed**: Small utilities, strong types, clear errors.
+- **Runtime-friendly**: Browser and Node support; `fetch` is properly bound in browsers.
+- **Separation of concerns**: Core primitives live here; MSP flows live in `msp-client`.
+
+### Roadmap
+- **Typed precompile interfaces**: Strongly-typed bindings and ABI-like helpers.
+- **Proof tooling**: End-to-end generation/verification for storage proofs.
+- **Chunking/commitment utilities**: Streaming chunker and deterministic trees.
+
+### When to use `core` vs `msp-client`
+- Use **`@storagehub-sdk/core`** for primitives that must work without any backend (wallets, Merkle, precompiles, chain helpers, low-level HTTP).
+- Use **`@storagehub-sdk/msp-client`** for MSP endpoints, auth/nonce/sign/verify flows, and file transfer APIs.
+
+### Environments
+Supported environments: web browsers and Node.js.

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const CHUNK_SIZE = 1024;

package/dist/file-manager.d.ts

@@ -0,0 +1,24 @@
+import type { AccountId, H256 } from '@polkadot/types/interfaces';
+export declare class FileManager {
+    private readonly file;
+    constructor(file: {
+        size: number;
+        stream: () => ReadableStream<Uint8Array>;
+    });
+    private fingerprint?;
+    private fileKey?;
+    /**
+     * Stream the file's contents, feed every 1 kB chunk into a new FileTrie, and
+     * return the resulting Merkle root.
+     */
+    getFingerprint(): Promise<H256>;
+    /**
+     * Compute the FileKey for this file.
+     *
+     * The caller must provide:
+     *   • owner – 32-byte AccountId (Uint8Array or 0x-prefixed hex string)
+     *   • bucketId – 32-byte BucketId (Uint8Array or 0x-prefixed hex string)
+     *   • location – path string (encoded to bytes as-is)
+     */
+    computeFileKey(owner: AccountId, bucketId: H256, location: string): Promise<H256>;
+}

package/dist/http/HttpClient.d.ts

@@ -0,0 +1,40 @@
+export type HttpClientConfig = {
+    baseUrl: string;
+    timeoutMs?: number;
+    defaultHeaders?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+};
+export type RequestOptions = {
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    query?: Record<string, string | number | boolean>;
+    /**
+     * Optional request body. If a non-BodyInit object is provided and no
+     * explicit Content-Type header is set, it will be JSON-encoded with
+     * 'application/json'.
+     */
+    body?: BodyInit | unknown;
+    /**
+     * If true, returns the raw Response without consuming the body.
+     * Useful for streaming downloads.
+     */
+    raw?: boolean;
+};
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly defaultHeaders;
+    private readonly fetchImpl;
+    constructor(options: HttpClientConfig);
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, options?: RequestOptions): Promise<T | Response>;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    getRaw(path: string, options?: RequestOptions): Promise<Response>;
+    private buildUrl;
+    private parseJsonSafely;
+    private isBodyInit;
+    private isAbortError;
+    private getErrorMessage;
+}

package/dist/http/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly body?: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+export declare class NetworkError extends Error {
+    constructor(message: string);
+}
+export declare class TimeoutError extends Error {
+    constructor(message: string);
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { FileManager } from './file-manager.js';
+export { HttpClient, type HttpClientConfig, type RequestOptions } from './http/HttpClient.js';
+export { initWasm } from './init.js';
+export { WalletBase } from './wallet/base.js';
+export { Eip1193Wallet } from './wallet/eip1193.js';
+export { WalletError, type WalletErrorCode } from './wallet/errors.js';
+export { LocalWallet } from './wallet/local.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+var Z=Object.defineProperty;var V=(n,e)=>()=>(n&&(e=n(n=0)),e);var Q=(n,e)=>{for(var t in e)Z(n,t,{get:e[t],enumerable:!0})};var N={};Q(N,{FileMetadata:()=>b,FileTrie:()=>h,default:()=>te,initSync:()=>ee});function W(){return(_===null||_.byteLength===0)&&(_=new Uint8Array(i.memory.buffer)),_}function O(n,e){return n=n>>>0,B.decode(W().subarray(n,n+e))}function T(n,e){let t=e(n.length*1,1)>>>0;return W().set(n,t/1),m=n.length,t}function K(n,e){return n=n>>>0,W().subarray(n/1,n/1+e)}function X(n){let e=i.__wbindgen_export_0.get(n);return i.__externref_table_dealloc(n),e}async function Y(n,e){if(typeof Response=="function"&&n instanceof Response){if(typeof WebAssembly.instantiateStreaming=="function")try{return await WebAssembly.instantiateStreaming(n,e)}catch(r){if(n.headers.get("Content-Type")!="application/wasm")console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n",r);else throw r}let t=await n.arrayBuffer();return await WebAssembly.instantiate(t,e)}else{let t=await WebAssembly.instantiate(n,e);return t instanceof WebAssembly.Instance?{instance:t,module:n}:t}}function j(){let n={};return n.wbg={},n.wbg.__wbindgen_init_externref_table=function(){let e=i.__wbindgen_export_0,t=e.grow(4);e.set(0,void 0),e.set(t+0,void 0),e.set(t+1,null),e.set(t+2,!0),e.set(t+3,!1)},n.wbg.__wbindgen_string_new=function(e,t){return O(e,t)},n.wbg.__wbindgen_throw=function(e,t){throw new Error(O(e,t))},n}function D(n,e){return i=n.exports,z.__wbindgen_wasm_module=e,_=null,i.__wbindgen_start(),i}function ee(n){if(i!==void 0)return i;typeof n<"u"&&(Object.getPrototypeOf(n)===Object.prototype?{module:n}=n:console.warn("using deprecated parameters for `initSync()`; pass a single object instead"));let e=j();n instanceof WebAssembly.Module||(n=new WebAssembly.Module(n));let t=new WebAssembly.Instance(n,e);return D(t,n)}async function z(n){if(i!==void 0)return i;typeof n<"u"&&(Object.getPrototypeOf(n)===Object.prototype?{module_or_path:n}=n:console.warn("using deprecated parameters for the initialization function; pass a single object instead")),typeof n>"u"&&(n=new URL("storagehub_wasm_bg.wasm",import.meta.url));let e=j();(typeof n=="string"||typeof Request=="function"&&n instanceof Request||typeof URL=="function"&&n instanceof URL)&&(n=fetch(n));let{instance:t,module:r}=await Y(await n,e);return D(t,r)}var i,B,_,m,L,b,C,h,te,U=V(()=>{"use strict";B=typeof TextDecoder<"u"?new TextDecoder("utf-8",{ignoreBOM:!0,fatal:!0}):{decode:()=>{throw Error("TextDecoder not available")}};typeof TextDecoder<"u"&&B.decode();_=null;m=0;L=typeof FinalizationRegistry>"u"?{register:()=>{},unregister:()=>{}}:new FinalizationRegistry(n=>i.__wbg_filemetadata_free(n>>>0,1)),b=class{__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,L.unregister(this),e}free(){let e=this.__destroy_into_raw();i.__wbg_filemetadata_free(e,0)}constructor(e,t,r,s,o){let a=T(e,i.__wbindgen_malloc),p=m,d=T(t,i.__wbindgen_malloc),l=m,c=T(r,i.__wbindgen_malloc),f=m,g=T(o,i.__wbindgen_malloc),v=m,u=i.filemetadata_new(a,p,d,l,c,f,s,g,v);if(u[2])throw X(u[1]);return this.__wbg_ptr=u[0]>>>0,L.register(this,this.__wbg_ptr,this),this}getFileKey(){let e=i.filemetadata_getFileKey(this.__wbg_ptr);var t=K(e[0],e[1]).slice();return i.__wbindgen_free(e[0],e[1]*1,1),t}},C=typeof FinalizationRegistry>"u"?{register:()=>{},unregister:()=>{}}:new FinalizationRegistry(n=>i.__wbg_filetrie_free(n>>>0,1)),h=class{__destroy_into_raw(){let e=this.__wbg_ptr;return this.__wbg_ptr=0,C.unregister(this),e}free(){let e=this.__destroy_into_raw();i.__wbg_filetrie_free(e,0)}constructor(){let e=i.filetrie_new();return this.__wbg_ptr=e>>>0,C.register(this,this.__wbg_ptr,this),this}push_chunk(e){let t=T(e,i.__wbindgen_malloc),r=m;i.filetrie_push_chunk(this.__wbg_ptr,t,r)}get_root(){let e=i.filetrie_get_root(this.__wbg_ptr);var t=K(e[0],e[1]).slice();return i.__wbindgen_free(e[0],e[1]*1,1),t}};te=z});U();import{TypeRegistry as $}from"@polkadot/types";var q=class{constructor(e){this.file=e}fingerprint;fileKey;async getFingerprint(){if(this.fingerprint)return this.fingerprint;let e=new $,t=new h,s=this.file.stream().getReader(),o=new Uint8Array,a=0;try{for(;;){let{done:l,value:c}=await s.read();if(l)break;if(c&&c.length){let f=o.subarray(a),g=new Uint8Array(f.length+c.length);for(g.set(f,0),g.set(c,f.length),o=g,a=0;o.length-a>=1024;){let v=o.subarray(a,a+1024);t.push_chunk(v),a+=1024}}}o.length-a>0&&t.push_chunk(o.subarray(a))}finally{s.releaseLock()}let p=t.get_root(),d=e.createType("H256",p);return this.fingerprint=d,d}async computeFileKey(e,t,r){if(this.fileKey)return this.fileKey;let s=await this.getFingerprint(),a=new b(e.toU8a(),t.toU8a(),new TextEncoder().encode(r),BigInt(this.file.size),s.toU8a()).getFileKey(),p=new $;return this.fileKey=p.createType("H256",a),this.fileKey}};var P=class extends Error{status;body;constructor(e,t,r){super(e),this.name="HttpError",this.status=t,this.body=r}},R=class extends Error{constructor(e){super(e),this.name="NetworkError"}},x=class extends Error{constructor(e){super(e),this.name="TimeoutError"}};var ne=3e4,M=class{baseUrl;timeoutMs;defaultHeaders;fetchImpl;constructor(e){if(!e.baseUrl)throw new Error("HttpClient: baseUrl is required");this.baseUrl=e.baseUrl.replace(/\/$/,""),this.timeoutMs=e.timeoutMs??ne,this.defaultHeaders={Accept:"application/json",...e.defaultHeaders??{}},this.fetchImpl=e.fetchImpl??fetch}async request(e,t,r={}){let s=this.buildUrl(t,r.query),o={...this.defaultHeaders,...r.headers??{}},a=!r.signal&&this.timeoutMs>0?new AbortController:void 0,p=r.signal??a?.signal,d=a?setTimeout(()=>a.abort(),this.timeoutMs):void 0;try{let l=Object.keys(o).some(E=>E.toLowerCase()==="content-type"),c=r.body,f=null;c!=null&&(this.isBodyInit(c)?f=c:(l||(o["Content-Type"]="application/json"),f=JSON.stringify(c)));let g={method:e,headers:o,...p?{signal:p}:{},...f!==null?{body:f}:{}},u=await(typeof globalThis<"u"&&this.fetchImpl===globalThis.fetch?globalThis.fetch.bind(globalThis):this.fetchImpl)(s,g);if(!u.ok){let E=await u.text(),G=this.parseJsonSafely(E);throw new P(`HTTP ${u.status} for ${e} ${s}`,u.status,G??E)}if(r.raw)return u;let S=await u.text();return this.parseJsonSafely(S)??S}catch(l){if(this.isAbortError(l))throw new x(`Request timed out for ${e} ${t}`);if(l instanceof P)throw l;let c=this.getErrorMessage(l);throw new R(c??`Network error for ${e} ${t}`)}finally{d&&clearTimeout(d)}}get(e,t){return this.request("GET",e,t)}post(e,t){return this.request("POST",e,t??{})}put(e,t){return this.request("PUT",e,t??{})}delete(e,t){return this.request("DELETE",e,t??{})}getRaw(e,t){return this.request("GET",e,{...t,raw:!0})}buildUrl(e,t){let r=e.startsWith("/")?e:`/${e}`,s=new URL(this.baseUrl+r);if(t)for(let[o,a]of Object.entries(t))s.searchParams.set(o,String(a));return s.toString()}parseJsonSafely(e){if(e)try{return JSON.parse(e)}catch{return}}isBodyInit(e){return typeof e=="string"||e instanceof Uint8Array||typeof ArrayBuffer<"u"&&e instanceof ArrayBuffer||typeof Blob<"u"&&e instanceof Blob||typeof FormData<"u"&&e instanceof FormData||typeof ReadableStream<"u"&&e instanceof ReadableStream}isAbortError(e){return typeof e=="object"&&e!==null&&"name"in e&&typeof e.name=="string"&&e.name==="AbortError"}getErrorMessage(e){if(typeof e=="string")return e;if(typeof e=="object"&&e!==null&&"message"in e){let t=e.message;if(typeof t=="string")return t}}};var A=null;async function re(){return A||(A=(async()=>{let n=(await Promise.resolve().then(()=>(U(),N))).default,e=new URL("../wasm/pkg/storagehub_wasm_bg.wasm",import.meta.url);if(typeof window>"u"){let t="node:fs/promises",{readFile:r}=await import(t),s=await r(e);await n(s)}else await n(e.href)})(),A)}var w=class{};import{BrowserProvider as J}from"ethers";var H=class n extends w{constructor(t){super();this.provider=t}static fromProvider(t){return new n(new J(t))}static async connect(){if(typeof window.ethereum>"u")throw new Error("EIP-1193 provider not found. Please install a compatible wallet.");let t=new J(window.ethereum);return await t.send("eth_requestAccounts",[]),new n(t)}async getAddress(){return(await this.provider.getSigner()).getAddress()}async sendTransaction(t){let r=await this.provider.getSigner(),s={};return t.to&&(s.to=t.to),t.data&&t.data!=="0x"&&(s.data=t.data),t.value&&t.value!==0n&&(s.value=t.value),t.gasLimit&&t.gasLimit!==0n&&(s.gasLimit=t.gasLimit),(await r.sendTransaction(s)).hash}async signMessage(t){return(await this.provider.getSigner()).signMessage(t)}};var y=class extends Error{name="WalletError";code;constructor(e,t){super(t??e),this.code=e}};import{hexlify as se,Transaction as ie,Wallet as I}from"ethers";var F=class n extends w{constructor(t,r){super();this.wallet=t;this.provider=r}static fromPrivateKey(t,r){if(!/^0x[0-9a-fA-F]{64}$/.test(t))throw new y("InvalidPrivateKey");try{return new n(new I(t,r),r)}catch{throw new y("InvalidPrivateKey")}}static fromMnemonic(t,r){try{let s=I.fromPhrase(t),o=r?s.connect(r):s;return new n(o,r)}catch{throw new y("InvalidMnemonic")}}static createRandom(t){let r=I.createRandom(),s=t?r.connect(t):r;return new n(s,t)}getAddress(){return Promise.resolve(this.wallet.address)}signTransaction(t){let r=se(t);return this.wallet.signTransaction(ie.from(r))}async sendTransaction(t){if(!this.provider)throw new Error("No provider configured for LocalWallet; cannot send transaction");return(await this.wallet.connect(this.provider).sendTransaction(t)).hash}signMessage(t){return this.wallet.signMessage(t)}};export{H as Eip1193Wallet,q as FileManager,M as HttpClient,F as LocalWallet,w as WalletBase,y as WalletError,re as initWasm};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../wasm/pkg/storagehub_wasm.js", "../src/wasm.ts", "../src/file-manager.ts", "../src/http/errors.ts", "../src/http/HttpClient.ts", "../src/init.ts", "../src/wallet/base.ts", "../src/wallet/eip1193.ts", "../src/wallet/errors.ts", "../src/wallet/local.ts"],
+  "sourcesContent": ["let wasm;\n\nconst cachedTextDecoder = (typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8', { ignoreBOM: true, fatal: true }) : { decode: () => { throw Error('TextDecoder not available') } } );\n\nif (typeof TextDecoder !== 'undefined') { cachedTextDecoder.decode(); };\n\nlet cachedUint8ArrayMemory0 = null;\n\nfunction getUint8ArrayMemory0() {\n    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {\n        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);\n    }\n    return cachedUint8ArrayMemory0;\n}\n\nfunction getStringFromWasm0(ptr, len) {\n    ptr = ptr >>> 0;\n    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));\n}\n\nlet WASM_VECTOR_LEN = 0;\n\nfunction passArray8ToWasm0(arg, malloc) {\n    const ptr = malloc(arg.length * 1, 1) >>> 0;\n    getUint8ArrayMemory0().set(arg, ptr / 1);\n    WASM_VECTOR_LEN = arg.length;\n    return ptr;\n}\n\nfunction getArrayU8FromWasm0(ptr, len) {\n    ptr = ptr >>> 0;\n    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);\n}\n\nfunction takeFromExternrefTable0(idx) {\n    const value = wasm.__wbindgen_export_0.get(idx);\n    wasm.__externref_table_dealloc(idx);\n    return value;\n}\n\nconst FileMetadataFinalization = (typeof FinalizationRegistry === 'undefined')\n    ? { register: () => {}, unregister: () => {} }\n    : new FinalizationRegistry(ptr => wasm.__wbg_filemetadata_free(ptr >>> 0, 1));\n\nexport class FileMetadata {\n\n    __destroy_into_raw() {\n        const ptr = this.__wbg_ptr;\n        this.__wbg_ptr = 0;\n        FileMetadataFinalization.unregister(this);\n        return ptr;\n    }\n\n    free() {\n        const ptr = this.__destroy_into_raw();\n        wasm.__wbg_filemetadata_free(ptr, 0);\n    }\n    /**\n     * Constructs a new `FileMetadata`.\n     * * `owner`, `bucket_id`, `fingerprint` \u2013 32-byte arrays (passed as slices)\n     * * `location` \u2013 arbitrary byte string (file path)\n     * * `size` \u2013 file size in bytes\n     * @param {Uint8Array} owner\n     * @param {Uint8Array} bucket_id\n     * @param {Uint8Array} location\n     * @param {bigint} size\n     * @param {Uint8Array} fingerprint\n     */\n    constructor(owner, bucket_id, location, size, fingerprint) {\n        const ptr0 = passArray8ToWasm0(owner, wasm.__wbindgen_malloc);\n        const len0 = WASM_VECTOR_LEN;\n        const ptr1 = passArray8ToWasm0(bucket_id, wasm.__wbindgen_malloc);\n        const len1 = WASM_VECTOR_LEN;\n        const ptr2 = passArray8ToWasm0(location, wasm.__wbindgen_malloc);\n        const len2 = WASM_VECTOR_LEN;\n        const ptr3 = passArray8ToWasm0(fingerprint, wasm.__wbindgen_malloc);\n        const len3 = WASM_VECTOR_LEN;\n        const ret = wasm.filemetadata_new(ptr0, len0, ptr1, len1, ptr2, len2, size, ptr3, len3);\n        if (ret[2]) {\n            throw takeFromExternrefTable0(ret[1]);\n        }\n        this.__wbg_ptr = ret[0] >>> 0;\n        FileMetadataFinalization.register(this, this.__wbg_ptr, this);\n        return this;\n    }\n    /**\n     * Returns the FileKey (blake2_256 hash of SCALE-encoded metadata) as a\n     * 32-byte `Uint8Array`.\n     * @returns {Uint8Array}\n     */\n    getFileKey() {\n        const ret = wasm.filemetadata_getFileKey(this.__wbg_ptr);\n        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();\n        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);\n        return v1;\n    }\n}\n\nconst FileTrieFinalization = (typeof FinalizationRegistry === 'undefined')\n    ? { register: () => {}, unregister: () => {} }\n    : new FinalizationRegistry(ptr => wasm.__wbg_filetrie_free(ptr >>> 0, 1));\n\nexport class FileTrie {\n\n    __destroy_into_raw() {\n        const ptr = this.__wbg_ptr;\n        this.__wbg_ptr = 0;\n        FileTrieFinalization.unregister(this);\n        return ptr;\n    }\n\n    free() {\n        const ptr = this.__destroy_into_raw();\n        wasm.__wbg_filetrie_free(ptr, 0);\n    }\n    constructor() {\n        const ret = wasm.filetrie_new();\n        this.__wbg_ptr = ret >>> 0;\n        FileTrieFinalization.register(this, this.__wbg_ptr, this);\n        return this;\n    }\n    /**\n     * @param {Uint8Array} bytes\n     */\n    push_chunk(bytes) {\n        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);\n        const len0 = WASM_VECTOR_LEN;\n        wasm.filetrie_push_chunk(this.__wbg_ptr, ptr0, len0);\n    }\n    /**\n     * Current Merkle root as a hex string.\n     * @returns {Uint8Array}\n     */\n    get_root() {\n        const ret = wasm.filetrie_get_root(this.__wbg_ptr);\n        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();\n        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);\n        return v1;\n    }\n}\n\nasync function __wbg_load(module, imports) {\n    if (typeof Response === 'function' && module instanceof Response) {\n        if (typeof WebAssembly.instantiateStreaming === 'function') {\n            try {\n                return await WebAssembly.instantiateStreaming(module, imports);\n\n            } catch (e) {\n                if (module.headers.get('Content-Type') != 'application/wasm') {\n                    console.warn(\"`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\\n\", e);\n\n                } else {\n                    throw e;\n                }\n            }\n        }\n\n        const bytes = await module.arrayBuffer();\n        return await WebAssembly.instantiate(bytes, imports);\n\n    } else {\n        const instance = await WebAssembly.instantiate(module, imports);\n\n        if (instance instanceof WebAssembly.Instance) {\n            return { instance, module };\n\n        } else {\n            return instance;\n        }\n    }\n}\n\nfunction __wbg_get_imports() {\n    const imports = {};\n    imports.wbg = {};\n    imports.wbg.__wbindgen_init_externref_table = function() {\n        const table = wasm.__wbindgen_export_0;\n        const offset = table.grow(4);\n        table.set(0, undefined);\n        table.set(offset + 0, undefined);\n        table.set(offset + 1, null);\n        table.set(offset + 2, true);\n        table.set(offset + 3, false);\n        ;\n    };\n    imports.wbg.__wbindgen_string_new = function(arg0, arg1) {\n        const ret = getStringFromWasm0(arg0, arg1);\n        return ret;\n    };\n    imports.wbg.__wbindgen_throw = function(arg0, arg1) {\n        throw new Error(getStringFromWasm0(arg0, arg1));\n    };\n\n    return imports;\n}\n\nfunction __wbg_init_memory(imports, memory) {\n\n}\n\nfunction __wbg_finalize_init(instance, module) {\n    wasm = instance.exports;\n    __wbg_init.__wbindgen_wasm_module = module;\n    cachedUint8ArrayMemory0 = null;\n\n\n    wasm.__wbindgen_start();\n    return wasm;\n}\n\nfunction initSync(module) {\n    if (wasm !== undefined) return wasm;\n\n\n    if (typeof module !== 'undefined') {\n        if (Object.getPrototypeOf(module) === Object.prototype) {\n            ({module} = module)\n        } else {\n            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')\n        }\n    }\n\n    const imports = __wbg_get_imports();\n\n    __wbg_init_memory(imports);\n\n    if (!(module instanceof WebAssembly.Module)) {\n        module = new WebAssembly.Module(module);\n    }\n\n    const instance = new WebAssembly.Instance(module, imports);\n\n    return __wbg_finalize_init(instance, module);\n}\n\nasync function __wbg_init(module_or_path) {\n    if (wasm !== undefined) return wasm;\n\n\n    if (typeof module_or_path !== 'undefined') {\n        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {\n            ({module_or_path} = module_or_path)\n        } else {\n            console.warn('using deprecated parameters for the initialization function; pass a single object instead')\n        }\n    }\n\n    if (typeof module_or_path === 'undefined') {\n        module_or_path = new URL('storagehub_wasm_bg.wasm', import.meta.url);\n    }\n    const imports = __wbg_get_imports();\n\n    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {\n        module_or_path = fetch(module_or_path);\n    }\n\n    __wbg_init_memory(imports);\n\n    const { instance, module } = await __wbg_load(await module_or_path, imports);\n\n    return __wbg_finalize_init(instance, module);\n}\n\nexport { initSync };\nexport default __wbg_init;\n", "export { FileMetadata, FileTrie } from '../wasm/pkg/storagehub_wasm.js';\n", "import { CHUNK_SIZE } from './constants';\nimport { FileMetadata, FileTrie } from './wasm.js';\nimport { TypeRegistry } from '@polkadot/types';\nimport type { AccountId, H256 } from '@polkadot/types/interfaces';\n\nexport class FileManager {\n  constructor(private readonly file: { size: number; stream: () => ReadableStream<Uint8Array> }) {}\n\n  private fingerprint?: H256;\n  private fileKey?: H256;\n\n  /**\n   * Stream the file's contents, feed every 1 kB chunk into a new FileTrie, and\n   * return the resulting Merkle root.\n   */\n  async getFingerprint(): Promise<H256> {\n    if (this.fingerprint) {\n      return this.fingerprint;\n    }\n\n    const registry = new TypeRegistry();\n    const trie = new FileTrie();\n\n    const stream = this.file.stream();\n    // ---\n    // Streaming fingerprint algorithm\n    // We want to feed the MerkleTrie with **fixed-size** `${CHUNK_SIZE}`-byte chunks\n    // but a `ReadableStream` gives us arbitrarily-sized `Uint8Array`s (default \u224864 KiB).\n    //\n    // Strategy\n    // 1. Keep an in-memory sliding buffer (`buffer`).\n    // 2. `bufferOffset` marks how much of that buffer has already been\n    //    consumed (pushed to the trie).\n    // 3. On each `reader.read()` we append the newly-read bytes after the\n    //    unconsumed tail.  Then, while we still have \u2265 CHUNK_SIZE bytes\n    //    available, cut a `${CHUNK_SIZE}`-byte window and push it into the trie.\n    // 4. Any leftover ( < CHUNK_SIZE ) stays in `buffer` to be prefixed by\n    //    the next read.\n    // ---\n    const reader = stream.getReader();\n    let buffer = new Uint8Array();\n    let bufferOffset = 0;\n\n    try {\n      while (true) {\n        // \u2500\u2500 Step-1: pull next blob fragment (\u224864 KiB) from the stream\n        const { done, value } = await reader.read();\n        if (done) break; // EOF \u21D2 exit outer loop\n\n        if (value && value.length) {\n          /*\n           * \u2500\u2500 Step-2: concatenate the newly-read bytes **after** any leftover\n           *            bytes we still haven\u2019t consumed (bufferOffset marks the\n           *            start of that tail).  We create a fresh Uint8Array to\n           *            avoid costly shifting of the existing buffer.\n           */\n          const unreadTail = buffer.subarray(bufferOffset);\n          const newBuffer = new Uint8Array(unreadTail.length + value.length);\n          newBuffer.set(unreadTail, 0);\n          newBuffer.set(value, unreadTail.length);\n          buffer = newBuffer;\n          bufferOffset = 0;\n\n          /*\n           * \u2500\u2500 Step-3: while the sliding-window holds at least one full\n           *            CHUNK_SIZE-byte block, slice it out and push it into the\n           *            trie.  We may loop multiple times if the stream chunk was\n           *            very large.\n           */\n          while (buffer.length - bufferOffset >= CHUNK_SIZE) {\n            const chunk = buffer.subarray(bufferOffset, bufferOffset + CHUNK_SIZE);\n            trie.push_chunk(chunk);\n            bufferOffset += CHUNK_SIZE;\n          }\n        }\n      }\n\n      // \u2500\u2500 Step-4: push the leftover bytes (< CHUNK_SIZE)\n      if (buffer.length - bufferOffset > 0) {\n        trie.push_chunk(buffer.subarray(bufferOffset));\n      }\n    } finally {\n      reader.releaseLock();\n    }\n\n    // Retrieve Merkle root from the trie and cache it\n    const rootHash = trie.get_root();\n    const fingerprint = registry.createType('H256', rootHash) as H256;\n\n    this.fingerprint = fingerprint;\n    return fingerprint;\n  }\n\n  /**\n   * Compute the FileKey for this file.\n   *\n   * The caller must provide:\n   *   \u2022 owner \u2013 32-byte AccountId (Uint8Array or 0x-prefixed hex string)\n   *   \u2022 bucketId \u2013 32-byte BucketId (Uint8Array or 0x-prefixed hex string)\n   *   \u2022 location \u2013 path string (encoded to bytes as-is)\n   */\n  async computeFileKey(owner: AccountId, bucketId: H256, location: string): Promise<H256> {\n    if (this.fileKey) {\n      return this.fileKey;\n    }\n\n    const fp = await this.getFingerprint();\n\n    const metadata = new FileMetadata(\n      owner.toU8a(),\n      bucketId.toU8a(),\n      new TextEncoder().encode(location),\n      BigInt(this.file.size),\n      fp.toU8a(),\n    );\n\n    const fileKey = metadata.getFileKey();\n    const registry = new TypeRegistry();\n    this.fileKey = registry.createType('H256', fileKey) as H256;\n    return this.fileKey;\n  }\n}\n", "export class HttpError extends Error {\n  public readonly status: number;\n  public readonly body?: unknown;\n\n  constructor(message: string, status: number, body?: unknown) {\n    super(message);\n    this.name = 'HttpError';\n    this.status = status;\n    this.body = body;\n  }\n}\n\nexport class NetworkError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'NetworkError';\n  }\n}\n\nexport class TimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n", "import { HttpError, NetworkError, TimeoutError } from './errors.js';\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\nexport type HttpClientConfig = {\n  baseUrl: string;\n  timeoutMs?: number;\n  defaultHeaders?: Record<string, string>;\n  fetchImpl?: typeof fetch;\n};\n\nexport type RequestOptions = {\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n  query?: Record<string, string | number | boolean>;\n  /**\n   * Optional request body. If a non-BodyInit object is provided and no\n   * explicit Content-Type header is set, it will be JSON-encoded with\n   * 'application/json'.\n   */\n  body?: BodyInit | unknown;\n  /**\n   * If true, returns the raw Response without consuming the body.\n   * Useful for streaming downloads.\n   */\n  raw?: boolean;\n};\n\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: HttpClientConfig) {\n    if (!options.baseUrl) throw new Error('HttpClient: baseUrl is required');\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.defaultHeaders = { Accept: 'application/json', ...(options.defaultHeaders ?? {}) };\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  async request<T>(\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE',\n    path: string,\n    options: RequestOptions = {},\n  ): Promise<T | Response> {\n    const url = this.buildUrl(path, options.query);\n    const headers = { ...this.defaultHeaders, ...(options.headers ?? {}) };\n\n    // Support timeout via AbortController if no external signal provided\n    const controller = !options.signal && this.timeoutMs > 0 ? new AbortController() : undefined;\n    const signal = options.signal ?? controller?.signal;\n\n    const timer: ReturnType<typeof setTimeout> | undefined = controller\n      ? setTimeout(() => controller.abort(), this.timeoutMs)\n      : undefined;\n\n    try {\n      // Auto-encode JSON bodies if caller passed a plain object and no Content-Type\n      const hasExplicitContentType = Object.keys(headers).some(\n        (h) => h.toLowerCase() === 'content-type',\n      );\n      const candidate = options.body;\n      let body: BodyInit | null = null;\n      if (candidate !== undefined && candidate !== null) {\n        if (this.isBodyInit(candidate)) {\n          body = candidate;\n        } else {\n          // For non-BodyInit payloads, send JSON\n          if (!hasExplicitContentType) headers['Content-Type'] = 'application/json';\n          body = JSON.stringify(candidate);\n        }\n      }\n\n      const init: RequestInit = {\n        method,\n        headers,\n        ...(signal ? { signal } : {}),\n        ...(body !== null ? { body } : {}),\n      };\n      const fetchFn =\n        typeof globalThis !== 'undefined' &&\n        this.fetchImpl === (globalThis as unknown as { fetch: typeof fetch }).fetch\n          ? (globalThis as unknown as { fetch: typeof fetch }).fetch.bind(globalThis)\n          : this.fetchImpl;\n      const res = await fetchFn(url, init);\n\n      // If the response is not OK, consume body for error details and throw\n      if (!res.ok) {\n        const text = await res.text();\n        const maybeJson = this.parseJsonSafely(text);\n        throw new HttpError(\n          `HTTP ${res.status} for ${method} ${url}`,\n          res.status,\n          maybeJson ?? text,\n        );\n      }\n\n      // If raw response requested, return it without consuming the body\n      if (options.raw) {\n        return res as Response;\n      }\n\n      // Normal response processing - consume and parse the body\n      const text = await res.text();\n      const maybeJson = this.parseJsonSafely(text);\n      return (maybeJson as T) ?? (text as unknown as T);\n    } catch (err: unknown) {\n      if (this.isAbortError(err)) {\n        throw new TimeoutError(`Request timed out for ${method} ${path}`);\n      }\n      if (err instanceof HttpError) throw err;\n      const msg = this.getErrorMessage(err);\n      throw new NetworkError(msg ?? `Network error for ${method} ${path}`);\n    } finally {\n      if (timer) clearTimeout(timer);\n    }\n  }\n\n  get<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>('GET', path, options) as Promise<T>;\n  }\n\n  post<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>('POST', path, options ?? {}) as Promise<T>;\n  }\n\n  put<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>('PUT', path, options ?? {}) as Promise<T>;\n  }\n\n  delete<T>(path: string, options?: RequestOptions): Promise<T> {\n    return this.request<T>('DELETE', path, options ?? {}) as Promise<T>;\n  }\n\n  getRaw(path: string, options?: RequestOptions): Promise<Response> {\n    return this.request('GET', path, { ...options, raw: true }) as Promise<Response>;\n  }\n\n  private buildUrl(path: string, query?: Record<string, string | number | boolean>): string {\n    const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n    const url = new URL(this.baseUrl + normalizedPath);\n\n    if (query) {\n      for (const [k, v] of Object.entries(query)) {\n        url.searchParams.set(k, String(v));\n      }\n    }\n\n    return url.toString();\n  }\n\n  private parseJsonSafely(text: string): unknown | undefined {\n    if (!text) return undefined;\n    try {\n      return JSON.parse(text);\n    } catch {\n      return undefined;\n    }\n  }\n\n  private isBodyInit(value: unknown): value is BodyInit {\n    return (\n      typeof value === 'string' ||\n      value instanceof Uint8Array ||\n      (typeof ArrayBuffer !== 'undefined' && value instanceof ArrayBuffer) ||\n      (typeof Blob !== 'undefined' && value instanceof Blob) ||\n      (typeof FormData !== 'undefined' && value instanceof FormData) ||\n      (typeof ReadableStream !== 'undefined' && value instanceof ReadableStream)\n    );\n  }\n\n  private isAbortError(err: unknown): err is { name: string } {\n    return (\n      typeof err === 'object' &&\n      err !== null &&\n      'name' in err &&\n      typeof (err as { name?: unknown }).name === 'string' &&\n      (err as { name: string }).name === 'AbortError'\n    );\n  }\n\n  private getErrorMessage(err: unknown): string | undefined {\n    if (typeof err === 'string') return err;\n    if (typeof err === 'object' && err !== null && 'message' in err) {\n      const m = (err as { message?: unknown }).message;\n      if (typeof m === 'string') return m;\n    }\n    return undefined;\n  }\n}\n", "let initPromise: Promise<void> | null = null;\n\nexport async function initWasm(): Promise<void> {\n  if (initPromise) {\n    // If initialization is already in progress, wait for the same Promise\n    return initPromise;\n  }\n\n  // Create the initialization Promise and store it\n  initPromise = (async () => {\n    // Import the web-style init function\n    const wasmInit = (await import('../wasm/pkg/storagehub_wasm.js')).default;\n\n    const wasmUrl = new URL('../wasm/pkg/storagehub_wasm_bg.wasm', import.meta.url);\n    if (typeof window === 'undefined') {\n      // Node.js: read WASM bytes and pass as ArrayBuffer\n      const fsMod = 'node:fs/promises';\n      const { readFile } = await import(fsMod);\n      const buf = await readFile(wasmUrl);\n      await wasmInit(buf);\n    } else {\n      // Browser: pass URL or fetch promise\n      await wasmInit(wasmUrl.href);\n    }\n  })();\n\n  return initPromise;\n}\n", "/**\n * Base abstraction for wallet integrations.\n *\n * Any concrete wallet (e.g. a browser extension wallet, a hardware wallet or a\n * mobile-SDK based wallet) must extend this class and implement the methods\n * for retrieving the active account address, sending transactions, and\n * signing arbitrary messages.\n */\nimport type { TransactionRequest } from 'ethers';\n\nexport abstract class WalletBase {\n  /**\n   * Return the public address for the currently selected account.\n   *\n   * Implementations may need to prompt the user to unlock the wallet or to\n   * choose an account if more than one is available.\n   */\n  public abstract getAddress(): Promise<string>;\n\n  /**\n   * Send a transaction through the wallet and return the transaction hash.\n   *\n   * This is the primary operation for most EIP-1193 compatible wallets which\n   * do not support producing detached transaction signatures.\n   */\n  public abstract sendTransaction(tx: TransactionRequest): Promise<string>;\n\n  /**\n   * Sign an arbitrary message and return the signature.\n   *\n   * This is commonly used for off-chain authentication flows (e.g. signing a\n   * nonce) or for verifying ownership of an address.\n   *\n   * @param msg The message to sign, either as raw bytes (`Uint8Array`) or a\n   *            regular UTF-8 string.\n   * @returns   A signature string, typically hex-encoded.\n   */\n  public abstract signMessage(msg: Uint8Array | string): Promise<string>;\n}\n", "import { WalletBase } from './base.js';\nimport { BrowserProvider, type Eip1193Provider, type TransactionRequest } from 'ethers';\n\ndeclare global {\n  /**\n   * EIP-1193 injected provider placed on the window object by browser wallets.\n   * The exact shape is library-specific; we wrap it via ethers' BrowserProvider.\n   */\n  interface Window {\n    ethereum?: unknown;\n  }\n}\n\n/**\n * Generic wallet integration for any EIP-1193 compliant injected provider.\n *\n * Implements the minimal `WalletBase` contract (fetching the current address,\n * sending transactions, and signing arbitrary messages) using ethers v6.\n */\nexport class Eip1193Wallet extends WalletBase {\n  private constructor(private readonly provider: BrowserProvider) {\n    super();\n  }\n\n  /**\n   * Create a wallet from an existing EIP-1193 provider instance.\n   */\n  public static fromProvider(provider: Eip1193Provider): Eip1193Wallet {\n    return new Eip1193Wallet(new BrowserProvider(provider));\n  }\n\n  /**\n   * Request connection to the injected provider at `window.ethereum` and\n   * create a new `Eip1193Wallet`.\n   *\n   * Internally this triggers the extension UI via `eth_requestAccounts` which\n   * asks the user to authorise account access.\n   *\n   * @throws If no injected provider is found.\n   */\n  public static async connect(): Promise<Eip1193Wallet> {\n    if (typeof window.ethereum === 'undefined') {\n      throw new Error('EIP-1193 provider not found. Please install a compatible wallet.');\n    }\n\n    const provider = new BrowserProvider(window.ethereum as Eip1193Provider);\n    await provider.send('eth_requestAccounts', []);\n    return new Eip1193Wallet(provider);\n  }\n\n  /** @inheritdoc */\n  public async getAddress(): Promise<string> {\n    const signer = await this.provider.getSigner();\n    return signer.getAddress();\n  }\n\n  /** @inheritdoc */\n  public async sendTransaction(tx: TransactionRequest): Promise<string> {\n    const signer = await this.provider.getSigner();\n    const txRequest: Partial<TransactionRequest> = {};\n    if (tx.to) txRequest.to = tx.to;\n    if (tx.data && tx.data !== '0x') txRequest.data = tx.data;\n    if (tx.value && tx.value !== 0n) txRequest.value = tx.value;\n    if (tx.gasLimit && tx.gasLimit !== 0n) txRequest.gasLimit = tx.gasLimit;\n    const response = await signer.sendTransaction(txRequest);\n    return response.hash;\n  }\n\n  /** @inheritdoc */\n  public async signMessage(msg: Uint8Array | string): Promise<string> {\n    const signer = await this.provider.getSigner();\n    return signer.signMessage(msg);\n  }\n}\n", "export type WalletErrorCode = 'InvalidPrivateKey' | 'InvalidMnemonic';\n\nexport class WalletError extends Error {\n  public readonly name = 'WalletError';\n  public readonly code: WalletErrorCode;\n\n  public constructor(code: WalletErrorCode, message?: string) {\n    super(message ?? code);\n    this.code = code;\n  }\n}\n", "import { WalletBase } from './base.js';\nimport { WalletError } from './errors.js';\nimport {\n  type HDNodeWallet,\n  hexlify,\n  type Provider,\n  Transaction,\n  type TransactionRequest,\n  Wallet as EthersWallet,\n} from 'ethers';\n\n/**\n * A local, in-memory wallet implementation.\n *\n * @warning This class is intended for development and testing purposes only.\n * It manages private keys in memory and is not suitable for production use\n * where secure key management is required.\n */\nexport class LocalWallet extends WalletBase {\n  private constructor(\n    private readonly wallet: EthersWallet | HDNodeWallet,\n    private readonly provider?: Provider,\n  ) {\n    super();\n  }\n\n  /**\n   * Create an instance from an existing private key.\n   *\n   * @param privateKey - A 0x-prefixed hex string containing the private key.\n   * @returns A new `LocalWallet` that can sign on behalf of the key\u02BCs address.\n   */\n  public static fromPrivateKey(privateKey: string, provider?: Provider): LocalWallet {\n    // Validate early to provide a stable error type regardless of ethers internals\n    const isHex = /^0x[0-9a-fA-F]{64}$/.test(privateKey);\n    if (!isHex) throw new WalletError('InvalidPrivateKey');\n\n    try {\n      return new LocalWallet(new EthersWallet(privateKey, provider), provider);\n    } catch {\n      throw new WalletError('InvalidPrivateKey');\n    }\n  }\n\n  /**\n   * Create an instance from a BIP-39 mnemonic phrase.\n   *\n   * @param mnemonic - The 12/24-word mnemonic phrase.\n   * @returns A new `LocalWallet` bound to the first account derived from the\n   *          mnemonic.\n   */\n  public static fromMnemonic(mnemonic: string, provider?: Provider): LocalWallet {\n    try {\n      const wallet = EthersWallet.fromPhrase(mnemonic);\n      const connected = provider ? wallet.connect(provider) : wallet;\n      return new LocalWallet(connected, provider);\n    } catch {\n      throw new WalletError('InvalidMnemonic');\n    }\n  }\n\n  /**\n   * Generate a brand-new keypair on the fly.\n   *\n   * @returns A freshly generated `LocalWallet` with a random private key.\n   */\n  public static createRandom(provider?: Provider): LocalWallet {\n    const wallet = EthersWallet.createRandom();\n    const connected = provider ? wallet.connect(provider) : wallet;\n    return new LocalWallet(connected, provider);\n  }\n\n  /** @inheritdoc */\n  public getAddress(): Promise<string> {\n    return Promise.resolve(this.wallet.address);\n  }\n\n  public signTransaction(tx: Uint8Array): Promise<string> {\n    const hexTx = hexlify(tx);\n    return this.wallet.signTransaction(Transaction.from(hexTx));\n  }\n\n  /** @inheritdoc */\n  public async sendTransaction(tx: TransactionRequest): Promise<string> {\n    if (!this.provider) {\n      throw new Error('No provider configured for LocalWallet; cannot send transaction');\n    }\n    const connected = this.wallet.connect(this.provider);\n    const response = await connected.sendTransaction(tx);\n    return response.hash;\n  }\n\n  /** @inheritdoc */\n  public signMessage(msg: Uint8Array | string): Promise<string> {\n    return this.wallet.signMessage(msg);\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["storagehub_wasm_exports", "__export", "FileMetadata", "FileTrie", "storagehub_wasm_default", "initSync", "getUint8ArrayMemory0", "cachedUint8ArrayMemory0", "wasm", "getStringFromWasm0", "ptr", "len", "cachedTextDecoder", "passArray8ToWasm0", "arg", "malloc", "WASM_VECTOR_LEN", "getArrayU8FromWasm0", "takeFromExternrefTable0", "idx", "value", "__wbg_load", "module", "imports", "e", "bytes", "instance", "__wbg_get_imports", "table", "offset", "arg0", "arg1", "__wbg_finalize_init", "__wbg_init", "module_or_path", "FileMetadataFinalization", "FileTrieFinalization", "init_storagehub_wasm", "__esmMin", "owner", "bucket_id", "location", "size", "fingerprint", "ptr0", "len0", "ptr1", "len1", "ptr2", "len2", "ptr3", "len3", "ret", "v1", "init_storagehub_wasm", "TypeRegistry", "FileManager", "file", "registry", "trie", "FileTrie", "reader", "buffer", "bufferOffset", "done", "value", "unreadTail", "newBuffer", "chunk", "rootHash", "fingerprint", "owner", "bucketId", "location", "fp", "fileKey", "FileMetadata", "HttpError", "message", "status", "body", "NetworkError", "TimeoutError", "DEFAULT_TIMEOUT_MS", "HttpClient", "options", "method", "path", "url", "headers", "controller", "signal", "timer", "hasExplicitContentType", "h", "candidate", "body", "init", "res", "text", "maybeJson", "HttpError", "err", "TimeoutError", "msg", "NetworkError", "query", "normalizedPath", "k", "v", "value", "m", "initPromise", "initWasm", "wasmInit", "wasmUrl", "fsMod", "readFile", "buf", "WalletBase", "BrowserProvider", "Eip1193Wallet", "_Eip1193Wallet", "WalletBase", "provider", "tx", "signer", "txRequest", "msg", "WalletError", "code", "message", "hexlify", "Transaction", "EthersWallet", "LocalWallet", "_LocalWallet", "WalletBase", "wallet", "provider", "privateKey", "WalletError", "mnemonic", "connected", "tx", "hexTx", "msg"]
+}

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function initWasm(): Promise<void>;

package/dist/wallet/base.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Base abstraction for wallet integrations.
+ *
+ * Any concrete wallet (e.g. a browser extension wallet, a hardware wallet or a
+ * mobile-SDK based wallet) must extend this class and implement the methods
+ * for retrieving the active account address, sending transactions, and
+ * signing arbitrary messages.
+ */
+import type { TransactionRequest } from 'ethers';
+export declare abstract class WalletBase {
+    /**
+     * Return the public address for the currently selected account.
+     *
+     * Implementations may need to prompt the user to unlock the wallet or to
+     * choose an account if more than one is available.
+     */
+    abstract getAddress(): Promise<string>;
+    /**
+     * Send a transaction through the wallet and return the transaction hash.
+     *
+     * This is the primary operation for most EIP-1193 compatible wallets which
+     * do not support producing detached transaction signatures.
+     */
+    abstract sendTransaction(tx: TransactionRequest): Promise<string>;
+    /**
+     * Sign an arbitrary message and return the signature.
+     *
+     * This is commonly used for off-chain authentication flows (e.g. signing a
+     * nonce) or for verifying ownership of an address.
+     *
+     * @param msg The message to sign, either as raw bytes (`Uint8Array`) or a
+     *            regular UTF-8 string.
+     * @returns   A signature string, typically hex-encoded.
+     */
+    abstract signMessage(msg: Uint8Array | string): Promise<string>;
+}

package/dist/wallet/eip1193.d.ts

@@ -0,0 +1,41 @@
+import { WalletBase } from './base.js';
+import { type Eip1193Provider, type TransactionRequest } from 'ethers';
+declare global {
+    /**
+     * EIP-1193 injected provider placed on the window object by browser wallets.
+     * The exact shape is library-specific; we wrap it via ethers' BrowserProvider.
+     */
+    interface Window {
+        ethereum?: unknown;
+    }
+}
+/**
+ * Generic wallet integration for any EIP-1193 compliant injected provider.
+ *
+ * Implements the minimal `WalletBase` contract (fetching the current address,
+ * sending transactions, and signing arbitrary messages) using ethers v6.
+ */
+export declare class Eip1193Wallet extends WalletBase {
+    private readonly provider;
+    private constructor();
+    /**
+     * Create a wallet from an existing EIP-1193 provider instance.
+     */
+    static fromProvider(provider: Eip1193Provider): Eip1193Wallet;
+    /**
+     * Request connection to the injected provider at `window.ethereum` and
+     * create a new `Eip1193Wallet`.
+     *
+     * Internally this triggers the extension UI via `eth_requestAccounts` which
+     * asks the user to authorise account access.
+     *
+     * @throws If no injected provider is found.
+     */
+    static connect(): Promise<Eip1193Wallet>;
+    /** @inheritdoc */
+    getAddress(): Promise<string>;
+    /** @inheritdoc */
+    sendTransaction(tx: TransactionRequest): Promise<string>;
+    /** @inheritdoc */
+    signMessage(msg: Uint8Array | string): Promise<string>;
+}

package/dist/wallet/errors.d.ts

@@ -0,0 +1,6 @@
+export type WalletErrorCode = 'InvalidPrivateKey' | 'InvalidMnemonic';
+export declare class WalletError extends Error {
+    readonly name = "WalletError";
+    readonly code: WalletErrorCode;
+    constructor(code: WalletErrorCode, message?: string);
+}

package/dist/wallet/local.d.ts

@@ -0,0 +1,42 @@
+import { WalletBase } from './base.js';
+import { type Provider, type TransactionRequest } from 'ethers';
+/**
+ * A local, in-memory wallet implementation.
+ *
+ * @warning This class is intended for development and testing purposes only.
+ * It manages private keys in memory and is not suitable for production use
+ * where secure key management is required.
+ */
+export declare class LocalWallet extends WalletBase {
+    private readonly wallet;
+    private readonly provider?;
+    private constructor();
+    /**
+     * Create an instance from an existing private key.
+     *
+     * @param privateKey - A 0x-prefixed hex string containing the private key.
+     * @returns A new `LocalWallet` that can sign on behalf of the keyʼs address.
+     */
+    static fromPrivateKey(privateKey: string, provider?: Provider): LocalWallet;
+    /**
+     * Create an instance from a BIP-39 mnemonic phrase.
+     *
+     * @param mnemonic - The 12/24-word mnemonic phrase.
+     * @returns A new `LocalWallet` bound to the first account derived from the
+     *          mnemonic.
+     */
+    static fromMnemonic(mnemonic: string, provider?: Provider): LocalWallet;
+    /**
+     * Generate a brand-new keypair on the fly.
+     *
+     * @returns A freshly generated `LocalWallet` with a random private key.
+     */
+    static createRandom(provider?: Provider): LocalWallet;
+    /** @inheritdoc */
+    getAddress(): Promise<string>;
+    signTransaction(tx: Uint8Array): Promise<string>;
+    /** @inheritdoc */
+    sendTransaction(tx: TransactionRequest): Promise<string>;
+    /** @inheritdoc */
+    signMessage(msg: Uint8Array | string): Promise<string>;
+}

package/dist/wasm.d.ts

@@ -0,0 +1 @@
+export { FileMetadata, FileTrie } from '../wasm/pkg/storagehub_wasm.js';

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@storagehub-sdk/core",
+  "version": "0.0.1",
+  "description": "Core primitives for StorageHub SDK (types, crypto, filemanager, storage, wasm bindings)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./wasm/pkg/*": "./wasm/pkg/*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "wasm/pkg",
+    "README.md"
+  ],
+  "dependencies": {
+    "@polkadot/types": "^10.10.3",
+    "ethers": "^6.15.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "2.1.4",
+    "@types/node": "^20.11.19"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "node ../scripts/build.js",
+    "build:types": "tsc --emitDeclarationOnly -p tsconfig.json",
+    "dev": "node ../scripts/build.js --watch",
+    "lint": "eslint \"{src/**/*.ts,src/**/*.tsx}\"",
+    "format": "prettier --write \"{src/**/*.ts,src/**/*.tsx}\"",
+    "format:check": "prettier --check \"{src/**/*.ts,src/**/*.tsx}\"",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "coverage": "vitest run --coverage",
+    "build:wasm": "wasm-pack build ./wasm --target web --release --out-dir pkg && rm -f ./wasm/pkg/package.json ./wasm/pkg/.gitignore"
+  }
+}

package/wasm/pkg/storagehub_wasm.d.ts

@@ -0,0 +1,65 @@
+/* tslint:disable */
+/* eslint-disable */
+export class FileMetadata {
+  free(): void;
+  /**
+   * Constructs a new `FileMetadata`.
+   * * `owner`, `bucket_id`, `fingerprint` – 32-byte arrays (passed as slices)
+   * * `location` – arbitrary byte string (file path)
+   * * `size` – file size in bytes
+   */
+  constructor(owner: Uint8Array, bucket_id: Uint8Array, location: Uint8Array, size: bigint, fingerprint: Uint8Array);
+  /**
+   * Returns the FileKey (blake2_256 hash of SCALE-encoded metadata) as a
+   * 32-byte `Uint8Array`.
+   */
+  getFileKey(): Uint8Array;
+}
+export class FileTrie {
+  free(): void;
+  constructor();
+  push_chunk(bytes: Uint8Array): void;
+  /**
+   * Current Merkle root as a hex string.
+   */
+  get_root(): Uint8Array;
+}
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+  readonly memory: WebAssembly.Memory;
+  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_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 __wbindgen_export_0: WebAssembly.Table;
+  readonly __wbindgen_malloc: (a: number, b: number) => number;
+  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+  readonly __externref_table_dealloc: (a: number) => void;
+  readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+/**
+* Instantiates the given `module`, which can either be bytes or
+* a precompiled `WebAssembly.Module`.
+*
+* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+*
+* @returns {InitOutput}
+*/
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+* for everything else, calls `WebAssembly.instantiate` directly.
+*
+* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+*
+* @returns {Promise<InitOutput>}
+*/
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;

package/wasm/pkg/storagehub_wasm.js

@@ -0,0 +1,265 @@
+let wasm;
+
+const cachedTextDecoder = (typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8', { ignoreBOM: true, fatal: true }) : { decode: () => { throw Error('TextDecoder not available') } } );
+
+if (typeof TextDecoder !== 'undefined') { cachedTextDecoder.decode(); };
+
+let cachedUint8ArrayMemory0 = null;
+
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+let WASM_VECTOR_LEN = 0;
+
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    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;
+}
+
+const FileMetadataFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_filemetadata_free(ptr >>> 0, 1));
+
+export class FileMetadata {
+
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        FileMetadataFinalization.unregister(this);
+        return ptr;
+    }
+
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_filemetadata_free(ptr, 0);
+    }
+    /**
+     * Constructs a new `FileMetadata`.
+     * * `owner`, `bucket_id`, `fingerprint` – 32-byte arrays (passed as slices)
+     * * `location` – arbitrary byte string (file path)
+     * * `size` – file size in bytes
+     * @param {Uint8Array} owner
+     * @param {Uint8Array} bucket_id
+     * @param {Uint8Array} location
+     * @param {bigint} size
+     * @param {Uint8Array} fingerprint
+     */
+    constructor(owner, bucket_id, location, size, fingerprint) {
+        const ptr0 = passArray8ToWasm0(owner, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passArray8ToWasm0(bucket_id, wasm.__wbindgen_malloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passArray8ToWasm0(location, wasm.__wbindgen_malloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passArray8ToWasm0(fingerprint, wasm.__wbindgen_malloc);
+        const len3 = WASM_VECTOR_LEN;
+        const ret = wasm.filemetadata_new(ptr0, len0, ptr1, len1, ptr2, len2, size, ptr3, len3);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0] >>> 0;
+        FileMetadataFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Returns the FileKey (blake2_256 hash of SCALE-encoded metadata) as a
+     * 32-byte `Uint8Array`.
+     * @returns {Uint8Array}
+     */
+    getFileKey() {
+        const ret = wasm.filemetadata_getFileKey(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+}
+
+const FileTrieFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_filetrie_free(ptr >>> 0, 1));
+
+export class FileTrie {
+
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        FileTrieFinalization.unregister(this);
+        return ptr;
+    }
+
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_filetrie_free(ptr, 0);
+    }
+    constructor() {
+        const ret = wasm.filetrie_new();
+        this.__wbg_ptr = ret >>> 0;
+        FileTrieFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @param {Uint8Array} bytes
+     */
+    push_chunk(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.filetrie_push_chunk(this.__wbg_ptr, ptr0, len0);
+    }
+    /**
+     * Current Merkle root as a hex string.
+     * @returns {Uint8Array}
+     */
+    get_root() {
+        const ret = wasm.filetrie_get_root(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+
+            } catch (e) {
+                if (module.headers.get('Content-Type') != 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else {
+                    throw e;
+                }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+
+        } else {
+            return instance;
+        }
+    }
+}
+
+function __wbg_get_imports() {
+    const imports = {};
+    imports.wbg = {};
+    imports.wbg.__wbindgen_init_externref_table = function() {
+        const table = wasm.__wbindgen_export_0;
+        const offset = table.grow(4);
+        table.set(0, undefined);
+        table.set(offset + 0, undefined);
+        table.set(offset + 1, null);
+        table.set(offset + 2, true);
+        table.set(offset + 3, false);
+        ;
+    };
+    imports.wbg.__wbindgen_string_new = function(arg0, arg1) {
+        const ret = getStringFromWasm0(arg0, arg1);
+        return ret;
+    };
+    imports.wbg.__wbindgen_throw = function(arg0, arg1) {
+        throw new Error(getStringFromWasm0(arg0, arg1));
+    };
+
+    return imports;
+}
+
+function __wbg_init_memory(imports, memory) {
+
+}
+
+function __wbg_finalize_init(instance, module) {
+    wasm = instance.exports;
+    __wbg_init.__wbindgen_wasm_module = module;
+    cachedUint8ArrayMemory0 = null;
+
+
+    wasm.__wbindgen_start();
+    return wasm;
+}
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (typeof module !== 'undefined') {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+
+    __wbg_init_memory(imports);
+
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+
+    const instance = new WebAssembly.Instance(module, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+async function __wbg_init(module_or_path) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (typeof module_or_path !== 'undefined') {
+        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
+            ({module_or_path} = module_or_path)
+        } else {
+            console.warn('using deprecated parameters for the initialization function; pass a single object instead')
+        }
+    }
+
+    if (typeof module_or_path === 'undefined') {
+        module_or_path = new URL('storagehub_wasm_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
+        module_or_path = fetch(module_or_path);
+    }
+
+    __wbg_init_memory(imports);
+
+    const { instance, module } = await __wbg_load(await module_or_path, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync };
+export default __wbg_init;

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

@@ -0,0 +1,15 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+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_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 __wbindgen_export_0: WebAssembly.Table;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_start: () => void;