@owney/sdk 0.7.25-beta.18 → 0.7.25-beta.19

package/dist/index.cjs

@@ -3769,6 +3769,35 @@ function mapYieldseekerEarnings(contexts) {
     tokens
   };
 }
+function mapYieldseekerDailyEarnings(walletAddress, contexts, days, now = Date.now()) {
+  const today = new Date(now).toISOString().slice(0, 10);
+  const dayCount = { "7D": 7, "14D": 14, "30D": 30 }[days];
+  const cutoff = new Date(Date.parse(today) - dayCount * 864e5).toISOString().slice(0, 10);
+  const assets = contexts.flatMap((context) => {
+    const snapshots = context.historic?.dailyYieldSnapshots;
+    if (!Array.isArray(snapshots)) invalid("historic position", "missing daily yield snapshots");
+    const byDate = /* @__PURE__ */ new Map();
+    for (const snapshot of snapshots) {
+      const time = Date.parse(snapshot.date);
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(snapshot.date) || !Number.isFinite(time) || new Date(time).toISOString().slice(0, 10) !== snapshot.date) {
+        invalid("historic position", "expected a UTC snapshot date");
+      }
+      if (snapshot.date > today) continue;
+      if (snapshot.baseAssetDecimals !== YIELDSEEKER_ASSET_METADATA[context.asset].decimals) {
+        invalid("historic position", "base asset decimals do not match the selected asset");
+      }
+      const amount = Number(decimal(snapshot.cumulativeYieldBase, snapshot.baseAssetDecimals, "historic position"));
+      if (!Number.isFinite(amount)) invalid("historic position", "expected finite cumulative yield");
+      byDate.set(snapshot.date, { date: snapshot.date, amount });
+    }
+    const sorted = [...byDate.values()].sort((a, b) => a.date.localeCompare(b.date));
+    const window2 = sorted.filter((point) => point.date >= cutoff);
+    if (!window2.length) return [];
+    const opening = sorted.filter((point) => point.date < cutoff).at(-1);
+    return [{ asset: context.asset, points: opening ? [opening, ...window2] : window2 }];
+  }).sort((a, b) => a.asset.localeCompare(b.asset));
+  return { walletAddress, chainId: 8453, assets };
+}
 function apyForDays(context, days, now) {
   if (days === "7D") return percent(context.snapshot.apy7d);
   if (days === "30D") return percent(context.snapshot.apy30d);
@@ -6110,6 +6139,17 @@ var YieldseekerAgent = class {
     });
     return mapYieldseekerApy(state.walletAddress, contexts, days);
   }
