@ember-finance/sdk 2.34.0 → 2.36.0

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

@@ -1,5 +1,12 @@
 import { Provider } from "ethers";
 import { FeeMultiplierTier, InstantWithdrawQuote } from "../../atomic/instant-withdraw.js";
+/** One queued holdback entry, as stored by AtomicLiquidity. */
+export interface EVMHoldbackEntry {
+    receiver: string;
+    amount: bigint;
+    createdAt: bigint;
+    sequenceNumber: bigint;
+}
 /**
  * Read-only views for the Atomic Liquidity Vault (BFE-817/818).
  *
@@ -60,6 +67,17 @@ export declare class EVMAtomicLiquidityReader {
     emberShareConfigs(vaultAddress: string, share: string): Promise<unknown>;
     /** Remaining swap capacity for a source share in the current epoch. */
     availableEmberShareCapacity(vaultAddress: string, share: string): Promise<bigint>;
+    /**
+     * The pending holdback queue for one source share, oldest first.
+     * @param vaultAddress The atomic vault
+     * @param share The source share (its vault address)
+     * @param maxEntries Read at most this many entries from the head
+     * @returns The number of pending entries and the entries read
+     */
+    getHoldbackQueue(vaultAddress: string, share: string, maxEntries: number): Promise<{
+        length: bigint;
+        entries: EVMHoldbackEntry[];
+    }>;
     /** Length of the holdback FIFO for a source share. */
     getHoldbackQueueLength(vaultAddress: string, share: string): Promise<bigint>;
     /**

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

@@ -97,6 +97,31 @@ export class EVMAtomicLiquidityReader {
     async availableEmberShareCapacity(vaultAddress, share) {
         return this.contract(vaultAddress).availableEmberShareCapacity(share);
     }
+    /**
+     * The pending holdback queue for one source share, oldest first.
+     * @param vaultAddress The atomic vault
+     * @param share The source share (its vault address)
+     * @param maxEntries Read at most this many entries from the head
+     * @returns The number of pending entries and the entries read
+     */
+    async getHoldbackQueue(vaultAddress, share, maxEntries) {
+        const vault = this.contract(vaultAddress);
+        const [start, pending] = await Promise.all([
+            vault.holdbackQueueStartIndex(share),
+            vault.getPendingHoldbackEntries(share)
+        ]);
+        const count = pending < BigInt(maxEntries) ? Number(pending) : maxEntries;
+        const entries = await Promise.all(Array.from({ length: count }, async (_, i) => {
+            const e = await vault.getHoldbackEntry(share, start + BigInt(i));
+            return {
+                receiver: e.recipient,
+                amount: BigInt(e.amount),
+                createdAt: BigInt(e.createdAt),
+                sequenceNumber: BigInt(e.sequenceNumber)
+            };
+        }));
+        return { length: pending, entries };
+    }
     /** Length of the holdback FIFO for a source share. */
     async getHoldbackQueueLength(vaultAddress, share) {
         return this.contract(vaultAddress).getHoldbackQueueLength(share);

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

@@ -115,6 +115,22 @@ export declare class EVMOperatorCalls extends EVMOnChainCalls {
      * @returns EvmOnChainCallResponse
      */
     setDepositAllowList(vaultAddress: string, user: string, status: boolean, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Add or remove a user on a vault's withdrawal-fee exemption list.
+     *
+     * Operator-gated, unlike the fee percentages themselves which are the admin's:
+     * `EmberVaultValidator.setFeeExemptionListStatus` rejects any caller that is not
+     * `roles().operator`. Adding also rejects the vault's three role addresses and any
+     * protocol-blacklisted account; removing has neither restriction, so an address can always
+     * be taken back off the list. Setting the value it already has reverts `SameValue`.
+     *
+     * @param vaultAddress The address of the vault
+     * @param user The account whose exemption is changing
+     * @param status True to exempt from withdrawal fees, false to remove the exemption
+     * @param options Optional tx execution params
+     * @returns EvmOnChainCallResponse
+     */
+    setFeeExemptionList(vaultAddress: string, user: string, status: boolean, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /** Atomic vault: supply `assets` of idle collateral into the external ERC-4626 strategy. */
     supplyToStrategy(vaultAddress: string, assets: NumStr, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /** Atomic vault: withdraw `assets` of collateral back from the strategy into the vault. */

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

@@ -156,6 +156,25 @@ export class EVMOperatorCalls extends EVMOnChainCalls {
         const txCall = this.txBuilder.setVaultDepositAllowList(vaultAddress, user, status);
         return this.execCall(txCall, options);
     }
+    /**
+     * Add or remove a user on a vault's withdrawal-fee exemption list.
+     *
+     * Operator-gated, unlike the fee percentages themselves which are the admin's:
+     * `EmberVaultValidator.setFeeExemptionListStatus` rejects any caller that is not
+     * `roles().operator`. Adding also rejects the vault's three role addresses and any
+     * protocol-blacklisted account; removing has neither restriction, so an address can always
+     * be taken back off the list. Setting the value it already has reverts `SameValue`.
+     *
+     * @param vaultAddress The address of the vault
+     * @param user The account whose exemption is changing
+     * @param status True to exempt from withdrawal fees, false to remove the exemption
+     * @param options Optional tx execution params
+     * @returns EvmOnChainCallResponse
+     */
+    async setFeeExemptionList(vaultAddress, user, status, options) {
+        const txCall = this.txBuilder.setVaultFeeExemptionList(vaultAddress, user, status);
+        return this.execCall(txCall, options);
+    }
     // ============================================
     // Atomic Liquidity Vault — operator actions (BFE-817/818)
     // ============================================

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

@@ -250,6 +250,21 @@ export declare class EVMTxBuilder {
      * @returns Transaction call object
      */
     setVaultDepositAllowList(vaultAddress: string, user: string, status: boolean): ITransactionCall;
+    /**
+     * Sets withdrawal-fee exemption for a user on a vault (called via ProtocolConfig)
+     *
+     * Operator-gated on chain, unlike the fee percentages themselves which are the admin's:
+     * `EmberVaultValidator.setFeeExemptionListStatus` rejects any caller that is not
+     * `roles().operator`. Adding also rejects the vault's three role addresses and any
+     * protocol-blacklisted account; removing has neither restriction, so an address can always
+     * be taken back off the list.
+     *
+     * @param vaultAddress Address of the vault
+     * @param user User address to update
+     * @param status True to exempt the user from withdrawal fees, false to remove the exemption
+     * @returns Transaction call object
+     */
+    setVaultFeeExemptionList(vaultAddress: string, user: string, status: boolean): ITransactionCall;
     /**
      * Updates the maximum TVL of a vault (called via ProtocolConfig)
      * @param vaultAddress Address of the vault

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

@@ -498,6 +498,30 @@ export class EVMTxBuilder {
             chainId: this.getChainId()
         };
     }
+    /**
+     * Sets withdrawal-fee exemption for a user on a vault (called via ProtocolConfig)
+     *
+     * Operator-gated on chain, unlike the fee percentages themselves which are the admin's:
+     * `EmberVaultValidator.setFeeExemptionListStatus` rejects any caller that is not
+     * `roles().operator`. Adding also rejects the vault's three role addresses and any
+     * protocol-blacklisted account; removing has neither restriction, so an address can always
+     * be taken back off the list.
+     *
+     * @param vaultAddress Address of the vault
+     * @param user User address to update
+     * @param status True to exempt the user from withdrawal fees, false to remove the exemption
+     * @returns Transaction call object
+     */
+    setVaultFeeExemptionList(vaultAddress, user, status) {
+        return {
+            to: this.parser.getProtocolConfigAddress(),
+            functionName: "setVaultFeeExemptionList",
+            args: [vaultAddress, user, status],
+            abi: EmberProtocolConfigABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
     /**
      * Updates the maximum TVL of a vault (called via ProtocolConfig)
      * @param vaultAddress Address of the vault

package/package.json

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