@ember-finance/sdk 2.1.3 → 2.2.0-rc.1

package/dist/src/api/v2/models/vault-parking-lot-info.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Ember Protocol Vaults API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 2.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface VaultParkingLotInfo
+ */
+export interface VaultParkingLotInfo {
+    /**
+     * The address of the vault\'s deposit parking lot contract
+     * @type {string}
+     * @memberof VaultParkingLotInfo
+     */
+    parkingLotAddress: string;
+    /**
+     * Whether new deposit requests are currently paused
+     * @type {boolean}
+     * @memberof VaultParkingLotInfo
+     */
+    depositsPaused: boolean;
+    /**
+     * Whether the parking lot is the vault\'s active deposit gate
+     * @type {boolean}
+     * @memberof VaultParkingLotInfo
+     */
+    isActive: boolean;
+    /**
+     * Cron expression (UTC) describing when the deposit queue is processed
+     * @type {string}
+     * @memberof VaultParkingLotInfo
+     */
+    processingSchedule?: string;
+    /**
+     * Next estimated queue processing timestamp in ms (derived from processingSchedule)
+     * @type {number}
+     * @memberof VaultParkingLotInfo
+     */
+    nextProcessingAt?: number;
+    /**
+     * Total collateral currently escrowed across pending deposit requests
+     * @type {string}
+     * @memberof VaultParkingLotInfo
+     */
+    totalPendingAssets: string;
+    /**
+     * Number of pending deposit requests in the queue
+     * @type {string}
+     * @memberof VaultParkingLotInfo
+     */
+    totalPendingCount: string;
+}

package/dist/src/api/v2/models/vault-parking-lot-info.js

@@ -0,0 +1,14 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ember Protocol Vaults API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 2.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export {};

package/dist/src/evm-vaults/interfaces/index.d.ts

@@ -153,15 +153,50 @@ export interface IEvmCallOptions {
     confirmations?: number;
     /** Gas limit override */
     gasLimit?: bigint;
+    /**
+     * Explicit deposit parking lot address for parking-lot actions (deposit /
+     * cancel / claim / process / operator / pause). When omitted it is read
+     * on-chain from `vault.parkingLot()`.
+     */
+    parkingLotAddress?: string;
     /** If true, uses EmberETHVault ABI instead of EmberVault ABI */
     isETHVault?: boolean;
 }
 /**
  * Optional parameters for user deposit/mint/redeem calls
  */
