@1delta/margin-fetcher 5.0.91 → 5.0.92

package/dist/index.d.ts

@@ -8933,6 +8933,10 @@ interface TermSheetDigest {
         settlement: SupplyExitTerms['settlement'];
         canOpen: boolean;
         headline: string;
+        /** The 1–3 sentence explainer — curated where a vault has hand-written
+         *  copy, templated from the structured fields otherwise. Always a string;
+         *  `''` only when the sheet itself carries none. */
+        description: string;
         tags: TermTag[];
         backedBy?: Omit<ExposureTerms, 'items'>;
     };
@@ -8946,6 +8950,8 @@ interface TermSheetDigest {
         liquidationTrigger: LiquidationTerms['trigger'];
         canOpen: boolean;
         headline: string;
+        /** See the supply-side note above. */
+        description: string;
         tags: TermTag[];
         acceptedCollateral?: Omit<ExposureTerms, 'items'>;
     };
@@ -14105,10 +14111,22 @@ declare function enrichmentIndexFromRows(rows: Record<string, any>[]): Enrichmen
 /**
  * Collapse a sheet to its digest form (`?terms=digest`).
  *
- * Drops `items[]` from the exposure sets and the long prose — an Aave market
- * with 30 accepted collaterals is several kB on its own, and it is the SAME
- * accepted set repeated on every row of that lender. Every dropped item is
- * still reachable: each carries a `marketUid` for the bulk endpoint.
+ * Drops `items[]` from the exposure sets — an Aave market with 30 accepted
+ * collaterals is several kB on its own, and it is the SAME accepted set
+ * repeated on every row of that lender. Every dropped item is still reachable:
+ * each carries a `marketUid` for the bulk endpoint.
+ *
+ * `description` is NOT dropped, though it was. The digest is what every
+ * listing actually requests — `full` is reserved for a detail view — so
+ * withholding the prose from it meant no surface ever rendered a sentence
+ * explaining what a row is, and the curated per-vault copy might as well not
+ * have been written.
+ *
+ * Measured on a live 500-row `/earn/latest` page (chain 1, 205 vault rows,
+ * mean 199 chars): +43 KB raw, +16.7 KB gzipped on a 378 KB page — +4.4 %,
+ * because the templates repeat across rows and compress accordingly. Unlike
+ * `items[]` it is bounded by construction: a sentence does not grow with the
+ * size of the market.
  */
 declare function toDigest(sheet: TermSheet): TermSheetDigest;
 /** Row shape of `~/risk-data/data/oracles/oracle-risk-flat.json`. */

package/dist/index.js

