@storagehub-sdk/core 0.3.5-dev.1 → 0.4.2-dev.1

package/dist/abi/filesystem.d.ts

@@ -0,0 +1,49 @@
+export declare const filesystemAbi: ({
+    anonymous: boolean;
+    inputs: {
+        indexed: boolean;
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    type: string;
+    outputs?: never;
+    stateMutability?: never;
+} | {
+    inputs: {
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        internalType: string;
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+    anonymous?: never;
+} | {
+    inputs: ({
+        components: {
+            internalType: string;
+            name: string;
+            type: string;
+        }[];
+        internalType: string;
+        name: string;
+        type: string;
+    } | {
+        internalType: string;
+        name: string;
+        type: string;
+        components?: never;
+    })[];
+    name: string;
+    outputs: never[];
+    stateMutability: string;
+    type: string;
+    anonymous?: never;
+})[];

package/dist/evm/storageHubClient.d.ts

@@ -7,11 +7,11 @@
  * All arguments are strongly typed. String data (names, paths) are passed as strings and encoded internally.
  * Binary data (signatures) are passed as Uint8Array. Hex values are 0x-prefixed strings (32-byte IDs).
  */
-import { type Address } from "viem";
-import { filesystemAbi } from "../abi/FileSystem.abi";
+import { filesystemAbi } from "../abi/filesystem";
 import type { FileInfo } from "../types";
 import type { EvmWriteOptions, StorageHubClientOptions } from "./types";
 import { type ReplicationLevel } from "./types";
+import { type Address } from "viem";
 export { filesystemAbi };
 /**
  * Default precompile address for FileSystem on StorageHub runtimes.
@@ -27,6 +27,12 @@ export declare class StorageHubClient {
     private static readonly MAX_PEER_ID_BYTES;
     private static readonly DEFAULT_GAS_MULTIPLIER;
     private static readonly DEFAULT_GAS_PRICE;
+    /**
+     * Get write contract instance bound to the wallet client.
+     *
+     * @returns Contract instance for write operations (transactions)
+     */
+    private getWriteContract;
     /**
      * Get read contract instance bound to the public client.
      *
@@ -48,6 +54,10 @@ export declare class StorageHubClient {
     /**
      * Build transaction options with gas and fee settings.
      * Handles both legacy and EIP-1559 fee structures.
+     *
+     * Note: `chain: null` is set to ensure compatibility with wallet clients that don't
+     * properly expose chain information (e.g., Reown's Social Login). This tells viem
+     * to use the wallet's currently selected chain rather than trying to fetch chainId.
      */
     private buildTxOptions;
     /**
@@ -58,6 +68,10 @@ export declare class StorageHubClient {
      * @returns 0x-prefixed hex string
      */
     private validateStringLength;
+    /**
+     * Assert that a value is present (non-null and non-undefined).
+     */
+    private assertPresent;
     /**
      * Serialize FileOperationIntention and sign it
      */
@@ -77,13 +91,13 @@ export declare class StorageHubClient {
      * @param name - bucket name as string (max 100 UTF-8 bytes)
      * @returns bucketId as 0x-prefixed 32-byte hex
      */
-    deriveBucketId(owner: Address, name: string): Promise<`0x${string}`>;
+    deriveBucketId(owner: Address, name: string): Promise<unknown> | undefined;
     /**
      * Get how many file deletion requests a user currently has pending.
      * @param user - user EVM address
      * @returns count as number
      */
-    getPendingFileDeletionRequestsCount(user: Address): Promise<number>;
+    getPendingFileDeletionRequestsCount(user: Address): Promise<unknown> | undefined;
     /**
      * Create a new bucket.
      * @param mspId - 32-byte MSP ID (0x-prefixed hex)
@@ -92,7 +106,7 @@ export declare class StorageHubClient {
      * @param valuePropId - 32-byte value proposition ID (0x-prefixed hex)
      * @param options - optional gas and fee overrides
      */
-    createBucket(mspId: `0x${string}`, name: string, isPrivate: boolean, valuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    createBucket(mspId: `0x${string}`, name: string, isPrivate: boolean, valuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Request moving a bucket to a new MSP/value proposition.
      * @param bucketId - 32-byte bucket ID
@@ -100,26 +114,26 @@ export declare class StorageHubClient {
      * @param newValuePropId - 32-byte new value proposition ID
      * @param options - optional gas and fee overrides
      */
-    requestMoveBucket(bucketId: `0x${string}`, newMspId: `0x${string}`, newValuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    requestMoveBucket(bucketId: `0x${string}`, newMspId: `0x${string}`, newValuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Update bucket privacy flag.
      * @param bucketId - 32-byte bucket ID
      * @param isPrivate - true for private
      * @param options - optional gas and fee overrides
      */
-    updateBucketPrivacy(bucketId: `0x${string}`, isPrivate: boolean, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    updateBucketPrivacy(bucketId: `0x${string}`, isPrivate: boolean, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Create and associate a collection with a bucket.
      * @param bucketId - 32-byte bucket ID
      * @param options - optional gas and fee overrides
      */
-    createAndAssociateCollectionWithBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    createAndAssociateCollectionWithBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Delete an empty bucket.
      * @param bucketId - 32-byte bucket ID
      * @param options - optional gas and fee overrides
      */
-    deleteBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    deleteBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Issue a storage request for a file.
      * @param bucketId - 32-byte bucket ID
@@ -132,13 +146,13 @@ export declare class StorageHubClient {
      * @param replicas - number of replicas (only required for ReplicationLevel.Custom)
      * @param options - optional gas and fee overrides
      */
-    issueStorageRequest(bucketId: `0x${string}`, location: string, fingerprint: `0x${string}`, size: bigint, mspId: `0x${string}`, peerIds: string[], replicationLevel: ReplicationLevel, replicas: number, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    issueStorageRequest(bucketId: `0x${string}`, location: string, fingerprint: `0x${string}`, size: bigint, mspId: `0x${string}`, peerIds: string[], replicationLevel: ReplicationLevel, replicas: number, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Revoke a pending storage request by file key.
      * @param fileKey - 32-byte file key
      * @param options - optional gas and fee overrides
      */
-    revokeStorageRequest(fileKey: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
+    revokeStorageRequest(fileKey: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
      * Request deletion of a file from the network.
      * @param fileInfo File information containing all required data