+/**
+ * On-chain state of a vault's deposit parking lot (async deposits).
+ */
+export interface IParkingLotInfo {
+    /** The parking lot contract address */
+    address: string;
+    /** The operator authorised to process the deposit queue */
+    operator: string;
+    /** Whether new deposit requests are currently paused */
+    depositsPaused: boolean;
+    /** Total collateral currently escrowed across pending requests */
+    totalPendingAssets: bigint;
+    /** Number of live (unprocessed, uncancelled) pending requests */
+    livePendingCount: bigint;
+    /** Latest assigned FIFO sequence number */
+    sequenceNumber: bigint;
+    /** Index of the next request the operator will process */
+    queueStartIndex: bigint;
+}
 export interface IUserCallOptions extends IEvmCallOptions {
     /** Receiver address for shares/funds. Defaults to the caller's address if not provided */
     receiver?: string;
+    /**
+     * Route the deposit through the vault's deposit parking lot (async deposit).
+     * The collateral is escrowed in the parking lot and queued; the operator later
+     * forwards it into the vault, minting shares to the receiver.
+     *
+     * Note: the collateral must be approved to the PARKING LOT address (not the
+     * vault). Only supported by plain `deposit()` — the parking lot has no
+     * mint/permit entrypoint. Ignored for ETH vaults.
+     */
+    depositToParkingLot?: boolean;
 }
 /**
  * Optional parameters for high-level OFT bridge send calls.

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

@@ -52,6 +52,15 @@ export declare class EVMOperatorCalls extends EVMOnChainCalls {
      * @returns EvmOnChainCallResponse
      */
     processWithdrawalRequests(vaultAddress: string, maxRequestCount: NumStr, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Process queued async (parked) deposits, forwarding escrowed collateral
+     * into the vault and minting shares to each request's receiver. Operator-only.
+     * @param vaultAddress The vault the parking lot serves
+     * @param numRequests Max number of FIFO requests to process this call
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    processParkingLotDeposits(vaultAddress: string, numRequests: NumStr, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /**
      * Collect accrued platform fees from a vault
      * @param vaultAddress The address of the vault

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

@@ -63,6 +63,19 @@ export class EVMOperatorCalls extends EVMOnChainCalls {
         const txCall = this.txBuilder.processWithdrawalRequests(vaultAddress, maxRequestCount, options?.isETHVault);
         return this.execCall(txCall, options);
     }
+    /**
+     * Process queued async (parked) deposits, forwarding escrowed collateral
+     * into the vault and minting shares to each request's receiver. Operator-only.
+     * @param vaultAddress The vault the parking lot serves
+     * @param numRequests Max number of FIFO requests to process this call
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    async processParkingLotDeposits(vaultAddress, numRequests, options) {
+        const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options?.parkingLotAddress);
+        const txCall = this.txBuilder.processParkingLotDeposits(parkingLotAddress, numRequests);
+        return this.execCall(txCall, options);
+    }
     // ============================================
     // Fee Collection
     // ============================================

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

@@ -150,6 +150,39 @@ export declare class EVMTxBuilder {
      * @returns Transaction call object
      */
     updateVaultAdmin(vaultAddress: string, newAdmin: string): ITransactionCall;
+    /**
+     * Binds (or clears) a vault's deposit parking lot, enabling async-deposit
+     * gating. Routed through the protocol config; caller must be the vault admin.
+     * Pass the zero address to unbind and restore permissionless deposits.
+     * @param vaultAddress The vault to bind the parking lot to
+     * @param parkingLotAddress The parking lot address (or zero address to clear)
+     * @returns Transaction call object
+     */
+    setVaultParkingLot(vaultAddress: string, parkingLotAddress: string): ITransactionCall;
+    /**
+     * Processes up to `numRequests` queued deposit requests in a parking lot,
+     * forwarding escrowed collateral into the vault (operator-only).
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param numRequests Max number of FIFO requests to process this call
+     * @returns Transaction call object
+     */
+    processParkingLotDeposits(parkingLotAddress: string, numRequests: NumStr): ITransactionCall;
+    /**
+     * Rotates the operator authorised to process a parking lot's queue
+     * (vault-admin only).
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param newOperator The new operator address
+     * @returns Transaction call object
+     */
+    setParkingLotOperator(parkingLotAddress: string, newOperator: string): ITransactionCall;
+    /**
+     * Pauses or resumes new deposit requests into a parking lot (vault admin or
+     * protocol guardian). Processing and cancellation remain available while paused.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param paused True to pause new deposits, false to resume
+     * @returns Transaction call object
+     */
+    setParkingLotDepositsPaused(parkingLotAddress: string, paused: boolean): ITransactionCall;
     /**
      * Updates the paused status of a vault operation (called via ProtocolConfig)
      * @param vaultAddress Address of the vault
@@ -265,6 +298,31 @@ export declare class EVMTxBuilder {
      * @returns Transaction call object
      */
     deposit(vaultAddress: string, assets: NumStr, receiver: string, isETHVault?: boolean): ITransactionCall;
+    /**
+     * Deposits assets into a vault's deposit parking lot (async deposit). The
+     * collateral is escrowed and queued; the operator later forwards it into the
+     * vault, minting shares to `receiver`. The caller must have approved the
+     * collateral to the parking lot address.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param assets Amount of assets to park
+     * @param receiver Address that will receive the minted shares when processed
+     * @returns Transaction call object
+     */
+    depositToParkingLot(parkingLotAddress: string, assets: NumStr, receiver: string): ITransactionCall;
+    /**
+     * Cancels a pending parked deposit request, refunding the escrowed collateral.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param sequenceNumber FIFO sequence number of the request to cancel
+     * @returns Transaction call object
+     */
+    cancelParkingLotDeposit(parkingLotAddress: string, sequenceNumber: NumStr): ITransactionCall;
+    /**
+     * Withdraws the caller's accrued claimable balance (undeliverable refunds)
+     * from the parking lot.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @returns Transaction call object
+     */
+    claimParkingLotRefund(parkingLotAddress: string): ITransactionCall;
     /**
      * Deposits assets to a vault using EIP-2612 permit (no separate approval needed)
      * @param vaultAddress Address of the vault

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

@@ -4,6 +4,7 @@ import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json"
 import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
 import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
 import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
+import EmberDepositParkingLotABI from "../../abis/EmberDepositParkingLot.json" with { type: "json" };
 /**
  * EVM Transaction Builder for Ember Protocol (ERC-4626 Compatible)
  *
@@ -276,6 +277,75 @@ export class EVMTxBuilder {
             chainId: this.getChainId()
         };
     }
+    /**
+     * Binds (or clears) a vault's deposit parking lot, enabling async-deposit
+     * gating. Routed through the protocol config; caller must be the vault admin.
+     * Pass the zero address to unbind and restore permissionless deposits.
+     * @param vaultAddress The vault to bind the parking lot to
+     * @param parkingLotAddress The parking lot address (or zero address to clear)
+     * @returns Transaction call object
+     */
+    setVaultParkingLot(vaultAddress, parkingLotAddress) {
+        return {
+            to: this.parser.getProtocolConfigAddress(),
+            functionName: "setVaultParkingLot",
+            args: [vaultAddress, parkingLotAddress],
+            abi: EmberProtocolConfigABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
+    /**
+     * Processes up to `numRequests` queued deposit requests in a parking lot,
+     * forwarding escrowed collateral into the vault (operator-only).
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param numRequests Max number of FIFO requests to process this call
+     * @returns Transaction call object
+     */
+    processParkingLotDeposits(parkingLotAddress, numRequests) {
+        return {
+            to: parkingLotAddress,
+            functionName: "processDeposits",
+            args: [BigInt(numRequests)],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
+    /**
+     * Rotates the operator authorised to process a parking lot's queue
+     * (vault-admin only).
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param newOperator The new operator address
+     * @returns Transaction call object
+     */
+    setParkingLotOperator(parkingLotAddress, newOperator) {
+        return {
+            to: parkingLotAddress,
+            functionName: "setOperator",
+            args: [newOperator],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
+    /**
+     * Pauses or resumes new deposit requests into a parking lot (vault admin or
+     * protocol guardian). Processing and cancellation remain available while paused.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param paused True to pause new deposits, false to resume
+     * @returns Transaction call object
+     */
+    setParkingLotDepositsPaused(parkingLotAddress, paused) {
+        return {
+            to: parkingLotAddress,
+            functionName: "setDepositsPaused",
+            args: [paused],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
     /**
      * Updates the paused status of a vault operation (called via ProtocolConfig)
      * @param vaultAddress Address of the vault
@@ -533,6 +603,58 @@ export class EVMTxBuilder {
             chainId: this.getChainId()
         };
     }
+    /**
+     * Deposits assets into a vault's deposit parking lot (async deposit). The
+     * collateral is escrowed and queued; the operator later forwards it into the
+     * vault, minting shares to `receiver`. The caller must have approved the
+     * collateral to the parking lot address.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param assets Amount of assets to park
+     * @param receiver Address that will receive the minted shares when processed
+     * @returns Transaction call object
+     */
+    depositToParkingLot(parkingLotAddress, assets, receiver) {
+        return {
+            to: parkingLotAddress,
+            functionName: "deposit",
+            args: [BigInt(assets), receiver],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
+    /**
+     * Cancels a pending parked deposit request, refunding the escrowed collateral.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @param sequenceNumber FIFO sequence number of the request to cancel
+     * @returns Transaction call object
+     */
+    cancelParkingLotDeposit(parkingLotAddress, sequenceNumber) {
+        return {
+            to: parkingLotAddress,
+            functionName: "cancelDeposit",
+            args: [BigInt(sequenceNumber)],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
+    /**
+     * Withdraws the caller's accrued claimable balance (undeliverable refunds)
+     * from the parking lot.
+     * @param parkingLotAddress Address of the EmberDepositParkingLot
+     * @returns Transaction call object
+     */
+    claimParkingLotRefund(parkingLotAddress) {
+        return {
+            to: parkingLotAddress,
+            functionName: "claim",
+            args: [],
+            abi: EmberDepositParkingLotABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
     /**
      * Deposits assets to a vault using EIP-2612 permit (no separate approval needed)
      * @param vaultAddress Address of the vault

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

@@ -63,6 +63,20 @@ export declare class EVMUserCalls extends EVMOnChainCalls {
      * @returns EvmOnChainCallResponse
      */
     deposit(vaultAddress: string, assets: NumStr, options?: IUserCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Cancels a pending async (parked) deposit, refunding the escrowed collateral.
+     * @param vaultAddress The vault the parking lot serves
+     * @param sequenceNumber FIFO sequence number of the request to cancel
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     */
+    cancelParkingLotDeposit(vaultAddress: string, sequenceNumber: NumStr, options?: IUserCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Withdraws the caller's accrued claimable balance (undeliverable refunds)
+     * from the vault's parking lot.
+     * @param vaultAddress The vault the parking lot serves
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     */
+    claimParkingLotRefund(vaultAddress: string, options?: IUserCallOptions): Promise<EvmOnChainCallResponse>;
     /**
      * Deposit assets into a vault using EIP-2612 permit (no separate approval needed)
      *

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

@@ -69,9 +69,39 @@ export class EVMUserCalls extends EVMOnChainCalls {
      */
     async deposit(vaultAddress, assets, options) {
         const receiver = options?.receiver ?? (await this.getWalletAddress());
+        // Async deposit: route through the vault's deposit parking lot. Funds are
+        // escrowed + queued and forwarded into the vault later by the operator.
+        // The collateral must be approved to the parking lot (not the vault).
+        if (options?.depositToParkingLot) {
+            const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options.parkingLotAddress);
+            const txCall = this.txBuilder.depositToParkingLot(parkingLotAddress, assets, receiver);
+            return this.execCall(txCall, options);
+        }
         const txCall = this.txBuilder.deposit(vaultAddress, assets, receiver, options?.isETHVault);
         return this.execCall(txCall, options);
     }
+    /**
+     * Cancels a pending async (parked) deposit, refunding the escrowed collateral.
+     * @param vaultAddress The vault the parking lot serves
+     * @param sequenceNumber FIFO sequence number of the request to cancel
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     */
+    async cancelParkingLotDeposit(vaultAddress, sequenceNumber, options) {
+        const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options?.parkingLotAddress);
+        const txCall = this.txBuilder.cancelParkingLotDeposit(parkingLotAddress, sequenceNumber);
+        return this.execCall(txCall, options);
+    }
+    /**
+     * Withdraws the caller's accrued claimable balance (undeliverable refunds)
+     * from the vault's parking lot.
+     * @param vaultAddress The vault the parking lot serves
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     */
+    async claimParkingLotRefund(vaultAddress, options) {
+        const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options?.parkingLotAddress);
+        const txCall = this.txBuilder.claimParkingLotRefund(parkingLotAddress);
+        return this.execCall(txCall, options);
+    }
     /**
      * Deposit assets into a vault using EIP-2612 permit (no separate approval needed)
      *

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

@@ -44,6 +44,34 @@ export declare class EVMVaultAdminCalls extends EVMOnChainCalls {
      * @returns EvmOnChainCallResponse
      */
     updateVaultOperator(vaultAddress: string, newOperator: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Bind (or clear) a vault's deposit parking lot, enabling async-deposit
+     * gating. Pass the zero address to unbind and restore permissionless deposits.
+     * Routed through the protocol config; caller must be the vault admin.
+     * @param vaultAddress The vault to bind
+     * @param parkingLotAddress The parking lot address (or zero address to clear)
+     * @param options Optional tx execution params
+     * @returns EvmOnChainCallResponse
+     */
+    setVaultParkingLot(vaultAddress: string, parkingLotAddress: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Rotate the operator authorised to process the vault's parking lot queue
+     * (vault-admin only).
+     * @param vaultAddress The vault the parking lot serves
+     * @param newOperator The new operator address
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    setParkingLotOperator(vaultAddress: string, newOperator: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Pause or resume new deposit requests into the vault's parking lot (vault
+     * admin or protocol guardian). Processing and cancellation stay available.
+     * @param vaultAddress The vault the parking lot serves
+     * @param paused True to pause new deposits, false to resume
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    setParkingLotDepositsPaused(vaultAddress: string, paused: boolean, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
     /**
      * Update the rate manager of a vault
      * @param vaultAddress The address of the vault

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

@@ -49,6 +49,48 @@ export class EVMVaultAdminCalls extends EVMOnChainCalls {
         const txCall = this.txBuilder.updateVaultOperator(vaultAddress, newOperator);
         return this.execCall(txCall, options);
     }
+    // ============================================
+    // Async Deposits (parking lot)
+    // ============================================
+    /**
+     * Bind (or clear) a vault's deposit parking lot, enabling async-deposit
+     * gating. Pass the zero address to unbind and restore permissionless deposits.
+     * Routed through the protocol config; caller must be the vault admin.
+     * @param vaultAddress The vault to bind
+     * @param parkingLotAddress The parking lot address (or zero address to clear)
+     * @param options Optional tx execution params
+     * @returns EvmOnChainCallResponse
+     */
+    async setVaultParkingLot(vaultAddress, parkingLotAddress, options) {
+        const txCall = this.txBuilder.setVaultParkingLot(vaultAddress, parkingLotAddress);
+        return this.execCall(txCall, options);
+    }
+    /**
+     * Rotate the operator authorised to process the vault's parking lot queue
+     * (vault-admin only).
+     * @param vaultAddress The vault the parking lot serves
+     * @param newOperator The new operator address
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    async setParkingLotOperator(vaultAddress, newOperator, options) {
+        const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options?.parkingLotAddress);
+        const txCall = this.txBuilder.setParkingLotOperator(parkingLotAddress, newOperator);
+        return this.execCall(txCall, options);
+    }
+    /**
+     * Pause or resume new deposit requests into the vault's parking lot (vault
+     * admin or protocol guardian). Processing and cancellation stay available.
+     * @param vaultAddress The vault the parking lot serves
+     * @param paused True to pause new deposits, false to resume
+     * @param options Optional tx execution params (incl. optional parkingLotAddress override)
+     * @returns EvmOnChainCallResponse
+     */
+    async setParkingLotDepositsPaused(vaultAddress, paused, options) {
+        const parkingLotAddress = this.parser.resolveParkingLotAddress(vaultAddress, options?.parkingLotAddress);
+        const txCall = this.txBuilder.setParkingLotDepositsPaused(parkingLotAddress, paused);
+        return this.execCall(txCall, options);
+    }
     /**
      * Update the rate manager of a vault
      * @param vaultAddress The address of the vault

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

@@ -1,6 +1,6 @@
 import { Provider } from "ethers";
 import { EVMDeploymentParser } from "../utils/deployment-parser.js";
-import { EvmProtocolInfo, IOFTSendParam, IOFTFeeQuote, IOFTVaultSupportedChain } from "../interfaces/index.js";
+import { EvmProtocolInfo, IOFTSendParam, IOFTFeeQuote, IOFTVaultSupportedChain, IParkingLotInfo } from "../interfaces/index.js";
 import { NumStr } from "../../common/types.js";
 import { Chain, VaultsApi } from "../../api/v2/index.js";
 /**
@@ -237,6 +237,30 @@ export declare class EVMVaultReader {
      * @returns Asset address
      */
     getAsset(vaultAddress: string, isETHVault?: boolean): Promise<string>;
+    /**
+     * Creates an ethers Contract instance for a deposit parking lot
+     */
+    private getParkingLotContract;
+    /**
+     * Gets the vault's bound deposit parking lot address (zero address if async
+     * deposits are not enabled for the vault).
+     * @param vaultAddress The vault address
+     * @param isETHVault If true, uses EmberETHVault ABI
+     */
+    getParkingLot(vaultAddress: string, isETHVault?: boolean): Promise<string>;
+    /**
+     * Reads the on-chain state of a deposit parking lot (operator, pause flag,
+     * pending totals, queue cursors).
+     * @param parkingLotAddress The parking lot address
+     */
+    getParkingLotInfo(parkingLotAddress: string): Promise<IParkingLotInfo>;
+    /**
+     * Gets an account's accrued claimable balance (undeliverable refunds) in a
+     * parking lot.
+     * @param parkingLotAddress The parking lot address
+     * @param account The account to query
+     */
+    getParkingLotClaimable(parkingLotAddress: string, account: string): Promise<bigint>;
     /**
      * Gets total assets under management
      * @param vaultAddress The vault address

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

@@ -5,6 +5,7 @@ import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json"
 import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
 import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
 import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
+import EmberDepositParkingLotABI from "../../abis/EmberDepositParkingLot.json" with { type: "json" };
 import { Configuration, VaultsApi } from "../../api/v2/index.js";
 import { environmentConfig } from "../../common/constants.js";
 /**
@@ -202,6 +203,58 @@ export class EVMVaultReader {
         const vault = this.getVaultContract(vaultAddress, isETHVault);
         return vault.asset();
     }
+    // ========== Async Deposits (parking lot) ==========
+    /**
+     * Creates an ethers Contract instance for a deposit parking lot
+     */
+    getParkingLotContract(parkingLotAddress) {
+        return new Contract(parkingLotAddress, EmberDepositParkingLotABI.abi, this.provider);
+    }
+    /**
+     * Gets the vault's bound deposit parking lot address (zero address if async
+     * deposits are not enabled for the vault).
+     * @param vaultAddress The vault address
+     * @param isETHVault If true, uses EmberETHVault ABI
+     */
+    async getParkingLot(vaultAddress, isETHVault) {
+        const vault = this.getVaultContract(vaultAddress, isETHVault);
+        return vault.parkingLot();
+    }
+    /**
+     * Reads the on-chain state of a deposit parking lot (operator, pause flag,
+     * pending totals, queue cursors).
+     * @param parkingLotAddress The parking lot address
+     */
+    async getParkingLotInfo(parkingLotAddress) {
+        const parkingLot = this.getParkingLotContract(parkingLotAddress);
+        const [operator, depositsPaused, totalPendingAssets, livePendingCount, sequenceNumber, queueStartIndex] = await Promise.all([
+            parkingLot.operator(),
+            parkingLot.depositsPaused(),
+            parkingLot.totalPendingAssets(),
+            parkingLot.getLivePendingDepositsCount(),
+            parkingLot.sequenceNumber(),
+            parkingLot.queueStartIndex()
+        ]);
+        return {
+            address: parkingLotAddress,
+            operator,
+            depositsPaused,
+            totalPendingAssets,
+            livePendingCount,
+            sequenceNumber,
+            queueStartIndex
+        };
+    }
+    /**
+     * Gets an account's accrued claimable balance (undeliverable refunds) in a
+     * parking lot.
+     * @param parkingLotAddress The parking lot address
+     * @param account The account to query
+     */
+    async getParkingLotClaimable(parkingLotAddress, account) {
+        const parkingLot = this.getParkingLotContract(parkingLotAddress);
+        return parkingLot.claimable(account);
+    }
     /**
      * Gets total assets under management
      * @param vaultAddress The vault address

package/dist/src/evm-vaults/utils/deployment-parser.d.ts

@@ -95,6 +95,22 @@ export declare class EVMDeploymentParser {
      * Gets all receipt token symbols
      */
     getReceiptTokenSymbols(): string[];
+    /**
+     * Finds the deposit parking lot address serving a given vault, from
+     * deployment info (async deposits). Returns undefined if the vault has no
+     * parking lot configured.
+     * @param vaultAddress The vault's proxy address
+     */
+    getParkingLotAddressByVaultAddress(vaultAddress: string): string | undefined;
+    /**
+     * Resolves the deposit parking lot address for a vault from deployment info:
+     * returns the caller override if given, otherwise looks it up in
+     * `contracts.depositParkingLots`.
+     * @param vaultAddress The vault whose parking lot to resolve
+     * @param override Optional explicit parking lot address (skips the lookup)
+     * @throws if no override is given and the deployment has no parking lot for the vault
+     */
+    resolveParkingLotAddress(vaultAddress: string, override?: string): string;
     /**
      * Finds the OFT adapter entry for a given vault address.
      * @param vaultAddress The vault address (receipt token address in EVM deployment data)