@augustdigital/sdk 9.13.0 → 9.13.2

package/lib/adapters/evm/getters.js

@@ -90,7 +90,7 @@ const getEvmVaultV1 = async (tokenizedVault, options) => {
             return (0, core_1.getSymbol)(provider, vault);
         }
         if (f === 'decimals') {
-            return (0, core_1.getDecimals)(provider, vault);
+            return (0, core_1.getDecimalsOrThrow)(provider, vault, 'getEvmVaultV1');
         }
         return vaultContract[f]();
     }));
@@ -188,7 +188,7 @@ const getEvmVaultV2 = async (tokenizedVault, options) => {
                 return (0, core_1.getSymbol)(provider, receiptAddress, false);
             }
             if (f === 'decimals') {
-                return (0, core_1.getDecimals)(provider, receiptAddress, false);
+                return (0, core_1.getDecimalsOrThrow)(provider, receiptAddress, 'getEvmVaultV2');
             }
             return reciptContract[f]();
         })),

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.2";

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.2';
 //# sourceMappingURL=version.js.map

package/lib/core/helpers/chain-error.js

@@ -467,6 +467,21 @@ const ARGUMENT_FREE_VIEW_SELECTORS = new Set([
     '0x06fdde03', // name()
     '0x18160ddd', // totalSupply()
     exports.LP_TOKEN_ADDRESS_SELECTOR, // lpTokenAddress()
+    // The vault views `getEvmVaultV1` / `getEvmVaultV2` read in one fan-out.
+    // Same caveat as `lpTokenAddress()`: each exists on one vault generation, so
+    // a misrouted vault answers empty deterministically and must still surface
+    // once the bounded retry is spent.
+    '0x38d52e0f', // asset()
+    '0x01e1d114', // totalAssets()
+    '0xd5abeb01', // maxSupply()
+    '0x8bc7e8c4', // withdrawalFee()
+    '0x24e86d67', // lagDuration()
+    '0xe9f2838e', // withdrawalsPaused()
+    '0x60da3e83', // depositsPaused()
+    '0x8ed83271', // maxDepositAmount()
+    '0xcdb1fb2b', // assetsWhitelistAddress()
+    '0x6e07302b', // getTotalAssets()
+    '0xdbd5edc7', // depositCap()
 ]);
 /**
  * Extract the 4-byte selector of the call an ethers `CALL_EXCEPTION` describes.

package/lib/core/helpers/signer.d.ts

@@ -12,9 +12,17 @@ import { type Signer, type Wallet } from 'ethers';
  */
 export declare function isViemWalletClient(signer: any): boolean;
 /**
- * Convert a viem WalletClient to an ethers-compatible Signer
- * Uses the walletClient as a provider and wraps it for ethers compatibility
- * @param walletClient Viem WalletClient from wagmi or viem
+ * Convert a viem WalletClient to an ethers-compatible Signer.
+ *
+ * The account and chain are answered from the client itself, and
+ * transactions, personal messages and EIP-712 typed data are signed through
+ * the client's own `sendTransaction` / `signMessage` / `signTypedData`, so a
+ * local account (for example an embedded wallet built with
+ * `createWalletClient({ account, transport: http() })`) signs locally and
+ * broadcasts the raw transaction. Every other request goes to the client's
+ * transport.
+ *
+ * @param walletClient - Viem WalletClient from wagmi or viem
  * @returns Ethers Signer that can be used with the SDK
  */
 export declare function viemToEthersSigner(walletClient: any): Promise<Signer | Wallet>;

package/lib/core/helpers/signer.js

@@ -26,39 +26,76 @@ function isViemWalletClient(signer) {
         'transport' in signer &&
         typeof signer.writeContract === 'function');
 }
