@storagehub-sdk/core 0.4.3 → 0.4.4

package/dist/evm/storageHubClient.d.ts

@@ -26,7 +26,6 @@ export declare class StorageHubClient {
     private static readonly MAX_LOCATION_BYTES;
     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.
      *
@@ -53,13 +52,28 @@ export declare class StorageHubClient {
     private estimateGas;
     /**
      * 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;
+    /**
+     * Builds EIP-1559 gas fee.
+     *
+     * Strategy:
+     * - Reads the `baseFeePerGas` from the latest block (EIP-1559 required).
+     * - Sets a congestion-aware tip (`maxPriorityFeePerGas`).
+     * - Computes `maxFeePerGas` as:
+     *
+     *      maxFeePerGas = baseFeePerGas * 3 + maxPriorityFeePerGas
+     *
+     * The 3x multiplier provides protection against short-term base fee spikes
+     * while avoiding excessive overpayment during normal conditions.
+     *
+     */
+    private buildEip1559FeeOptions;
     /**
      * Validate string length in UTF-8 bytes and convert to hex.
      * @param str - Input string to validate and encode

package/dist/evm/types.d.ts

@@ -24,16 +24,32 @@ export type StorageHubClientOptions = {
     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.
+ * Use this type to explicitly control transaction fees when submitting
+ * EIP-1559 transactions, especially under network congestion or when
+ * automatic fee estimation is unreliable.
  *
- * - 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`.
+ * Notes:
+ * - These fields are mutually exclusive with legacy `gasPrice`.
+ * - The effective gas price paid is:
+ *   `min(maxFeePerGas, baseFeePerGas + maxPriorityFeePerGas)`.
  */
+export type Eip1559FeeOptions = {
+    /**
+     * Maximum total fee per gas unit (wei).
+     *
+     * Acts as an upper bound that protects against sudden base fee spikes
+     * between blocks.
+     */
+    maxFeePerGas: bigint;
+    /**
+     * Priority fee (tip) per gas unit (wei) paid to the block producer.
+     *
+     * Higher values increase the likelihood of faster inclusion under
+     * congestion.
+     */
+    maxPriorityFeePerGas: bigint;
+};
 export type EvmWriteOptions = {
     /**
      * Explicit gas limit. If omitted, the SDK will estimate and multiply.
@@ -45,7 +61,10 @@ export type EvmWriteOptions = {
      */
     gasMultiplier?: number;
     /**
-     * Legacy gas price (wei). If set, EIP-1559 fields are ignored by most clients.
+     * Legacy gas price (wei).
+     *
+     * @deprecated StorageHub SDK is moving to EIP-1559 only. This field is ignored by the SDK.
+     * Use `maxFeePerGas` and `maxPriorityFeePerGas` instead.
      */
     gasPrice?: bigint;
     /**