@gauntlet-xyz/sdk 2.3.0 → 3.0.1

package/src/evm/withdrawQuote.ts

@@ -0,0 +1,434 @@
+import type { Address } from 'viem';
+import type { GauntletClient } from '../client';
+import {
+  AccountRequiredError,
+  InvalidSlippageBPSError,
+  InvalidWithdrawParamsError,
+  requireNonZeroSyncWithdrawBound,
+  UnsupportedAssetError,
+  UnsupportedFeatureError,
+  VaultNotFoundError,
+} from '../errors';
+import { DEFAULT_BPS, MAX_BPS } from '../constants';
+import { resolveVault } from './vaults';
+import {
+  applySlippageDown,
+  applySlippageUp,
+  requireAeraSyncRedeemRuntime,
+  resolveAeraRuntimeContracts,
+  resolveAeraTokenModeSupport,
+} from './aeraContracts';
+import { multiDepositorVaultAbi } from './abis/multiDepositorVault';
+import {
+  convertNumeraireToToken,
+  convertTokenToNumeraire,
+} from './aeraContracts/priceAndFeeCalculator';
+import {
+  getKnownSyncRedeemLiquidityTokens,
+  getSyncRedeemEpochState,
+  getSyncRedeemRate,
+  getSyncRedeemRateContext,
+  getSyncRedeemTokenOut,
+  getSyncWithdrawUnitsIn,
+  getUserUnitsRefundableUntil,
+  type SyncRedeemRate,
+} from './aeraContracts/v2';
+import { resolveOperationMode } from './operationMode';
+
+/** Epoch-cap accounting plus any liquid-token balance known to the caller. */
+export interface SyncWithdrawCapacity {
+  /** Effective epoch cap (min of relative and absolute), in numeraire. */
+  epochCapNumeraire: bigint;
+  /** Numeraire already redeemed globally in the current epoch. */
+  epochRedeemedNumeraire: bigint;
+  /** Remaining global sync redeem capacity this epoch, in numeraire. */
+  remainingNumeraire: bigint;
+  /** Remaining capacity expressed in the withdraw token. */
+  remainingTokens: bigint;
+  /** Vault token balance when no pull-funds calldata is configured; otherwise unknown. */
+  knownLiquidityTokens?: bigint;
+  /** This redemption's size in numeraire (matches the on-chain epoch accounting). */
+  requestNumeraire: bigint;
+  /** True when this redemption alone exceeds remaining epoch capacity (the tx would revert). */
+  exceedsCapacity: boolean;
+}
+
+export type SyncWithdrawQuoteRequest =
+  | { mode: 'amount'; amount: bigint }
+  | { mode: 'shares'; shares: bigint }
+  | { mode: 'entireAmount'; account: Address };
+
+export interface SyncWithdrawQuoteContext {
+  vaultId: string;
+  chainId: number;
+  tokenAddress: Address;
+  /** Account used for balance and lock reads when the quote is account-scoped. */
+  account?: Address;
+  /** Slippage tolerance used to derive `minTokensOut` or `maxUnitsIn`. */
+  slippageBps: number;
+  /** Block snapshot used for all quote reads. */
+  blockNumber: bigint;
+  /** Exact sizing request that produced this quote. */
+  request: SyncWithdrawQuoteRequest;
+}
+
+interface SyncWithdrawQuoteDetails {
+  /** Vault units (shares) burned: exact for `'redeem'`, estimated for `'withdraw'`. */
+  shares: bigint;
+  /** Upper bound on shares burned after slippage (equals `shares` for `'redeem'`). */
+  maxUnitsIn: bigint;
+  /** Tokens received: exact (requested) for `'withdraw'`, estimated for `'redeem'`. */
+  tokensOut: bigint;
+  /** Lower bound on tokens received after slippage (equals `tokensOut` for `'withdraw'`). */
+  minTokensOut: bigint;
+  /** Largest exact-token withdrawal that fits `shares`; only set for `'redeem'` quotes. */
+  shareSafeTokensOut?: bigint;
+  /** Live multiplier breakdown (base, dynamic premium, effective), in bps. */
+  rate: SyncRedeemRate;
+  capacity: SyncWithdrawCapacity;
+  /** Timestamp until which the account's units are locked; undefined when no account was quoted. */
+  unitsLockedUntil?: bigint;
+  /** Context that must match any transaction build using these quote bounds. */
+  context: SyncWithdrawQuoteContext;
+}
+
+/** Bounds consumed by one of the two on-chain sync withdraw entry points. */
+export type SyncWithdrawQuoteBounds =
+  | {
+      kind: 'redeem';
+      shares: bigint;
+      minTokensOut: bigint;
+      context: SyncWithdrawQuoteContext;
+    }
+  | {
+      kind: 'withdraw';
+      tokensOut: bigint;
+      maxUnitsIn: bigint;
+      context: SyncWithdrawQuoteContext;
+    };
+
+/**
+ * A live quote for an instant (sync) withdraw.
+ *
+ * `kind` distinguishes the two on-chain entry points:
+ * - `'redeem'`: exact shares burned, estimated tokens out (used for by-shares / entire-balance exits)
+ * - `'withdraw'`: exact tokens out, estimated shares burned (used for by-token-amount exits)
+ */
+export type SyncWithdrawQuote =
+  | (SyncWithdrawQuoteDetails & { kind: 'redeem' })
+  | (SyncWithdrawQuoteDetails & { kind: 'withdraw' });
+
+export type SyncWithdrawRateParams = {
+  vaultId: string;
+  /** EVM chain ID. Defaults to the vault's primary chain (Base for current multichain vaults). */
+  chainId?: number;
+  /** Required for multiasset vaults. */
+  assetSymbol?: string;
+};
+
+type SyncWithdrawQuoteBaseParams = SyncWithdrawRateParams & {
+  /** Optional for explicit amount/shares quotes; required for full-position quotes. */
+  account?: Address;
+  /**
+   * Slippage tolerance in basis points (e.g. 100 = 1%). Defaults to 100.
+   * A value of 10000 is invalid for share-sized quotes because it makes `minTokensOut` zero.
+   */
+  slippageBps?: number;
+};
+
+export type SyncWithdrawQuoteParams =
+  | (SyncWithdrawQuoteBaseParams & { shares: bigint; amount?: never; entireAmount?: never })
+  | (SyncWithdrawQuoteBaseParams & { amount: bigint; shares?: never; entireAmount?: never })
+  | (SyncWithdrawQuoteBaseParams & {
+      account: Address;
+      entireAmount: true;
+      shares?: never;
+      amount?: never;
+    });
+
+function validateSyncWithdrawQuoteParams(params: SyncWithdrawQuoteParams) {
+  const modes = [
+    'amount' in params && params.amount != null,
+    'shares' in params && params.shares != null,
+    'entireAmount' in params && params.entireAmount === true,
+  ].filter(Boolean).length;
+
+  if (modes !== 1) throw new InvalidWithdrawParamsError();
+  if ('entireAmount' in params && params.entireAmount === true && !params.account) {
+    throw new AccountRequiredError();
+  }
+}
+
+async function resolveSyncWithdrawContext(
+  client: GauntletClient,
+  params: SyncWithdrawRateParams,
+  readKind: 'quote' | 'rate'
+) {
+  const resolved = await resolveVault(client, params.vaultId, params.chainId);
+  if (!resolved) throw new VaultNotFoundError(params.vaultId);
+
+  const { vault, protocol } = resolved;
+  if (protocol !== 'aera') {
+    throw new UnsupportedFeatureError(
+      readKind === 'quote'
+        ? 'Sync withdraw quote is only available for Aera vaults'
+        : 'Sync withdraw rate is only available for Aera vaults'
+    );
+  }
+
+  const chainId = params.chainId ?? vault.chainId;
+  const publicClient = client.getPublicClient(chainId);
+  const token =
+    vault.supplyToken.length > 1
+      ? vault.supplyToken.find((tInfo) => tInfo.symbol === params.assetSymbol)
+      : vault.supplyToken[0];
+  if (token === undefined) {
+    throw new UnsupportedAssetError(params.assetSymbol ?? 'unknown', params.vaultId);
+  }
+
+  const quoteBlock = await publicClient.getBlock();
+  if (quoteBlock.number === null) {
+    throw new UnsupportedFeatureError(
+      readKind === 'quote'
+        ? 'Aera: sync withdraw quote requires a numbered block'
+        : 'Aera: sync withdraw rate requires a numbered block'
+    );
+  }
+  const readContext = {
+    blockNumber: quoteBlock.number,
+    blockTimestamp: BigInt(quoteBlock.timestamp),
+  };
+
+  const runtime = await resolveAeraRuntimeContracts(publicClient, vault, readContext);
+  requireAeraSyncRedeemRuntime(runtime);
+
+  const support = await resolveAeraTokenModeSupport(
+    publicClient,
+    runtime,
+    token.address,
+    readContext
+  );
+  resolveOperationMode(params.vaultId, 'sync', {
+    async: support.asyncRedeem,
+    sync: support.syncRedeem,
+  });
+
+  return { publicClient, vault, token, runtime, chainId, readContext };
+}
+
+/** Reads the live instant-withdraw fee rate without requiring a withdrawal amount or account. */
+export async function getSyncWithdrawRate(
+  client: GauntletClient,
+  params: SyncWithdrawRateParams
+): Promise<SyncRedeemRate> {
+  const { publicClient, vault, token, runtime, readContext } = await resolveSyncWithdrawContext(
+    client,
+    params,
+    'rate'
+  );
+
+  return getSyncRedeemRate(
+    publicClient,
+    runtime.provisioner.address,
+    vault.vaultAddress,
+    token.address,
+    runtime.feeCalculator.address,
+    readContext
+  );
+}
+
+/**
+ * Builds a live quote for an instant (sync) withdraw without sending a transaction.
+ *
+ * Surfaces everything the on-chain `redeem`/`withdraw` would apply or check but that a plain
+ * transaction build does not pre-validate: the effective rate (including the price-age dynamic
+ * premium), slippage bounds, the global per-epoch redeem capacity, any known vault-balance limit,
+ * and whether the caller's units are still locked from a recent sync deposit.
+ *
+ * @throws {VaultNotFoundError} If the vault ID is not found.
+ * @throws {UnsupportedAssetError} If the asset symbol is not accepted by the vault.
+ * @throws {UnsupportedFeatureError} If the vault is not an Aera V2 deployment.
+ * @throws {UnsupportedDepositModeError} If sync redeem is not enabled for the token.
+ * @throws {StalePriceError} If the oracle price is too stale for an instant redeem.
+ */
+export async function getSyncWithdrawQuote(
+  client: GauntletClient,
+  params: SyncWithdrawQuoteParams
+): Promise<SyncWithdrawQuote> {
+  validateSyncWithdrawQuoteParams(params);
+
+  if (
+    params.slippageBps !== undefined &&
+    (!Number.isInteger(params.slippageBps) ||
+      params.slippageBps < 0 ||
+      params.slippageBps > Number(MAX_BPS))
+  ) {
+    throw new InvalidSlippageBPSError(params.slippageBps);
+  }
+  const slippageBps = params.slippageBps ?? DEFAULT_BPS;
+
+  const {
+    publicClient,
+    vault,
+    token,
+    runtime,
+    chainId,
+    readContext: quoteReadContext,
+  } = await resolveSyncWithdrawContext(client, params, 'quote');
+
+  const provisioner = runtime.provisioner.address;
+  const feeCalculator = runtime.feeCalculator.address;
+  const feeVersion = runtime.feeCalculator.version;
+  const vaultAddress = vault.vaultAddress;
+
+  const { rate, hasPullFundsSubmitData } = await getSyncRedeemRateContext(
+    publicClient,
+    provisioner,
+    vaultAddress,
+    token.address,
+    feeCalculator,
+    quoteReadContext
+  );
+
+  let kind: SyncWithdrawQuote['kind'];
+  let shares: bigint;
+  let tokensOut: bigint;
+  let minTokensOut: bigint;
+  let maxUnitsIn: bigint;
+  let request: SyncWithdrawQuoteRequest;
+  let shareSafeTokensOut: bigint | undefined;
+
+  if ('amount' in params && params.amount != null) {
+    // Exact token out: shares burned is the estimate, bounded above by slippage.
+    kind = 'withdraw';
+    request = { mode: 'amount', amount: params.amount };
+    tokensOut = params.amount;
+    requireNonZeroSyncWithdrawBound(tokensOut, 'tokensOut');
+    minTokensOut = params.amount;
+    shares = await getSyncWithdrawUnitsIn(
+      publicClient,
+      provisioner,
+      feeCalculator,
+      feeVersion,
+      vaultAddress,
+      token.address,
+      params.amount,
+      rate.effectiveMultiplierBps,
+      quoteReadContext
+    );
+    maxUnitsIn = applySlippageUp(shares, slippageBps);
+    requireNonZeroSyncWithdrawBound(maxUnitsIn, 'maxUnitsIn');
+  } else {
+    // Exact shares in: tokens out is the estimate, bounded below by slippage.
+    kind = 'redeem';
+    if ('entireAmount' in params && params.entireAmount) {
+      if (!params.account) throw new AccountRequiredError();
+      request = { mode: 'entireAmount', account: params.account };
+      shares = await publicClient.readContract({
+        address: vaultAddress,
+        abi: multiDepositorVaultAbi,
+        functionName: 'balanceOf',
+        args: [params.account],
+        blockNumber: quoteReadContext.blockNumber,
+      });
+    } else if ('shares' in params && params.shares != null) {
+      request = { mode: 'shares', shares: params.shares };
+      shares = params.shares;
+    } else {
+      throw new InvalidWithdrawParamsError();
+    }
+    requireNonZeroSyncWithdrawBound(shares, 'unitsIn');
+    const getTokensOut = (unitsIn: bigint) =>
+      getSyncRedeemTokenOut(
+        publicClient,
+        provisioner,
+        feeCalculator,
+        feeVersion,
+        vaultAddress,
+        token.address,
+        unitsIn,
+        rate.effectiveMultiplierBps,
+        quoteReadContext
+      );
+    // A capacity-limited Max is submitted as an exact-token withdraw. Reserve slippage headroom so
+    // its maximum share cost cannot exceed the user's share balance.
+    const shareSafeUnitsIn = (shares * MAX_BPS) / (MAX_BPS + BigInt(slippageBps));
+    const tokensOutPromise = getTokensOut(shares);
+    const shareSafeTokensOutPromise =
+      shareSafeUnitsIn === shares ? tokensOutPromise : getTokensOut(shareSafeUnitsIn);
+    [tokensOut, shareSafeTokensOut] = await Promise.all([
+      tokensOutPromise,
+      shareSafeTokensOutPromise,
+    ]);
+    minTokensOut = applySlippageDown(tokensOut, slippageBps);
+    requireNonZeroSyncWithdrawBound(minTokensOut, 'minTokensOut');
+    maxUnitsIn = shares;
+  }
+
+  const [epoch, requestNumeraire, unitsLockedUntil, knownLiquidityTokens] = await Promise.all([
+    getSyncRedeemEpochState(publicClient, provisioner, quoteReadContext),
+    convertTokenToNumeraire(
+      publicClient,
+      feeCalculator,
+      feeVersion,
+      vaultAddress,
+      token.address,
+      tokensOut,
+      quoteReadContext
+    ),
+    params.account
+      ? getUserUnitsRefundableUntil(publicClient, provisioner, params.account, quoteReadContext)
+      : Promise.resolve(undefined),
+    getKnownSyncRedeemLiquidityTokens(
+      publicClient,
+      vaultAddress,
+      token.address,
+      hasPullFundsSubmitData,
+      quoteReadContext
+    ),
+  ]);
+
+  const remainingNumeraire =
+    epoch.epochCapNumeraire > epoch.epochRedeemedNumeraire
+      ? epoch.epochCapNumeraire - epoch.epochRedeemedNumeraire
+      : 0n;
+  const remainingTokens = await convertNumeraireToToken(
+    publicClient,
+    feeCalculator,
+    feeVersion,
+    vaultAddress,
+    token.address,
+    remainingNumeraire,
+    quoteReadContext
+  );
+  const quoteDetails: SyncWithdrawQuoteDetails = {
+    shares,
+    maxUnitsIn,
+    tokensOut,
+    minTokensOut,
+    shareSafeTokensOut,
+    rate,
+    capacity: {
+      epochCapNumeraire: epoch.epochCapNumeraire,
+      epochRedeemedNumeraire: epoch.epochRedeemedNumeraire,
+      remainingNumeraire,
+      remainingTokens,
+      knownLiquidityTokens,
+      requestNumeraire,
+      exceedsCapacity: requestNumeraire > remainingNumeraire,
+    },
+    unitsLockedUntil,
+    context: {
+      vaultId: params.vaultId,
+      chainId,
+      tokenAddress: token.address,
+      ...(params.account ? { account: params.account } : {}),
+      slippageBps,
+      blockNumber: quoteReadContext.blockNumber,
+      request,
+    },
+  };
+
+  if (kind === 'redeem') return { kind, ...quoteDetails };
+  return { kind, ...quoteDetails };
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-export { GauntletClient, AttributionMode } from './client';
+export { GauntletClient, AttributionMode, bundledVaultManifest } from './client';
 export type { GauntletClientConfig } from './client';
 export { ContractVersion } from './evm/types';
 
@@ -15,7 +15,10 @@ export type { VaultFilter } from './evm/vaults';
 
 export { getDepositTx } from './evm/deposit';
 export { getDepositReceiverApprovalTx } from './evm/depositReceiverApproval';
+export { getSyncDepositQuote, getSyncDepositRate } from './evm/depositQuote';
 export { getWithdrawTx } from './evm/withdraw';
+export { getSyncWithdrawQuote, getSyncWithdrawRate } from './evm/withdrawQuote';
+export { getAeraTokenModeSupport } from './evm/tokenModes';
 export { getUserCurrentBalance } from './evm/userCurrentBalance';
 export { getVaults, VaultId } from './evm/vaults';
 export { resolveAeraRuntimeContracts, resolveContractVersion } from './evm/aeraContracts';
@@ -32,7 +35,24 @@ export {
 
 export type { EvmDepositParams } from './evm/deposit';
 export type { EvmDepositReceiverApprovalParams } from './evm/depositReceiverApproval';
+export type {
+  SyncDepositQuote,
+  SyncDepositQuoteParams,
+  SyncDepositRate,
+  SyncDepositRateParams,
+} from './evm/depositQuote';
 export type { EvmWithdrawParams } from './evm/withdraw';
+export type {
+  SyncWithdrawQuote,
+  SyncWithdrawQuoteParams,
+  SyncWithdrawCapacity,
+  SyncWithdrawQuoteContext,
+  SyncWithdrawQuoteRequest,
+  SyncWithdrawQuoteBounds,
+  SyncWithdrawRateParams,
+} from './evm/withdrawQuote';
+export type { AeraTokenModeSupportParams } from './evm/tokenModes';
+export type { SyncRedeemRate } from './evm/aeraContracts/v2';
 export type { EvmTxStep } from './evm/adapters/types';
 export type { UserCurrentBalanceParams, UserCurrentBalance } from './evm/userCurrentBalance';
 export type { PreparedTx } from './attribution';
@@ -46,12 +66,17 @@ export {
   ChainMismatchError,
   UnsupportedDepositModeError,
   RpcNotConfiguredError,
+  AccountMismatchError,
   AccountRequiredError,
   UnsupportedProtocolError,
   UnsupportedFeatureError,
   InvalidWithdrawParamsError,
+  InvalidSyncDepositBoundError,
+  InvalidSyncWithdrawBoundError,
+  InvalidSlippageBPSError,
   UnimplementedFeatureError,
   UnitConversionError,
   StalePriceError,
   InvalidSolverTipError,
 } from './errors';
+export type { SyncWithdrawBound } from './errors';

package/dist/api/activity.js

@@ -1,154 +0,0 @@
-import { GauntletSDKError } from '../errors';
-import { decimalToBigInt, sharesToBigInt } from './decimal';
-import { SettlementTimeoutError } from './errors';
-const PENDING_TYPES = new Set(['deposit_pending', 'withdraw_pending']);
-const REFUNDED_TYPES = new Set(['deposit_refunded', 'withdraw_refunded']);
-function flowKind(rowType) {
-    if (rowType.startsWith('deposit'))
-        return 'deposit';
-    if (rowType.startsWith('withdraw'))
-        return 'withdraw';
-    if (rowType === 'transfer_in' || rowType === 'transfer_out')
-        return rowType;
-    throw new GauntletSDKError(`Unknown activity row type "${rowType}"`);
-}
-function abs(value) {
-    return value < 0n ? -value : value;
-}
-/**
- * Comparison scale for asset amounts. The API emits human-unit decimal strings
- * with at most `token.decimals` fractional digits, so 18 digits is exact for
- * every supported asset.
- */
-const ASSET_SCALE = 18;
-function toAssetAmount(rows) {
-    // Per the API contract, at most one row of an async lifecycle carries the
-    // asset movement (the other legs are "0"), so the max magnitude is the
-    // flow's amount. For refunded flows this surfaces the requested amount
-    // instead of the useless net of zero.
-    let best = rows[0];
-    let bestMagnitude = abs(decimalToBigInt(best.assets_delta.native, ASSET_SCALE));
-    for (const row of rows.slice(1)) {
-        const magnitude = abs(decimalToBigInt(row.assets_delta.native, ASSET_SCALE));
-        if (magnitude > bestMagnitude) {
-            best = row;
-            bestMagnitude = magnitude;
-        }
-    }
-    const token = best.assets_delta.token ?? rows.find((r) => r.assets_delta.token)?.assets_delta.token ?? null;
-    const decimal = best.assets_delta.native.replace(/^-/, '');
-    const raw = token?.decimals != null ? decimalToBigInt(decimal, token.decimals) : null;
-    return { decimal, raw, token };
-}
-/**
- * Pure stitcher: folds raw activity rows into `ActivityFlow`s. Rows may be in
- * any order and may span multiple vaults; async lifecycles are paired by
- * `request_hash`. Flows are returned newest-first (by the flow's latest row).
- */
-export function stitchActivityFlows(rows) {
-    const groups = new Map();
-    for (const [index, row] of rows.entries()) {
-        // Rows without a request_hash are standalone sync flows: each one is its
-        // own group, so two same-type events in one transaction (e.g. a multicall
-        // doing two deposits) stay two flows.
-        const key = row.request_hash ?? `row:${index}`;
-        const group = groups.get(key);
-        if (group)
-            group.push(row);
-        else
-            groups.set(key, [row]);
-    }
-    const flows = [];
-    for (const group of groups.values()) {
-        group.sort((a, b) => a.block_timestamp - b.block_timestamp);
-        const pendingRow = group.find((r) => PENDING_TYPES.has(r.type)) ?? null;
-        const terminalRow = group.find((r) => !PENDING_TYPES.has(r.type)) ?? null;
-        const isAsync = group.some((r) => r.request_hash != null);
-        let status;
-        if (!terminalRow)
-            status = 'pending';
-        else if (REFUNDED_TYPES.has(terminalRow.type))
-            status = 'refunded';
-        else
-            status = 'settled';
-        let sharesMagnitude = 0n;
-        for (const row of group) {
-            const shares = abs(sharesToBigInt(row.shares_delta));
-            if (shares > sharesMagnitude)
-                sharesMagnitude = shares;
-        }
-        flows.push({
-            kind: flowKind((terminalRow ?? pendingRow ?? group[0]).type),
-            status,
-            vaultId: group[0].vault_id,
-            requestHash: group[0].request_hash ?? null,
-            requestedAt: pendingRow
-                ? new Date(pendingRow.block_timestamp * 1000)
-                : isAsync
-                    ? null
-                    : new Date(group[0].block_timestamp * 1000),
-            settledAt: terminalRow ? new Date(terminalRow.block_timestamp * 1000) : null,
-            assets: toAssetAmount(group),
-            shares: sharesMagnitude,
-            txHashes: [...new Set(group.map((r) => r.tx_hash))],
-        });
-    }
-    return flows.sort((a, b) => {
-        const aAt = (a.settledAt ?? a.requestedAt)?.getTime() ?? 0;
-        const bAt = (b.settledAt ?? b.requestedAt)?.getTime() ?? 0;
-        return bAt - aAt;
-    });
-}
-/**
- * Fetches the wallet's activity log and stitches it into lifecycle-aware
- * flows — the replacement for scanning vault event logs over RPC.
- *
- * ```ts
- * const flows = await getActivityFlows(client.api, wallet);
- * const open = flows.filter((f) => f.status === 'pending');
- * ```
- */
-export async function getActivityFlows(api, walletAddress, options = {}) {
-    const maxRows = options.maxRows ?? 1000;
-    const rows = [];
-    for await (const row of api.activityRows(walletAddress, {
-        vaultId: options.vaultId,
-        // The API caps page size at 1000; request maxRows per page so the common
-        // case is a single round trip instead of ten default-100 pages.
-        limit: options.limit ?? Math.min(maxRows, 1000),
-        order: 'desc',
-    })) {
-        rows.push(row);
-        if (rows.length >= maxRows)
-            break;
-    }
-    const flows = stitchActivityFlows(rows);
-    if (rows.length >= maxRows) {
-        // The window cut may have split an async lifecycle, keeping a terminal
-        // row whose request leg (the one carrying the amount) fell outside the
-        // window. Drop those flows rather than reporting zeroed amounts.
-        return flows.filter((f) => f.requestHash === null || f.requestedAt !== null);
-    }
-    return flows;
-}
-/**
- * Polls the activity log until the Aera async request identified by
- * `requestHash` reaches a terminal state, and returns the settled or refunded
- * flow. Use after submitting a `requestDeposit` / `requestRedeem` transaction.
- */
-export async function waitForRequestSettlement(api, walletAddress, requestHash, options = {}) {
-    const pollIntervalMs = options.pollIntervalMs ?? 5000;
-    const timeoutMs = options.timeoutMs ?? 600000;
-    const deadline = Date.now() + timeoutMs;
-    for (;;) {
-        const flows = await getActivityFlows(api, walletAddress, { vaultId: options.vaultId });
-        const flow = flows.find((f) => f.requestHash === requestHash);
-        if (flow && flow.status !== 'pending')
-            return flow;
-        if (Date.now() + pollIntervalMs > deadline) {
-            throw new SettlementTimeoutError(requestHash, timeoutMs);
-        }
-        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-    }
-}
-//# sourceMappingURL=activity.js.map

package/dist/api/activity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/api/activity.ts"],"names":[],"mappings":"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"}