@ember-finance/sdk 2.3.1 → 2.5.0-pre.0

package/dist/src/api/v2/models/fee-multiplier-tier.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 FeeMultiplierTier
+ */
+export interface FeeMultiplierTier {
+    /**
+     * Utilization threshold (fixed-point, 1e18 EVM / 1e9 Sui)
+     * @type {string}
+     * @memberof FeeMultiplierTier
+     */
+    threshold: string;
+    /**
+     * Fee multiplier at/above the threshold (fixed-point, 1x = scale)
+     * @type {string}
+     * @memberof FeeMultiplierTier
+     */
+    multiplier: string;
+}

package/dist/src/api/v2/models/fee-multiplier-tier.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/api/v2/models/index.d.ts

@@ -18,6 +18,8 @@ export * from "./coin-price.js";
 export * from "./defi-integration.js";
 export * from "./deposit-transaction.js";
 export * from "./ember-position.js";
+export * from "./evm-atomic-liquidity-lib.js";
+export * from "./evm-atomic-vault.js";
 export * from "./evm-contracts.js";
 export * from "./evm-deposit-parking-lot.js";
 export * from "./evm-deposit-token.js";
@@ -34,8 +36,10 @@ export * from "./exposure.js";
 export * from "./exposure-coin.js";
 export * from "./exposure-protocol.js";
 export * from "./fee.js";
+export * from "./fee-multiplier-tier.js";
 export * from "./fees.js";
 export * from "./history-interval.js";
+export * from "./instant-withdraw-config.js";
 export * from "./lp.js";
 export * from "./manager.js";
 export * from "./min-withdrawal-shares-updated-event.js";

package/dist/src/api/v2/models/index.js

@@ -18,6 +18,8 @@ export * from "./coin-price.js";
 export * from "./defi-integration.js";
 export * from "./deposit-transaction.js";
 export * from "./ember-position.js";
+export * from "./evm-atomic-liquidity-lib.js";
+export * from "./evm-atomic-vault.js";
 export * from "./evm-contracts.js";
 export * from "./evm-deposit-parking-lot.js";
 export * from "./evm-deposit-token.js";
@@ -34,8 +36,10 @@ export * from "./exposure.js";
 export * from "./exposure-coin.js";
 export * from "./exposure-protocol.js";
 export * from "./fee.js";
+export * from "./fee-multiplier-tier.js";
 export * from "./fees.js";
 export * from "./history-interval.js";
+export * from "./instant-withdraw-config.js";
 export * from "./lp.js";
 export * from "./manager.js";
 export * from "./min-withdrawal-shares-updated-event.js";

package/dist/src/api/v2/models/instant-withdraw-config.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+import type { FeeMultiplierTier } from "./fee-multiplier-tier.js";
+/**
+ *
+ * @export
+ * @interface InstantWithdrawConfig
+ */
+export interface InstantWithdrawConfig {
+    /**
+     * On-chain id of the whitelisted source vault
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    sourceVaultId: string;
+    /**
+     * Stable off-chain id of the source vault (null when the source vault is not indexed by us, e.g. an external EmberShare)
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    sourceVaultOffchainId?: string | null;
+    /**
+     *
+     * @type {boolean}
+     * @memberof InstantWithdrawConfig
+     */
+    whitelisted: boolean;
+    /**
+     * Base instant-withdraw fee (1e18 fixed-point)
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    feePercentageE18: string;
+    /**
+     * Portion held back and released later (1e18 fixed-point)
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    holdbackPercentageE18: string;
+    /**
+     * Max swap capacity per epoch as a % of source vault TVL (1e18 fixed-point)
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    maxCapacityPercentageE18: string;
+    /**
+     * Post-swap concentration cap (1e18 fixed-point)
+     * @type {string}
+     * @memberof InstantWithdrawConfig
+     */
+    maxUtilizationPercentageE18: string;
+    /**
+     *
+     * @type {Array<FeeMultiplierTier>}
+     * @memberof InstantWithdrawConfig
+     */
+    feeMultiplierCurve: Array<FeeMultiplierTier>;
+}

package/dist/src/api/v2/models/instant-withdraw-config.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/api/v2/models/vault-detail.d.ts