@@ -50765,7 +50765,7 @@ var BITWAY_LEGS2 = [
     "USDT",
     "0x5c4a6903732532eeb3ae0803e062d8ae25d52bd1",
     "0x2b8464ffb2b77de64cfefdeb00ad925576f157cb",
-    "the Absolute Return strategy (0.5% instant-exit fee)"
+    "Absolute Return strategy (0.5% instant-exit fee)"
   ],
   [
     "bwU",
@@ -50775,7 +50775,7 @@ var BITWAY_LEGS2 = [
     "U",
     "0x5c4a6903732532eeb3ae0803e062d8ae25d52bd1",
     "0x2b8464ffb2b77de64cfefdeb00ad925576f157cb",
-    "the Absolute Return strategy (0.5% instant-exit fee)"
+    "Absolute Return strategy (0.5% instant-exit fee)"
   ],
   [
     "bwBTW",
@@ -50785,7 +50785,7 @@ var BITWAY_LEGS2 = [
     "BTW",
     "0x5c4a6903732532eeb3ae0803e062d8ae25d52bd1",
     "0x2b8464ffb2b77de64cfefdeb00ad925576f157cb",
-    "the Absolute Return strategy (0.5% instant-exit fee). The rate is denominated in BTW, Bitway's own volatile token \u2014 not in dollars"
+    "Absolute Return strategy (0.5% instant-exit fee). The rate is denominated in BTW, Bitway's own volatile token \u2014 not in dollars"
   ],
   [
     "BTWUSDT",
@@ -50795,7 +50795,7 @@ var BITWAY_LEGS2 = [
     "USDT",
     "0xb82e32062c773c7748776c06fdb11b92edae3b63",
     "0xfc8e6b1ab1a4c37724f8bc797730afa8d01d04ef",
-    "the Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
+    "Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
   ],
   [
     "BTWUSD1",
@@ -50805,7 +50805,7 @@ var BITWAY_LEGS2 = [
     "USD1",
     "0xb82e32062c773c7748776c06fdb11b92edae3b63",
     "0xfc8e6b1ab1a4c37724f8bc797730afa8d01d04ef",
-    "the Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
+    "Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
   ],
   [
     "BTWU",
@@ -50815,7 +50815,7 @@ var BITWAY_LEGS2 = [
     "U",
     "0xb82e32062c773c7748776c06fdb11b92edae3b63",
     "0xfc8e6b1ab1a4c37724f8bc797730afa8d01d04ef",
-    "the Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
+    "Core Alpha strategy (no instant-exit fee live; ~1M per-user stake cap)"
   ]
 ];
 var BITWAY_ENTRIES = {
@@ -79020,11 +79020,27 @@ function toVaultTermInput(vault, provider, chainId) {
     exposures: Array.isArray(row.exposures) ? row.exposures : void 0
   };
 }
+function savingsCuration(provider, chainId, address) {
+  if (provider !== "savings") return {};
+  const lc2 = address.toLowerCase();
+  const e = getSavingsRegistry(chainId).find((x) => x.address === lc2);
+  if (!e) return {};
+  return {
+    // `''` is how an entry says "no curated copy"; it must not beat the
+    // template, so it is normalized to absent.
+    description: e.description || void 0,
+    solvency: e.solvency,
+    accrual: e.accrual,
+    yieldWarmupSeconds: e.yieldWarmupSeconds,
+    needsDepositApproval: e.needsDepositApproval
+  };
+}
 function vaultTermInputFromEarnMarket(m) {
   if (m.venueKind !== "vault") return void 0;
   const provider = m.venue.startsWith(VAULT_VENUE_PREFIX) ? m.venue.slice(VAULT_VENUE_PREFIX.length) : void 0;
   if (!provider) return void 0;
   const meta = m.providerMeta ?? {};
+  const curated = savingsCuration(provider, m.chainId, m.ref);
   return {
     provider,
     chainId: m.chainId,
@@ -79033,7 +79049,7 @@ function vaultTermInputFromEarnMarket(m) {
     name: m.name,
     brand: m.brand,
     curatorName: m.brand,
-    description: str7(meta.description),
+    description: str7(meta.description) ?? curated.description,
     asset: {
       chainId: m.chainId,
       address: m.asset.address,
@@ -79063,9 +79079,9 @@ function vaultTermInputFromEarnMarket(m) {
     swapFeeRate: num14(meta.feeRate),
     redemptionDiscountBps: num14(meta.redemptionDiscountBps),
     instantRedeemEnabled: bool2(meta.instantRedeemEnabled),
-    yieldWarmupSeconds: num14(meta.yieldWarmupSeconds),
-    accrual: str7(meta.accrual),
-    needsDepositApproval: bool2(meta.needsDepositApproval),
+    yieldWarmupSeconds: num14(meta.yieldWarmupSeconds) ?? curated.yieldWarmupSeconds,
+    accrual: str7(meta.accrual) ?? curated.accrual,
+    needsDepositApproval: bool2(meta.needsDepositApproval) ?? curated.needsDepositApproval,
     // `canDeposit` already folds in the cap, the pause and the gate, so it is
     // the authoritative answer — but the REASON is what a disabled CTA renders,
     // and that only survives in the raw fields.
@@ -79083,7 +79099,7 @@ function vaultTermInputFromEarnMarket(m) {
     curator: str7(meta.curator),
     guardian: str7(meta.guardian),
     feeRecipient: str7(meta.feeRecipient),
-    solvency: m.risk?.counterparty,
+    solvency: m.risk?.counterparty ?? curated.solvency,
     navOracle: str7(meta.navOracle),
     yieldProfile: m.risk?.yieldProfile,
     exposures: m.refs?.exposures
@@ -79110,6 +79126,7 @@ function vaultTermInputFromSourceRow(row, chainId) {
   const info = row.vaultInfo ?? {};
   const assetInfo = row.underlyingInfo?.asset;
   const assetDecimals = num14(row.assetDecimals) ?? num14(assetInfo?.decimals) ?? num14(row.decimals);
+  const curated = savingsCuration(provider, chainId, address);
   return {
     provider,
     chainId,
@@ -79118,7 +79135,7 @@ function vaultTermInputFromSourceRow(row, chainId) {
     name: str7(info.name) ?? str7(row.displayName) ?? str7(row.name),
     brand: str7(row.curatorName) ?? str7(meta.brand),
     curatorName: str7(row.curatorName),
-    description: str7(meta.description),
+    description: str7(meta.description) ?? curated.description,
     asset: {
       chainId,
       address: str7(row.underlying)?.toLowerCase() ?? "",
@@ -79146,9 +79163,9 @@ function vaultTermInputFromSourceRow(row, chainId) {
     swapFeeRate: num14(meta.feeRate),
     redemptionDiscountBps: num14(meta.redemptionDiscountBps),
     instantRedeemEnabled: bool2(meta.instantRedeemEnabled),
-    yieldWarmupSeconds: num14(meta.yieldWarmupSeconds),
-    accrual: str7(meta.accrual),
-    needsDepositApproval: bool2(meta.needsDepositApproval),
+    yieldWarmupSeconds: num14(meta.yieldWarmupSeconds) ?? curated.yieldWarmupSeconds,
+    accrual: str7(meta.accrual) ?? curated.accrual,
+    needsDepositApproval: bool2(meta.needsDepositApproval) ?? curated.needsDepositApproval,
     isMintable: bool2(meta.isMintable),
     depositCapacity: str7(meta.depositCapacity) ?? str7(meta.maxDeposit),
     supplyCap: str7(meta.supplyCap),
@@ -79164,7 +79181,7 @@ function vaultTermInputFromSourceRow(row, chainId) {
     curator: str7(meta.curator),
     guardian: str7(meta.guardian),
     feeRecipient: str7(meta.feeRecipient),
-    solvency: str7(meta.solvency),
+    solvency: str7(meta.solvency) ?? curated.solvency,
     navOracle: str7(meta.navOracle),
     yieldProfile: str7(info.yieldProfile),
     exposures: Array.isArray(row.exposures) ? row.exposures : Array.isArray(meta.exposures) ? meta.exposures : void 0
@@ -81955,6 +81972,7 @@ function toDigest(sheet) {
       settlement: sheet.supply.exit.settlement,
       canOpen: sheet.supply.availability.canOpen,
       headline: sheet.supply.info.headline,
+      description: sheet.supply.info.description,
       tags: sheet.supply.info.tags,
       backedBy: strip(sheet.supply.backedBy)
     } : void 0,
@@ -81968,6 +81986,7 @@ function toDigest(sheet) {
       liquidationTrigger: sheet.borrow.liquidation.trigger,
       canOpen: sheet.borrow.availability.canOpen,
       headline: sheet.borrow.info.headline,
+      description: sheet.borrow.info.description,
       tags: sheet.borrow.info.tags,
       acceptedCollateral: strip(sheet.borrow.acceptedCollateral)
     } : void 0,