@1delta/margin-fetcher 0.0.400 → 0.0.403

package/dist/index.d.ts

@@ -4541,7 +4541,7 @@ declare const resolveStCeloDepositGroup: (user: Address, requestedGroup?: string
  * kept separate so the two providers can evolve independently without
  * one provider's withdrawal taxonomy creep affecting the other.
  */
-type SavingsWithdrawalMode = 'instant' | 'fixed-cooldown' | 'queued' | 'request-based' | 'fee-or-queued';
+type SavingsWithdrawalMode = 'instant' | 'instant-capped' | 'fixed-cooldown' | 'queued' | 'request-based' | 'fee-or-queued';
 /**
  * Parsed savings-vault entry.
  *
@@ -4603,9 +4603,13 @@ interface SavingsVault extends VaultClassificationFields {
     /** Sum of `supplyRate + rewardsRate` — what a depositor actually
      *  earns. */
     depositRate: number;
-    /** Always true for this provider — every entry is ERC-4626. Kept
-     *  for API parity with `LstShareToken.isErc4626`. */
-    isErc4626: true;
+    /** Whether the share token implements ERC-4626. True for every entry
+     *  except Native's wNLP, which is a bespoke wrapper (`asset()`,
+     *  `totalAssets()` and `convertToAssets()` all revert) — the
+     *  `convertTo*` / `exchangeRate` fields below are still populated for
+     *  it, derived from its own rate getter. Parity with
+     *  `LstShareToken.isErc4626`. */
+    isErc4626: boolean;
     /** Whether the share token itself rebases. False for nearly every
      *  savings vault (they're the non-rebasing wrapper); rebasing
      *  surfaces sit on the underlying (e.g. USDe inside sUSDe). */
@@ -4619,12 +4623,51 @@ interface SavingsVault extends VaultClassificationFields {
     mintContract?: string;
     /** Withdrawal mechanism. */
     withdrawalMode: SavingsWithdrawalMode;
-    /** Fixed cooldown in seconds for `fixed-cooldown` mode. Some
-     *  protocols (Ethena, Avant) expose this on-chain via
-     *  `cooldownDuration()`. Static value here pinned in the registry —
-     *  re-read on-chain if you need the precise governance-current
-     *  value. */
+    /** Waiting period in seconds before a requested redemption can be
+     *  claimed. For `fixed-cooldown` entries (Ethena, Avant) this is the
+     *  registry-pinned value. For `fee-or-queued` entries it is the
+     *  **live** on-chain queue window, which varies per asset (Native
+     *  runs 8 h on some pools and 3 days on most). */
     withdrawalCooldownSeconds?: number;
+    /**
+     * Exit fee in basis points (`10` = 0.10 %) — same units and name as
+     * `GearboxV3Pool.withdrawFeeBps`, so consumers read one field across
+     * providers.
+     *
+     * **How it is charged** (Native): it is *not* a deposit fee, a
+     * management fee, or a skim on yield — `exchangeRate` and `supplyRate`
+     * are already net of everything Native takes on the way in. It is a
+     * one-off haircut on the **instant** exit only, taken out of the
+     * underlying paid to the receiver:
+     *
+     *     received = shares × exchangeRate × (1 − withdrawFeeBps/10_000)
+     *
+     * so redeeming 9,867.98 wNLP-USDC worth 10,000 USDC returns 9,900 USDC
+     * at 100 bps. The shares burn in full — the fee is deducted from the
+     * payout, never charged as a separate transfer, so a caller does not
+     * need to fund it or approve anything extra.
+     *
+     * The **queued** leg (`withdrawQueue`, after
+     * `withdrawalCooldownSeconds`) pays out at par and does not touch this
+     * field. Its cost is implicit instead: the payout is snapshotted when
+     * the request is made, so yield accruing during the wait goes to the
+     * protocol rather than the requester.
+     *
+     * `0` means the instant leg is free. Absent when the vault has no
+     * instant leg at all.
+     */
+    withdrawFeeBps?: number;
+    /** Whether the instant leg is enabled at all — some assets are
+     *  queue-only. When `false`, `liquidity` is `0` regardless of the
+     *  protocol's inventory and `withdrawFeeBps` is unreachable. */
+    instantRedeemEnabled?: boolean;
+    /** Contract the instant leg draws from — Native's per-chain
+     *  `CreditVault`. Its underlying balance is what `liquidity`
+     *  measures. */
+    inventoryContract?: string;
+    /** Contract a delayed redemption is requested from and claimed
+     *  against, when it is not the share token itself. */
+    withdrawQueue?: string;
     /** Hydrated asset metadata from the provided token list, if any. */
     asset?: GenericCurrency;
     /** USD price of one underlying unit, if prices were supplied. */
@@ -4633,18 +4676,60 @@ interface SavingsVault extends VaultClassificationFields {
     totalAssetsFormatted: number;
     /** Human-formatted total assets in USD. */
     totalAssetsUsd: number;
-    /** Instantly-withdrawable underlying right now, raw integer string,
-     *  derived from `withdrawalMode`: `instant` vaults are fully liquid
-     *  (`= totalAssets`); `fixed-cooldown` / `queued` / `request-based` /
-     *  `fee-or-queued` vaults require a waiting period, so their
-     *  instantaneous withdrawable is `0`. (A cooldown vault's underlying
-     *  may still be redeemable after the wait — this field is the *right
-     *  now* figure, matching the cross-provider `liquidity` semantic.) */
+    /** Withdrawable underlying **right now**, raw integer string, per
+     *  `withdrawalMode`:
+     *   - `instant` — fully liquid (`= totalAssets`).
+     *   - `instant-capped` — settles in the same transaction, but only up
+     *     to a live inventory that is smaller than the vault: Spark
+     *     Savings V1 is capped by the PSM3 pocket's underlying balance
+     *     (6–29 % of TVL on the L2 deployments) and Spark Vaults V2 by the
+     *     vault's own idle balance (the rest is lent out through the Spark
+     *     Liquidity Layer). No fee and no cooldown on this leg — the
+     *     difference from `instant` is purely the size cap, and the
+     *     difference from `fee-or-queued` is that exceeding it costs
+     *     nothing extra, it simply cannot be done this block.
+     *   - `fee-or-queued` — the protocol's live instant-exit inventory,
+     *     clamped to `totalAssets`; `0` when the instant leg is disabled.
+     *     This is a **gross** figure: pulling it out instantly nets
+     *     `withdrawFeeBps` less (see that field). The queued leg is not
+     *     inventory-capped and pays at par, so `liquidity` is not a cap on
+     *     what the vault can ultimately return.
+     *   - `fixed-cooldown` / `queued` / `request-based` — `0`; these
+     *     require a waiting period.
+     *  A cooldown vault's underlying may still be redeemable after the
+     *  wait — this field is the *right now* figure, matching the
+     *  cross-provider `liquidity` semantic. */
     liquidity: string;
     /** Human-formatted withdrawable liquidity. */
     liquidityFormatted: number;
     /** Withdrawable liquidity in USD. */
     liquidityUsd: number;
+    /**
+     * `liquidity / totalAssets`, clamped to `0…1` — the share of the vault a
+     * holder could exit **this block**. `1 − instantLiquidityRatio` is the
+     * share that must wait, so this is the vault's **lockup indicator**.
+     *
+     * Deliberately *not* called `utilization`. For a lending vault
+     * utilization is `borrowed / supplied`, read from a debt accumulator;
+     * none of these protocols expose one (Native's CreditVault and NTLP have
+     * no debt getter at all, and the CreditVault commingles market-maker
+     * collateral with pool inventory, so its balance can exceed the pool).
+     * What this measures is exit **coverage**, which is the quantity that
+     * actually predicts lockup — and unlike utilization it stays meaningful
+     * for cooldown vaults that have no borrow side whatsoever.
+     *
+     * Reads per mode:
+     *  - `instant` → always `1` (fully liquid by construction).
+     *  - `fee-or-queued` → the live CreditVault coverage; the observed spread
+     *    across Native pools is the full `0…1` range, so it carries real
+     *    information (BNB `wNLP-T4B` sits near `0`, Ethereum `wNLP-USDC` at
+     *    `1`). Below `1` the remainder is not lost, just queued.
+     *  - `fixed-cooldown` / `queued` / `request-based` → always `0`; nothing
+     *    is redeemable without waiting.
+     *
+     * An empty vault reports `1` — there is nothing to be locked up.
+     */
+    instantLiquidityRatio: number;
 }
 /**
  * Full parsed payload: per-share-token-address map.