+function toBigInt(value) {
+    return value == null ? undefined : BigInt(value);
+}
+function toViemTransaction(tx) {
+    return {
+        to: tx.to ?? undefined,
+        data: tx.data,
+        accessList: tx.accessList,
+        value: toBigInt(tx.value),
+        gas: toBigInt(tx.gas),
+        gasPrice: toBigInt(tx.gasPrice),
+        maxFeePerGas: toBigInt(tx.maxFeePerGas),
+        maxPriorityFeePerGas: toBigInt(tx.maxPriorityFeePerGas),
+        nonce: tx.nonce == null ? undefined : Number(tx.nonce),
+    };
+}
 /**
- * Convert a viem WalletClient to an ethers-compatible Signer
- * Uses the walletClient as a provider and wraps it for ethers compatibility
- * @param walletClient Viem WalletClient from wagmi or viem
+ * Convert a viem WalletClient to an ethers-compatible Signer.
+ *
+ * The account and chain are answered from the client itself, and
+ * transactions, personal messages and EIP-712 typed data are signed through
+ * the client's own `sendTransaction` / `signMessage` / `signTypedData`, so a
+ * local account (for example an embedded wallet built with
+ * `createWalletClient({ account, transport: http() })`) signs locally and
+ * broadcasts the raw transaction. Every other request goes to the client's
+ * transport.
+ *
+ * @param walletClient - Viem WalletClient from wagmi or viem
  * @returns Ethers Signer that can be used with the SDK
  */
 async function viemToEthersSigner(walletClient) {
     if (!walletClient) {
         throw new Error('WalletClient is required');
     }
-    // Create an EIP-1193 provider from the wallet client
     const { account, chain, transport } = walletClient;
     if (!account) {
         throw new Error('WalletClient must have an account');
     }
-    // Create a custom transport that uses the walletClient
     const provider = new ethers_1.BrowserProvider({
-        request: async ({ method, params }) => {
-            // Use the wallet client's transport for all requests
-            if (method === 'eth_sendTransaction') {
-                // For transactions, use writeContract or sendTransaction
-                const [tx] = params;
-                return walletClient.sendTransaction({
-                    ...tx,
-                    account,
-                    chain,
-                });
+        request: async ({ method, params = [] }) => {
+            switch (method) {
+                case 'eth_accounts':
+                case 'eth_requestAccounts':
+                    return [account.address];
+                case 'eth_chainId':
+                    if (chain)
+                        return (0, ethers_1.toQuantity)(chain.id);
+                    break;
+                case 'eth_sendTransaction':
+                    return walletClient.sendTransaction({
+                        ...toViemTransaction(params[0]),
+                        account,
+                        chain,
+                    });
+                case 'personal_sign':
+                    return walletClient.signMessage({
+                        account,
+                        message: { raw: params[0] },
+                    });
+                case 'eth_signTypedData_v4':
+                    return walletClient.signTypedData({
+                        account,
+                        ...(typeof params[1] === 'string'
+                            ? JSON.parse(params[1])
+                            : params[1]),
+                    });
             }
-            // For all other requests, use the transport directly
-            return transport({ chain }).request({ method, params });
+            return transport.request({ method, params });
         },
     }, chain?.id);
-    // Get the signer from the provider
     return provider.getSigner(account.address);
 }
 /**

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

@@ -169,7 +169,11 @@ async function getVault({ vault, loans = false, allocations = false, options, lo
         }
     }
     catch (err) {
-        core_1.Logger.log.error('getVault', err, { vault });
+        // A provider fault (rate limit, socket reset, an empty response to one of
+        // the vault's argument-free views) is not an SDK or caller defect: the
+        // caller sees the same throw either way, so it is recorded as a breadcrumb
+        // rather than a billed Sentry issue. Everything else stays at error.
+        (0, core_1.logChainError)('getVault', err, (0, core_1.isRetryableRpcError)(err) || (0, core_1.isEmptyViewResponse)(err), { vault });
         throw new Error(`#getVault::${vault}: ${err?.message}`);
     }
     // Loans enrichment stays EVM-only — there is no non-EVM loan book to read.
@@ -1625,7 +1629,7 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, o
                 // get vault metadata and balance based on version
                 let bal = BigInt(0);
                 if (version === 'evm-2') {
-                    const receiptAddress = await (0, core_1.getReceiptTokenAddress)(provider, vault);
+                    const receiptAddress = await (0, core_1.getReceiptTokenAddress)(provider, v.address);
                     decimals = await (0, core_1.getDecimals)(provider, receiptAddress, false);
                     if (wallet && (0, ethers_1.isAddress)(wallet)) {
                         if (typeof prefetched?.balance === 'bigint') {
@@ -1642,7 +1646,7 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, o
                     }
                 }
                 else {
-                    decimals = await (0, core_1.getDecimals)(provider, vault);
+                    decimals = await (0, core_1.getDecimals)(provider, v.address);
                     if (wallet && (0, ethers_1.isAddress)(wallet)) {
                         bal =
                             typeof prefetched?.balance === 'bigint'
@@ -1675,7 +1679,7 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, o
                 const aggregateAvailableRedemptions = availableRedemptions.reduce((acc, curr) => acc + BigInt(curr.amount.raw), BigInt(0));
                 // return obj
                 return {
-                    vault,
+                    vault: v.address,
                     status: renderStatus(availableRedemptions, balance),
                     availableRedemptions,
                     pendingRedemptions,
@@ -1686,7 +1690,7 @@ async function getVaultPositions({ vault, wallet, solanaWallet, stellarWallet, o
             catch (vaultError) {
                 core_1.Logger.log.error(`getVaultPositions`, `Error processing vault ${v.address}: ${vaultError}`);
                 return {
-                    vault,
+                    vault: v.address,
                     status: 'PENDING',
                     availableRedemptions: [],
                     pendingRedemptions: [],
@@ -3445,9 +3449,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 +3472,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 +3509,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;
@@ -29773,9 +29785,17 @@ declare type AsArray<T> = T extends readonly unknown[] ? T : never;
                                                                                                                  export declare function verifyInfuraKey(key: string): Promise<boolean>;
 
                                                                                                                  /**
-                                                                                                                  * Convert a viem WalletClient to an ethers-compatible Signer
-                                                                                                                  * Uses the walletClient as a provider and wraps it for ethers compatibility
-                                                                                                                  * @param walletClient Viem WalletClient from wagmi or viem
+                                                                                                                  * Convert a viem WalletClient to an ethers-compatible Signer.
+                                                                                                                  *
+                                                                                                                  * The account and chain are answered from the client itself, and
+                                                                                                                  * transactions, personal messages and EIP-712 typed data are signed through
+                                                                                                                  * the client's own `sendTransaction` / `signMessage` / `signTypedData`, so a
+                                                                                                                  * local account (for example an embedded wallet built with
+                                                                                                                  * `createWalletClient({ account, transport: http() })`) signs locally and
+                                                                                                                  * broadcasts the raw transaction. Every other request goes to the client's
+                                                                                                                  * transport.
+                                                                                                                  *
+                                                                                                                  * @param walletClient - Viem WalletClient from wagmi or viem
                                                                                                                   * @returns Ethers Signer that can be used with the SDK
                                                                                                                   */
                                                                                                                  export declare function viemToEthersSigner(walletClient: any): Promise<Signer | Wallet>;

package/package.json

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