@augustdigital/sdk 9.11.0 → 9.13.0

package/lib/types/vaults.d.ts

@@ -383,6 +383,14 @@ export interface IVault {
     enabled_historical_price_horizons?: number[];
     defaultApyHorizon?: 7 | 30 | null;
     latest_reported_tvl?: number | null;
+    /**
+     * Wrapper vaults only: the vault this one wraps, which holds the assets. A
+     * wrapper's own on-chain `totalAssets` reads 0, so its TVL is the underlying
+     * vault's. Null on a non-wrapper vault. Address casing is preserved verbatim.
+     */
+    underlyingVaultAddress?: VaultAddress | null;
+    /** Chain id of {@link IVault.underlyingVaultAddress}; null on a non-wrapper vault. */
+    underlyingChainId?: number | null;
     cachedAt?: string | null;
     /**
      * Provenance timestamps for the vault's server-side data — when its APY was last
@@ -395,6 +403,12 @@ export interface IVault {
     /** Controls how the vault's APY is displayed; null when the backend has not set an override. */
     apyOverride?: IApyOverride | null;
     programId?: string;
+    /**
+     * Solana only: the vault's withdrawal queue, when it has one. Absent for
+     * other chains and for Solana vaults that never had a queue. See
+     * {@link IVaultWithdrawalQueue}.
+     */
+    withdrawalQueue?: IVaultWithdrawalQueue;
     /** Instant redemption config, populated from backend instant_redeem_config */
     instant_redeem_config?: {
         subaccountAddress: IAddress;
@@ -411,7 +425,40 @@ export interface IVault {
 }
 export declare enum VaultRedemptionStatus {
     AWAITING_COOLDOWN = "awaiting_cooldown",
-    READY_TO_CLAIM = "ready_to_claim"
+    READY_TO_CLAIM = "ready_to_claim",
+    /**
+     * Solana withdrawal queue only: the request's fulfillment window has closed.
+     * It can no longer be claimed, only cancelled, which returns its shares.
+     */
+    EXPIRED = "expired"
+}
+/**
+ * A Solana vault's withdrawal queue, as `IVault.withdrawalQueue`.
+ *
+ * With a queue attached, holders cannot redeem directly: they request a
+ * withdrawal, wait out the cooldown, then claim. Read from the queue account on
+ * each vault fetch, so the counts are live.
+ */
+export interface IVaultWithdrawalQueue {
+    /** The queue account (PDA) address, base58. */
+    address: string;
+    /**
+     * Whether the vault's redeem gate points at this queue, i.e. whether new
+     * requests are accepted and direct redemption is closed. `false` for a
+     * released queue, which may still hold requests made before the release.
+     */
+    enabled: boolean;
+    /** Seconds between a new request and when it can be claimed. */
+    cooldownSeconds: number;
+    /**
+     * Seconds after the cooldown that a new request stays claimable, or `0` for
+     * no limit. A request past its window can only be cancelled.
+     */
+    fulfillmentWindowSeconds: number;
+    /** Number of requests not yet claimed or cancelled, across all holders. */
+    pendingCount: number;
+    /** Shares escrowed across all pending requests, in share-token units. */
+    pendingShares: INormalizedNumber;
 }
 export type IVaultAvailableRedemption = {
     id: string;
@@ -425,6 +472,13 @@ export type IVaultAvailableRedemption = {
     date: Date;
     vault: IAddress;
     status?: VaultRedemptionStatus;
+    /**
+     * Solana withdrawal queue only: what claiming would pay now, in deposit-token
+     * units and net of the vault's withdrawal fee. The payout is priced when the
+     * request is claimed, so this moves with the share price. Absent when the
+     * vault has no share price to quote.
+     */
+    estimatedAssets?: INormalizedNumber;
 };
 export type IVaultRedemptionHistoryItem = {
     receiver: IAddress;

package/lib/types/vaults.js

@@ -5,6 +5,11 @@ var VaultRedemptionStatus;
 (function (VaultRedemptionStatus) {
     VaultRedemptionStatus["AWAITING_COOLDOWN"] = "awaiting_cooldown";
     VaultRedemptionStatus["READY_TO_CLAIM"] = "ready_to_claim";
+    /**
+     * Solana withdrawal queue only: the request's fulfillment window has closed.
+     * It can no longer be claimed, only cancelled, which returns its shares.
+     */
+    VaultRedemptionStatus["EXPIRED"] = "expired";
 })(VaultRedemptionStatus || (exports.VaultRedemptionStatus = VaultRedemptionStatus = {}));
 /**
  * Numeric vault-type tag used by the on-chain `SwapRouter` to branch between

package/lib/types/webserver.d.ts

@@ -647,6 +647,14 @@ export interface ITokenizedVault {
     max_drawdown: number | null;
     daily_pnl_per_share: Record<string, number>;
     latest_reported_tvl: number | null;
+    /**
+     * Set when this vault is a wrapper: the address of the inner vault it
+     * deposits into. null/absent = not a wrapper. A wrapper's TVL is already
+     * counted in its underlying vault, so platform totals skip it.
+     */
+    underlying_vault_address?: string | null;
+    /** Chain of the underlying vault; null/absent when not a wrapper. */
+    underlying_chain?: number | null;
     cached_at?: string | null;
     /**
      * Per-vault provenance timestamps (APY recompute, newest share-price snapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "9.11.0",
+  "version": "9.13.0",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [