@augustdigital/sdk 9.13.0 → 9.13.1

package/lib/core/analytics/version.d.ts

@@ -3,4 +3,4 @@
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-export declare const SDK_VERSION = "9.13.0";
+export declare const SDK_VERSION = "9.13.1";

package/lib/core/analytics/version.js

@@ -6,5 +6,5 @@ exports.SDK_VERSION = void 0;
  * Generated during publish from package.json version
  * This file is gitignored and created at publish time
  */
-exports.SDK_VERSION = '9.13.0';
+exports.SDK_VERSION = '9.13.1';
 //# sourceMappingURL=version.js.map

package/lib/modules/vaults/getters.d.ts

@@ -860,9 +860,21 @@ export declare function getVaultUserLifetimePnl({ vault, wallet, options, }: {
  * Calculate PnL for a vault (vault-level, not user-specific).
  * Returns the vault's overall profit and loss across all users.
  *
+ * Sums, over the vault's whole history, each day's change in assets per share
+ * times that day's total shares, then prices the result at the receipt
+ * token's current USD price. The daily history comes from
+ * `GET /tokenized_vault/{vault}/historical-timeseries`, the replacement for the
+ * deprecated `load_snapshots` flag on the vault read.
+ *
+ * Network: one backend vault read, one timeseries read and one price read.
+ *
  * @param vault - Vault contract address
  * @param options - RPC configuration and service options
- * @returns Vault PnL in USD and notional value
+ * @returns Vault PnL in the deposit asset (`totalPnl`) and in USD (`pnlUsd`).
+ *   Both are zero for a vault with no recorded history. `pnlUsd` is also zero
+ *   when the receipt token price cannot be fetched.
+ * @throws Error when `vault` is missing, is a Stellar vault, is not an
+ *   address, or the vault or its history cannot be read.
  */
 export declare function getVaultPnl({ vault, options, }: {
     vault: IAddress;

package/lib/modules/vaults/getters.js

@@ -3445,9 +3445,21 @@ async function getVaultUserLifetimePnl({ vault, wallet, options, }) {
  * Calculate PnL for a vault (vault-level, not user-specific).
  * Returns the vault's overall profit and loss across all users.
  *
+ * Sums, over the vault's whole history, each day's change in assets per share
+ * times that day's total shares, then prices the result at the receipt
+ * token's current USD price. The daily history comes from
+ * `GET /tokenized_vault/{vault}/historical-timeseries`, the replacement for the
+ * deprecated `load_snapshots` flag on the vault read.
+ *
+ * Network: one backend vault read, one timeseries read and one price read.
+ *
  * @param vault - Vault contract address
  * @param options - RPC configuration and service options
- * @returns Vault PnL in USD and notional value
+ * @returns Vault PnL in the deposit asset (`totalPnl`) and in USD (`pnlUsd`).
+ *   Both are zero for a vault with no recorded history. `pnlUsd` is also zero
+ *   when the receipt token price cannot be fetched.
+ * @throws Error when `vault` is missing, is a Stellar vault, is not an
+ *   address, or the vault or its history cannot be read.
  */
 async function getVaultPnl({ vault, options, }) {
     try {
@@ -3456,60 +3468,33 @@ async function getVaultPnl({ vault, options, }) {
         (0, utils_3.assertNotStellar)(vault, 'Vault PnL');
         if (!(0, ethers_1.isAddress)(vault))
             throw new Error(`Vault input parameter is not an address: ${String(vault)}`);
-        // Get vault data
-        const vaultData = await getVault({
-            vault,
-            loans: false,
-            allocations: false,
-            options,
-        });
+        // The vault row only supplies decimals, chain and receipt token, so skip
+        // its subaccounts and snapshots. 3650 days reads the full history, as
+        // `fetchShareRatios` does.
+        const [vaultData, { data: history }] = await Promise.all([
+            getVault({
+                vault,
+                loans: false,
+                allocations: false,
+                options,
+                loadSubaccounts: false,
+                loadSnapshots: false,
+            }),
+            (0, core_1.fetchVaultHistoricalTimeseries)(vault, 3650, options?.headers),
+        ]);
         if (!vaultData) {
             throw new Error(`Vault ${vault} not found`);
         }
-        // Check if vault has daily_pnl_per_share and historical_snapshots
-        if (!vaultData.dailyPnlPerShare ||
-            !Array.isArray(vaultData.dailyPnlPerShare) ||
-            vaultData.dailyPnlPerShare.length === 0) {
-            return {
-                totalPnl: (0, core_1.toNormalizedBn)(0, vaultData.decimals),
-                pnlUsd: 0,
-            };
-        }
-        if (!vaultData.historical_snapshots ||
-            !Array.isArray(vaultData.historical_snapshots) ||
-            vaultData.historical_snapshots.length === 0) {
-            return {
-                totalPnl: (0, core_1.toNormalizedBn)(0, vaultData.decimals),
-                pnlUsd: 0,
-            };
-        }
         const decimals = vaultData.decimals;
-        // Filter out dates with zero PnL
-        const validDailyPnl = vaultData.dailyPnlPerShare.filter((dayData) => dayData.value && dayData.value !== 0);
-        // Create a map of historical_snapshots by date (YYYY-MM-DD) for quick lookup
-        const snapshotsByDate = new Map();
-        vaultData.historical_snapshots.forEach((snapshot) => {
-            const snapshotDate = new Date(snapshot.snapshot_datetime);
-            const dateKey = snapshotDate.toISOString().split('T')[0]; // YYYY-MM-DD
-            snapshotsByDate.set(dateKey, snapshot);
-        });
-        // Calculate PnL for each day using historical_snapshots
+        // `daily_pnl` is the day's change in assets per share. It is zero on the
+        // first day and on forward-filled (`missing`) days, so those add nothing.
         let totalPnlRaw = BigInt(0);
-        validDailyPnl.forEach((dayData) => {
-            const dayTimestamp = dayData.timestamp;
-            const dailyPnlPerShare = dayData.value;
-            // Get date key (YYYY-MM-DD) from timestamp
-            const dayDate = new Date(dayTimestamp);
-            const dateKey = dayDate.toISOString().split('T')[0];
-            // Find matching snapshot for this date
-            const snapshot = snapshotsByDate.get(dateKey);
-            if (!snapshot?.total_shares) {
-                core_1.Logger.log.warn('getVaultPnl:snapshotNotFound', `No snapshot found for date ${dateKey}`);
+        Object.values(history ?? {}).forEach((day) => {
+            if (!day.daily_pnl || !day.total_shares)
                 return;
-            }
             // Convert normalized numbers to BigInt using toNormalizedBn's normalized string
-            const dailyPnlNorm = (0, core_1.toNormalizedBn)(dailyPnlPerShare, decimals);
-            const totalSharesNorm = (0, core_1.toNormalizedBn)(snapshot.total_shares, decimals);
+            const dailyPnlNorm = (0, core_1.toNormalizedBn)(day.daily_pnl, decimals);
+            const totalSharesNorm = (0, core_1.toNormalizedBn)(day.total_shares, decimals);
             // Convert normalized strings to BigInt (split, pad fraction, combine) - all inline
             const [dailyWhole = '0', dailyFrac = ''] = dailyPnlNorm.normalized.split('.');
             const dailyPnlPerShareScaled = BigInt(dailyWhole + (dailyFrac || '').padEnd(decimals, '0').slice(0, decimals));
@@ -3520,6 +3505,10 @@ async function getVaultPnl({ vault, options, }) {
             const dayPnlRaw = (dailyPnlPerShareScaled * totalSharesScaled) / BigInt(10 ** decimals);
             totalPnlRaw += dayPnlRaw;
         });
+        // No history (or no PnL in it) prices to zero, so skip the price read.
+        if (totalPnlRaw === BigInt(0)) {
+            return { totalPnl: (0, core_1.toNormalizedBn)(0, decimals), pnlUsd: 0 };
+        }
         // Convert totalPnlRaw (BigInt) to normalized number using toNormalizedBn
         const totalPnl = (0, core_1.toNormalizedBn)(totalPnlRaw, decimals);
         const totalPnlNormalized = Number(totalPnl.normalized);

package/lib/sdk.d.ts

@@ -20178,9 +20178,21 @@ declare type AsArray<T> = T extends readonly unknown[] ? T : never;
                                                                      * Calculate PnL for a vault (vault-level, not user-specific).
                                                                      * Returns the vault's overall profit and loss across all users.
                                                                      *
+                                                                     * Sums, over the vault's whole history, each day's change in assets per share
+                                                                     * times that day's total shares, then prices the result at the receipt
+                                                                     * token's current USD price. The daily history comes from
+                                                                     * `GET /tokenized_vault/{vault}/historical-timeseries`, the replacement for the
+                                                                     * deprecated `load_snapshots` flag on the vault read.
+                                                                     *
+                                                                     * Network: one backend vault read, one timeseries read and one price read.
+                                                                     *
                                                                      * @param vault - Vault contract address
                                                                      * @param options - RPC configuration and service options
-                                                                     * @returns Vault PnL in USD and notional value
+                                                                     * @returns Vault PnL in the deposit asset (`totalPnl`) and in USD (`pnlUsd`).
+                                                                     *   Both are zero for a vault with no recorded history. `pnlUsd` is also zero
+                                                                     *   when the receipt token price cannot be fetched.
+                                                                     * @throws Error when `vault` is missing, is a Stellar vault, is not an
+                                                                     *   address, or the vault or its history cannot be read.
                                                                      */
                                                                     export declare function getVaultPnl({ vault, options, }: {
                                                                         vault: IAddress;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "9.13.0",
+  "version": "9.13.1",
   "main": "lib/index.js",
   "types": "lib/sdk.d.ts",
   "keywords": [