@augustdigital/sdk 8.6.1 → 8.7.0

package/lib/adapters/evm/index.d.ts

@@ -1,5 +1,5 @@
 import { type IContractWriteOptions, type INativeDepositOptions, type ApproveResult } from '../../modules/vaults/write.actions';
-import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions } from '../../types';
+import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions, ISwapRouterDepositOptions } from '../../types';
 import { type IPreviewDepositOptions, type IPreviewRedeemOptions, type IAllowanceOptions, type IBalanceOfOptions, type IMaxDepositOptions } from '../../modules/vaults/read.actions';
 import { type CompatibleSigner } from '../../core/helpers/signer';
 import type { IAddress } from '../../types';
@@ -191,6 +191,29 @@ declare class EVMAdapter {
      * @returns The transaction hash of the `depositNativeToken` call.
      */
     depositNativeViaSwapRouter(options: ISwapRouterNativeDepositOptions): Promise<string>;
+    /**
+     * Deposit into a vault through the on-chain `SwapRouter`, choosing the router
+     * path from `depositAsset` (direct deposit, native wrap, or a swap to the
+     * reference asset). The high-level, explicit counterpart to the SwapRouter
+     * branch inside {@link vaultDeposit} — the caller opts into the router
+     * deliberately, so a native-deposit vault is never accidentally swapped.
+     *
+     * Reads the vault's reference asset + decimals on-chain, resolves the swap
+     * quote and fail-closes on aggregator/whitelist drift, and sends the ERC-20
+     * approval to the SwapRouter when allowance is short.
+     *
+     * @param options - {@link ISwapRouterDepositOptions}.
+     * @returns The transaction hash of the router deposit call.
+     * @throws AugustValidationError on unsupported chain, invalid address, zero
+     *   amount, a native deposit into a non-wrapped-native vault, or quote drift.
+     * @example
+     * ```ts
+     * const hash = await augustSdk.evm.swapRouterDeposit({
+     *   chainId: 1, vault, depositAsset: USDT, amount: '100', slippageBps: 50,
+     * });
+     * ```
+     */
+    swapRouterDeposit(options: ISwapRouterDepositOptions): Promise<string>;
     /**
      * Claim assets from a matured redemption request on a dated-redemption
      * (RWA-style) vault. The `year`, `month`, `day`, and `receiverIndex` tuple

package/lib/adapters/evm/index.js

@@ -251,6 +251,32 @@ class EVMAdapter {
         const signer = await this.getSigner();
         return (0, write_actions_1.depositNativeViaSwapRouter)(signer, options);
     }
+    /**
+     * Deposit into a vault through the on-chain `SwapRouter`, choosing the router
+     * path from `depositAsset` (direct deposit, native wrap, or a swap to the
+     * reference asset). The high-level, explicit counterpart to the SwapRouter
+     * branch inside {@link vaultDeposit} — the caller opts into the router
+     * deliberately, so a native-deposit vault is never accidentally swapped.
+     *
+     * Reads the vault's reference asset + decimals on-chain, resolves the swap
+     * quote and fail-closes on aggregator/whitelist drift, and sends the ERC-20
+     * approval to the SwapRouter when allowance is short.
+     *
+     * @param options - {@link ISwapRouterDepositOptions}.
+     * @returns The transaction hash of the router deposit call.
+     * @throws AugustValidationError on unsupported chain, invalid address, zero
+     *   amount, a native deposit into a non-wrapped-native vault, or quote drift.
+     * @example
+     * ```ts
+     * const hash = await augustSdk.evm.swapRouterDeposit({
+     *   chainId: 1, vault, depositAsset: USDT, amount: '100', slippageBps: 50,
+     * });
+     * ```
+     */
+    async swapRouterDeposit(options) {
+        const signer = await this.getSigner();
+        return (0, write_actions_1.swapRouterDeposit)(signer, options);
+    }
     /**
      * Claim assets from a matured redemption request on a dated-redemption
      * (RWA-style) vault. The `year`, `month`, `day`, and `receiverIndex` tuple

package/lib/adapters/solana/vault.actions.d.ts

@@ -2,6 +2,24 @@ import { type web3 } from '@coral-xyz/anchor';
 import { type Connection, PublicKey, Transaction } from '@solana/web3.js';
 import type { ISolanaConnectionOptions } from './types';
 import type { SendTransactionOptions } from '@solana/wallet-adapter-base';
+/**
+ * Extract a human- and machine-readable reason from a thrown Solana/Anchor
+ * error.
+ *
+ * Anchor's {@link https://github.com/coral-xyz/anchor `ProgramError`} calls
+ * `super()` with no argument, so its `.message` is the empty string by
+ * construction — the real reason lives on `.msg`/`.code` (and `.toString()`).
+ * `AnchorError` puts it on `.error.errorMessage` / `.error.errorCode.number`.
+ * Reading `.message` directly (as this file used to) therefore rendered
+ * `"Solana deposit failed: "` for every recognized on-chain revert — dropping
+ * the numeric code the team needs to tell "Vault is paused" from
+ * "Insufficient amount" from an account-constraint violation.
+ *
+ * When no reason can be extracted, returns an actionable, user-facing fallback
+ * rather than an "unknown error" admission — the raw throwable is still
+ * preserved on the wrapped error's `cause` and in telemetry for diagnosis.
+ */
+export declare function describeSolanaError(e: unknown): string;
 /**
  * Deposit funds into a Solana August vault and mint share tokens.
  *

package/lib/adapters/solana/vault.actions.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeSolanaError = describeSolanaError;
 exports.handleSolanaDeposit = handleSolanaDeposit;
 exports.handleSolanaRedeem = handleSolanaRedeem;
 const anchor_1 = require("@coral-xyz/anchor");
@@ -8,6 +9,46 @@ const spl_token_1 = require("@solana/spl-token");
 const constants_1 = require("./constants");
 const utils_1 = require("./utils");
 const core_1 = require("../../core");
+/**
+ * User-facing fallback for a throwable that carries no extractable reason.
+ * Surfaces as e.g. `"Solana deposit failed: please try again"` — actionable,
+ * and without telling the user we couldn't classify the failure.
+ */
+const REASONLESS_SOLANA_ERROR = 'please try again';
+/**
+ * Extract a human- and machine-readable reason from a thrown Solana/Anchor
+ * error.
+ *
+ * Anchor's {@link https://github.com/coral-xyz/anchor `ProgramError`} calls
+ * `super()` with no argument, so its `.message` is the empty string by
+ * construction — the real reason lives on `.msg`/`.code` (and `.toString()`).
+ * `AnchorError` puts it on `.error.errorMessage` / `.error.errorCode.number`.
+ * Reading `.message` directly (as this file used to) therefore rendered
+ * `"Solana deposit failed: "` for every recognized on-chain revert — dropping
+ * the numeric code the team needs to tell "Vault is paused" from
+ * "Insufficient amount" from an account-constraint violation.
+ *
+ * When no reason can be extracted, returns an actionable, user-facing fallback
+ * rather than an "unknown error" admission — the raw throwable is still
+ * preserved on the wrapped error's `cause` and in telemetry for diagnosis.
+ */
+function describeSolanaError(e) {
+    if (!(e instanceof Error))
+        return REASONLESS_SOLANA_ERROR;
+    const anchor = e;
+    const reason = anchor.error?.errorMessage ?? anchor.msg ?? '';
+    const code = anchor.error?.errorCode?.number ?? anchor.code;
+    if (reason)
+        return code === undefined ? reason : `${reason} (code ${code})`;
+    // SendTransactionError / generic Error carry a non-empty `.message`.
+    if (e.message)
+        return e.message;
+    // Last resort: a subclass may override `toString()` (never the empty string).
+    const str = e.toString();
+    return str && str !== e.name && str !== `${e.name}: `
+        ? str
+        : REASONLESS_SOLANA_ERROR;
+}
 /**
  * Deposit funds into a Solana August vault and mint share tokens.
  *
@@ -159,7 +200,7 @@ async function handleSolanaDeposit({ provider, connection, network = constants_1
             vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
             depositAmount: depositAmountForLog,
         });
-        throw new core_1.AugustSDKError('UNKNOWN', `Solana deposit failed: ${e instanceof Error ? e.message : 'Unknown error'}`, {
+        throw new core_1.AugustSDKError('UNKNOWN', `Solana deposit failed: ${describeSolanaError(e)}`, {
             cause: e,
             context: {
                 vaultProgramId: String(vaultProgramId),
@@ -325,7 +366,7 @@ async function handleSolanaRedeem({ provider, connection, vaultProgramId, vaultA
             vaultAddress: vaultAddress ? String(vaultAddress) : undefined,
             redeemShares: redeemSharesForLog,
         });
-        throw new core_1.AugustSDKError('UNKNOWN', `Solana redeem failed: ${e instanceof Error ? e.message : 'Unknown error'}`, {
+        throw new core_1.AugustSDKError('UNKNOWN', `Solana redeem failed: ${describeSolanaError(e)}`, {
             cause: e,
             context: {
                 vaultProgramId: String(vaultProgramId),

package/lib/core/analytics/method-taxonomy.js

@@ -26,6 +26,7 @@ exports.METHOD_CATEGORIES = {
     getLatestUnrealizedPnl: 'read.vault',
     getVaultBorrowerHealthFactor: 'read.vault',
     getYieldLastRealizedOn: 'read.vault',
+    getVaultActivity: 'read.vault',
     getVaultPositions: 'read.position',
     getVaultUserHistory: 'read.position',
     getUserHistory: 'read.position',
@@ -82,6 +83,7 @@ exports.METHOD_CATEGORIES = {
     swapAndDeposit: 'write.deposit',
     depositViaSwapRouter: 'write.deposit',
     depositNativeViaSwapRouter: 'write.deposit',
+    swapRouterDeposit: 'write.deposit',
     vaultRedeem: 'write.redeem',
     vaultRequestRedeem: 'write.redeem',
     rwaRedeemAsset: 'write.redeem',

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 = "8.6.1";
+export declare const SDK_VERSION = "8.7.0";

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 = '8.6.1';
+exports.SDK_VERSION = '8.7.0';
 //# sourceMappingURL=version.js.map

package/lib/core/constants/swap-router.d.ts

@@ -9,17 +9,35 @@ import type { IAddress } from '../../types';
  */
 export declare const SWAP_ROUTER_ADDRESSES: Readonly<Record<number, IAddress>>;
 /**
- * Vault addresses registered on a `SwapRouter` via `enableVault`. The
- * presence of a vault here is the signal to route its deposits through the
- * SwapRouter rather than the legacy adapter path.
+ * Vaults whose UI **may offer the any-token SwapRouter deposit surface** —
+ * i.e. the SwapRouter is `enableVault`-ed for them on-chain.
  *
- * Entries mirror the on-chain `vaultInfo[addr].referenceAsset != 0` state of
- * the `SwapRouter` deployment. Verify against the deployed contract before
- * adding a new entry — a vault that is not registered on-chain will revert
- * with `InvalidVault` at deposit time.
+ * This is *eligibility metadata only*. It is consumed by:
+ *  - the app UI, to decide whether to render the (flag-gated) swap-router
+ *    deposit surface for a vault; and
+ *  - {@link swapRouterDeposit}, optionally, as a fail-fast eligibility check.
+ *
+ * It is deliberately **NOT** read by {@link vaultDeposit}: `vaultDeposit` is the
+ * native/multiasset/adapter path and never routes through the SwapRouter. That
+ * separation is what stops a natively-accepted asset from being silently
+ * swapped — the regression that implicit auto-routing caused. Any-token swap
+ * deposits are the explicit, opt-in job of {@link swapRouterDeposit}.
+ *
+ * Membership requires the vault to be registered on-chain
+ * (`vaultInfo[addr].referenceAsset != 0`) — an unregistered vault reverts with
+ * `InvalidVault` at deposit time. A listed vault's natively-accepted assets
+ * (for a multi-asset vault, its whole deposit-asset set) still deposit via
+ * `vaultDeposit`; only tokens OUTSIDE that set go through `swapRouterDeposit`.
  *
  * Lowercase comparison is required when checking — use
- * {@link vaultUsesSwapRouter} rather than reading this set directly.
+ * {@link isSwapRouterEligible} rather than reading this set directly.
+ */
+export declare const SWAP_ROUTER_ELIGIBLE_VAULTS: ReadonlySet<string>;
+/**
+ * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS}, and the semantics
+ * changed: this set no longer drives `vaultDeposit` auto-routing (that branch
+ * was removed) — it now only marks vaults whose UI may offer the swap-router
+ * deposit surface. Kept as an alias for one release; migrate to the new name.
  */
 export declare const VAULTS_USING_SWAP_ROUTER: ReadonlySet<string>;
 /**

package/lib/core/constants/swap-router.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SWAP_ROUTER_DEX_AGGREGATOR = exports.SWAP_ROUTER_WRAPPED_NATIVE = exports.SWAP_ROUTER_MAX_SWAPS = exports.ORIGIN_CODES = exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ADDRESSES = void 0;
+exports.SWAP_ROUTER_DEX_AGGREGATOR = exports.SWAP_ROUTER_WRAPPED_NATIVE = exports.SWAP_ROUTER_MAX_SWAPS = exports.ORIGIN_CODES = exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ELIGIBLE_VAULTS = exports.SWAP_ROUTER_ADDRESSES = void 0;
 /**
  * Address of the `SwapRouter` periphery contract on each supported chain.
  *
@@ -13,26 +13,42 @@ exports.SWAP_ROUTER_ADDRESSES = {
     1: '0xAC771209FF2b71EECfF6E85a9AD01db8Ff2618B0',
 };
 /**
- * Vault addresses registered on a `SwapRouter` via `enableVault`. The
- * presence of a vault here is the signal to route its deposits through the
- * SwapRouter rather than the legacy adapter path.
+ * Vaults whose UI **may offer the any-token SwapRouter deposit surface** —
+ * i.e. the SwapRouter is `enableVault`-ed for them on-chain.
  *
- * Entries mirror the on-chain `vaultInfo[addr].referenceAsset != 0` state of
- * the `SwapRouter` deployment. Verify against the deployed contract before
- * adding a new entry — a vault that is not registered on-chain will revert
- * with `InvalidVault` at deposit time.
+ * This is *eligibility metadata only*. It is consumed by:
+ *  - the app UI, to decide whether to render the (flag-gated) swap-router
+ *    deposit surface for a vault; and
+ *  - {@link swapRouterDeposit}, optionally, as a fail-fast eligibility check.
+ *
+ * It is deliberately **NOT** read by {@link vaultDeposit}: `vaultDeposit` is the
+ * native/multiasset/adapter path and never routes through the SwapRouter. That
+ * separation is what stops a natively-accepted asset from being silently
+ * swapped — the regression that implicit auto-routing caused. Any-token swap
+ * deposits are the explicit, opt-in job of {@link swapRouterDeposit}.
+ *
+ * Membership requires the vault to be registered on-chain
+ * (`vaultInfo[addr].referenceAsset != 0`) — an unregistered vault reverts with
+ * `InvalidVault` at deposit time. A listed vault's natively-accepted assets
+ * (for a multi-asset vault, its whole deposit-asset set) still deposit via
+ * `vaultDeposit`; only tokens OUTSIDE that set go through `swapRouterDeposit`.
  *
  * Lowercase comparison is required when checking — use
- * {@link vaultUsesSwapRouter} rather than reading this set directly.
+ * {@link isSwapRouterEligible} rather than reading this set directly.
  */
-exports.VAULTS_USING_SWAP_ROUTER = new Set([
-    // Upshift Core USDC — ERC-4626 vault, reference asset USDC. Enabled on
-    // the mainnet SwapRouter at vaultType=1 (VAULT_TYPE_ERC4626).
-    '0xe9b725010a9e419412ed67d0fa5f3a5f40159d32',
-    // Sentora USD — Tokenized Vault V2, reference asset USDC. Enabled on the
-    // mainnet SwapRouter at vaultType=2 (VAULT_TYPE_TOKENIZED_VAULT_V2).
+exports.SWAP_ROUTER_ELIGIBLE_VAULTS = new Set([
+    // Sentora USD — native multi-asset Tokenized Vault V2 (reference asset
+    // USDC). Its native assets (USDC/RLUSD/PYUSD/USDT) deposit via vaultDeposit;
+    // the swap-router surface adds deposits of tokens outside that set.
     '0x74ad2f789ed583dbd141bbdafc673fe1f033718b',
 ]);
+/**
+ * @deprecated Renamed to {@link SWAP_ROUTER_ELIGIBLE_VAULTS}, and the semantics
+ * changed: this set no longer drives `vaultDeposit` auto-routing (that branch
+ * was removed) — it now only marks vaults whose UI may offer the swap-router
+ * deposit surface. Kept as an alias for one release; migrate to the new name.
+ */
+exports.VAULTS_USING_SWAP_ROUTER = exports.SWAP_ROUTER_ELIGIBLE_VAULTS;
 /**
  * 32-byte origin codes registered on the `SwapRouter` via `addOrigin`.
  * Drives origin/referral-fee accrual. The on-chain admin must register a

package/lib/core/helpers/swap-router.d.ts

@@ -12,13 +12,25 @@ import type { IAddress } from '../../types';
  */
 export declare function getSwapRouterAddress(chainId: number): IAddress | undefined;
 /**
- * Whether a vault has been registered on a `SwapRouter` and should route
- * its deposits through it. Address comparison is case-insensitive.
+ * Whether a vault is eligible for the any-token `SwapRouter` deposit surface
+ * (the SwapRouter is `enableVault`-ed for it on-chain). Address comparison is
+ * case-insensitive.
+ *
+ * This gates the (flag-controlled) swap-router deposit UI and can fail-fast a
+ * {@link swapRouterDeposit} call. It does **not** affect {@link vaultDeposit},
+ * which is always the native/multiasset/adapter path.
  *
  * @param vaultAddress - August vault address.
- * @returns `true` when the vault is in {@link VAULTS_USING_SWAP_ROUTER}.
+ * @returns `true` when the vault is in {@link SWAP_ROUTER_ELIGIBLE_VAULTS}.
+ */
+export declare function isSwapRouterEligible(vaultAddress: IAddress): boolean;
+/**
+ * @deprecated Renamed to {@link isSwapRouterEligible}. The meaning also changed:
+ * it no longer implies `vaultDeposit` routes the vault through the SwapRouter
+ * (that behavior was removed) — it only reports swap-router *eligibility* for
+ * the opt-in deposit surface. Kept as an alias for one release.
  */
-export declare function vaultUsesSwapRouter(vaultAddress: IAddress): boolean;
+export declare const vaultUsesSwapRouter: typeof isSwapRouterEligible;
 /**
  * Normalize an optional origin code to the value to send on-chain.
  *

package/lib/core/helpers/swap-router.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.vaultUsesSwapRouter = void 0;
 exports.getSwapRouterAddress = getSwapRouterAddress;
-exports.vaultUsesSwapRouter = vaultUsesSwapRouter;
+exports.isSwapRouterEligible = isSwapRouterEligible;
 exports.resolveOriginCode = resolveOriginCode;
 const swap_router_1 = require("../constants/swap-router");
 const errors_1 = require("../errors");
@@ -20,15 +21,27 @@ function getSwapRouterAddress(chainId) {
     return swap_router_1.SWAP_ROUTER_ADDRESSES[chainId];
 }
 /**
- * Whether a vault has been registered on a `SwapRouter` and should route
- * its deposits through it. Address comparison is case-insensitive.
+ * Whether a vault is eligible for the any-token `SwapRouter` deposit surface
+ * (the SwapRouter is `enableVault`-ed for it on-chain). Address comparison is
+ * case-insensitive.
+ *
+ * This gates the (flag-controlled) swap-router deposit UI and can fail-fast a
+ * {@link swapRouterDeposit} call. It does **not** affect {@link vaultDeposit},
+ * which is always the native/multiasset/adapter path.
  *
  * @param vaultAddress - August vault address.
- * @returns `true` when the vault is in {@link VAULTS_USING_SWAP_ROUTER}.
+ * @returns `true` when the vault is in {@link SWAP_ROUTER_ELIGIBLE_VAULTS}.
  */
-function vaultUsesSwapRouter(vaultAddress) {
-    return swap_router_1.VAULTS_USING_SWAP_ROUTER.has(vaultAddress.toLowerCase());
+function isSwapRouterEligible(vaultAddress) {
+    return swap_router_1.SWAP_ROUTER_ELIGIBLE_VAULTS.has(vaultAddress.toLowerCase());
 }
+/**
+ * @deprecated Renamed to {@link isSwapRouterEligible}. The meaning also changed:
+ * it no longer implies `vaultDeposit` routes the vault through the SwapRouter
+ * (that behavior was removed) — it only reports swap-router *eligibility* for
+ * the opt-in deposit surface. Kept as an alias for one release.
+ */
+exports.vaultUsesSwapRouter = isSwapRouterEligible;
 /**
  * Normalize an optional origin code to the value to send on-chain.
  *

package/lib/main.d.ts

@@ -253,6 +253,32 @@ export declare class AugustSDK extends AugustBase {
         timestamp: number;
         transactionHash: string;
     }[]>;
+    /**
+     * Get a vault's deposit/withdrawal activity across every participant.
+     *
+     * The vault-wide counterpart to {@link AugustSDK.getVaultUserHistory} — use
+     * it to answer flow questions ("how many deposits in the last 7 days", "net
+     * flow this week") that point-in-time TVL cannot. Reads from the Goldsky
+     * subgraph, paginated so busy vaults are not truncated; a `sinceTs` window
+     * keeps short lookbacks cheap.
+     * @param props - Vault address, optional chain id, optional `sinceTs`/`untilTs`
+     * Unix-second bounds, and an optional `types` filter.
+     * @returns Array of activity items (oldest-first) with normalized amounts,
+     * actor addresses, event type, and transaction hashes.
+     * @throws If `vault` is not a valid address or no chain id can be resolved.
+     * @example
+     * ```ts
+     * const weekAgo = Math.floor(Date.now() / 1000) - 7 * 86_400;
+     * const items = await sdk.getVaultActivity({ vault, chainId: 143, sinceTs: weekAgo });
+     * ```
+     */
+    getVaultActivity(props: {
+        vault: IAddress;
+        chainId?: IChainId;
+        sinceTs?: number;
+        untilTs?: number;
+        types?: ('withdraw-request' | 'deposit' | 'withdraw-processed' | 'redeem')[];
+    }): Promise<import("./types").IVaultUserHistoryItem[]>;
     /**
      * Get lifetime PnL for a user in a specific vault.
      * Calculates realized and unrealized PnL based on deposit/withdrawal history and current position.

package/lib/main.js

@@ -316,6 +316,28 @@ class AugustSDK extends core_1.AugustBase {
     async getVaultUserTransfers(props) {
         return await this.vaults.getUserTransfers(props);
     }
+    /**
+     * Get a vault's deposit/withdrawal activity across every participant.
+     *
+     * The vault-wide counterpart to {@link AugustSDK.getVaultUserHistory} — use
+     * it to answer flow questions ("how many deposits in the last 7 days", "net
+     * flow this week") that point-in-time TVL cannot. Reads from the Goldsky
+     * subgraph, paginated so busy vaults are not truncated; a `sinceTs` window
+     * keeps short lookbacks cheap.
+     * @param props - Vault address, optional chain id, optional `sinceTs`/`untilTs`
+     * Unix-second bounds, and an optional `types` filter.
+     * @returns Array of activity items (oldest-first) with normalized amounts,
+     * actor addresses, event type, and transaction hashes.
+     * @throws If `vault` is not a valid address or no chain id can be resolved.
+     * @example
+     * ```ts
+     * const weekAgo = Math.floor(Date.now() / 1000) - 7 * 86_400;
+     * const items = await sdk.getVaultActivity({ vault, chainId: 143, sinceTs: weekAgo });
+     * ```
+     */
+    async getVaultActivity(props) {
+        return await this.vaults.getVaultActivity(props);
+    }
     /**
      * Get lifetime PnL for a user in a specific vault.
      * Calculates realized and unrealized PnL based on deposit/withdrawal history and current position.

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

@@ -254,6 +254,52 @@ export declare class AugustVaults extends AugustBase {
         timestamp: number;
         transactionHash: string;
     }[]>;
+    /**
+     * Fetch a vault's deposit/withdrawal activity across every participant.
+     *
+     * This is the vault-wide counterpart to {@link getUserHistory}: instead of
+     * filtering the subgraph to one wallet, it returns every deposit,
+     * withdrawal-request, and processed-withdrawal event for the pool. Use it to
+     * answer flow questions ("how many deposits in the last 7 days", "net flow
+     * this week") that point-in-time TVL cannot.
+     *
+     * Rows are read from the Goldsky subgraph, paginated internally so busy
+     * vaults are not truncated at the 1000-row page cap. When `sinceTs` is
+     * supplied the reader stops paging once it passes the window boundary, so a
+     * short lookback stays cheap even on high-volume vaults.
+     *
+     * @param params - Query parameters.
+     * @param params.vault - Vault (pool) address to read activity for.
+     * @param params.chainId - Chain id of the vault; falls back to the active
+     * network when omitted. Required for the subgraph lookup.
+     * @param params.sinceTs - Lower bound (inclusive) as a Unix timestamp in
+     * seconds. Events at or after this time are returned.
+     * @param params.untilTs - Upper bound (inclusive) as a Unix timestamp in
+     * seconds. Events at or before this time are returned.
+     * @param params.types - Restrict to a subset of event types (e.g.
+     * `['deposit']`). Returns all types when omitted.
+     * @returns Activity items sorted oldest-first, each with a normalized
+     * `amount`, actor `address`, `type`, and `transactionHash`.
+     * @throws If `vault` is not a valid address, or no chain id can be resolved.
+     * @example
+     * ```ts
+     * const weekAgo = Math.floor(Date.now() / 1000) - 7 * 86_400;
+     * const deposits = await sdk.getVaultActivity({
+     *   vault: '0x36eDbF0C834591BFdfCaC0Ef9605528c75c406aA',
+     *   chainId: 143,
+     *   sinceTs: weekAgo,
+     *   types: ['deposit'],
+     * });
+     * console.log(`${deposits.length} deposits in the last 7 days`);
+     * ```
+     */
+    getVaultActivity({ vault, chainId, sinceTs, untilTs, types, }: {
+        vault: IAddress;
+        chainId?: IChainId;
+        sinceTs?: number;
+        untilTs?: number;
+        types?: IVaultUserHistoryItem['type'][];
+    }): Promise<IVaultUserHistoryItem[]>;
     /**
      * @function getStakingPositions gets all available reward staking positions
      * @param wallet optionally passed user wallet address

package/lib/modules/vaults/main.js

@@ -905,6 +905,77 @@ class AugustVaults extends core_1.AugustBase {
         core_1.Logger.log.info('getUserTransfers', `${wallet}::${finalArray.length}`);
         return finalArray;
     }
+    /**
+     * Fetch a vault's deposit/withdrawal activity across every participant.
+     *
+     * This is the vault-wide counterpart to {@link getUserHistory}: instead of
+     * filtering the subgraph to one wallet, it returns every deposit,
+     * withdrawal-request, and processed-withdrawal event for the pool. Use it to
+     * answer flow questions ("how many deposits in the last 7 days", "net flow
+     * this week") that point-in-time TVL cannot.
+     *
+     * Rows are read from the Goldsky subgraph, paginated internally so busy
+     * vaults are not truncated at the 1000-row page cap. When `sinceTs` is
+     * supplied the reader stops paging once it passes the window boundary, so a
+     * short lookback stays cheap even on high-volume vaults.
+     *
+     * @param params - Query parameters.
+     * @param params.vault - Vault (pool) address to read activity for.
+     * @param params.chainId - Chain id of the vault; falls back to the active
+     * network when omitted. Required for the subgraph lookup.
+     * @param params.sinceTs - Lower bound (inclusive) as a Unix timestamp in
+     * seconds. Events at or after this time are returned.
+     * @param params.untilTs - Upper bound (inclusive) as a Unix timestamp in
+     * seconds. Events at or before this time are returned.
+     * @param params.types - Restrict to a subset of event types (e.g.
+     * `['deposit']`). Returns all types when omitted.
+     * @returns Activity items sorted oldest-first, each with a normalized
+     * `amount`, actor `address`, `type`, and `transactionHash`.
+     * @throws If `vault` is not a valid address, or no chain id can be resolved.
+     * @example
+     * ```ts
+     * const weekAgo = Math.floor(Date.now() / 1000) - 7 * 86_400;
+     * const deposits = await sdk.getVaultActivity({
+     *   vault: '0x36eDbF0C834591BFdfCaC0Ef9605528c75c406aA',
+     *   chainId: 143,
+     *   sinceTs: weekAgo,
+     *   types: ['deposit'],
+     * });
+     * console.log(`${deposits.length} deposits in the last 7 days`);
+     * ```
+     */
+    async getVaultActivity({ vault, chainId, sinceTs, untilTs, types, }) {
+        if (!(0, ethers_1.isAddress)(vault))
+            throw new Error(`Vault parameter is not an address: ${String(vault)}`);
+        const _chainId = chainId || this.activeNetwork?.chainId;
+        if (!_chainId) {
+            throw new Error('Chain ID is required for getVaultActivity. Pass chainId explicitly or configure an active network.');
+        }
+        const provider = (0, core_1.createProvider)(this.providers?.[_chainId]);
+        const raw = await (0, vaults_1.getSubgraphVaultHistory)(provider, vault, undefined, {
+            sinceTs,
+        });
+        const typeFilter = types?.length ? new Set(types) : undefined;
+        return raw
+            .map((h) => ({
+            timestamp: Number(h.timestamp_),
+            address: h.address,
+            amount: (0, core_1.toNormalizedBn)(BigInt(h.amount), h.decimals),
+            pool: h.contractId_,
+            chainId: _chainId,
+            type: h.type,
+            transactionHash: h.transactionHash_,
+        }))
+            .filter((h) => {
+            if (sinceTs !== undefined && h.timestamp < sinceTs)
+                return false;
+            if (untilTs !== undefined && h.timestamp > untilTs)
+                return false;
+            if (typeFilter && !typeFilter.has(h.type))
+                return false;
+            return true;
+        });
+    }
     /**
      * @function getStakingPositions gets all available reward staking positions
      * @param wallet optionally passed user wallet address

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

@@ -1,6 +1,6 @@
 import { type Signer, type Wallet, type TransactionResponse } from 'ethers';
 import type { IAddress } from '../../types';
-import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions } from '../../types';
+import type { ISwapAndDepositOptions, ISwapRouterDirectDepositOptions, ISwapRouterNativeDepositOptions, ISwapRouterDepositOptions } from '../../types';
 export type IContractWriteOptions = {
     target: IAddress;
     wallet: IAddress;
@@ -76,7 +76,6 @@ export declare function resolveSpender(args: {
     isMultiAssetVault: boolean;
     isAdapterDeposit: boolean;
     adapterWrapperAddress?: IAddress;
-    swapRouterAddress?: IAddress;
 }): IAddress;
 /** @internal */
 export declare function validateAmountPrecision(amount: string | bigint | number): void;
@@ -438,3 +437,53 @@ export declare function depositViaSwapRouter(signer: Signer | Wallet, options: I
  * addresses, or zero amount.
  */
 export declare function depositNativeViaSwapRouter(signer: Signer | Wallet, options: ISwapRouterNativeDepositOptions): Promise<string>;
+/**
+ * Deposit into an August vault through the on-chain `SwapRouter`, selecting the
+ * correct router path from the deposit asset. This is the high-level, explicit
+ * counterpart to the SwapRouter branch inside {@link vaultDeposit}.
+ *
+ * Where `vaultDeposit` decides whether to use the SwapRouter from the
+ * `VAULTS_USING_SWAP_ROUTER` allowlist, this function always routes through the
+ * SwapRouter because the caller asked it to. Making the intent explicit is the
+ * point: a native-deposit vault (e.g. a multi-asset Tokenized Vault V2 whose
+ * non-reference assets are accepted directly) is never accidentally swapped —
+ * the regression that implicit, allowlist-driven routing caused. Use
+ * `vaultDeposit` for native / adapter deposits and this for SwapRouter deposits.
+ *
+ * The vault's reference asset and its decimals are read on-chain (never trusted
+ * from the caller — a wrong reference asset would mis-route the swap). The path
+ * is then chosen from `depositAsset`:
+ *  - equals the reference asset → direct router deposit, no swap
+ *    ({@link depositViaSwapRouter});
+ *  - the zero address → native-token deposit ({@link depositNativeViaSwapRouter}),
+ *    valid only when the reference asset is the chain's wrapped-native token;
+ *  - any other ERC-20 → a swap to the reference asset (Paraswap quote pinned to
+ *    the chain's whitelisted aggregator, fail-closed on router/selector drift)
+ *    bundled into {@link swapAndDeposit}.
+ *
+ * Side effects: reads tokenized-vault metadata, the vault's reference asset and
+ * decimals, and (on the swap path) one Paraswap quote; sends one ERC-20
+ * `approve` to the SwapRouter when allowance is short, then the deposit tx.
+ *
+ * @param signer - ethers `Signer` or `Wallet` that signs the approval + deposit.
+ * @param options - {@link ISwapRouterDepositOptions}.
+ * @returns The transaction hash of the router deposit call.
+ * @throws {@link AugustValidationError} for an unsupported chain (no SwapRouter
+ *   deployment), an invalid vault or deposit-asset address, a missing or zero
+ *   amount, a native deposit into a non-wrapped-native vault, or drift between
+ *   the aggregator quote and the on-chain router whitelist.
+ * @worstCaseRpcCalls 5 on the swap path — tokenized-vault metadata, reference
+ *   asset + decimals, deposit-token decimals, the quote, and the allowance read.
+ * @example
+ * ```ts
+ * // USDT deposited into a USDC-reference vault → swapped to USDC en route.
+ * const hash = await augustSdk.evm.swapRouterDeposit({
+ *   chainId: 1,
+ *   vault: '0xe9b725010a9e419412ed67d0fa5f3a5f40159d32',
+ *   depositAsset: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
+ *   amount: '100',
+ *   slippageBps: 50,
+ * });
+ * ```
+ */
+export declare function swapRouterDeposit(signer: Signer | Wallet, options: ISwapRouterDepositOptions): Promise<string>;