@1delta/margin-fetcher 5.0.75 → 5.0.77

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -8668,6 +8668,28 @@ interface SavingsVault extends VaultClassificationFields {
8668
8668
  /** Sum of `supplyRate + rewardsRate` — what a depositor actually
8669
8669
  * earns. */
8670
8670
  depositRate: number;
8671
+ /**
8672
+ * Incentive APR the vault's POSITION earns that a depositor does NOT, in
8673
+ * percent. Absent ⇒ not established; `0` ⇒ established and currently none.
8674
+ *
8675
+ * Deliberately outside `rewardsRate`/`depositRate`, which are what a
8676
+ * depositor actually earns — this is the opposite claim, and summing it in
8677
+ * would overstate every affected row.
8678
+ *
8679
+ * Venus's Liquidity Hub is the case it exists for. Its Core YieldGroup holds
8680
+ * vTokens, so XVS supply emissions accrue to that contract inside the
8681
+ * Comptroller — but nothing on the Hub, the YieldGroup or `AdapterCoreV1`
8682
+ * claims them, and nothing routes them into `totalAssets()`. After the
8683
+ * permissionless `claimVenus` the XVS sits on the YieldGroup and can only
8684
+ * leave through an ACM-gated `sweep`. The value is real, measurable, and
8685
+ * not the depositor's.
8686
+ *
8687
+ * Publishing it is a MONITOR, not a headline. Every Core market these Hubs
8688
+ * use read `venusSupplySpeeds == 0` at integration, so today this is `0` —
8689
+ * and the day Venus turns emissions back on, this is the only field on the
8690
+ * row that moves.
8691
+ */
8692
+ strandedRewardsRate?: number;
8671
8693
  /** Whether the share token implements ERC-4626. True for every entry
8672
8694
  * except Native's wNLP, which is a bespoke wrapper (`asset()`,
8673
8695
  * `totalAssets()` and `convertToAssets()` all revert) — the
@@ -8730,6 +8752,20 @@ interface SavingsVault extends VaultClassificationFields {
8730
8752
  * instant leg at all.
8731
8753
  */
8732
8754
  withdrawFeeBps?: number;
8755
+ /**
8756
+ * ENTRY fee in basis points — the mirror of `withdrawFeeBps`, same units and
8757
+ * same discipline: absent means NOT READ, `0` means read and currently free.
8758
+ *
8759
+ * Charged out of the deposit before shares are minted, so a depositor funds
8760
+ * `assets` and is credited on `assets × (1 − bps/10_000)`. `convertToShares`
8761
+ * on this row is already net of it wherever a reader publishes both, so a
8762
+ * consumer sizing an entry does not need to apply it twice.
8763
+ *
8764
+ * Populated only by readers whose protocol exposes the dial. Saturn's
8765
+ * `sUSDat` is the case: 0 at integration against a `MAX_DEPOSIT_FEE_BPS` of
8766
+ * 500, on a `DEFAULT_ADMIN_ROLE` setter, while its docs claim 10 bps.
8767
+ */
8768
+ depositFeeBps?: number;
8733
8769
  /**
8734
8770
  * Seconds a FRESH deposit earns nothing before the rate applies.
8735
8771
  *
@@ -11435,6 +11471,12 @@ interface ClassifyVaultInput {
11435
11471
  address: string;
11436
11472
  /** Underlying token symbol, when known (drives `denomination`). */
11437
11473
  underlyingSymbol?: string;
11474
+ /**
11475
+ * Underlying token ADDRESS, when known. Consulted against
11476
+ * {@link STABLECOIN_UNDERLYING_OVERRIDES} before the symbol heuristic, for
11477
+ * the underlyings whose ticker cannot identify them.
11478
+ */
11479
+ underlyingAddress?: string;
11438
11480
  }
11439
11481
  /**
11440
11482
  * Classify a vault on both axes. Pure — no I/O. `yieldProfile` is