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

package/dist/abi/FileSystem.abi.d.ts

@@ -0,0 +1,334 @@
+export declare const filesystemAbi: readonly [{
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "mspId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "BucketCreated";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "BucketDeleted";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "newMspId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "BucketMoveRequested";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "_private";
+        readonly type: "bool";
+    }];
+    readonly name: "BucketPrivacyUpdated";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "collectionId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "CollectionCreated";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "fileKey";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly name: "FileDeletionRequested";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "who";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "fileKey";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "StorageRequestIssued";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "fileKey";
+        readonly type: "bytes32";
+    }];
+    readonly name: "StorageRequestRevoked";
+    readonly type: "event";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "createAndAssociateCollectionWithBucket";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "mspId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "name";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "bool";
+        readonly name: "_private";
+        readonly type: "bool";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "valuePropId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "createBucket";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "deleteBucket";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "name";
+        readonly type: "bytes";
+    }];
+    readonly name: "deriveBucketId";
+    readonly outputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly name: "getPendingFileDeletionRequestsCount";
+    readonly outputs: readonly [{
+        readonly internalType: "uint32";
+        readonly name: "count";
+        readonly type: "uint32";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "location";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "fingerprint";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "uint64";
+        readonly name: "size";
+        readonly type: "uint64";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "mspId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes[]";
+        readonly name: "peerIds";
+        readonly type: "bytes[]";
+    }, {
+        readonly internalType: "enum FileSystem.ReplicationTarget";
+        readonly name: "replicationTarget";
+        readonly type: "uint8";
+    }, {
+        readonly internalType: "uint32";
+        readonly name: "customReplicationTarget";
+        readonly type: "uint32";
+    }];
+    readonly name: "issueStorageRequest";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "bytes32";
+            readonly name: "fileKey";
+            readonly type: "bytes32";
+        }, {
+            readonly internalType: "enum FileSystem.FileOperation";
+            readonly name: "operation";
+            readonly type: "uint8";
+        }];
+        readonly internalType: "struct FileSystem.FileOperationIntention";
+        readonly name: "signedIntention";
+        readonly type: "tuple";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes";
+        readonly name: "location";
+        readonly type: "bytes";
+    }, {
+        readonly internalType: "uint64";
+        readonly name: "size";
+        readonly type: "uint64";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "fingerprint";
+        readonly type: "bytes32";
+    }];
+    readonly name: "requestDeleteFile";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "newMspId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bytes32";
+        readonly name: "newValuePropId";
+        readonly type: "bytes32";
+    }];
+    readonly name: "requestMoveBucket";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "fileKey";
+        readonly type: "bytes32";
+    }];
+    readonly name: "revokeStorageRequest";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "bytes32";
+        readonly name: "bucketId";
+        readonly type: "bytes32";
+    }, {
+        readonly internalType: "bool";
+        readonly name: "_private";
+        readonly type: "bool";
+    }];
+    readonly name: "updateBucketPrivacy";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];

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 { filesystemAbi } from "../abi/filesystem";
+import { type Address } from "viem";
+import { filesystemAbi } from "../abi/FileSystem.abi";
 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,12 +27,6 @@ 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.
      *
@@ -64,10 +58,6 @@ 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
      */
@@ -87,13 +77,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<unknown> | undefined;
+    deriveBucketId(owner: Address, name: string): Promise<`0x${string}`>;
     /**
      * Get how many file deletion requests a user currently has pending.
      * @param user - user EVM address
      * @returns count as number
      */
-    getPendingFileDeletionRequestsCount(user: Address): Promise<unknown> | undefined;
+    getPendingFileDeletionRequestsCount(user: Address): Promise<number>;
     /**
      * Create a new bucket.
      * @param mspId - 32-byte MSP ID (0x-prefixed hex)
@@ -102,7 +92,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}` | undefined>;
+    createBucket(mspId: `0x${string}`, name: string, isPrivate: boolean, valuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * Request moving a bucket to a new MSP/value proposition.
      * @param bucketId - 32-byte bucket ID
@@ -110,26 +100,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}` | undefined>;
+    requestMoveBucket(bucketId: `0x${string}`, newMspId: `0x${string}`, newValuePropId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * 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}` | undefined>;
+    updateBucketPrivacy(bucketId: `0x${string}`, isPrivate: boolean, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * 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}` | undefined>;
+    createAndAssociateCollectionWithBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * 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}` | undefined>;
+    deleteBucket(bucketId: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * Issue a storage request for a file.
      * @param bucketId - 32-byte bucket ID
@@ -142,13 +132,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}` | undefined>;
+    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}`>;
     /**
      * 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}` | undefined>;
+    revokeStorageRequest(fileKey: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}`>;
     /**
      * Request deletion of a file from the network.
      * @param fileInfo File information containing all required data