@ember-finance/sdk 2.1.2 → 2.2.0-rc.0

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

@@ -109,6 +109,23 @@ export class EVMAdminCalls extends EVMOnChainCalls {
         const txCall = this.txBuilder.pauseNonAdminOperations(pause);
         return this.execCall(txCall, options);
     }
+    /**
+     * Guardian fast-path equivalent of {@link pauseNonAdminOperations}: pause /
+     * unpause non-admin protocol operations without going through the timelock.
+     *
+     * The owner-gated `pauseNonAdminOperations` reverts with
+     * `OwnableUnauthorizedAccount` once `ProtocolConfig` ownership has been
+     * transferred to the admin timelock, so any caller signing with the
+     * guardian key must use this variant instead.
+     *
+     * @param pause Whether to pause non-admin operations
+     * @param options Optional tx execution params
+     * @returns EvmOnChainCallResponse
+     */
+    async guardianPauseNonAdminOperations(pause, options) {
+        const txCall = this.txBuilder.guardianPauseNonAdminOperations(pause);
+        return this.execCall(txCall, options);
+    }
     /**
      * Update the max rate interval of the protocol
      * @param maxRateInterval The new max rate interval

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

@@ -60,6 +60,23 @@ export declare class EVMTxBuilder {
      * @returns Transaction call object
      */
     pauseNonAdminOperations(pause: boolean): ITransactionCall;
+    /**
+     * Guardian fast-path equivalent of {@link pauseNonAdminOperations}.
+     *
+     * The contract exposes two pause toggles:
+     *  - `pauseNonAdminOperations`            — `onlyOwner` (slow path; behind the timelock
+     *                                            once ownership of `ProtocolConfig` has been
+     *                                            transferred)
+     *  - `guardianPauseNonAdminOperations`    — `onlyGuardian` (instant, no timelock)
+     *
+     * Use this variant when signing with the guardian key. Calling the owner-path setter from a
+     * guardian signer will revert with `OwnableUnauthorizedAccount` on any chain whose
+     * `ProtocolConfig` ownership has moved to the timelock.
+     *
+     * @param pause True to pause, false to unpause
+     * @returns Transaction call object
+     */
+    guardianPauseNonAdminOperations(pause: boolean): ITransactionCall;
     /**
      * Updates the platform fee recipient address
      * @param recipient New recipient address
@@ -133,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
@@ -248,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)
  *
@@ -82,6 +83,32 @@ export class EVMTxBuilder {
             chainId: this.getChainId()
         };
     }
+    /**
+     * Guardian fast-path equivalent of {@link pauseNonAdminOperations}.
+     *
+     * The contract exposes two pause toggles:
+     *  - `pauseNonAdminOperations`            — `onlyOwner` (slow path; behind the timelock
+     *                                            once ownership of `ProtocolConfig` has been
+     *                                            transferred)
+     *  - `guardianPauseNonAdminOperations`    — `onlyGuardian` (instant, no timelock)
+     *
+     * Use this variant when signing with the guardian key. Calling the owner-path setter from a
+     * guardian signer will revert with `OwnableUnauthorizedAccount` on any chain whose
+     * `ProtocolConfig` ownership has moved to the timelock.
+     *
+     * @param pause True to pause, false to unpause
+     * @returns Transaction call object
+     */
+    guardianPauseNonAdminOperations(pause) {
+        return {
+            to: this.parser.getProtocolConfigAddress(),
+            functionName: "guardianPauseNonAdminOperations",
+            args: [pause],
+            abi: EmberProtocolConfigABI.abi,
+            value: 0n,
+            chainId: this.getChainId()
+        };
+    }
     /**
      * Updates the platform fee recipient address
      * @param recipient New recipient address
@@ -250,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
@@ -507,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)

package/dist/src/evm-vaults/utils/deployment-parser.js

@@ -157,6 +157,33 @@ export class EVMDeploymentParser {
     getReceiptTokenSymbols() {
         return Object.keys(this.deployment.contracts?.receiptTokens ?? {});
     }
+    /**
+     * 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) {
+        const entry = Object.values(this.deployment.contracts?.depositParkingLots ?? {}).find(parkingLot => parkingLot.vault?.toLowerCase() === vaultAddress.toLowerCase());
+        return entry?.proxyAddress;
+    }
+    /**
+     * 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, override) {
+        if (override)
+            return override;
+        const parkingLot = this.getParkingLotAddressByVaultAddress(vaultAddress);
+        if (!parkingLot) {
+            throw new Error(`No parking lot configured for vault ${vaultAddress} in deployment info (async deposits not enabled, or the protocol info is stale — pass options.parkingLotAddress to override).`);
+        }
+        return parkingLot;
+    }
     /**
      * Finds the OFT adapter entry for a given vault address.
      * @param vaultAddress The vault address (receipt token address in EVM deployment data)

package/package.json

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