@1delta/margin-fetcher 0.0.402 → 0.0.404

package/dist/index.d.ts

@@ -329,6 +329,76 @@ interface FixedTermProvider {
     /** The single counterparty/venue contract, when there is one (Lista broker, Term servicer). */
     address?: string;
 }
+/**
+ * Origination window for a fixed-term market whose terms are only obtainable
+ * during a bounded round rather than continuously (`provider.kind: 'auction'`
+ * — Term Finance).
+ *
+ * This is the difference between "the rate card is empty right now" and "this
+ * market is dead": between rounds a Term repo still has a maturity, collateral
+ * params and a last-cleared rate, but nothing can be borrowed until the next
+ * round is listed. Without it every closed repo renders as an ordinary
+ * borrowable market whose action silently cannot be built.
+ *
+ * `status` is a snapshot at fetch time; the timestamps are raw so a consumer
+ * can re-derive it live (and drive a countdown) against a cached response.
+ */
+interface FixedTermAuction {
+    /**
+     * Round lifecycle at fetch time:
+     *  - `upcoming`  — listed but not yet accepting submissions (`now < startTime`)
+     *  - `open`      — accepting sealed bids/offers (`startTime ≤ now < revealTime`)
+     *  - `revealing` — submissions closed, prices revealing / clearing pending
+     *                  (`revealTime ≤ now < endTime`)
+     *  - `closed`    — no round is currently listed for this market. Borrowing is
+     *                  unavailable until the next one; lending may still be
+     *                  possible on the secondary repo-token book.
+     */
+    status: 'upcoming' | 'open' | 'revealing' | 'closed';
+    /**
+     * Can a NEW borrow be opened right now? True only inside an open round —
+     * Term borrow origination is a sealed bid, so there is no other entry point.
+     *
+     * Consume this rather than re-deriving from `status`: it is the single flag
+     * a borrow CTA should gate on, and it stays correct if more statuses appear.
+     * It is NOT the same as `canLend` — see below.
+     */
+    canBorrow: boolean;
+    /**
+     * Can a NEW lend position be opened right now? Deliberately decoupled from
+     * `canBorrow`: the primary auction is only one of two lend surfaces, and
+     * buying repo tokens on the secondary book works between rounds. So a closed
+     * round leaves the market lend-only rather than fully inert, and a UI that
+     * greys out the whole market would be wrong.
+     */
+    canLend: boolean;
+    /**
+     * Seconds until submissions close (`revealTime − now`), or undefined when no
+     * round is open. A snapshot — for a live countdown, derive from `revealTime`.
+     */
+    secondsUntilClose?: number;
+    /**
+     * Ready-to-display consequences of this market's origination model, most
+     * important first. Mirrors `params.market.teller.implications`: auction
+     * mechanics are unusual enough that a UI showing only a rate misleads.
+     */
+    implications?: string[];
+    /** Round id. Absent when `status: 'closed'`. */
+    id?: string;
+    /** Submissions open (unix seconds). Absent when `status: 'closed'`. */
+    startTime?: number;
+    /** Submissions CLOSE / reveal begins (unix seconds). Absent when closed. */
+    revealTime?: number;
+    /** Round clears (unix seconds). Absent when closed. */
+    endTime?: number;
+    /**
+     * Minimum submission size in loan-token base units (raw). Term rounds carry a
+     * real floor (e.g. 1000 USDC) — an amount below it cannot be submitted at all,
+     * so it belongs next to the terms rather than surfacing as a failed action.
+     */
+    minBorrowAmount?: string;
+    minLendAmount?: string;
+}
 /**
  * Canonical fixed-term market descriptor, emitted on `params.market.fixedTerm`
  * for EVERY fixed-rate / fixed-maturity market (Lista brokered + Morpho
@@ -367,6 +437,12 @@ interface FixedTermInfo {
     earlyRepay: FixedTermEarlyRepay;
     /** Who offers the term (Lista broker vs Midnight order book). */
     provider?: FixedTermProvider;
