@1delta/margin-fetcher 5.0.83 → 5.0.85

package/dist/index.js

@@ -48765,8 +48765,129 @@ var sthusdFetcher = {
     };
   }
 };
+var CHAIN_ID13 = Chain.ETHEREUM_MAINNET;
+var HUMA_PST_FEED = "0x4be50be32db1510240d542f77c5b36ca0d0965e6";
+var HUMA_PST_KEY = "HUMA::PST";
+var HUMA_PST_GROUP_KEY = "PayFi Strategy Token::PST";
+var HUMA_PST_WINDOW_SECONDS = 30 * 86400;
+var MIN_WINDOW_SECONDS = 7 * 86400;
+var MAX_STALENESS_SECONDS = 14 * 86400;
+var PROBE_OFFSETS = [560, 620, 680, 720, 760, 820, 900, 1e3, 1200];
+var YEAR_SECONDS12 = 365 * 86400;
+var PHASE_SHIFT = 64n;
+var ROUND_MASK = (1n << PHASE_SHIFT) - 1n;
+var FEED_ABI = [
+  {
+    name: "latestRoundData",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" }
+    ]
+  },
+  {
+    name: "getRoundData",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "roundId", type: "uint80" }],
+    outputs: [
+      { name: "roundId", type: "uint80" },
+      { name: "answer", type: "int256" },
+      { name: "startedAt", type: "uint256" },
+      { name: "updatedAt", type: "uint256" },
+      { name: "answeredInRound", type: "uint80" }
+    ]
+  }
+];
+var parseRound = (raw) => {
+  if (!raw) return void 0;
+  const tuple = Array.isArray(raw) ? raw : [
+    raw.roundId,
+    raw.answer,
+    raw.startedAt,
+    raw.updatedAt
+  ];
+  const answer = tuple[1];
+  const updatedAt = tuple[3];
+  if (typeof answer !== "bigint" || typeof updatedAt !== "bigint")
+    return void 0;
+  if (answer <= 0n || updatedAt <= 0n) return void 0;
+  return { answer, updatedAt: Number(updatedAt) };
+};
+var windowAprFromRounds = (latest, candidates, nowSeconds, windowSeconds = HUMA_PST_WINDOW_SECONDS) => {
+  if (nowSeconds - latest.updatedAt > MAX_STALENESS_SECONDS) {
+    throw new Error(
+      `Huma PST: feed stale \u2014 last update ${nowSeconds - latest.updatedAt}s ago`
+    );
+  }
+  const cutoff = latest.updatedAt - windowSeconds;
+  const older = candidates.filter((c) => c.updatedAt < latest.updatedAt).sort((a, b) => b.updatedAt - a.updatedAt);
+  if (older.length === 0) throw new Error("Huma PST: no historical round");
+  const start = older.find((c) => c.updatedAt <= cutoff) ?? older[older.length - 1];
+  const dt = latest.updatedAt - start.updatedAt;
+  if (dt < MIN_WINDOW_SECONDS) {
+    throw new Error(`Huma PST: window too short (${dt}s)`);
+  }
+  const growth = Number(latest.answer * 10n ** 18n / start.answer) / 1e18 - 1;
+  const apr = growth * YEAR_SECONDS12 * 100 / dt;
+  if (!Number.isFinite(apr) || Math.abs(apr) > 100) {
+    throw new Error(`Huma PST: implausible rate ${apr}`);
+  }
+  return apr;
+};
+var fetchPstAprOnChain = async () => {
+  const [latestRaw] = await multicallRetryUniversal({
+    chain: CHAIN_ID13,
+    abi: FEED_ABI,
+    calls: [{ address: HUMA_PST_FEED, name: "latestRoundData", params: [] }],
+    allowFailure: false
+  });
+  const latestTuple = Array.isArray(latestRaw) ? latestRaw : [latestRaw?.roundId];
+  const latestRoundId = latestTuple[0];
+  const latest = parseRound(latestRaw);
+  if (typeof latestRoundId !== "bigint" || !latest) {
+    throw new Error("Huma PST: latestRoundData unreadable");
+  }
+  const phase = latestRoundId >> PHASE_SHIFT;
+  const aggRound = latestRoundId & ROUND_MASK;
+  const probeRounds = [
+    ...new Set(
+      PROBE_OFFSETS.map((off) => {
+        const r = aggRound - BigInt(off);
+        return r < 1n ? 1n : r;
+      })
+    )
+  ];
+  const results = await multicallRetryUniversal({
+    chain: CHAIN_ID13,
+    abi: FEED_ABI,
+    calls: probeRounds.map((r) => ({
+      address: HUMA_PST_FEED,
+      name: "getRoundData",
+      params: [phase << PHASE_SHIFT | r]
+    })),
+    allowFailure: true
+  });
+  const candidates = results.map(parseRound).filter((r) => r !== void 0);
+  return windowAprFromRounds(latest, candidates, Math.floor(Date.now() / 1e3));
+};
+var humaPstFetcher = {
+  label: "HUMA_PST",
+  fetch: async () => {
+    const apr = await fetchPstAprOnChain();
+    return {
+      [HUMA_PST_KEY]: apr,
+      [HUMA_PST_GROUP_KEY]: apr
+    };
+  }
+};
 var RAY9 = 10n ** 27n;
