@storagehub-sdk/core 0.0.5 → 0.1.1

package/dist/evm/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Type definitions for StorageHub EVM client
+ */
+import type { Address, Chain, WalletClient } from "viem";
+/**
+ * Configuration options for StorageHubClient
+ */
+export type StorageHubClientOptions = {
+    /**
+     * RPC endpoint URL for the StorageHub chain
+     */
+    rpcUrl: string;
+    /**
+     * Viem chain configuration
+     */
+    chain: Chain;
+    /**
+     * Wallet client for transaction signing
+     */
+    walletClient: WalletClient;
+    /**
+     * Filesystem precompile contract address (optional, defaults to standard address)
+     */
+    filesystemContractAddress?: Address;
+};
+/**
+ * Optional EVM write overrides for SDK calls.
+ *
+ * Use these when you need to customize the transaction envelope or
+ * sidestep under-estimation issues on Frontier/weight based pallets.
+ *
+ * - If `gas` is not provided, the SDK will estimate gas for the function
+ *   and apply `gasMultiplier` (default 5) for headroom.
+ * - You can provide legacy `gasPrice`, or EIP-1559 fees via
+ *   `maxFeePerGas` and `maxPriorityFeePerGas`.
+ */
+export type EvmWriteOptions = {
+    /**
+     * Explicit gas limit. If omitted, the SDK will estimate and multiply.
+     */
+    gas?: bigint;
+    /**
+     * Multiplier applied over the SDK gas estimate when `gas` is not supplied.
+     * Defaults to 5.
+     */
+    gasMultiplier?: number;
+    /**
+     * Legacy gas price (wei). If set, EIP-1559 fields are ignored by most clients.
+     */
+    gasPrice?: bigint;
+    /**
+     * EIP-1559: max fee per gas (wei). Use with `maxPriorityFeePerGas`.
+     */
+    maxFeePerGas?: bigint;
+    /**
+     * EIP-1559: max priority fee per gas (wei).
+     */
+    maxPriorityFeePerGas?: bigint;
+};
+/**
+ * Replication levels for storage requests.
+ * Each level provides different redundancy and availability guarantees.
+ */
+export declare enum ReplicationLevel {
+    /** Basic replication (default) */
+    Basic = 0,
+    /** Standard replication */
+    Standard = 1,
+    /** High security replication */
+    HighSecurity = 2,
+    /** Super high security replication */
+    SuperHighSecurity = 3,
+    /** Ultra high security replication */
+    UltraHighSecurity = 4,
+    /** Custom replication (requires specifying exact replica count) */
+    Custom = 5
+}

package/dist/file-manager.d.ts

@@ -1,4 +1,4 @@
-import type { AccountId, H256 } from '@polkadot/types/interfaces';
+import type { AccountId20, H256 } from "@polkadot/types/interfaces";
 export declare class FileManager {
     private readonly file;
     constructor(file: {
@@ -7,11 +7,13 @@ export declare class FileManager {
     });
     private fingerprint?;
     private fileKey?;
+    private fileBlob?;
     /**
      * Stream the file's contents, feed every 1 kB chunk into a new FileTrie, and
      * return the resulting Merkle root.
      */
     getFingerprint(): Promise<H256>;
+    getFileSize(): number;
     /**
      * Compute the FileKey for this file.
      *
@@ -20,5 +22,10 @@ export declare class FileManager {
      *   • 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>;
+    computeFileKey(owner: AccountId20, bucketId: H256, location: string): Promise<H256>;
+    /**
+     * Retrieve the file as a Blob. If not already available, this will
+     * compute it by streaming the file (also computing and caching the fingerprint).
+     */
+    getFileBlob(): Promise<Blob>;
 }

package/dist/http/HttpClient.d.ts

@@ -26,7 +26,7 @@ export declare class HttpClient {
     private readonly defaultHeaders;
     private readonly fetchImpl;
     constructor(options: HttpClientConfig);
-    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, options?: RequestOptions): Promise<T | Response>;
+    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>;