@ember-finance/sdk 2.34.0 → 2.35.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/package.json

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