+  async getDailyEarnings(state, chainId, days, tokenSymbol) {
+    this.assertChain(chainId);
+    const asset = tokenSymbol?.toUpperCase();
+    if (asset !== void 0) this.assertAsset(asset);
+    const contexts = await this.loadActivityPortfolio(state, chainId, {
+      ...asset ? { asset } : {},
+      historic: true,
+      includePositions: false
+    });
+    return mapYieldseekerDailyEarnings(state.walletAddress, contexts, days);
+  }
   async getHistory(state, chainId, options) {
     this.assertChain(chainId);
     const asset = options?.tokenSymbol?.toUpperCase();
@@ -6620,7 +6660,7 @@ var YieldseekerAgent = class {
   }
   async loadPortfolioParts(state, chainId, context, options, contextKey) {
     const [positions, historic, actions] = await Promise.all([
-      this.cachedRead(
+      options.includePositions === false ? Promise.resolve({ yieldPositions: [] }) : this.cachedRead(
         `positions:${contextKey}`,
         this.portfolioCacheMs(contextKey),
         async () => {
@@ -7243,6 +7283,43 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
   return out;
 }
 
+// src/lib/helpers/daily-earnings-helper.ts
+function aggregateDailyEarnings(series, tokenSymbol) {
+  const wanted = tokenSymbol?.toUpperCase();
+  const byAsset = /* @__PURE__ */ new Map();
+  for (const account of series) {
+    for (const { asset, points } of account.assets) {
+      const symbol = asset.toUpperCase();
+      if (!points.length || wanted && symbol !== wanted) continue;
+      const components = byAsset.get(symbol) ?? [];
+      components.push([...points].sort((a, b) => a.date.localeCompare(b.date)));
+      byAsset.set(symbol, components);
+    }
+  }
+  return [...byAsset.entries()].map(([asset, components]) => {
+    const dates = [...new Set(components.flatMap((points2) => points2.map((point) => point.date)))].sort();
+    const cursors = components.map((points2) => ({
+      index: 0,
+      // Providers can have different lifetime/window offsets and start dates.
+      // Remove each opening reading before combining their earned amounts.
+      baseline: points2[0].amount,
+      current: points2[0].amount
+    }));
+    const points = dates.map((date) => {
+      let amount = 0;
+      components.forEach((component, index) => {
+        const cursor = cursors[index];
+        while (cursor.index < component.length && component[cursor.index].date <= date) {
+          cursor.current = component[cursor.index++].amount;
+        }
+        amount += cursor.current - cursor.baseline;
+      });
+      return { date, amount };
+    });
+    return { asset, points };
+  }).sort((a, b) => a.asset.localeCompare(b.asset));
+}
+
 // src/client.ts
 var import_viem17 = require("viem");
 var import_chains5 = require("viem/chains");
@@ -9625,10 +9702,8 @@ var OwneySDK = class {
    * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
    */
   /**
-   * Daily cumulative NET earnings for the selected chain/asset, backing the
-   * "recent earnings" subline. Net is computed as Zyfai's own
-   * `lifetime + unrealized + current x 0.9`, so the figure reconciles with the
-   * balance headline rather than reading ~11% high. (ROUT-452)
+   * Daily cumulative earnings in the selected asset's units, backing the
+   * "recent earnings" subline. Each adapter uses its provider's earnings basis.
    *
    * Unlike getAccountApy this does NOT blend across agents: earnings are
    * summed, not weighted, and an agent that fails to report must not silently
@@ -9661,7 +9736,7 @@ var OwneySDK = class {
     const entries = [...this.getActiveAgents().entries()].filter(
       ([, agent]) => agent.getDailyEarnings
     );
-    const series = await Promise.all(
+    const settled = await Promise.allSettled(
       entries.map(
         ([, agent]) => this.readAgent(
           agent,
@@ -9671,23 +9746,15 @@ var OwneySDK = class {
         )
       )
     );
-    const byAsset = /* @__PURE__ */ new Map();
-    for (const s of series) {
-      for (const { asset, points } of s.assets) {
-        const byDate = byAsset.get(asset) ?? /* @__PURE__ */ new Map();
-        for (const point of points) {
-          byDate.set(point.date, (byDate.get(point.date) ?? 0) + point.amount);
-        }
-        byAsset.set(asset, byDate);
-      }
+    const series = settled.flatMap((result) => result.status === "fulfilled" ? [result.value] : []);
+    if (entries.length && !series.length) {
+      const failure = settled.find((result) => result.status === "rejected");
+      if (failure?.status === "rejected") throw failure.reason;
     }
     return {
       walletAddress: series[0]?.walletAddress ?? state.walletAddress ?? "",
       chainId,
-      assets: [...byAsset.entries()].map(([asset, byDate]) => ({
-        asset,
-        points: [...byDate.entries()].map(([date, amount]) => ({ date, amount })).sort((a, b) => a.date.localeCompare(b.date))
-      })).sort((a, b) => a.asset.localeCompare(b.asset))
+      assets: aggregateDailyEarnings(series, tokenSymbol)
     };
   }
   async getAccountApy({

package/dist/index.d.cts

@@ -169,9 +169,9 @@ interface IAgent {
      */
     tokenSymbol?: string): Promise<AccountAgentApy>;
     /**
-     * Daily cumulative NET earnings for the window, scoped to a chain/asset.
-     * Backs the "recent earnings" subline, whose figure must reconcile with the
-     * balance headline directly above it. (ROUT-452)
+     * Daily cumulative earnings in token units, scoped to a chain/asset, using
+     * the provider's earnings basis. Include an opening snapshot when available
+     * so the "recent earnings" subline can difference the endpoints. (ROUT-452)
      */
     getDailyEarnings?(state: ConnectionState, chainId: number, days: LookbackDays, tokenSymbol?: string): Promise<AccountDailyEarnings>;
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
@@ -658,15 +658,15 @@ interface AgentApy {
 interface OwneyAgentApy {
     agentApy: Record<AgentId, AgentApy>;
 }
-/** One day's cumulative NET earnings for a single asset. */
+/** One day's cumulative earnings for a single asset. */
 interface DailyEarningsPoint {
     /** ISO date string for the day, e.g. "2026-09-01". */
     date: string;
     /**
-     * Earnings accumulated from the start of the returned series up to and
-     * including this day, net of the agent's performance fee, denominated in the
-     * asset's own units. A running total of daily deltas, so it measures the
-     * window — not the wallet's lifetime.
+     * Cumulative earnings in the asset's own units, using the provider's earnings
+     * basis. A provider may return lifetime totals or a running window total;
+     * difference the last and opening points to measure earnings over the window.
+     * Aggregate series normalize each component's opening value before summing.
      */
     amount: number;
 }
@@ -675,8 +675,9 @@ interface AssetDailyEarnings {
     /** Asset symbol, e.g. "USDC" / "WETH". */
     asset: string;
     /**
-     * Ascending by date. Days the wallet held nothing of this asset are absent
-     * rather than zero — a zero would read as "earned nothing that day".
+     * Ascending by date, including an opening snapshot before the requested
+     * window when available. Provider gaps remain absent; aggregates carry the
+     * most recent cumulative value across dates reported by other providers.
      */
     points: DailyEarningsPoint[];
 }
@@ -954,10 +955,8 @@ declare class OwneySDK {
      * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
      */
     /**
-     * Daily cumulative NET earnings for the selected chain/asset, backing the
-     * "recent earnings" subline. Net is computed as Zyfai's own
-     * `lifetime + unrealized + current x 0.9`, so the figure reconciles with the
-     * balance headline rather than reading ~11% high. (ROUT-452)
+     * Daily cumulative earnings in the selected asset's units, backing the
+     * "recent earnings" subline. Each adapter uses its provider's earnings basis.
      *
      * Unlike getAccountApy this does NOT blend across agents: earnings are
      * summed, not weighted, and an agent that fails to report must not silently
@@ -1146,6 +1145,7 @@ declare class YieldseekerAgent implements IAgent {
     hasExistingDepositFunds(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, tokenSymbol?: string): Promise<AccountAgentApy>;
+    getDailyEarnings(state: ConnectionState, chainId: number, days: LookbackDays, tokenSymbol?: string): Promise<AccountDailyEarnings>;
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;

package/dist/index.d.ts

@@ -169,9 +169,9 @@ interface IAgent {
      */
     tokenSymbol?: string): Promise<AccountAgentApy>;
     /**
-     * Daily cumulative NET earnings for the window, scoped to a chain/asset.
-     * Backs the "recent earnings" subline, whose figure must reconcile with the
-     * balance headline directly above it. (ROUT-452)
+     * Daily cumulative earnings in token units, scoped to a chain/asset, using
+     * the provider's earnings basis. Include an opening snapshot when available
+     * so the "recent earnings" subline can difference the endpoints. (ROUT-452)
      */
     getDailyEarnings?(state: ConnectionState, chainId: number, days: LookbackDays, tokenSymbol?: string): Promise<AccountDailyEarnings>;
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
@@ -658,15 +658,15 @@ interface AgentApy {
 interface OwneyAgentApy {
     agentApy: Record<AgentId, AgentApy>;
 }
-/** One day's cumulative NET earnings for a single asset. */
+/** One day's cumulative earnings for a single asset. */
 interface DailyEarningsPoint {
     /** ISO date string for the day, e.g. "2026-09-01". */
     date: string;
     /**
-     * Earnings accumulated from the start of the returned series up to and
-     * including this day, net of the agent's performance fee, denominated in the
-     * asset's own units. A running total of daily deltas, so it measures the
-     * window — not the wallet's lifetime.
+     * Cumulative earnings in the asset's own units, using the provider's earnings
+     * basis. A provider may return lifetime totals or a running window total;
+     * difference the last and opening points to measure earnings over the window.
+     * Aggregate series normalize each component's opening value before summing.
      */
     amount: number;
 }
@@ -675,8 +675,9 @@ interface AssetDailyEarnings {
     /** Asset symbol, e.g. "USDC" / "WETH". */
     asset: string;
     /**
-     * Ascending by date. Days the wallet held nothing of this asset are absent
-     * rather than zero — a zero would read as "earned nothing that day".
+     * Ascending by date, including an opening snapshot before the requested
+     * window when available. Provider gaps remain absent; aggregates carry the
+     * most recent cumulative value across dates reported by other providers.
      */
     points: DailyEarningsPoint[];
 }
@@ -954,10 +955,8 @@ declare class OwneySDK {
      * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
      */
     /**
-     * Daily cumulative NET earnings for the selected chain/asset, backing the
-     * "recent earnings" subline. Net is computed as Zyfai's own
-     * `lifetime + unrealized + current x 0.9`, so the figure reconciles with the
-     * balance headline rather than reading ~11% high. (ROUT-452)
+     * Daily cumulative earnings in the selected asset's units, backing the
+     * "recent earnings" subline. Each adapter uses its provider's earnings basis.
      *
      * Unlike getAccountApy this does NOT blend across agents: earnings are
      * summed, not weighted, and an agent that fails to report must not silently
@@ -1146,6 +1145,7 @@ declare class YieldseekerAgent implements IAgent {
     hasExistingDepositFunds(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<true | undefined>;
     getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
     getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, tokenSymbol?: string): Promise<AccountAgentApy>;
+    getDailyEarnings(state: ConnectionState, chainId: number, days: LookbackDays, tokenSymbol?: string): Promise<AccountDailyEarnings>;
     getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
     getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;

package/dist/index.js

@@ -3755,6 +3755,35 @@ function mapYieldseekerEarnings(contexts) {
     tokens
   };
 }
+function mapYieldseekerDailyEarnings(walletAddress, contexts, days, now = Date.now()) {
+  const today = new Date(now).toISOString().slice(0, 10);
+  const dayCount = { "7D": 7, "14D": 14, "30D": 30 }[days];
+  const cutoff = new Date(Date.parse(today) - dayCount * 864e5).toISOString().slice(0, 10);
+  const assets = contexts.flatMap((context) => {
+    const snapshots = context.historic?.dailyYieldSnapshots;
+    if (!Array.isArray(snapshots)) invalid("historic position", "missing daily yield snapshots");
+    const byDate = /* @__PURE__ */ new Map();
+    for (const snapshot of snapshots) {
+      const time = Date.parse(snapshot.date);
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(snapshot.date) || !Number.isFinite(time) || new Date(time).toISOString().slice(0, 10) !== snapshot.date) {
+        invalid("historic position", "expected a UTC snapshot date");
+      }
+      if (snapshot.date > today) continue;
+      if (snapshot.baseAssetDecimals !== YIELDSEEKER_ASSET_METADATA[context.asset].decimals) {
+        invalid("historic position", "base asset decimals do not match the selected asset");
+      }
+      const amount = Number(decimal(snapshot.cumulativeYieldBase, snapshot.baseAssetDecimals, "historic position"));
+      if (!Number.isFinite(amount)) invalid("historic position", "expected finite cumulative yield");
+      byDate.set(snapshot.date, { date: snapshot.date, amount });
+    }
+    const sorted = [...byDate.values()].sort((a, b) => a.date.localeCompare(b.date));
+    const window2 = sorted.filter((point) => point.date >= cutoff);
+    if (!window2.length) return [];
+    const opening = sorted.filter((point) => point.date < cutoff).at(-1);
+    return [{ asset: context.asset, points: opening ? [opening, ...window2] : window2 }];
+  }).sort((a, b) => a.asset.localeCompare(b.asset));
+  return { walletAddress, chainId: 8453, assets };
+}
 function apyForDays(context, days, now) {
   if (days === "7D") return percent(context.snapshot.apy7d);
   if (days === "30D") return percent(context.snapshot.apy30d);
@@ -6105,6 +6134,17 @@ var YieldseekerAgent = class {
     });
     return mapYieldseekerApy(state.walletAddress, contexts, days);
   }
+  async getDailyEarnings(state, chainId, days, tokenSymbol) {
+    this.assertChain(chainId);
+    const asset = tokenSymbol?.toUpperCase();
+    if (asset !== void 0) this.assertAsset(asset);
+    const contexts = await this.loadActivityPortfolio(state, chainId, {
+      ...asset ? { asset } : {},
+      historic: true,
+      includePositions: false
+    });
+    return mapYieldseekerDailyEarnings(state.walletAddress, contexts, days);
+  }
   async getHistory(state, chainId, options) {
     this.assertChain(chainId);
     const asset = options?.tokenSymbol?.toUpperCase();
@@ -6615,7 +6655,7 @@ var YieldseekerAgent = class {
   }
   async loadPortfolioParts(state, chainId, context, options, contextKey) {
     const [positions, historic, actions] = await Promise.all([
-      this.cachedRead(
+      options.includePositions === false ? Promise.resolve({ yieldPositions: [] }) : this.cachedRead(
         `positions:${contextKey}`,
         this.portfolioCacheMs(contextKey),
         async () => {
@@ -7238,6 +7278,43 @@ function aggregateApyByChainAndAsset(agentApys, agentBalances) {
   return out;
 }
 
+// src/lib/helpers/daily-earnings-helper.ts
+function aggregateDailyEarnings(series, tokenSymbol) {
+  const wanted = tokenSymbol?.toUpperCase();
+  const byAsset = /* @__PURE__ */ new Map();
+  for (const account of series) {
+    for (const { asset, points } of account.assets) {
+      const symbol = asset.toUpperCase();
+      if (!points.length || wanted && symbol !== wanted) continue;
+      const components = byAsset.get(symbol) ?? [];
+      components.push([...points].sort((a, b) => a.date.localeCompare(b.date)));
+      byAsset.set(symbol, components);
+    }
+  }
+  return [...byAsset.entries()].map(([asset, components]) => {
+    const dates = [...new Set(components.flatMap((points2) => points2.map((point) => point.date)))].sort();
+    const cursors = components.map((points2) => ({
+      index: 0,
+      // Providers can have different lifetime/window offsets and start dates.
+      // Remove each opening reading before combining their earned amounts.
+      baseline: points2[0].amount,
+      current: points2[0].amount
+    }));
+    const points = dates.map((date) => {
+      let amount = 0;
+      components.forEach((component, index) => {
+        const cursor = cursors[index];
+        while (cursor.index < component.length && component[cursor.index].date <= date) {
+          cursor.current = component[cursor.index++].amount;
+        }
+        amount += cursor.current - cursor.baseline;
+      });
+      return { date, amount };
+    });
+    return { asset, points };
+  }).sort((a, b) => a.asset.localeCompare(b.asset));
+}
+
 // src/client.ts
 import {
   parseUnits as parseUnits3,
@@ -9629,10 +9706,8 @@ var OwneySDK = class {
    * @returns {AccountAgentApy} for a single agent, or {OwneyAccountApy} with totalApy and per-agent breakdown
    */
   /**
-   * Daily cumulative NET earnings for the selected chain/asset, backing the
-   * "recent earnings" subline. Net is computed as Zyfai's own
-   * `lifetime + unrealized + current x 0.9`, so the figure reconciles with the
-   * balance headline rather than reading ~11% high. (ROUT-452)
+   * Daily cumulative earnings in the selected asset's units, backing the
+   * "recent earnings" subline. Each adapter uses its provider's earnings basis.
    *
    * Unlike getAccountApy this does NOT blend across agents: earnings are
    * summed, not weighted, and an agent that fails to report must not silently
@@ -9665,7 +9740,7 @@ var OwneySDK = class {
     const entries = [...this.getActiveAgents().entries()].filter(
       ([, agent]) => agent.getDailyEarnings
     );
-    const series = await Promise.all(
+    const settled = await Promise.allSettled(
       entries.map(
         ([, agent]) => this.readAgent(
           agent,
@@ -9675,23 +9750,15 @@ var OwneySDK = class {
         )
       )
     );
-    const byAsset = /* @__PURE__ */ new Map();
-    for (const s of series) {
-      for (const { asset, points } of s.assets) {
-        const byDate = byAsset.get(asset) ?? /* @__PURE__ */ new Map();
-        for (const point of points) {
-          byDate.set(point.date, (byDate.get(point.date) ?? 0) + point.amount);
-        }
-        byAsset.set(asset, byDate);
-      }
+    const series = settled.flatMap((result) => result.status === "fulfilled" ? [result.value] : []);
+    if (entries.length && !series.length) {
+      const failure = settled.find((result) => result.status === "rejected");
+      if (failure?.status === "rejected") throw failure.reason;
     }
     return {
       walletAddress: series[0]?.walletAddress ?? state.walletAddress ?? "",
       chainId,
-      assets: [...byAsset.entries()].map(([asset, byDate]) => ({
-        asset,
-        points: [...byDate.entries()].map(([date, amount]) => ({ date, amount })).sort((a, b) => a.date.localeCompare(b.date))
-      })).sort((a, b) => a.asset.localeCompare(b.asset))
+      assets: aggregateDailyEarnings(series, tokenSymbol)
     };
   }
   async getAccountApy({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.7.25-beta.18",
+  "version": "0.7.25-beta.19",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",