@kasufinance/kasu-sdk 2.15.0 → 2.17.0

package/dist/domain/yields.js

@@ -18,6 +18,16 @@
  * window, and the accrual spreads an epoch's interest across it.
  */
 export const SECONDS_PER_WEEK = 604800;
+/**
+ * The most unpaid interest {@link accruedInterestSince} shows for one pool:
+ * this many epochs of its weekly figure (owner ruling 2026-11-07).
+ *
+ * A pool can stop being cleared without being flagged stopped. On Base, one
+ * pool is more than six epochs behind and another more than a hundred.
+ * Uncapped, the figure would show interest that may never be credited. Four
+ * epochs covers any ordinary late clearing.
+ */
+export const MAX_ACCRUAL_EPOCHS = 4;
 function isUsableFeePercent(feePercent) {
     return (feePercent !== null &&
         Number.isFinite(feePercent) &&
@@ -71,28 +81,40 @@ export function dailyInterest(weekly) {
     return weekly / 7;
 }
 /**
- * Interest accrued since each pool's OWN last cycle close — the moving part
- * of lifetime interest (lifetime = settled on chain + this).
+ * Interest accrued since each pool's OWN last clearing transaction, capped at
+ * one epoch per pool.
  *
  * ```
  * accrued = Σ_pool  weekly_pool × clamp(now − clearing_pool, 0, 604 800) / 604 800
  * ```
  *
- * **Per pool, because pools clear independently.** One shared anchor accrues
- * a stale pool's share from a close it never had, and when another pool
- * clears it drops the total by the stale pool's whole weekly share. Anchored
- * per pool, the total is monotonic across any single pool's clearing: that
- * pool swaps its accrued share for a capitalised one, and no other term moves.
+ * Per pool, because pools clear independently: one shared anchor accrues a
+ * stale pool's share from a close it never had, and when another pool clears
+ * it drops the total by the stale pool's whole weekly share.
  *
- * **The one-epoch cap is load-bearing.** Clearings are not exactly weekly,
- * and `weeklyInterest` is per EPOCH, so extrapolating past seven days would
- * promise interest the close will not credit; a late clearing under-reports
- * instead. The low clamp makes a close ahead of the local clock zero, never
- * negative.
+ * **The one-epoch cap rested on a wrong premise.** It assumed a late
+ * clearing credits only one epoch, so accruing past seven days would promise
+ * interest no close pays. The contracts say otherwise. `ClearingCoordinator`
+ * states that clearing "must be executed once per epoch for each lending
+ * pool" and that "clearing epochs must be executed in order"; `doClearing`
+ * reverts unless the target epoch is the pool's `nextLendingPoolClearingEpoch`,
+ * and it calls `LendingPool.applyInterests(targetEpoch)` on every clearing,
+ * late or not ("if clearing for the epoch is executed only after the clearing
+ * period, only yield will be applied"). Every missed epoch's interest is
+ * therefore credited when the clearings catch up — on Base, one pool cleared
+ * epochs 116 to 119 in the same block, four weeks credited at once.
+ * Capped, the figure freezes as soon as a clearing is a week late; anchored
+ * on the transaction, it also DIPS on a catch-up (elapsed resets to zero
+ * while only one week is credited per clearing).
  *
+ * The low clamp makes a close ahead of the local clock zero, never negative.
  * A non-finite term contributes nothing; a non-finite `nowSeconds` accrues
- * nothing. Callers fail closed upstream by not offering an accrual for a pool
- * whose weekly interest or anchor is unknown.
+ * nothing.
+ *
+ * @deprecated Use {@link accruedInterestSince} with {@link epochAccrual}:
+ * identical while clearings run on time, and it keeps accruing, up to four
+ * epochs, when they run late. Kept, behaviour-identical, for existing
+ * callers.
  */
 export function accruedInterest(accruals, nowSeconds) {
     if (!Number.isFinite(nowSeconds))
@@ -107,6 +129,181 @@ export function accruedInterest(accruals, nowSeconds) {
     }
     return accrued;
 }
+/**
+ * Unix SECONDS at which `epoch` ENDS — the start of the next one:
+ *
+ * ```
+ * epochEnd(e) = initialEpochStart + (e + 1) × 604 800
+ * ```
+ *
+ * `SystemVariables.epochStartTimestamp(e)` is `initial + e × EPOCH_DURATION`,
+ * and the initial start is written once, at initialisation, so the end of any
+ * epoch follows from `epochStartTimestamp(0)` with no further read.
+ *
+ * FAILS CLOSED with `NaN`: a non-integer, non-finite or negative epoch, an
+ * initial start that is not a positive integer, or a result past
+ * `Number.MAX_SAFE_INTEGER`.
+ *
+ * @param initialEpochStart unix seconds, `epochStartTimestamp(0)`.
+ * @param epoch the epoch number, 0-based.
+ */
+export function epochEndTimestamp(initialEpochStart, epoch) {
+    if (!Number.isSafeInteger(initialEpochStart) || initialEpochStart <= 0) {
+        return NaN;
+    }
+    if (!Number.isSafeInteger(epoch) || epoch < 0)
+        return NaN;
+    const end = initialEpochStart + (epoch + 1) * SECONDS_PER_WEEK;
+    return Number.isSafeInteger(end) ? end : NaN;
+}
+/**
+ * Builds one pool's {@link EpochAccrual} from what the chain and the subgraph
+ * say about its last clearing:
+ *
+ * ```
+ * epochEnd    = epochEndTimestamp(initialEpochStart, lastClearedEpoch)
+ * accruesFrom = min(clearingStartedAt, epochEnd)
+ * ```
+ *
+ * - **On time** (the clearing started inside its window, before its epoch
+ *   ended): `accruesFrom` is the clearing's start. Clearing applies the
+ *   epoch's interest first and only then accepts requests, so today's
+ *   balance — which includes a deposit that clearing accepted — is never
+ *   charged for time before it: a new lender starts at exactly 0.
+ * - **Late** (it started at or after its epoch end): `accruesFrom` is the
+ *   epoch end. A late clearing accepts no requests and credits exactly one
+ *   epoch, so the time it did not credit is kept.
+ *
+ * `lastClearedEpoch` is the newest epoch whose clearing has STARTED (the
+ * subgraph has a `LendingPoolClearing` for it), not the newest that has
+ * finished, and `clearingStartedAt` is that clearing's `startTimestamp`.
+ * `ClearingCoordinator.doClearing` mints the epoch's interest in its FIRST
+ * transaction (`applyInterests`), while `nextLendingPoolClearingEpoch` only
+ * advances when the clearing ENDS, so it is the wrong source.
+ *
+ * FAILS CLOSED with `null`: whatever {@link epochEndTimestamp} rejects, a
+ * `clearingStartedAt` that is not a finite positive number, or a
+ * `weeklyInterest` that is not finite or is negative. The caller then offers
+ * no term for that pool.
+ *
+ * @param input.weeklyInterest the pool's net interest for one epoch.
+ * @param input.initialEpochStart unix seconds, `epochStartTimestamp(0)`.
+ * @param input.lastClearedEpoch the newest epoch whose clearing has started.
+ * @param input.clearingStartedAt unix seconds, that clearing's start.
+ */
+export function epochAccrual(input) {
+    const { weeklyInterest: weekly, clearingStartedAt } = input;
+    if (!Number.isFinite(weekly) || weekly < 0)
+        return null;
+    if (!Number.isFinite(clearingStartedAt) || clearingStartedAt <= 0) {
+        return null;
+    }
+    const epochEnd = epochEndTimestamp(input.initialEpochStart, input.lastClearedEpoch);
+    if (Number.isNaN(epochEnd))
+        return null;
+    return {
+        weeklyInterest: weekly,
+        accruesFrom: Math.min(clearingStartedAt, epochEnd),
+        epochEnd,
+    };
+}
+/**
+ * Interest accrued and not yet credited — the moving part of lifetime
+ * interest (lifetime = settled on chain + this). Per term, with
+ * `W` = 604 800 s:
+ *
+ * ```
+ * accrued = min( weekly × ( min(max(now − accruesFrom, 0), W)
+ *                         + max(now − (epochEnd + W), 0) ) / W,
+ *                MAX_ACCRUAL_EPOCHS × weekly )
+ * ```
+ *
+ * Read along the clock, for one pool:
+ * 1. from `accruesFrom`, one epoch of interest accrues linearly;
+ * 2. it then HOLDS from `accruesFrom + W` until `epochEnd + W`, the end of
+ *    the next epoch — at most 48 h after an on-time clearing (its clearing
+ *    window), no time at all after a late one (`accruesFrom == epochEnd`);
+ * 3. then it resumes, up to {@link MAX_ACCRUAL_EPOCHS} (4) epochs of
+ *    `weekly` in all, and stops there.
+ *
+ * **Why it keeps accruing past one epoch.** Clearing must run once per
+ * epoch for each pool, in order (`ClearingCoordinator.doClearing` reverts
+ * unless the target epoch is the pool's `nextLendingPoolClearingEpoch`), and
+ * every clearing, on time or late, starts with
+ * `LendingPool.applyInterests(targetEpoch)`. A missed epoch is therefore
+ * credited when the clearings catch up (on Base, one pool cleared epochs 116
+ * to 119 in the same block).
+ *
+ * **Why it stops at four epochs** (owner ruling 2026-11-07). A pool can stop
+ * being cleared without being flagged stopped. On Base today one pool is
+ * more than six epochs behind and another more than a hundred. Past four
+ * epochs the figure would show interest that may never be credited. Four
+ * covers any ordinary late clearing.
+ *
+ * **Why the hold.** Without it an on-time anchor accrues past one epoch
+ * while the next on-time clearing — which credits exactly one — is still to
+ * come, and the total steps DOWN when it lands. With it, at a constant
+ * balance, `settled + accrued` never steps down at a clearing (`t` = the
+ * NEW clearing's start, `E` = the end of the epoch it clears):
+ * - on time after on time: identical to the deprecated `accruedInterest`
+ *   at every instant. With `gap` = `t` − the previous clearing's start, it
+ *   steps UP by `weekly × (W − gap) / W` when `gap < W` (at most 2/7 of one
+ *   weekly, as before), and not at all when `gap ≥ W`;
+ * - late after on time, and late after late: exactly continuous;
+ * - on time after late: steps UP by `weekly × (E − t) / W`, at most 2/7 of
+ *   one weekly.
+ * A deposit or top-up accepted at an on-time clearing starts at 0, so it
+ * never dips the total either.
+ *
+ * **At the cap.** All of the above holds for a pool below the cap, where
+ * the cap changes nothing. A pool AT the cap shows `4 × weekly` before a
+ * catch-up clearing; after it, one more `weekly` is settled and the new term
+ * shows `min(elapsed′, 4 × weekly)`, so `after = min(elapsed′ + weekly,
+ * 5 × weekly) ≥ before`. Each clearing steps the total UP by at most one
+ * weekly until the pool is back under the cap. Never down, and never above
+ * settled plus `4 × weekly` per pool.
+ *
+ * **Never negative**, and non-decreasing in `now`. A term is skipped — it
+ * contributes nothing — when `weeklyInterest` is not finite or is negative,
+ * when `accruesFrom` or `epochEnd` is not finite, when `accruesFrom >
+ * epochEnd` (inconsistent: the anchor is never after the epoch end), or when
+ * an elapsed time overflows. A non-finite `nowSeconds` accrues nothing.
+ *
+ * **Per pool, because pools clear independently.** One shared anchor accrues
+ * a stale pool's share from a close it never had.
+ *
+ * **Accepted approximation.** `weekly` is today's balance at today's epoch
+ * rate. Over a multi-week gap the chain compounds weekly and may apply other
+ * epochs' rates, so a long accrual reads slightly LOW. It is a ticking
+ * estimate, not a ledger.
+ *
+ * Callers fail closed upstream: no term for a pool whose weekly interest or
+ * clearing is unknown (`epochAccrual` returns `null`), and none for a pool
+ * that has stopped — it will never clear again.
+ */
+export function accruedInterestSince(accruals, nowSeconds) {
+    if (!Number.isFinite(nowSeconds))
+        return 0;
+    let accrued = 0;
+    for (const { weeklyInterest: weekly, accruesFrom, epochEnd } of accruals) {
+        if (!Number.isFinite(weekly) || weekly < 0)
+            continue;
+        if (!Number.isFinite(accruesFrom) || !Number.isFinite(epochEnd)) {
+            continue;
+        }
+        if (accruesFrom > epochEnd)
+            continue;
+        const sinceAnchor = nowSeconds - accruesFrom;
+        const sinceHoldEnd = nowSeconds - (epochEnd + SECONDS_PER_WEEK);
+        if (!Number.isFinite(sinceAnchor) || !Number.isFinite(sinceHoldEnd)) {
+            continue;
+        }
+        const elapsed = Math.min(Math.max(sinceAnchor, 0), SECONDS_PER_WEEK) +
+            Math.max(sinceHoldEnd, 0);
+        accrued += Math.min((weekly * elapsed) / SECONDS_PER_WEEK, MAX_ACCRUAL_EPOCHS * weekly);
+    }
+    return accrued;
+}
 /**
  * What `amount` earns in a year at a NET rate — the "≈ $Y a year" line.
  * Feed it `netEffectiveApy(...)`, never a gross APY: the result is a lender's

package/dist/domain/yields.js.map

@@ -1 +1 @@
-{"version":3,"file":"yields.js","sourceRoot":"","sources":["../../src/domain/yields.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"yields.js","sourceRoot":"","sources":["../../src/domain/yields.ts"],"names":[],"mappings":"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"}

package/dist/services/Locking/locking.d.ts

@@ -72,6 +72,18 @@ export declare class KSULocking {
     getAvailableKsuBonus(): Promise<string>;
     getUserKsuBalance(userAddress: string): Promise<string>;
     getNextEpochDate(): Promise<EpochTimeStamp>;
+    /**
+     * Unix SECONDS at which epoch 0 started:
+     * `SystemVariables.epochStartTimestamp(0)`. The contract writes this once,
+     * at initialisation, so it never changes for a deployment and may be cached
+     * for the life of the app. Every epoch boundary follows from it —
+     * `epochEndTimestamp(initial, epoch)` and `epochAccrual` in the domain
+     * layer.
+     *
+     * Available on every deployment, Full and Lite. A failed read rejects; the
+     * caller validates the value (a positive integer) before using it.
+     */
+    getInitialEpochStartTimestamp(): Promise<number>;
     getNextClearingPeriodDate(): Promise<EpochTimeStamp>;
     getActiveLockPeriods(): Promise<LockPeriod[]>;
     getProjectedApy(): string;

package/dist/services/Locking/locking.js

@@ -415,6 +415,22 @@ export class KSULocking {
             return (yield this._systemVariablesAbi.nextEpochStartTimestamp()).toNumber();
         });
     }