+    /**
+     * Origination window, for `provider.kind: 'auction'` markets only (Term
+     * Finance). Absent for lenders whose terms are continuously available — a
+     * missing `auction` means "no window applies", NOT "closed".
+     */
+    auction?: FixedTermAuction;
 }
 /** A Lista loan, attached to its own entry in the positions array. */
 interface ListaTermLoan {
@@ -2234,14 +2310,48 @@ interface TermBookSource {
     getTopAndBook?(config: TermMarketConfig, maxLevels?: number): Promise<{
         top: TermBookTop;
         book: TermBook;
+        /** Live/upcoming auction round; null when none is listed. */
+        auction: TermAuctionWindow | null;
     } | null>;
 }
+/**
+ * The repo's CURRENT primary auction round, when one is listed.
+ *
+ * Term borrow origination is a periodic sealed-bid auction, not a continuous
+ * book: outside the submission window there is nothing to bid on, so a repo
+ * whose auction has cleared is lend-only (buy repo tokens on the secondary
+ * book) until the next round is listed. Timestamps are raw so consumers can
+ * derive a live countdown; `status` is a snapshot at fetch time.
+ */
+interface TermAuctionWindow {
+    /** Auction round id (the TermAuction entity id). */
+    id: string;
+    /** Submissions open (unix seconds). */
+    startTime: number;
+    /** Submissions CLOSE and the sealed prices start revealing (unix seconds). */
+    revealTime: number;
+    /** Auction clears (unix seconds). Equal to `revealTime` on current deployments. */
+    endTime: number;
+    /** Minimum bid (borrow) size, loan-token base units (raw string; '0' when unset). */
+    minBidAmount: string;
+    /** Minimum offer (lend) size, loan-token base units (raw string; '0' when unset). */
+    minOfferAmount: string;
+    /** Highest accepted bid rate, WAD (raw string; '0' when unset). */
+    maxBidPriceWad: string;
+    /** Highest accepted offer rate, WAD (raw string; '0' when unset). */
+    maxOfferPriceWad: string;
+}
 /** A Term repo paired with its current top-of-book (null when the fetch failed). */
 interface TermMarketRaw {
     config: TermMarketConfig;
     top: TermBookTop | null;
     /** Bounded book slice (top-N levels/side); null/absent when unavailable. */
     book?: TermBook | null;
+    /**
+     * The live/upcoming auction round, or null when no round is currently listed
+     * (the common case between auctions — the repo is then lend-only).
+     */
+    auction?: TermAuctionWindow | null;
 }
 
 /**
@@ -2287,15 +2397,24 @@ declare class TermSubgraphSource implements TermBookSource {
     getBookTop(config: TermMarketConfig): Promise<TermBookTop | null>;
     /**
      * ONE query → the aggregate top (best APR + FULL depth) PLUS a bounded book
-     * slice (top `maxLevels` open orders per side). `asks` = orders selling repo
-     * tokens (the secondary LEND book); `bids` = the rest (borrow side, usually
-     * empty — Term borrow is sealed-bid auction, not a continuous book). Term
-     * secondary orders carry no per-order rate, so every level shares the market's
-     * clearing APR; the levels expose per-order SIZE for filtering.
+     * slice (top `maxLevels` open orders per side) PLUS the repo's current
+     * auction round. `asks` = orders selling repo tokens (the secondary LEND
+     * book); `bids` = the rest (borrow side, usually empty — Term borrow is
+     * sealed-bid auction, not a continuous book). Term secondary orders carry no
+     * per-order rate, so every level shares the market's clearing APR; the levels
+     * expose per-order SIZE for filtering.
+     *
+     * Two auction reads, deliberately distinct:
+     *  - `cleared` — the latest COMPLETE round, whose clearing price IS the
+     *    market's fixed APR (and stays the reference rate between auctions).
+     *  - `pending` — rounds not yet complete/cancelled. Only one of these is a
+     *    real, actionable round; the rest are abandoned listings the subgraph
+     *    never marked complete, filtered out below.
      */
     getTopAndBook(config: TermMarketConfig, maxLevels?: number): Promise<{
         top: TermBookTop;
         book: TermBook;
+        auction: TermAuctionWindow | null;
     } | null>;
     getListings(config: TermMarketConfig): Promise<TermListing[] | null>;
     /**