@augustdigital/sdk 8.5.0 → 8.6.0

package/lib/modules/vaults/getters.js

@@ -103,10 +103,10 @@ const redeems_1 = require("../../services/layerzero/redeems");
  * Fetch comprehensive vault data including on-chain state and backend metadata.
  * Routes to appropriate chain adapter (EVM v1/v2, Solana, or Stellar) based on vault version.
  * Optionally enriches with loan and allocation data.
- * @param vault Vault contract address (EVM hex, Stellar C-address, or Solana program ID)
- * @param loans Include active loan data
- * @param allocations Include DeFi/CeFi allocation breakdowns
- * @param options RPC and service configuration
+ * @param vault - Vault contract address (EVM hex, Stellar C-address, or Solana program ID)
+ * @param loans - Include active loan data
+ * @param allocations - Include DeFi/CeFi allocation breakdowns
+ * @param options - RPC and service configuration
  * @returns Complete vault object with optional enrichments
  */
 async function getVault({ vault, loans = false, allocations = false, options, loadSubaccounts, loadSnapshots, }) {
@@ -355,8 +355,8 @@ async function getVaultSubaccountLoans(vault, options) {
  * Fetch comprehensive vault asset allocation breakdown.
  * Includes DeFi protocols (via DeBank), CeFi balances, OTC positions, and loans.
  * Categorizes exposures by borrowing, supplying, lending, and wallet holdings.
- * @param vault Vault address
- * @param options RPC configuration
+ * @param vault - Vault address
+ * @param options - RPC configuration
  * @returns Detailed allocation data with exposure categorization
  */
 async function getVaultAllocations(vault, options) {
@@ -604,9 +604,9 @@ async function getVaultAvailableRedemptions({ vault, wallet, options, }) {
                 core_1.Logger.log.warn('getVaultAvailableRedemptions', `Skipping invalid event: ${ev}`);
                 continue;
             }
-            let month;
-            let day;
-            let year;
+            let month = 0;
+            let day = 0;
+            let year = 0;
             if (version === 'evm-2') {
                 // Use UTC-based computeClaimableDate to mirror contract logic exactly
                 const claimable = (0, date_utils_1.computeClaimableDate)(Number(ev.timestamp_), lagDuration);
@@ -931,11 +931,12 @@ async function getVaultRedemptionHistory({ vault, wallet, lookbackBlocks, option
         if (isV2 && logs.length > 0) {
             const uniqueBlocks = [...new Set(logs.map((l) => l.blockNumber))];
             const blockResults = await Promise.all(uniqueBlocks.map((bn) => provider.getBlock(bn)));
-            blockTimestamps = new Map();
+            const timestamps = new Map();
             blockResults.forEach((block) => {
                 if (block)
-                    blockTimestamps.set(block.number, block.timestamp);
+                    timestamps.set(block.number, block.timestamp);
             });
+            blockTimestamps = timestamps;
         }
         // format — iterate logs directly to preserve transactionHash
         const redemptions = [];
@@ -1190,7 +1191,7 @@ async function getVaultApy({ vault, options, historical, }) {
                 const query = urlParams.toString();
                 if (!query)
                     return '';
-                return baseUrl && baseUrl.includes('?') ? `&${query}` : `?${query}`;
+                return baseUrl?.includes('?') ? `&${query}` : `?${query}`;
             }
             const baseUrl = core_1.WEBSERVER_ENDPOINTS.public.tokenizedVault.historicalApy(vault);
             const historicalApy = await (0, core_1.fetchAugustPublic)(`${baseUrl}${paramBuilder(historical, baseUrl)}`, {
@@ -1357,15 +1358,15 @@ async function getVaultTvl({ vault, options, historical, }) {
                 case 'evm-2': {
                     const receiptTokenAddress = await (0, core_1.getReceiptTokenAddress)(provider, vault);
                     const receiptTokenDecimals = await (0, core_1.getDecimals)(provider, receiptTokenAddress, false);
-                    const receiptTokenContract = (0, core_1.createContract)({
-                        address: receiptTokenAddress,
-                        abi: TokenizedVaultV2Receipt_1.ABI_TOKENIZED_VAULT_V2_RECEIPT,
+                    const vaultContract = (0, core_1.createContract)({
+                        address: vault,
+                        abi: TokenizedVaultV2_1.ABI_TOKENIZED_VAULT_V2,
                         provider,
                     });
-                    const totalSupply = await receiptTokenContract.totalSupply();
+                    const totalAssets = await vaultContract.getTotalAssets();
                     return [
                         {
-                            value: (0, core_1.toNormalizedBn)(totalSupply, receiptTokenDecimals),
+                            value: (0, core_1.toNormalizedBn)(totalAssets, receiptTokenDecimals),
                             timestamp: new Date().toISOString(),
                         },
                     ];
@@ -1377,10 +1378,10 @@ async function getVaultTvl({ vault, options, historical, }) {
                         provider,
                     });
                     const decimals = await (0, core_1.getDecimals)(provider, vault);
-                    const totalSupply = await vaultContract.totalSupply();
+                    const totalAssets = await vaultContract.totalAssets();
                     return [
                         {
-                            value: (0, core_1.toNormalizedBn)(totalSupply, decimals),
+                            value: (0, core_1.toNormalizedBn)(totalAssets, decimals),
                             timestamp: new Date().toISOString(),
                         },
                     ];
@@ -1495,8 +1496,8 @@ async function getVaultTvl({ vault, options, historical, }) {
  * `health_factor: undefined` so callers can render an explicit empty state
  * rather than a perpetual loading skeleton.
  *
- * @param vault Vault address to scope the fetch to.
- * @param options Standard vault options — `rpcUrl` must point at `vault`'s chain.
+ * @param vault - Vault address to scope the fetch to.
+ * @param options - Standard vault options — `rpcUrl` must point at `vault`'s chain.
  * @returns Array of `IVaultBorrowerHealthFactor`, one entry per active loan.
  */
 async function getVaultBorrowerHealthFactor({ vault, options, }) {
@@ -1588,8 +1589,8 @@ async function getVaultBorrowerHealthFactor({ vault, options, }) {
  * look up entries without worrying about EIP-55 checksum casing in either the
  * backend response or the caller's input.
  *
- * @param options Standard vault options — `rpcUrl` should match `vault`'s chain.
- * @param vault Optional vault address to scope the fetch to.
+ * @param options - Standard vault options — `rpcUrl` should match `vault`'s chain.
+ * @param vault - Optional vault address to scope the fetch to.
  * @returns Map of lowercased vault address → array of borrower-health-factor rows.
  */
 async function getHealthFactorOfBorrowersByVault({ options, vault, }) {
@@ -1620,8 +1621,8 @@ async function getHealthFactorOfBorrowersByVault({ options, vault, }) {
 /**
  * Fetch user points from the backend API endpoint.
  * This replaces client-side points calculation with server-side processing.
- * @param userAddress User wallet address (EVM or Solana)
- * @param options Request options including headers
+ * @param userAddress - User wallet address (EVM or Solana)
+ * @param options - Request options including headers
  * @returns Points data from the backend API
  */
 async function getUserPoints({ userAddress, options, }) {
@@ -1665,24 +1666,24 @@ async function getUserPoints({ userAddress, options, }) {
  * expires: {expiry}
  * ```
  *
- * @param userAddress EVM wallet address being registered. Must match the
+ * @param userAddress - EVM wallet address being registered. Must match the
  *   signer that produced `signature`. Lowercased before being embedded in
  *   the canonical message.
- * @param referrerAddress Optional EVM address that referred this user.
+ * @param referrerAddress - Optional EVM address that referred this user.
  *   Lowercased when embedded; the literal string `"none"` is used when
  *   absent. Tampering with this field after signing produces 401.
- * @param chainId Chain on which the wallet signed. For smart-contract wallets
+ * @param chainId - Chain on which the wallet signed. For smart-contract wallets
  *   (Safe etc.) this is the chain whose RPC the backend will use to run the
  *   EIP-1271 `isValidSignature` check; for EOAs it still pins the signature
  *   to a chain so it can't be replayed cross-chain. Must be one of the chains
  *   Upshift supports (see backend `SUPPORTED_REGISTRATION_CHAINS`).
- * @param signature `0x`-prefixed hex of the personal_sign signature over
+ * @param signature - `0x`-prefixed hex of the personal_sign signature over
  *   the canonical message. Single-use: replays within ~10 min are rejected.
- * @param nonce Caller-generated random string (8–128 chars). Pair with
+ * @param nonce - Caller-generated random string (8–128 chars). Pair with
  *   `userAddress` to form the single-use key in the backend's nonce store.
- * @param expiry Unix timestamp (seconds). Must be in the future and within
+ * @param expiry - Unix timestamp (seconds). Must be in the future and within
  *   the backend's TTL window (currently 10 min).
- * @param options Request options (headers).
+ * @param options - Request options (headers).
  * @returns Raw `Response` from the backend. 200 on success, 401 for
  *   expired / replayed / mismatched-signer / tampered-referrer, 422 for an
  *   unsupported `chainId`.
@@ -1735,8 +1736,8 @@ async function registerUserForPoints({ userAddress, referrerAddress, chainId, si
 }
 /**
  * Fetch the points leaderboard data.
- * @param params Optional parameters for pagination and sorting
- * @param options Request options including headers
+ * @param params - Optional parameters for pagination and sorting
+ * @param options - Request options including headers
  * @returns Leaderboard response data
  */
 async function fetchPointsLeaderboard({ params, options, }) {
@@ -1764,8 +1765,8 @@ async function fetchPointsLeaderboard({ params, options, }) {
 /**
  * Fetch the timestamp when yield was last realized for a vault.
  * Returns the assetsUpdatedOn timestamp from the vault contract.
- * @param vault Vault contract address
- * @param options RPC configuration
+ * @param vault - Vault contract address
+ * @param options - RPC configuration
  * @returns Timestamp (Unix timestamp in seconds) when yield was last realized
  */
 async function getYieldLastRealizedOn({ vault, options, }) {
@@ -1822,9 +1823,9 @@ async function getYieldLastRealizedOn({ vault, options, }) {
  * 2. Fetch user's current assets (balanceOf * sharePrice via convertToAssets)
  * 3. Calculate PnL = assets withdrawn + current assets - assets deposited
  *
- * @param vault Vault contract address
- * @param wallet User wallet address
- * @param options RPC configuration and service options
+ * @param vault - Vault contract address
+ * @param wallet - User wallet address
+ * @param options - RPC configuration and service options
  * @returns Lifetime PnL data in both native token and USD
  */
 async function getVaultUserLifetimePnl({ vault, wallet, options, }) {
@@ -2196,8 +2197,8 @@ 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.
  *
- * @param vault Vault contract address
- * @param options RPC configuration and service options
+ * @param vault - Vault contract address
+ * @param options - RPC configuration and service options
  * @returns Vault PnL in USD and notional value
  */
 async function getVaultPnl({ vault, options, }) {
@@ -2254,7 +2255,7 @@ async function getVaultPnl({ vault, options, }) {
             const dateKey = dayDate.toISOString().split('T')[0];
             // Find matching snapshot for this date
             const snapshot = snapshotsByDate.get(dateKey);
-            if (!snapshot || !snapshot.total_shares) {
+            if (!snapshot?.total_shares) {
                 core_1.Logger.log.warn('getVaultPnl:snapshotNotFound', `No snapshot found for date ${dateKey}`);
                 return;
             }
@@ -2301,9 +2302,9 @@ async function getVaultPnl({ vault, options, }) {
 /*
  * Fetch historical timeseries data for a vault.
  * Returns TVL, APY, PnL, share price, and other metrics over time.
- * @param vault Vault contract address
- * @param nDays Number of days of historical data (default 30, min 1)
- * @param options Request options including headers
+ * @param vault - Vault contract address
+ * @param nDays - Number of days of historical data (default 30, min 1)
+ * @param options - Request options including headers
  * @returns Historical timeseries data with date string keys
  */
 async function getVaultHistoricalTimeseries({ vault, nDays, options, }) {
@@ -2328,8 +2329,8 @@ async function getVaultHistoricalTimeseries({ vault, nDays, options, }) {
  * These fields will be removed on 2026-01-01.
  * Use `liquidAPY30Day` and `liquidAPY7Day` fields instead.
  *
- * @param vault Vault contract address
- * @param options Request options including headers
+ * @param vault - Vault contract address
+ * @param options - Request options including headers
  * @returns Annualized APY data including liquidity APY
  */
 async function getVaultAnnualizedApy({ vault, options, }) {
@@ -2358,8 +2359,8 @@ async function getVaultAnnualizedApy({ vault, options, }) {
 }
 /**
  * Fetch summary data for a vault (name, type, chain, recent returns).
- * @param vault Vault contract address
- * @param options Request options including headers
+ * @param vault - Vault contract address
+ * @param options - Request options including headers
  * @returns Vault summary data
  */
 async function getVaultSummary({ vault, options, }) {
@@ -2389,9 +2390,9 @@ async function getVaultSummary({ vault, options, }) {
 }
 /**
  * Fetch withdrawal summary and pending queue for a vault.
- * @param vault Vault contract address
- * @param chain Chain identifier (e.g., chain ID as string)
- * @param options Request options including headers
+ * @param vault - Vault contract address
+ * @param chain - Chain identifier (e.g., chain ID as string)
+ * @param options - Request options including headers
  * @returns Withdrawal summary and pending queue
  */
 async function getVaultWithdrawals({ vault, chain, options, }) {
@@ -2424,10 +2425,10 @@ async function getVaultWithdrawals({ vault, chain, options, }) {
 }
 /**
  * Fetch pending redemptions for a vault with liquidity analysis.
- * @param vault Vault contract address
- * @param pastDays Number of past days to include (default 7, min 1, max 30)
- * @param futureDays Number of future days to include (default 14, min 1, max 30)
- * @param options Request options including headers
+ * @param vault - Vault contract address
+ * @param pastDays - Number of past days to include (default 7, min 1, max 30)
+ * @param futureDays - Number of future days to include (default 14, min 1, max 30)
+ * @param options - Request options including headers
  * @returns Pending redemptions grouped by date with liquidity summary
  */
 async function getVaultPendingRedemptions({ vault, pastDays, futureDays, options, }) {
@@ -2499,10 +2500,10 @@ async function getVaultPendingRedemptions({ vault, pastDays, futureDays, options
 }
 /**
  * Preview the amount of assets that would be received for redeeming shares (queued redemption).
- * @param vault Vault contract address
- * @param sharesAmount Amount of shares to redeem (human-readable, raw bigint, or string)
- * @param options RPC configuration
- * @returns The amount of assets as INormalizedNumber { normalized, raw }
+ * @param vault - Vault contract address
+ * @param sharesAmount - Amount of shares to redeem (human-readable, raw bigint, or string)
+ * @param options - RPC configuration
+ * @returns The amount of assets as an INormalizedNumber with `normalized` and `raw` fields
  */
 async function getPreviewRedemption({ vault, sharesAmount, options, }) {
     try {
@@ -2599,13 +2600,13 @@ async function decodeProcessingTransaction(txHash, provider, iface) {
  * - `'ready_to_claim'` — Claimable date has passed (within the lookback window) but no processed event found.
  * - `'pending'` — Claimable date is still in the future.
  *
- * @param params - Query parameters
- * @param params.vault - Vault address to query
- * @param params.receiver - (Optional) Filter by receiver address
- * @param params.lookbackBlocks - (Optional) On-chain log lookback window in blocks.
- *   Defaults to a chain-specific value (e.g. 150,000 for Ethereum, 3,456,000 for Monad).
- *   Increasing this scans more history but requires more RPC calls.
- * @param params.options - Standard vault query options (provider, RPC URL, etc.)
+ * @param params - Query parameters:
+ *   - `vault` — Vault address to query.
+ *   - `receiver` — (Optional) Filter by receiver address.
+ *   - `lookbackBlocks` — (Optional) On-chain log lookback window in blocks.
+ *     Defaults to a chain-specific value (e.g. 150,000 for Ethereum, 3,456,000 for Monad).
+ *     Increasing this scans more history but requires more RPC calls.
+ *   - `options` — Standard vault query options (provider, RPC URL, etc.).
  * @returns Array of withdrawal requests with status and claimable dates
  *
  * @example

package/lib/modules/vaults/main.js

@@ -71,9 +71,11 @@ const read_actions_1 = require("./read.actions");
  * Supports both EVM and Solana vaults with unified interface.
  */
 class AugustVaults extends core_1.AugustBase {
+    solanaService;
+    suiService;
+    headers = null;
     constructor(baseConfig, solana, sui) {
         super(baseConfig);
-        this.headers = null;
         this.solanaService = solana;
         this.suiService = sui || new sui_1.default();
         this.headers = {

package/lib/modules/vaults/read.actions.d.ts

@@ -1,5 +1,5 @@
-import { IAddress, IContractRunner, INormalizedNumber } from '../../types';
-import { IContractWriteOptions } from './write.actions';
+import type { IAddress, IContractRunner, INormalizedNumber } from '../../types';
+import type { IContractWriteOptions } from './write.actions';
 /**
  * Function to fetch instant redemption fee
  * @param signer - signer / provider object

package/lib/modules/vaults/utils/call-data-decoder.d.ts

@@ -4,7 +4,7 @@
  * Decodes transaction calldata to extract which (year, month, day) cluster
  * was processed when a WithdrawalProcessed event was emitted.
  */
-import { ContractTransactionReceipt, Interface } from 'ethers';
+import type { ContractTransactionReceipt, Interface } from 'ethers';
 export interface ProcessingCallData {
     functionName: 'processAllClaimsByDate' | 'claim' | 'unknown';
     year: number;

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

@@ -16,9 +16,18 @@ export declare function walletClientToSigner(walletClient: WalletClient): Promis
  */
 export declare const getRewardMultiplierByTimestamp: (foundPool: IVault, timestamp?: number) => number;
 /**
- * Get the rewards for the vault
- * @param tokenizedVault - The tokenized vault
- * @returns The rewards
+ * Get the rewards for the vault.
+ *
+ * Builds the display-facing rewards summary from the raw tokenized-vault
+ * rewards array. In addition to the legacy `additionalPoints` string list, it
+ * emits `additionalPointsDetailed`, which pairs each label with its
+ * backend-provided `img_url`. Consumers (e.g. the Upshift app) resolve a
+ * reward's logo from this `imgUrl` first, falling back to a bundled asset only
+ * when it is absent — so a newly-added reward with a backend logo (e.g.
+ * "Cores") renders its icon without any client-side keyword mapping.
+ *
+ * @param tokenizedVault - The tokenized vault.
+ * @returns The rewards summary, including `additionalPointsDetailed`.
  */
 export declare function getVaultRewards(tokenizedVault: ITokenizedVault): {
     points: string;
@@ -28,6 +37,13 @@ export declare function getVaultRewards(tokenizedVault: ITokenizedVault): {
         value: number;
     }[];
     additionalPoints: string[];
+    additionalPointsDetailed: {
+        id: string;
+        label: string;
+        text: string;
+        imgUrl: string;
+        multiplier: number;
+    }[];
 };
 /**
  * Get the idle assets for the vault

package/lib/modules/vaults/utils.js

@@ -72,9 +72,34 @@ const getRewardMultiplierByTimestamp = (foundPool, timestamp) => {
 };
 exports.getRewardMultiplierByTimestamp = getRewardMultiplierByTimestamp;
 /**
- * Get the rewards for the vault
- * @param tokenizedVault - The tokenized vault
- * @returns The rewards
+ * Build the human-readable display label for a single reward.
+ *
+ * The format is `"{multiplier}x {text}"`, with the multiplier prefix omitted
+ * when it equals 1 (e.g. `"2x Cores"`, `" Cores"` when multiplier is 1 — the
+ * leading space is preserved to keep `additionalPoints` and the
+ * `additionalPointsDetailed` label in lockstep). This is a display string only;
+ * consumers that need a stable key should join on the reward's `id`
+ * (see {@link IVaultRewardDetail}), not on this label.
+ *
+ * @param reward - The raw tokenized-vault reward.
+ * @returns The display label string.
+ */
+function getRewardLabel(reward) {
+    return `${reward.multiplier !== 1 ? `${reward.multiplier}x` : ''} ${reward.text}`;
+}
+/**
+ * Get the rewards for the vault.
+ *
+ * Builds the display-facing rewards summary from the raw tokenized-vault
+ * rewards array. In addition to the legacy `additionalPoints` string list, it
+ * emits `additionalPointsDetailed`, which pairs each label with its
+ * backend-provided `img_url`. Consumers (e.g. the Upshift app) resolve a
+ * reward's logo from this `imgUrl` first, falling back to a bundled asset only
+ * when it is absent — so a newly-added reward with a backend logo (e.g.
+ * "Cores") renders its icon without any client-side keyword mapping.
+ *
+ * @param tokenizedVault - The tokenized vault.
+ * @returns The rewards summary, including `additionalPointsDetailed`.
  */
 function getVaultRewards(tokenizedVault) {
     const upshiftPointRewards = tokenizedVault.rewards?.filter((r) => r.text === 'Upshift Points');
@@ -91,7 +116,14 @@ function getVaultRewards(tokenizedVault) {
             : '',
         multiplier: latestUpshiftPointMultiplier,
         multipliers: upshiftPointsMultipliers,
-        additionalPoints: tokenizedVault.rewards.map((r) => `${r.multiplier !== 1 ? `${r.multiplier}x` : ''} ${r.text}`),
+        additionalPoints: tokenizedVault.rewards.map(getRewardLabel),
+        additionalPointsDetailed: tokenizedVault.rewards.map((r) => ({
+            id: r.id,
+            label: getRewardLabel(r),
+            text: r.text,
+            imgUrl: r.img_url || null,
+            multiplier: r.multiplier,
+        })),
     };
     return rewards;
 }
@@ -289,6 +321,7 @@ function buildBackendVault(tokenizedVault, overrides) {
             multiplier: 0,
             multipliers: [],
             additionalPoints: [],
+            additionalPointsDetailed: [],
         };
     return {
         operator: '0x',
@@ -313,7 +346,7 @@ function buildBackendVault(tokenizedVault, overrides) {
         reserveTolerance: tokenizedVault.reserve_tolerance || 0,
         // Vault decimals are derived from the receipt token decimals for non-EVM vaults
         decimals: overrides.receipt.decimals,
-        maxSupply: (0, core_1.toNormalizedBn)(1000000000),
+        maxSupply: (0, core_1.toNormalizedBn)(1_000_000_000),
         depositCap: null,
         apy,
         rewards,
@@ -498,7 +531,7 @@ async function buildFormattedVault(provider, tokenizedVault, contractCalls) {
             depositAssets = [...depositAssets, ...extraAssets];
             totalSupply = contractCalls.totalSupply;
             (maxSupply =
-                (0, core_1.toNormalizedBn)(1000000000000)), // @hardcoded: no maxSupply on here
+                (0, core_1.toNormalizedBn)(1_000_000_000_000)), // @hardcoded: no maxSupply on here
                 (receipt = {
                     symbol: tokenizedVault.receipt_token_symbol,
                     address: contractCalls.lpTokenAddress,

package/lib/modules/vaults/write.actions.js

@@ -90,7 +90,7 @@ function validateAmountPrecision(amount) {
 }
 // Tries tx.wait() first (preserves replacement detection & revert checks), then falls back to
 // provider.waitForTransaction() for RPCs (e.g. Monad) that return malformed pending tx fields.
-const SAFE_WAIT_TIMEOUT_MS = 120000;
+const SAFE_WAIT_TIMEOUT_MS = 120_000;
 /** @internal */
 function isNonceParsing(error) {
     const code = error?.code;
@@ -1040,6 +1040,22 @@ async function dispatchViaSwapRouter(args) {
         abi: abis_1.ABI_ERC20,
     });
     const underlyingDecimals = Number(await underlyingErc20.decimals());
+    // The on-chain SwapRouter only authorizes a specific (router, selector) pair
+    // per chain (see SWAP_ROUTER_DEX_AGGREGATOR). Pin the aggregator to that
+    // router's single generic method so the calldata selector is deterministic,
+    // then reject any quote that would not match — otherwise the deposit reverts
+    // on-chain with InvalidRouter() / InvalidNotWhitelisted() after the user has
+    // already paid gas.
+    const aggregator = core_1.SWAP_ROUTER_DEX_AGGREGATOR[args.chainId];
+    if (!aggregator) {
+        throw new core_1.AugustValidationError('INVALID_CHAIN', `vaultDeposit (SwapRouter): no DEX aggregator is configured for chainId ${args.chainId}, but a swap is required because the deposit asset (${args.actualDepositAsset}) differs from the vault's reference asset (${args.underlyingAsset}). Deposit the reference asset directly, or add a SWAP_ROUTER_DEX_AGGREGATOR entry once the router is whitelisted on-chain.`, {
+            context: {
+                chainId: args.chainId,
+                depositAsset: args.actualDepositAsset,
+                underlyingAsset: args.underlyingAsset,
+            },
+        });
+    }
     const quote = await (0, swap_quotes_1.fetchSwapQuote)({
         chainId: args.chainId,
         srcToken: args.actualDepositAsset,
@@ -1049,7 +1065,25 @@ async function dispatchViaSwapRouter(args) {
         amount: amountRaw,
         receiver: args.routerAddress,
         slippageBps: args.slippageBps,
+        contractMethod: aggregator.contractMethod,
     });
+    // Fail closed on off-chain/on-chain config drift: if the aggregator's quote
+    // targets a router or selector the deployed SwapRouter has not whitelisted,
+    // the swapAndDeposit call would revert. Surfacing it here turns a wasted gas
+    // burn into an actionable SDK error.
+    const quotedSelector = quote.payload.slice(0, 10).toLowerCase();
+    if (quote.router.toLowerCase() !== aggregator.router.toLowerCase() ||
+        quotedSelector !== aggregator.selector.toLowerCase()) {
+        throw new core_1.AugustValidationError('INVALID_INPUT', `vaultDeposit (SwapRouter): the aggregator quote (router ${quote.router}, selector ${quotedSelector}) does not match the router whitelisted on chain ${args.chainId} (router ${aggregator.router}, selector ${aggregator.selector}); the on-chain SwapRouter would revert. This signals drift between the SDK's SWAP_ROUTER_DEX_AGGREGATOR and the deployed router's enableRouter config.`, {
+            context: {
+                chainId: args.chainId,
+                quotedRouter: quote.router,
+                quotedSelector,
+                expectedRouter: aggregator.router,
+                expectedSelector: aggregator.selector,
+            },
+        });
+    }
     return swapAndDeposit(args.signer, {
         chainId: args.chainId,
         vault: args.target,

package/lib/polyfills.js

@@ -5,8 +5,8 @@ const buffer_1 = require("buffer");
 if (typeof window !== 'undefined' && !window.Buffer) {
     window.Buffer = buffer_1.Buffer;
 }
-// @ts-ignore - Node.js global
-if (typeof global !== 'undefined' && !global.Buffer) {
-    global.Buffer = buffer_1.Buffer;
+const globalRef = globalThis;
+if (typeof globalRef !== 'undefined' && !globalRef.Buffer) {
+    globalRef.Buffer = buffer_1.Buffer;
 }
 //# sourceMappingURL=polyfills.js.map