@ember-finance/sdk 2.10.1 → 2.10.2

package/dist/src/evm-vaults/on-chain-calls/user.d.ts

@@ -477,6 +477,23 @@ export declare class EVMUserCalls extends EVMOnChainCalls {
      * that can neither receive ETH nor call claimWithdrawalTo. Owner-only.
      */
     recoverUnclaimedWithdrawal(vaultAddress: string, receiver: string, to: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Gas floor for atomic-vault user paths that may hit `_ensureLiquidity` —
+     * i.e. call into the configured ERC-4626 strategy's `withdraw` to top up the
+     * vault's idle collateral before paying the caller. A strategy `withdraw`
+     * routinely lands in the 200-400k band on its own; combined with the vault-
+     * side accounting an OOG revert at 500k is easy to trip (observed on
+     * mainnet: tx 0x93bd9f36…3d8ef34409, 482k / 500k budget, empty revert data).
+     *
+     * Ethers' auto-estimation can also under-budget when a Timelock proposal
+     * freezes the gas limit at scheduling time and the strategy's on-chain
+     * state drifts before execution. Enforce a conservative floor here so
+     * callers don't need to know the mechanics; explicit `options.gasLimit`
+     * still overrides.
+     */
+    private static readonly ATOMIC_STRATEGY_PULL_GAS_FLOOR;
+    /** Applies the atomic-vault gas floor unless the caller has already set one. */
+    private withAtomicGasFloor;
     /** Atomic vault: instant (capped, fee'd) withdraw of `shares` to `receiver`; auto-pulls from strategy. */
     instantWithdraw(vaultAddress: string, shares: NumStr, receiver: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /**
@@ -487,6 +504,9 @@ export declare class EVMUserCalls extends EVMOnChainCalls {
      * Pass `0` to disable the guard; otherwise call
      * {@link EVMReaderCalls.previewSwapInstantWithdraw} first and derive
      * `minNetOut` from `quote.netAmount` minus your tolerance.
+     *
+     * A 2M gas floor is applied when the caller doesn't set `options.gasLimit`
+     * — see {@link ATOMIC_STRATEGY_PULL_GAS_FLOOR} for the reasoning.
      */
     swapEmberShares(vaultAddress: string, share: string, shareAmount: NumStr, receiver: string, minNetOut: NumStr, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /**

package/dist/src/evm-vaults/on-chain-calls/user.js

@@ -732,13 +732,19 @@ export class EVMUserCalls extends EVMOnChainCalls {
     async recoverUnclaimedWithdrawal(vaultAddress, receiver, to, options) {
         return this.execCall(this.txBuilder.recoverUnclaimedWithdrawal(vaultAddress, receiver, to), options);
     }
-    // ============================================
-    // Atomic Liquidity Vault — user actions (BFE-817/818)
-    // ============================================
+    /** Applies the atomic-vault gas floor unless the caller has already set one. */
+    withAtomicGasFloor(options) {
+        if (options?.gasLimit && options.gasLimit > 0n)
+            return options;
+        return {
+            ...(options ?? {}),
+            gasLimit: EVMUserCalls.ATOMIC_STRATEGY_PULL_GAS_FLOOR
+        };
+    }
     /** Atomic vault: instant (capped, fee'd) withdraw of `shares` to `receiver`; auto-pulls from strategy. */
     async instantWithdraw(vaultAddress, shares, receiver, options) {
         const txCall = this.txBuilder.atomicInstantWithdraw(vaultAddress, shares, receiver);
-        return this.execCall(txCall, options);
+        return this.execCall(txCall, this.withAtomicGasFloor(options));
     }
     /**
      * Atomic vault: swap `shareAmount` of a whitelisted source EmberShare `share` into collateral.
@@ -748,10 +754,13 @@ export class EVMUserCalls extends EVMOnChainCalls {
      * Pass `0` to disable the guard; otherwise call
      * {@link EVMReaderCalls.previewSwapInstantWithdraw} first and derive
      * `minNetOut` from `quote.netAmount` minus your tolerance.
+     *
+     * A 2M gas floor is applied when the caller doesn't set `options.gasLimit`
+     * — see {@link ATOMIC_STRATEGY_PULL_GAS_FLOOR} for the reasoning.
      */
     async swapEmberShares(vaultAddress, share, shareAmount, receiver, minNetOut, options) {
         const txCall = this.txBuilder.atomicSwapEmberShares(vaultAddress, share, shareAmount, receiver, minNetOut);
-        return this.execCall(txCall, options);
+        return this.execCall(txCall, this.withAtomicGasFloor(options));
     }
     /**
      * Atomic vault: claim your own escrowed holdback — collateral that couldn't be
@@ -786,3 +795,21 @@ export class EVMUserCalls extends EVMOnChainCalls {
         return this.execCall(this.txBuilder.atomicRecoverUnclaimedHoldback(vaultAddress, recipient, to), options);
     }
 }
+// ============================================
+// Atomic Liquidity Vault — user actions (BFE-817/818)
+// ============================================
+/**
+ * Gas floor for atomic-vault user paths that may hit `_ensureLiquidity` —
+ * i.e. call into the configured ERC-4626 strategy's `withdraw` to top up the
+ * vault's idle collateral before paying the caller. A strategy `withdraw`
+ * routinely lands in the 200-400k band on its own; combined with the vault-
+ * side accounting an OOG revert at 500k is easy to trip (observed on
+ * mainnet: tx 0x93bd9f36…3d8ef34409, 482k / 500k budget, empty revert data).
+ *
+ * Ethers' auto-estimation can also under-budget when a Timelock proposal
+ * freezes the gas limit at scheduling time and the strategy's on-chain
+ * state drifts before execution. Enforce a conservative floor here so
+ * callers don't need to know the mechanics; explicit `options.gasLimit`
+ * still overrides.
+ */
+EVMUserCalls.ATOMIC_STRATEGY_PULL_GAS_FLOOR = 2000000n;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ember-finance/sdk",
     "description": "Ember Protocol SDK",
-    "version": "2.10.1",
+    "version": "2.10.2",
     "type": "module",
     "module": "./dist/index.js",
     "main": "./dist/index.js",