@@ -30,6 +30,12 @@ export interface VaultDetail {
      * @memberof VaultDetail
      */
     id: string;
+    /**
+     * Vault flavor at the parent (root) level. TOKENIZED vaults mint a transferable receipt token. ATOMIC (atomic-liquidity) vaults use non-transferable internal shares and have no real receipt token. Defaults to TOKENIZED for backward compatibility.
+     * @type {string}
+     * @memberof VaultDetail
+     */
+    vaultType?: VaultDetailVaultTypeEnum;
     /**
      * Short name/symbol of the vault
      * @type {string}
@@ -237,6 +243,11 @@ export interface VaultDetail {
      */
     defiIntegrations: Array<DefiIntegration>;
 }
+export declare const VaultDetailVaultTypeEnum: {
+    readonly Tokenized: "TOKENIZED";
+    readonly Atomic: "ATOMIC";
+};
+export type VaultDetailVaultTypeEnum = (typeof VaultDetailVaultTypeEnum)[keyof typeof VaultDetailVaultTypeEnum];
 export declare const VaultDetailStatusEnum: {
     readonly Active: "active";
     readonly Paused: "paused";

package/dist/src/api/v2/models/vault-detail.js

@@ -11,6 +11,10 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+export const VaultDetailVaultTypeEnum = {
+    Tokenized: "TOKENIZED",
+    Atomic: "ATOMIC"
+};
 export const VaultDetailStatusEnum = {
     Active: "active",
     Paused: "paused",

package/dist/src/atomic/instant-withdraw.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Chain-agnostic Atomic Liquidity Vault (ALV) instant-withdraw quote core (BET-4111).
+ *
+ * There is NO on-chain preview/quote function on the ALV, so the SDK computes the
+ * quote client-side by mirroring the exact contract math. Both chains use the same
+ * formulas with a different fixed-point scale, so this module is parameterised by
+ * `scale` (EVM = 1e18, Sui = 1e9) and consumed by both the EVM and Sui readers, which
+ * supply the live on-chain inputs (rate/TVL/held-value/config) via RPC.
+ *
+ * Mirrors:
+ *  - swap-with-holdback: EVM `AtomicLiquidityLib.swapEmberShares`,
+ *    Sui `atomic_liquidity_vault::swap_ember_shares`
+ *  - plain instant withdraw: EVM `AtomicLiquidity.instantWithdraw`,
+ *    Sui `do_instant_withdraw_core`
+ *  - fixed point: `Math.mul = (a*b)/scale`, `Math.div = (a*scale)/b` (floor)
+ *  - fee curve: `_lookupFeeMultiplier` (ascending tiers; highest threshold <= utilization wins; 1x default)
+ */
+/** Fixed-point multiply: `(a * b) / scale`, floor (matches Solidity/Move `Math.mul`). */
+export declare function mulFp(a: bigint, b: bigint, scale: bigint): bigint;
+/** Fixed-point divide: `(a * scale) / b`, floor (matches Solidity/Move `Math.div`). */
+export declare function divFp(a: bigint, b: bigint, scale: bigint): bigint;
+/** A single (threshold, multiplier) tier of the fee-multiplier curve (fixed-point at `scale`). */
+export interface FeeMultiplierTier {
+    threshold: bigint;
+    multiplier: bigint;
+}
+/**
+ * Resolve the fee multiplier from an ascending curve at a given utilization.
+ * Returns the multiplier of the highest tier whose `threshold <= utilization`, or `scale`
+ * (1x) when the curve is empty / no tier matches. Mirrors `_lookupFeeMultiplier`.
+ */
+export declare function lookupFeeMultiplier(curve: FeeMultiplierTier[], utilization: bigint, scale: bigint): bigint;
+/** Per-source-share EmberShare swap config (fixed-point percentages at `scale`). */
+export interface EmberShareSwapConfig {
+    feePercentage: bigint;
+    holdbackPercentage: bigint;
+    maxUtilizationPercentage: bigint;
+    feeMultiplierCurve: FeeMultiplierTier[];
+    /**
+     * Minimum gross collateral value per swap (collateral units). A swap with
+     * `gross < minSwapGross` reverts `SwapAmountTooSmall`. 0/undefined disables the floor.
+     * EVM-only (no Sui equivalent yet) — omit on Sui.
+     */
+    minSwapGross?: bigint;
+    /**
+     * TVL-independent absolute ceiling on this source share's post-swap held value
+     * (collateral units). A swap pushing `currentHeldValue + gross` above it reverts
+     * `EmberShareHeldValueCapExceeded`. 0/undefined disables it. EVM-only — omit on Sui.
+     */
+    maxHeldValueAbsolute?: bigint;
+}
+export interface SwapQuoteInputs {
+    /** Fixed-point scale: 1e18 (EVM) / 1e9 (Sui). */
+    scale: bigint;
+    /** Gross collateral value of the source shares: `source.convertToAssets(shareAmount)`. */
+    grossAmount: bigint;
+    /** Source shares being swapped (for `resultingShares`). */
+    shareAmount: bigint;
+    /** Caller's current source-share balance (for `resultingShares`). */
+    userShareBalance: bigint;
+    /** Collateral value the ALV already holds for this source share (pre-swap). */
+    currentHeldValue: bigint;
+    /** ALV `totalAssets()`. */
+    vaultTotalAssets: bigint;
+    /** Remaining epoch capacity for this source share: `availableEmberShareCapacity(share)`. */
+    availableCapacity: bigint;
+    config: EmberShareSwapConfig;
+    feeWaived?: boolean;
+    holdbackWaived?: boolean;
+}
+export interface InstantWithdrawQuote {
+    /** Gross collateral value of the redeemed shares. */
+    grossAmount: bigint;
+    /** Paid to the receiver immediately (`gross - fee - holdback`). */
+    instantlyReceive: bigint;
+    /** Held back, released later by the operator (0 for the plain path). */
+    lockedAmount: bigint;
+    /** Fee charged (collateral units). */
+    feeAmount: bigint;
+    /** Effective fee % applied (base * curve multiplier), fixed-point at `scale`. */
+    effectiveFeePercentage: bigint;
+    /** Holdback % applied, fixed-point at `scale` (0 for the plain path). */
+    holdbackPercentage: bigint;
+    /** Post-swap utilization used for the cap + fee-multiplier (0 for the plain path). */
+    utilizationAtSwap: bigint;
+    /** Caller's source-share balance after the withdraw. */
+    resultingShares: bigint;
+    /** True if the swap/withdraw would succeed against ALL caps (utilization, epoch capacity,
+     *  absolute held-value, min-swap floor). Use the granular flags below to explain a `false`. */
+    withinCapacity: boolean;
+    /** True if `gross < minSwapGross` — the swap would revert `SwapAmountTooSmall`.
+     *  Always false for the plain path and when no floor is configured. */
+    belowMinSwap: boolean;
+    /** True if the post-swap held value is within `maxHeldValueAbsolute` (or the cap is disabled).
+     *  Always true for the plain path. */
+    withinHeldValueCap: boolean;
+}
+/**
+ * Quote the EmberShare swap-with-holdback path (source tokenized vault -> ALV).
+ * Mirrors `swapEmberShares` exactly: post-swap utilization drives the fee multiplier,
+ * `net = gross - fee - holdback` is paid now, the holdback is queued for later release.
+ */
+export declare function computeSwapQuote(inputs: SwapQuoteInputs): InstantWithdrawQuote;
+export interface PlainInstantQuoteInputs {
+    /** Fixed-point scale: 1e18 (EVM) / 1e9 (Sui). */
+    scale: bigint;
+    /** Gross collateral value of the shares: ALV `convertToAssets(shareAmount)`. */
+    grossAmount: bigint;
+    /** ALV shares being instantly withdrawn. */
+    shareAmount: bigint;
+    /** Caller's current ALV share balance (for `resultingShares`). */
+    userShareBalance: bigint;
+    /** `instantWithdrawFeePercentage`, fixed-point at `scale`. */
+    instantWithdrawFeePercentage: bigint;
+    /** `cumulativeInstantWithdrawShares`. */
+    cumulativeInstantWithdrawShares: bigint;
+    /** `maxInstantWithdrawShares` (cumulative cap). */
+    maxInstantWithdrawShares: bigint;
+}
+/**
+ * Quote the ALV's own plain `instantWithdraw` path (atomic-share holders).
+ * Mirrors the contract: `net = gross - fee`, no holdback; capped by
+ * `cumulative + shares <= maxInstantWithdrawShares`.
+ */
+export declare function computePlainInstantQuote(inputs: PlainInstantQuoteInputs): InstantWithdrawQuote;

package/dist/src/atomic/instant-withdraw.js

@@ -0,0 +1,122 @@
+/**
+ * Chain-agnostic Atomic Liquidity Vault (ALV) instant-withdraw quote core (BET-4111).
+ *
+ * There is NO on-chain preview/quote function on the ALV, so the SDK computes the
+ * quote client-side by mirroring the exact contract math. Both chains use the same
+ * formulas with a different fixed-point scale, so this module is parameterised by
+ * `scale` (EVM = 1e18, Sui = 1e9) and consumed by both the EVM and Sui readers, which
+ * supply the live on-chain inputs (rate/TVL/held-value/config) via RPC.
+ *
+ * Mirrors:
+ *  - swap-with-holdback: EVM `AtomicLiquidityLib.swapEmberShares`,
+ *    Sui `atomic_liquidity_vault::swap_ember_shares`
+ *  - plain instant withdraw: EVM `AtomicLiquidity.instantWithdraw`,
+ *    Sui `do_instant_withdraw_core`
+ *  - fixed point: `Math.mul = (a*b)/scale`, `Math.div = (a*scale)/b` (floor)
+ *  - fee curve: `_lookupFeeMultiplier` (ascending tiers; highest threshold <= utilization wins; 1x default)
+ */
+/** Fixed-point multiply: `(a * b) / scale`, floor (matches Solidity/Move `Math.mul`). */
+export function mulFp(a, b, scale) {
+    if (a === 0n || b === 0n)
+        return 0n;
+    return (a * b) / scale;
+}
+/** Fixed-point divide: `(a * scale) / b`, floor (matches Solidity/Move `Math.div`). */
+export function divFp(a, b, scale) {
+    if (b === 0n)
+        return 0n;
+    return (a * scale) / b;
+}
+/**
+ * Resolve the fee multiplier from an ascending curve at a given utilization.
+ * Returns the multiplier of the highest tier whose `threshold <= utilization`, or `scale`
+ * (1x) when the curve is empty / no tier matches. Mirrors `_lookupFeeMultiplier`.
+ */
+export function lookupFeeMultiplier(curve, utilization, scale) {
+    let multiplier = scale; // 1x
+    for (const tier of curve) {
+        if (utilization >= tier.threshold) {
+            multiplier = tier.multiplier;
+        }
+        else {
+            break; // ascending: once utilization < threshold, all later tiers are higher
+        }
+    }
+    return multiplier;
+}
+/**
+ * Quote the EmberShare swap-with-holdback path (source tokenized vault -> ALV).
+ * Mirrors `swapEmberShares` exactly: post-swap utilization drives the fee multiplier,
+ * `net = gross - fee - holdback` is paid now, the holdback is queued for later release.
+ */
+export function computeSwapQuote(inputs) {
+    const { scale, grossAmount, config, feeWaived, holdbackWaived } = inputs;
+    const newHeldValue = inputs.currentHeldValue + grossAmount;
+    const utilizationAtSwap = inputs.vaultTotalAssets === 0n
+        ? 0n
+        : divFp(newHeldValue, inputs.vaultTotalAssets, scale);
+    const feeMultiplier = lookupFeeMultiplier(config.feeMultiplierCurve, utilizationAtSwap, scale);
+    const effectiveFeePercentage = mulFp(config.feePercentage, feeMultiplier, scale);
+    const feeAmount = feeWaived ? 0n : mulFp(grossAmount, effectiveFeePercentage, scale);
+    const holdbackAmount = holdbackWaived
+        ? 0n
+        : mulFp(grossAmount, config.holdbackPercentage, scale);
+    // Mirror the contract's underflow guard.
+    const instantlyReceive = feeAmount + holdbackAmount > grossAmount
+        ? 0n
+        : grossAmount - feeAmount - holdbackAmount;
+    const withinUtilization = utilizationAtSwap <= config.maxUtilizationPercentage;
+    const withinEpochCapacity = grossAmount <= inputs.availableCapacity;
+    // Absolute held-value cap (0/undefined disables it); mirrors EmberShareHeldValueCapExceeded.
+    const maxHeldValueAbsolute = config.maxHeldValueAbsolute ?? 0n;
+    const withinHeldValueCap = maxHeldValueAbsolute === 0n || newHeldValue <= maxHeldValueAbsolute;
+    // Per-swap dust floor (0/undefined disables it); mirrors SwapAmountTooSmall.
+    const minSwapGross = config.minSwapGross ?? 0n;
+    const belowMinSwap = minSwapGross > 0n && grossAmount < minSwapGross;
+    return {
+        grossAmount,
+        instantlyReceive,
+        lockedAmount: holdbackAmount,
+        feeAmount,
+        effectiveFeePercentage,
+        holdbackPercentage: holdbackWaived ? 0n : config.holdbackPercentage,
+        utilizationAtSwap,
+        resultingShares: inputs.userShareBalance >= inputs.shareAmount
+            ? inputs.userShareBalance - inputs.shareAmount
+            : 0n,
+        belowMinSwap,
+        withinHeldValueCap,
+        withinCapacity: withinUtilization &&
+            withinEpochCapacity &&
+            withinHeldValueCap &&
+            !belowMinSwap &&
+            feeAmount + holdbackAmount <= grossAmount
+    };
+}
+/**
+ * Quote the ALV's own plain `instantWithdraw` path (atomic-share holders).
+ * Mirrors the contract: `net = gross - fee`, no holdback; capped by
+ * `cumulative + shares <= maxInstantWithdrawShares`.
+ */
+export function computePlainInstantQuote(inputs) {
+    const { scale, grossAmount, shareAmount } = inputs;
+    const feeAmount = mulFp(grossAmount, inputs.instantWithdrawFeePercentage, scale);
+    const instantlyReceive = feeAmount > grossAmount ? 0n : grossAmount - feeAmount;
+    const withinCapacity = inputs.cumulativeInstantWithdrawShares + shareAmount <=
+        inputs.maxInstantWithdrawShares;
+    return {
+        grossAmount,
+        instantlyReceive,
+        lockedAmount: 0n,
+        feeAmount,
+        effectiveFeePercentage: inputs.instantWithdrawFeePercentage,
+        holdbackPercentage: 0n,
+        utilizationAtSwap: 0n,
+        resultingShares: inputs.userShareBalance >= shareAmount
+            ? inputs.userShareBalance - shareAmount
+            : 0n,
+        belowMinSwap: false,
+        withinHeldValueCap: true,
+        withinCapacity
+    };
+}

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

@@ -0,0 +1,98 @@
+import { Provider } from "ethers";
+import { FeeMultiplierTier, InstantWithdrawQuote } from "../../atomic/instant-withdraw.js";
+/**
+ * Read-only views for the Atomic Liquidity Vault (BFE-817/818).
+ *
+ * Write calls live on the role classes (EVMUserCalls.instantWithdraw /
+ * swapEmberShares, EVMOperatorCalls.supplyToStrategy / withdrawFromStrategy /
+ * redeemCollectedEmberShares / releaseUsersHoldback, EVMVaultAdminCalls.setStrategy /
+ * setEmberShareWhitelist / setSwapWaiver / setMaxInstantWithdrawShares /
+ * setInstantWithdrawFeePercentage). Shared lifecycle calls (deposit, redeemShares,
+ * cancelPendingWithdrawalRequest, processWithdrawalRequests, collectPlatformFee,
+ * updateVaultRate, pause/role/cap setters) reuse the existing EmberVault methods on
+ * those same classes.
+ *
+ * This reader uses an ethers Contract against the bundled AtomicLiquidity ABI and
+ * provides typed convenience getters plus a generic `read` for any view not covered.
+ *
+ * @example
+ * ```typescript
+ * const reader = new EVMAtomicLiquidityReader(provider);
+ * const rate = await reader.rate(vault);
+ * const supplied = await reader.getStrategyAssets(vault);
+ * const cfg = await reader.read(vault, "emberShareConfigs", [sourceShare]);
+ * ```
+ */
+export declare class EVMAtomicLiquidityReader {
+    provider: Provider;
+    constructor(_provider: Provider);
+    private contract;
+    /** A source EmberShare vault (ERC-4626) for read-only convertToAssets/balanceOf/accounts. */
+    private shareContract;
+    /** Generic view call for any function on the AtomicLiquidity ABI. */
+    read(vaultAddress: string, functionName: string, args?: unknown[]): Promise<unknown>;
+    /** roles() -> { admin, operator, rateManager }. */
+    roles(vaultAddress: string): Promise<unknown>;
+    /** rate() -> { value, maxRateChangePerUpdate, rateUpdateInterval, lastUpdatedAt }. */
+    rate(vaultAddress: string): Promise<unknown>;
+    /** Current external strategy address (zero if none). */
+    strategy(vaultAddress: string): Promise<string>;
+    /** Assets currently supplied to the strategy. */
+    getStrategyAssets(vaultAddress: string): Promise<bigint>;
+    /** Total assets (idle + strategy + outstanding). */
+    totalAssets(vaultAddress: string): Promise<bigint>;
+    /**
+     * Solvency margin (collateral units, signed): `totalAssets - totalLiabilities`. Negative
+     * means the vault is under-collateralised. Monitoring view added with the audit fixes.
+     */
+    solvencyMargin(vaultAddress: string): Promise<bigint>;
+    /** Total non-transferable shares in circulation. */
+    totalShares(vaultAddress: string): Promise<bigint>;
+    /** Non-transferable share balance of `account`. */
+    shareOf(vaultAddress: string, account: string): Promise<bigint>;
+    /** Cumulative instant-withdraw shares used. */
+    cumulativeInstantWithdrawShares(vaultAddress: string): Promise<bigint>;
+    /** Configured instant-withdraw cap (shares). */
+    maxInstantWithdrawShares(vaultAddress: string): Promise<bigint>;
+    /** Remaining instant-withdraw headroom (shares). */
+    availableInstantWithdrawShares(vaultAddress: string): Promise<bigint>;
+    /** Per-source-share swap config. */
+    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>;
+    /** Length of the holdback FIFO for a source share. */
+    getHoldbackQueueLength(vaultAddress: string, share: string): Promise<bigint>;
+    /**
+     * Escrowed (deferred) holdback collateral claimable by `account` — accrued when a
+     * holdback payout couldn't be transferred to it during `releaseUsersHoldback` (e.g. a
+     * token-level blocklist). Claim via user `claimHoldback` / `claimHoldbackFor`. 0 if none.
+     */
+    unclaimedHoldback(vaultAddress: string, account: string): Promise<bigint>;
+    /** Whether `operation` ("deposits" | "withdrawals" | "privilegedOperations") is paused. */
+    pauseStatus(vaultAddress: string, operation: string): Promise<boolean>;
+    /** Per-account state (shares + pending withdrawals). */
+    getAccountState(vaultAddress: string, account: string): Promise<unknown>;
+    /** Convert a share amount to assets at the current rate. */
+    convertToAssets(vaultAddress: string, shares: bigint): Promise<bigint>;
+    /** Convert an asset amount to shares at the current rate. */
+    convertToShares(vaultAddress: string, assets: bigint): Promise<bigint>;
+    /** Contract version string. */
+    version(vaultAddress: string): Promise<string>;
+    /**
+     * Live quote for the EmberShare swap-with-holdback "instant withdraw": a holder of a
+     * source vault's shares (`share`) swaps `shareAmount` into this ALV, receiving most of
+     * the value instantly with a small % held back for later operator release.
+     *
+     * All dynamic inputs (rate, TVL, held value, epoch capacity, waivers) are read live via
+     * RPC. The fee-multiplier curve has no on-chain getter (the public `emberShareConfigs`
+     * getter omits the dynamic array), so pass it from bfvs `instantWithdrawConfig`; an empty
+     * curve means a 1x multiplier (matches the contract default).
+     */
+    previewSwapInstantWithdraw(vaultAddress: string, share: string, shareAmount: bigint, owner: string, feeMultiplierCurve?: FeeMultiplierTier[]): Promise<InstantWithdrawQuote>;
+    /**
+     * Live quote for the ALV's own plain `instantWithdraw` (atomic-share holders): burn
+     * `shareAmount` ALV shares for `gross - fee`, no holdback, capped by
+     * `maxInstantWithdrawShares`. All inputs read live via RPC.
+     */
+    previewPlainInstantWithdraw(vaultAddress: string, shareAmount: bigint, owner: string): Promise<InstantWithdrawQuote>;
+}