-var YEAR_SECONDS12 = 31536e3;
+var YEAR_SECONDS13 = 31536e3;
 var DSR_ABI = [
   {
     name: "dsr",
@@ -48794,7 +48915,7 @@ var SUSDD_GROUP_KEY = "Savings Usdd::sUSDD";
 var aprFromDsr = (dsr) => {
   if (dsr <= RAY9) return 0;
   const perSecond = Number(dsr - RAY9) / 1e27;
-  return perSecond * YEAR_SECONDS12 * 100;
+  return perSecond * YEAR_SECONDS13 * 100;
 };
 var fetchChainDsr = async (chainId, pot) => {
   const [dsr] = await multicallRetryUniversal({
@@ -52675,6 +52796,72 @@ var SINGLE_CHAIN_ENTRIES = {
       withdrawalCooldownSeconds: 432e3,
       yieldFetcher: sthusdFetcher,
       yieldKey: STHUSD_KEY
+    },
+    {
+      // Huma **PST** (PayFi Strategy Token), bridged. Huma 2.0 is a
+      // SOLANA product: a permissionless USDC pool (no KYC) funding
+      // short-dated cross-border payment receivables — originated almost
+      // entirely by Arf, a Huma affiliate — whose yield is paid as a rising
+      // PST price. 306.6M PST exist ($347M at 1.1325); **148.2M of them are
+      // on Ethereum** through Chainlink CCIP, and 125.8M of THOSE sit as
+      // collateral in Morpho Blue (84.4M, three listed markets at 86 % LLTV)
+      // and Fluid (41.4M, vaults 165/166/169) — the Ethereum book is a
+      // loop book, ~22M floats. Assessed + built 2026-09-16; see HUMA.md.
+      //
+      // This address is NOT a vault. It is Chainlink's `BurnMintERC20`,
+      // whose only minter and burner is the CCIP `BurnMintTokenPool 1.6.1`
+      // (`0xbe776c85…`, one lane, Solana): no `asset()`, no
+      // `convertToAssets()`, no `owner()`, not verified on Sourcify. So there
+      // is **no primary mint and no redemption on this chain at all** — the
+      // ways in and out are the market (Fluid DEX PST-USDC: a $1M round trip
+      // quoted ~4 bps total on KyberSwap at integration) or the bridge back
+      // to Solana. Hence `secondaryMarketOnly`: the Re shape, but with an
+      // even plainer reason — Re's mint is KYC-gated, this one does not
+      // exist. `isMintable: false` states that fact, not a permission.
+      //
+      // Priced by Chainlink's **"PST-USDC Exchange Rate (Calculated)"**
+      // proxy `0x4be50be3…` — the same feed both Morpho PST oracles wrap as
+      // `BASE_FEED_1`, so the earn row and the lending rows cannot disagree
+      // about what a PST is worth. It answers in **6 decimals** (hence
+      // `priceOracleDecimals`), hourly, and — unlike Re's feeds — keeps its
+      // FULL round history, which is where `humaPstFetcher` measures the
+      // realized rate (7.7 % APR on every window since 2026-05-25). TRAP: the
+      // feed's AGGREGATOR reverts `No access` for a contract caller, so any
+      // multicall must target the PROXY, which is what this pins.
+      //
+      // `nav-attested`, asserted: the price is produced by Huma's own
+      // off-chain Price Oracle and relayed by Chainlink — an operator-
+      // published NAV over an off-chain receivables book with a "modest"
+      // first-loss cover and no on-chain solvency invariant (the Theo /
+      // Maple / Native trust class). Every consequence the label earns —
+      // `nav-accrual` as the rate kind, `nav-drawdown` in the risks — is
+      // true here.
+      //
+      // `withdrawalMode` / cooldown describe the exit a holder who BRIDGES
+      // BACK gets on Solana: a redemption request the operator's autotask
+      // settles "typically within 1 business day", SLA 7 days, under a global
+      // daily cap that rejects further requests once hit. The pin is the SLA
+      // worst case (the Re call); a bridge hop each way is on top. For a
+      // holder on this chain the exit is the `market` route.
+      reader: "nav-oracle",
+      solvency: "nav-attested",
+      address: "0x22ae3d9a738471f405169af055d31c687087d4c7",
+      underlying: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+      // USDC
+      priceOracle: HUMA_PST_FEED,
+      priceOracleDecimals: 6,
+      symbol: "PST",
+      brand: "Huma",
+      description: "Huma's PayFi Strategy Token, bridged from Solana over Chainlink CCIP: a share of Huma 2.0's USDC pool, funding short-dated cross-border payment receivables nearly all originated by Arf, a Huma affiliate; the fee is paid as a rising PST price set by Huma's oracle and relayed by Chainlink. There is no mint and no redemption on Ethereum: you enter and exit by TRADING PST (venue: Fluid DEX PST-USDC) against that NAV, or by bridging back to Solana, where redemption is an operator-settled request under a daily cap. Backing is unsecured receivables credit with a small first-loss cover.",
+      decimals: 6,
+      underlyingDecimals: 6,
+      isRebasing: false,
+      isMintable: false,
+      secondaryMarketOnly: true,
+      withdrawalMode: "request-based",
+      withdrawalCooldownSeconds: 7 * 86400,
+      yieldFetcher: humaPstFetcher,
+      yieldKey: HUMA_PST_KEY
     }
   ],
   "100": [
@@ -52964,6 +53151,53 @@ var SINGLE_CHAIN_ENTRIES = {
       yieldKey: STHUSD_KEY
     }
   ],
+  // ---------------------------------------------------------------------
+  // Arc (5042) — Circle's USDC-gas L1, mainnet 2026-09-16. One row: Huma's
+  // PST, bridged in over Chainlink CCIP the same day.
+  // ---------------------------------------------------------------------
+  "5042": [
+    {
+      // Huma **PST**, bridged to Arc. Same asset and same trust story as the
+      // chain-1 row (see it for the product); what differs is the SHAPE of
+      // the exit. On Ethereum PST has $16M of DEX depth, so the row is
+      // `secondaryMarketOnly`. Here it has NONE: KyberSwap answers
+      // `route not found` for PST on Arc while routing USDC→WETH fine, and
+      // at integration the whole bridged supply (441,548 PST, ≈ $500k) sat
+      // inside the one listed Morpho Blue PST/USDC market — the Theo-on-
+      // Stable shape, where a `via: 'swap'` route would advertise depth that
+      // does not exist. So `isMintable: false` (a CCIP `BurnMintERC20` has
+      // no mint function) and NOT `secondaryMarketOnly`: the only way in or
+      // out is the bridge back to Solana. Flip the flag when a venue appears.
+      //
+      // Priced by Chainlink's **"PSTUSDC / USDC Exchange Rate"** proxy
+      // `0x1abf15e8…` on Arc — the feed the Morpho market's oracle wraps as
+      // `BASE_FEED_1`, so the earn row and the lending row agree. 6 decimals
+      // TODAY; TRAP: its round history is NOT uniformly scaled — rounds 1
+      // to ~100 (2026-06-19 → 06-23) answered at 12 decimals
+      // (`1111266641610`) before the feed settled at 6 — so never derive a
+      // rate from this feed's history. The rate is `humaPstFetcher`, which
+      // measures the Ethereum feed; PST accrues identically on every chain
+      // (1.132518 here vs 1.132511 on Ethereum at the same hour).
+      reader: "nav-oracle",
+      solvency: "nav-attested",
+      address: "0xa6db07ebf438d91aa653746fc05523e435645525",
+      underlying: "0x3600000000000000000000000000000000000000",
+      // USDC (ERC-20)
+      priceOracle: "0x1abf15e82566d274bf8722ac3e42fc3c79304051",
+      priceOracleDecimals: 6,
+      symbol: "PST",
+      brand: "Huma",
+      description: "Huma's PayFi Strategy Token, bridged to Arc over Chainlink CCIP: a share of Huma 2.0's USDC pool on Solana, funding short-dated cross-border payment receivables nearly all originated by Arf, a Huma affiliate; the fee is paid as a rising PST price set by Huma's oracle and relayed by Chainlink. There is no mint, no redemption and no trading venue on Arc: the only way in or out is bridging back to Solana, where redemption is an operator-settled request under a daily cap. Backing is unsecured receivables credit with a small first-loss cover.",
+      decimals: 6,
+      underlyingDecimals: 6,
+      isRebasing: false,
+      isMintable: false,
+      withdrawalMode: "request-based",
+      withdrawalCooldownSeconds: 7 * 86400,
+      yieldFetcher: humaPstFetcher,
+      yieldKey: HUMA_PST_KEY
+    }
+  ],
   "4663": [
     {
       // Spark Vaults V2 spUSDG on Robinhood Chain — the first V2 vault
@@ -73206,7 +73440,7 @@ var readVaultSharePrices = async (chainId, addresses, multicallRetry) => {
 };
 
 // src/vaults/yield/annualize.ts
-var YEAR_SECONDS13 = 365 * 24 * 60 * 60;
+var YEAR_SECONDS14 = 365 * 24 * 60 * 60;
 var SCALE = 10n ** 18n;
 var appendSnapshot = (points, snap, options) => {
   const maxPoints = options?.maxPoints ?? 90;
@@ -73235,7 +73469,7 @@ var computeVaultApr = (points, options) => {
   if (pThen === 0n) return void 0;
   const ratioScaled = BigInt(now.p) * SCALE / pThen;
   const ratio = Number(ratioScaled) / 1e18;
-  const apr = (ratio - 1) * (YEAR_SECONDS13 / windowSeconds);
+  const apr = (ratio - 1) * (YEAR_SECONDS14 / windowSeconds);
   return {
     apr,
     sharePriceNow: now.p,