@augustdigital/sdk 8.6.1 → 8.7.1

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.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 = '8.6.1';
+exports.SDK_VERSION = '8.7.1';
 //# 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/core/helpers/vaults.d.ts

@@ -23,4 +23,26 @@ export declare const SUBGRAPH_POOL_URLS: (apiKey: string, chainId?: number, pool
 } | {
     999: string;
 };
-export declare const getDefaultSubgraphUrl: (network: string, symbol: string) => string;
+/**
+ * Previously fabricated a Goldsky subgraph URL from the chain name and vault
+ * symbol. That guess is unreliable and produced dead endpoints:
+ * - The path segment `/v1/subgraphs/name/goldsky/` is legacy hosted-service
+ *   syntax, not Goldsky's current scheme (cf. {@link SUBGRAPH_VAULT_URLS}).
+ * - The chain name isn't the subgraph slug — ethers reports Citrea's network as
+ *   `unknown`, and mainnet as `mainnet` where the subgraph uses `eth`.
+ * - A vault's symbol isn't its subgraph name — e.g. on-chain `EctUSD` vs the
+ *   deployed `earn-ctusd`.
+ *
+ * A fabricated URL 404s silently, so a missing subgraph reads as "no data"
+ * rather than an error (this masked the Citrea Earn ctUSD outage). Subgraph URLs
+ * must now come from backend vault metadata (`fetchVaultMetadata → subgraph`).
+ * This returns `undefined` so callers hit their existing "Missing Subgraph"
+ * branch (warn + Slack alert) instead of querying a dead endpoint.
+ *
+ * @param _network - Unused. Kept for call-site compatibility.
+ * @param _symbol - Unused. Kept for call-site compatibility.
+ * @returns `undefined` — the SDK no longer guesses subgraph URLs.
+ * @deprecated Resolve subgraph URLs from `fetchVaultMetadata`; do not rely on a
+ *   generated fallback.
+ */
+export declare const getDefaultSubgraphUrl: (_network: string, _symbol: string) => string | undefined;

package/lib/core/helpers/vaults.js

@@ -153,8 +153,30 @@ const SUBGRAPH_POOL_URLS = (apiKey, chainId, pool) => {
     return urls;
 };
 exports.SUBGRAPH_POOL_URLS = SUBGRAPH_POOL_URLS;
-const getDefaultSubgraphUrl = (network, symbol) => {
-    return `${vaults_1.GOLDSKY_BASE_URL}/v1/subgraphs/name/goldsky/august-${network.toLowerCase()}-${symbol}/1.0.0/gn`;
+/**
+ * Previously fabricated a Goldsky subgraph URL from the chain name and vault
+ * symbol. That guess is unreliable and produced dead endpoints:
+ * - The path segment `/v1/subgraphs/name/goldsky/` is legacy hosted-service
+ *   syntax, not Goldsky's current scheme (cf. {@link SUBGRAPH_VAULT_URLS}).
+ * - The chain name isn't the subgraph slug — ethers reports Citrea's network as
+ *   `unknown`, and mainnet as `mainnet` where the subgraph uses `eth`.
+ * - A vault's symbol isn't its subgraph name — e.g. on-chain `EctUSD` vs the
+ *   deployed `earn-ctusd`.
+ *
+ * A fabricated URL 404s silently, so a missing subgraph reads as "no data"
+ * rather than an error (this masked the Citrea Earn ctUSD outage). Subgraph URLs
+ * must now come from backend vault metadata (`fetchVaultMetadata → subgraph`).
+ * This returns `undefined` so callers hit their existing "Missing Subgraph"
+ * branch (warn + Slack alert) instead of querying a dead endpoint.
+ *
+ * @param _network - Unused. Kept for call-site compatibility.
+ * @param _symbol - Unused. Kept for call-site compatibility.
+ * @returns `undefined` — the SDK no longer guesses subgraph URLs.
+ * @deprecated Resolve subgraph URLs from `fetchVaultMetadata`; do not rely on a
+ *   generated fallback.
+ */
+const getDefaultSubgraphUrl = (_network, _symbol) => {
+    return undefined;
 };
 exports.getDefaultSubgraphUrl = getDefaultSubgraphUrl;
 //# sourceMappingURL=vaults.js.map

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