+    /**
+     * Unix SECONDS at which epoch 0 started:
+     * `SystemVariables.epochStartTimestamp(0)`. The contract writes this once,
+     * at initialisation, so it never changes for a deployment and may be cached
+     * for the life of the app. Every epoch boundary follows from it —
+     * `epochEndTimestamp(initial, epoch)` and `epochAccrual` in the domain
+     * layer.
+     *
+     * Available on every deployment, Full and Lite. A failed read rejects; the
+     * caller validates the value (a positive integer) before using it.
+     */
+    getInitialEpochStartTimestamp() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return (yield this._systemVariablesAbi.epochStartTimestamp(0)).toNumber();
+        });
+    }
     getNextClearingPeriodDate() {
         return __awaiter(this, void 0, void 0, function* () {
             const nextEpochDate = yield this.getNextEpochDate();

package/dist/services/Locking/locking.js.map

@@ -1 +1 @@
-{"version":3,"file":"locking.js","sourceRoot":"","sources":["../../../src/services/Locking/locking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"locking.js","sourceRoot":"","sources":["../../../src/services/Locking/locking.ts"],"names":[],"mappings":"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"}

package/dist/services/Portfolio/portfolio.d.ts

@@ -77,7 +77,12 @@ export declare class Portfolio {
      * Cost: three parallel `SystemVariables` reads and the positions query in
      * one round, then one subgraph request per page of the longest series
      * (1000 rows a page) — normally two subgraph round trips in all, never one
-     * per epoch.
+     * per epoch — alongside one `LendingPool.userBalance` call per pool at
+     * the subgraph's block. A pool whose ledger credits more than the wallet
+     * holds at that block (shares moved away outside a withdrawal) is left
+     * out; if the node says it cannot serve that block, `latest` is read
+     * and nothing is. Any other failure of those reads (a rate limit, a
+     * network error) THROWS: the history needs a working RPC.
      *
      * On a LITE deployment, a subgraph that lacks the entities (a validation
      * error naming them) yields `[]`; on a full deployment that error throws,
@@ -87,6 +92,54 @@ export declare class Portfolio {
      * network read.
      */
     getYieldHistory(userAddress: string, options?: YieldHistoryOptions): Promise<YieldHistoryEntry[]>;
+    /**
+     * Read the chain at the subgraph's block, so the chain and the ledger
+     * describe the same state: after every clearing the subgraph runs a few
+     * blocks behind, and a `latest` read would then disagree with an
+     * honest ledger (interest moved every balance, deposits were accepted)
+     * and book that difference as a ledger fault.
+     *
+     * Only when the node says it cannot serve that block (pruned, or behind
+     * the subgraph: `isBlockUnavailableError`) does it fall back to `latest`,
+     * and it says so (`blockTag: undefined`): unpinned figures are never
+     * compared with the ledger, and `getPortfolioLendingData` marks the pools
+     * `chainPinned: false`. Any other failure — a rate limit, a timeout, a
+     * network error — is thrown, never turned into an unpinned read.
+     */
+    private readChainAt;
+    /**
+     * One pool's balances: the ledger's (the subgraph counts a lender's
+     * shares as accepted deposits − accepted withdrawals ± top-ups) checked
+     * against the chain's `LendingPool.userBalance` at the SAME block.
+     *
+     * The ledger does not follow shares that move between wallets any other
+     * way (an administrative move of a position is the case seen on chain):
+     * the receiving wallet goes negative as it withdraws, the sending one
+     * keeps shares it no longer holds. Where the two disagree at that block —
+     * or any ledger balance is negative — the tranche balances are read from
+     * the chain at that block (`userActiveAssets`, one call per tranche), the
+     * tranche's ledger `yieldEarned` moves by the same difference, and the
+     * pool carries `ledgerMismatch`. Unpinned (the node could not serve the
+     * block), only a negative ledger balance is corrected. A pool that agrees
+     * — every ordinary lender — costs nothing extra.
+     *
+     * Lifetime figures stay ledger figures: they cannot tell moved principal
+     * from interest.
+     */
+    private reconcilePool;
+    /**
+     * The last-epoch figures of positions whose newest interest is OLDER than
+     * the recent window. Pools clear independently, and some clear only when
+     * the originator repays, so a pool's last cycle can be weeks back: it is
+     * priced at THAT epoch, from a history read of just those positions over
+     * just those epochs, through the same `positionEpochYield` — so it equals
+     * the history's newest bar.
+     *
+     * A lender who has since left the tranche (no ledger shares now) gets no
+     * figure: an old pool's last cycle is not theirs to show. Costs nothing
+     * when no position qualifies.
+     */
+    private staleLastEpochYields;
     /**
      * A money figure as a plain decimal string. Below a millionth of a token
      * (the stable asset's own precision) is float noise, never money, so it