@storagehub-sdk/core 0.2.0 → 0.3.0

package/README.md

@@ -45,7 +45,7 @@ The Core SDK provides seamless integration with StorageHub's EVM precompiles, of
 #### StorageHubClient - Unified EVM Interface
 
 ```ts
-import { StorageHubClient } from '@storagehub-sdk/core';
+import { StorageHubClient, SH_FILE_SYSTEM_PRECOMPILE_ADDRESS } from '@storagehub-sdk/core';
 import { createWalletClient, defineChain, http } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 
@@ -69,7 +69,8 @@ const walletClient = createWalletClient({
 const hub = new StorageHubClient({
   rpcUrl: 'http://localhost:9944',
   chain: storageHubChain,
-  walletClient
+  walletClient,
+  filesystemContractAddress: SH_FILE_SYSTEM_PRECOMPILE_ADDRESS
 });
 ```
 
@@ -107,7 +108,7 @@ const txHash2 = await hub.updateBucketPrivacy('0xBucketId', true, {
 **Storage Operations:**
 - `issueStorageRequest(bucketId, location, fingerprint, size, mspId, peerIds, replicationTarget, customReplicationTarget, options?)`
 - `revokeStorageRequest(fileKey, options?)`
-- `requestDeleteFile(signedIntention, signature, bucketId, location, size, fingerprint, options?)`
+- `requestDeleteFile(fileInfo, options?)`
 
 **Collections:**
 - `createAndAssociateCollectionWithBucket(bucketId, options?)`

package/dist/evm/storageHubClient.d.ts

@@ -8,10 +8,16 @@
  * Binary data (signatures) are passed as Uint8Array. Hex values are 0x-prefixed strings (32-byte IDs).
  */
 import { filesystemAbi } from "../abi/filesystem";
+import type { FileInfo } from "../types";
 import type { EvmWriteOptions, StorageHubClientOptions } from "./types";
-import type { ReplicationLevel } from "./types";
+import { type ReplicationLevel } from "./types";
 import { type Address } from "viem";
 export { filesystemAbi };
+/**
+ * Default precompile address for FileSystem on StorageHub runtimes.
+ * If a chain uses a different address, this constant should be updated accordingly.
+ */
+export declare const SH_FILE_SYSTEM_PRECOMPILE_ADDRESS: Address;
 export declare class StorageHubClient {
     private readonly publicClient;
     private readonly walletClient;
@@ -58,13 +64,21 @@ 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
+     */
+    private signIntention;
     /**
      * Create a StorageHub client with automatic gas estimation.
      *
      * @param opts.rpcUrl - RPC endpoint URL for the StorageHub chain
      * @param opts.chain - Viem chain configuration
      * @param opts.walletClient - Wallet client for transaction signing
-     * @param opts.filesystemContractAddress - Optional filesystem precompile address
+     * @param opts.filesystemContractAddress - Filesystem precompile address
      */
     constructor(opts: StorageHubClientOptions);
     /**
@@ -136,14 +150,10 @@ export declare class StorageHubClient {
      */
     revokeStorageRequest(fileKey: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
     /**
-     * Request deletion of a file using a signed intention.
-     * @param signedIntention - tuple [fileKey: 0x32, operation: number] where operation must be 0 (Delete)
-     * @param signature - 65-byte secp256k1 signature over the SCALE-encoded intention
-     * @param bucketId - 32-byte bucket ID
-     * @param location - file path as string (max 512 UTF-8 bytes)
-     * @param size - file size as bigint (storage units)
-     * @param fingerprint - 32-byte file fingerprint
-     * @param options - optional gas and fee overrides
+     * Request deletion of a file from the network.
+     * @param fileInfo File information containing all required data
+     * @param options Optional transaction options
+     * @returns Transaction hash
      */
-    requestDeleteFile(signedIntention: readonly [`0x${string}`, number], signature: Uint8Array, bucketId: `0x${string}`, location: string, size: bigint, fingerprint: `0x${string}`, options?: EvmWriteOptions): Promise<`0x${string}` | undefined>;
+    requestDeleteFile(fileInfo: FileInfo, options?: EvmWriteOptions): Promise<`0x${string}`>;
 }

package/dist/evm/types.d.ts

@@ -19,9 +19,9 @@ export type StorageHubClientOptions = {
      */
     walletClient: WalletClient;
     /**
-     * Filesystem precompile contract address (optional, defaults to standard address)
+     * Filesystem precompile contract address
      */
-    filesystemContractAddress?: Address;
+    filesystemContractAddress: Address;
 };
 /**
  * Optional EVM write overrides for SDK calls.
@@ -75,3 +75,10 @@ export declare enum ReplicationLevel {
     /** Custom replication (requires specifying exact replica count) */
     Custom = 5
 }
+/**
+ * File operations supported by the StorageHub protocol.
+ */
+export declare enum FileOperation {
+    /** Delete operation for a file */
+    Delete = 0
+}