@gauntlet-xyz/sdk 2.3.0 → 2.5.0

package/manifest/vaults.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-07-29",
+  "version": "2026-08-05",
   "vaults": [
     {
       "vaultId": "baseUsdcPrime",
@@ -1534,90 +1534,6 @@
         }
       ]
     },
-    {
-      "vaultId": "junoMxnbPrime",
-      "name": "Juno MXNB Prime",
-      "protocol": "morpho",
-      "strategy": "Prime Lending v2",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 8453,
-          "vaultAddress": "0x08cc279532f159BdB450eBc0bAf6562f585Ded58",
-          "vaultType": "single-depositor",
-          "supplyToken": [
-            {
-              "address": "0xF197FFC28c23E0309B5559e7a166f2c6164C80aA",
-              "symbol": "MXNB",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "vaultId": "tempoPathusdPrime",
-      "name": "Gauntlet pathUSD Prime",
-      "protocol": "morpho",
-      "strategy": "Prime Lending v2",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 4217,
-          "vaultAddress": "0xC609656Ed9ef219c98C8e549bF729144F211f06E",
-          "vaultType": "single-depositor",
-          "supplyToken": [
-            {
-              "address": "0x20C0000000000000000000000000000000000000",
-              "symbol": "pathUSD",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "vaultId": "tempoPathusdFrontier",
-      "name": "Gauntlet pathUSD Frontier",
-      "protocol": "morpho",
-      "strategy": "Frontier Lending v2",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 4217,
-          "vaultAddress": "0xe5235da8Ad839dd2A9De1f1069c89cA3575b5208",
-          "vaultType": "single-depositor",
-          "supplyToken": [
-            {
-              "address": "0x20C0000000000000000000000000000000000000",
-              "symbol": "pathUSD",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "vaultId": "stableUsdtEarn",
-      "name": "Gauntlet USDT StableEarn",
-      "protocol": "morpho",
-      "strategy": "Frontier Lending v2",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 988,
-          "vaultAddress": "0xb7Df8db22A5DBBFA9ebeb94b3910aec6a4f05c08",
-          "vaultType": "single-depositor",
-          "supplyToken": [
-            {
-              "address": "0x779Ded0c9e1022225f8E0630b35a9b54bE713736",
-              "symbol": "USDT0",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
     {
       "vaultId": "gtusda",
       "name": "Gauntlet USD Alpha",
@@ -1830,7 +1746,7 @@
           "chainId": 1,
           "vaultAddress": "0x00000000d8f3d6c5DFeB2D2b5ED2276095f3aF44",
           "vaultType": "multi-depositor",
-          "expirationDays": 64,
+          "expirationDays": 90,
           "supplyToken": [
             {
               "address": "0xc26a6fa2c37b38e549a4a1807543801db684f99c",
@@ -1857,7 +1773,7 @@
           "chainId": 1,
           "vaultAddress": "0x953Ca96b057D5397CE7791C5AE9b5a19b1352341",
           "vaultType": "multi-depositor",
-          "expirationDays": 64,
+          "expirationDays": 90,
           "supplyToken": [
             {
               "address": "0x99e05cdbeac5d91150935c59ff8e9ba9945d6884",
@@ -2117,74 +2033,11 @@
         }
       ]
     },
-    {
-      "vaultId": "lidov3stg",
-      "name": "evstETH Stg",
-      "protocol": "aera",
-      "strategy": "Lido V3 wstETH Leverage",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 1,
-          "vaultAddress": "0x0313C149AB341e8A3695edC472c8723F27379315",
-          "vaultType": "multi-depositor",
-          "supplyToken": [
-            {
-              "address": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
-              "symbol": "wstETH",
-              "decimals": 18
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "vaultId": "pestovault",
-      "name": "PestoVault",
-      "protocol": "aera",
-      "strategy": "Multi-strategy Stablecoin Yield",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 1,
-          "vaultAddress": "0x4D6F5E146f248392228b711162dc585F95daC067",
-          "vaultType": "multi-depositor",
-          "supplyToken": [
-            {
-              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
-              "symbol": "USDC",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "vaultId": "devburrito",
-      "name": "BurritoVault",
-      "protocol": "aera",
-      "strategy": "Multi-strategy Stablecoin Yield",
-      "deployments": [
-        {
-          "chain": "evm",
-          "chainId": 8453,
-          "vaultAddress": "0xE5E6f0e217b1eA3ADE09324b69F5765662b9e061",
-          "vaultType": "multi-depositor",
-          "supplyToken": [
-            {
-              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-              "symbol": "USDC",
-              "decimals": 6
-            }
-          ]
-        }
-      ]
-    },
     {
       "vaultId": "gtlpsnib",
-      "name": "Gauntlet x SecondFi LP Vault",
+      "name": "gtLPSNIB",
       "protocol": "aera",
-      "strategy": "USDC LP Yield",
+      "strategy": "Gauntlet x SecondFi LP Vault",
       "deployments": [
         {
           "chain": "evm",
@@ -2203,9 +2056,9 @@
     },
     {
       "vaultId": "gtlpluia",
-      "name": "Gauntlet x Liquid LP Vault",
+      "name": "gtLPLUIA",
       "protocol": "aera",
-      "strategy": "USDC LP Yield",
+      "strategy": "Gauntlet x Liquid LP Vault",
       "deployments": [
         {
           "chain": "evm",
@@ -2368,6 +2221,111 @@
           ]
         }
       ]
+    },
+    {
+      "vaultId": "stgusdhy",
+      "name": "stgUSDhy",
+      "protocol": "aera",
+      "strategy": "Gauntlet High Yield Staging",
+      "deployments": [
+        {
+          "chain": "evm",
+          "chainId": 1,
+          "vaultAddress": "0x12081d6D2fC9AFe58390FF7B8909c8A31d4F4Ff2",
+          "vaultType": "multi-depositor",
+          "supplyToken": [
+            {
+              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+              "symbol": "USDC",
+              "decimals": 6
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "vaultId": "gtusdhy",
+      "name": "gtUSDhy",
+      "protocol": "aera",
+      "strategy": "Gauntlet High Yield Prod",
+      "deployments": [
+        {
+          "chain": "evm",
+          "chainId": 1,
+          "vaultAddress": "0x15218Fbb0Efc0A3D5D731a242d853fa625532C3D",
+          "vaultType": "multi-depositor",
+          "supplyToken": [
+            {
+              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+              "symbol": "USDC",
+              "decimals": 6
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "vaultId": "gtlooper",
+      "name": "sUSDS Looping Dev",
+      "protocol": "aera",
+      "strategy": "sUSDS Looping",
+      "deployments": [
+        {
+          "chain": "evm",
+          "chainId": 1,
+          "vaultAddress": "0x65bC393D16381b292221A664a783812A89f11DE6",
+          "vaultType": "multi-depositor",
+          "supplyToken": [
+            {
+              "address": "0xdC035D45d973E3EC169d2276DDab16f1e407384F",
+              "symbol": "USDS",
+              "decimals": 18
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "vaultId": "stgskylev",
+      "name": "sUSDS Looping Staging",
+      "protocol": "aera",
+      "strategy": "sUSDS Looping",
+      "deployments": [
+        {
+          "chain": "evm",
+          "chainId": 1,
+          "vaultAddress": "0x8BE13F43F1693F98343bD0C3DB6bE705D57221A3",
+          "vaultType": "multi-depositor",
+          "supplyToken": [
+            {
+              "address": "0xdC035D45d973E3EC169d2276DDab16f1e407384F",
+              "symbol": "USDS",
+              "decimals": 18
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "vaultId": "gtskylooping",
+      "name": "Gauntlet sUSDS Looping",
+      "protocol": "aera",
+      "strategy": "sUSDS Looping",
+      "deployments": [
+        {
+          "chain": "evm",
+          "chainId": 1,
+          "vaultAddress": "0xeA40De595f099cA04695b0Ca105499E50AF77f92",
+          "vaultType": "multi-depositor",
+          "supplyToken": [
+            {
+              "address": "0xdC035D45d973E3EC169d2276DDab16f1e407384F",
+              "symbol": "USDS",
+              "decimals": 18
+            }
+          ]
+        }
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gauntlet-xyz/sdk",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Official Gauntlet SDK for vault deposits, withdrawals, and attribution",
   "license": "MIT",
   "keywords": [

package/src/api/client.ts

@@ -15,6 +15,10 @@ export type VaultDetailResponse = Schemas['VaultDetailResponse'];
 export type VaultTimeseriesResponse = Schemas['VaultTimeseriesResponse'];
 export type VaultTimeseriesPoint = Schemas['VaultTimeseriesPoint'];
 export type VaultMetrics = Schemas['VaultMetrics'];
+export type FeaturedVault = Schemas['FeaturedVault'];
+export type FeaturedVaultsResponse = Schemas['FeaturedVaultsResponse'];
+export type StrategyCard = Schemas['StrategyCard'];
+export type StrategyListResponse = Schemas['StrategyListResponse'];
 export type TvlResponse = Schemas['TvlResponse'];
 export type LatestPriceResponse = Schemas['LatestPriceResponse'];
 export type PriceTimeseriesResponse = Schemas['TimeseriesResponse'];
@@ -42,6 +46,20 @@ export interface TimeWindowOptions extends PageOptions {
 export interface ActivityOptions extends PageOptions {
   /** CAIP-10 vault id (`"{chainId}:{address}"`). Omit for wallet-wide activity. */
   vaultId?: string;
+  /**
+   * Wallet-wide feeds only: include activity in hidden (enabled but unlisted)
+   * vaults alongside visible ones. Activity in disabled vaults is never
+   * returned. Ignored when `vaultId` is set.
+   */
+  includeHidden?: boolean;
+}
+
+export interface PositionsOptions extends PageOptions {
+  /**
+   * Include positions in hidden (enabled but unlisted) vaults alongside
+   * visible ones. Positions in disabled vaults are never returned.
+   */
+  includeHidden?: boolean;
 }
 
 export interface LatestPriceOptions {
@@ -103,6 +121,16 @@ export class GauntletApi {
     return this.get('/v1/vaults', { next: options.next, limit: options.limit });
   }
 
+  /** GET /v1/vaults/featured — admin-curated featured vault cards. */
+  featuredVaults(): Promise<FeaturedVaultsResponse> {
+    return this.get('/v1/vaults/featured');
+  }
+
+  /** GET /v1/strategies — admin-curated strategy cards. */
+  strategies(): Promise<StrategyListResponse> {
+    return this.get('/v1/strategies');
+  }
+
   /** GET /v1/vaults/{vault_id} — one vault with live metrics. `vaultId` is CAIP-10. */
   vault(vaultId: string): Promise<VaultDetailResponse> {
     return this.get(`/v1/vaults/${encodeURIComponent(vaultId)}`);
@@ -122,10 +150,14 @@ export class GauntletApi {
   }
 
   /** GET /v1/users/{wallet}/positions — all of a wallet's indexed positions with PnL. */
-  positions(walletAddress: string, options: PageOptions = {}): Promise<UserAllPositionsResponse> {
+  positions(
+    walletAddress: string,
+    options: PositionsOptions = {}
+  ): Promise<UserAllPositionsResponse> {
     return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/positions`, {
       next: options.next,
       limit: options.limit,
+      include_hidden: options.includeHidden,
     });
   }
 
@@ -150,9 +182,10 @@ export class GauntletApi {
 
   /** GET /v1/users/{wallet}/activity — one page of the wallet's immutable event log. */
   activity(walletAddress: string, options: ActivityOptions = {}): Promise<UserActivityResponse> {
-    const { vaultId, ...page } = options;
+    const { vaultId, includeHidden, ...page } = options;
     return this.get(`/v1/users/${encodeURIComponent(walletAddress)}/activity`, {
       vault_id: vaultId,
+      include_hidden: includeHidden,
       ...page,
     });
   }

package/src/api/generated.ts

@@ -223,7 +223,7 @@ export interface paths {
         };
         /**
          * List Gauntlet-curated vaults
-         * @description Returns identification-only rows for the admin-curated visible vaults, ordered most-recent-first; pass `?include_hidden=true` for every enabled vault (hidden included, disabled never). Use `/{vault_id}` for current metrics, `/{vault_id}/definition` for the full vault definition, `/{vault_id}/timeseries` for history.
+         * @description Returns identification-only rows for the admin-curated visible vaults, ordered most-recent-first; pass `?include_hidden=true` for every enabled vault (hidden included, disabled never). Each row's `group.id` groups deployments of the same logical Admin vault, `group.slug` is its unique public route, and `group.is_primary` identifies its representative. Use `/{vault_id}` for current metrics, `/{vault_id}/definition` for the full vault definition, `/{vault_id}/timeseries` for history.
          *
          *     Cursor-paginated, but the default page size is the cap so most callers don't need to think about it — pass `meta.next_cursor` back as `?next=` only if the result exceeds 1000 vaults.
          */
@@ -245,7 +245,7 @@ export interface paths {
         };
         /**
          * Get current vault metrics
-         * @description Returns the current metrics snapshot for a vault — same metric shape that `/timeseries` emits per point, so this is `current point` and timeseries is `historical points`. The vault's protocol-specific definition (fees, hooks, curator, etc.) lives on `/{vault_id}/definition`.
+         * @description Returns the current metrics snapshot for a vault — same metric shape that `/timeseries` emits per point, so this is `current point` and timeseries is `historical points`. The vault's Admin grouping is included when the deployment is associated. The protocol-specific definition (fees, hooks, curator, etc.) lives on `/{vault_id}/definition`.
          */
         get: operations["get_vault"];
         put?: never;
@@ -398,8 +398,8 @@ export interface components {
             description?: string | null;
             /**
              * @description Curated display name; falls back to the registry id when the
-             *     curator hasn't named the vault yet. `vault_ids` carries the
-             *     stable identifiers.
+             *     curator hasn't named the vault yet. `vault_id` carries the
+             *     stable logical identifier.
              */
             name: string;
             /**
@@ -408,6 +408,8 @@ export interface components {
              *     decide whether to fall back to `description`.
              */
             short_description?: string | null;
+            /** @description Stable public route for the logical vault group. */
+            slug: string;
             /**
              * @description Supply (numeraire) token symbol, from the highest-TVL deployment
              *     that reports one.
@@ -421,6 +423,8 @@ export interface components {
              *     `null` when no deployment carried a usable timestamp.
              */
             updated_at?: string | null;
+            /** @description Stable logical vault id assigned by Admin. */
+            vault_id: string;
             /**
              * @description Per-deployment API vault ids (`{chainId}:{address}`, same order
              *     as `chains`) for `/v1/vaults/{vault_id}` links.
@@ -451,8 +455,8 @@ export interface components {
             timestamp: string;
         };
         /**
-         * @description Envelope for unpaginated list endpoints: `count` but no paging
-         *     fields.
+         * @description Documented metadata for list endpoints; pagination fields are omitted
+         *     by unpaginated responses.
          */
         ListMeta: {
             /**
@@ -460,6 +464,13 @@ export interface components {
              * @description Number of items in this response.
              */
             count: number;
+            /**
+             * Format: int64
+             * @description Page-size cap actually applied to paginated lists.
+             */
+            limit?: number | null;
+            /** @description Set when more pages exist; pass back as `?next=`. */
+            next_cursor?: string | null;
             /** @description Item-scoped failures isolated from an aggregate response. */
             partial_errors?: components["schemas"]["PartialResponseError"][] | null;
             /** Format: date-time */
@@ -571,6 +582,16 @@ export interface components {
             data: components["schemas"]["StrategyCard"][];
             meta: components["schemas"]["ListMeta"];
         };
+        /** @description Curated strategy assignment from the admin registry. */
+        StrategyRef: {
+            /**
+             * @description Strategy label id (`prime_lending`, `earn`, …) — matches
+             *     `/v1/strategies` card ids.
+             */
+            id: string;
+            /** @description Display name (`Prime Lending`). */
+            name: string;
+        };
         TimeseriesMeta: {
             /**
              * Format: int64
@@ -789,9 +810,11 @@ export interface components {
             address: string;
             /** Format: int64 */
             chain_id: number;
+            group?: null | components["schemas"]["VaultGroupRef"];
             metrics: components["schemas"]["VaultMetrics"];
             name: string;
             numeraire_token: components["schemas"]["TokenRef"];
+            strategy?: null | components["schemas"]["StrategyRef"];
             symbol: string;
             vault_id: string;
             vault_type: string;
@@ -800,6 +823,25 @@ export interface components {
             data: components["schemas"]["VaultDetail"];
             meta: components["schemas"]["BasicMeta"];
         };
+        /** @description Admin-curated logical grouping for a deployment-level vault row. */
+        VaultGroupRef: {
+            /** @description Admin-curated deployment date (`YYYY-MM-DD`). */
+            deployment_date?: string | null;
+            /** @description Admin-curated long-form detail-page copy. */
+            description?: string | null;
+            /** @description Stable internal group id from the Admin vault registry (`vlt_176`). */
+            id: string;
+            /** @description Whether this deployment is the group's primary representative. */
+            is_primary: boolean;
+            /** @description Whether performance views should use a stable-denominated basis. */
+            is_stable: boolean;
+            /** @description Unique, curator-managed public route (`stgusda`). */
+            slug: string;
+        };
+        VaultListResponse: {
+            data: components["schemas"]["VaultDetail"][];
+            meta: components["schemas"]["ListMeta"];
+        };
         VaultMetrics: {
             /** Format: double */
             apy_7d?: number | null;
@@ -1255,7 +1297,9 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["VaultListResponse"];
+                };
             };
             /** @description Missing or invalid auth */
             401: {

package/src/api/index.ts

@@ -3,14 +3,19 @@ export type {
   ActivityOptions,
   AmountPair,
   ChainSyncStatus,
+  FeaturedVault,
+  FeaturedVaultsResponse,
   HealthResponse,
   LatestPriceOptions,
   LatestPriceResponse,
   PageOptions,
   PartialResponseError,
+  PositionsOptions,
   PositionTimeseriesPoint,
   PriceTimeseriesOptions,
   PriceTimeseriesResponse,
+  StrategyCard,
+  StrategyListResponse,
   TimeseriesMeta,
   TimeWindowOptions,
   TokenRef,

package/src/errors.ts

@@ -53,7 +53,7 @@ export class UnsupportedDepositModeError extends GauntletSDKError {
   readonly available: string;
 
   constructor(vaultId: string, requested: string, available: string) {
-    super(`Vault "${vaultId}" does not support ${requested} deposits (available: ${available})`);
+    super(`Vault "${vaultId}" does not support ${requested} operations (available: ${available})`);
     this.name = 'UnsupportedDepositModeError';
     this.vaultId = vaultId;
     this.requested = requested;
@@ -73,11 +73,25 @@ export class RpcNotConfiguredError extends GauntletSDKError {
 
 export class AccountRequiredError extends GauntletSDKError {
   constructor() {
-    super('No account specified. Provide a wallet in the client config.');
+    super(
+      'No account specified. Pass the required account, or configure a wallet when building transactions.'
+    );
     this.name = 'AccountRequiredError';
   }
 }
 
+export class AccountMismatchError extends GauntletSDKError {
+  readonly expected: string;
+  readonly received: string;
+
+  constructor(expected: string, received: string) {
+    super(`Account mismatch: expected "${expected}", received "${received}"`);
+    this.name = 'AccountMismatchError';
+    this.expected = expected;
+    this.received = received;
+  }
+}
+
 export class UnsupportedProtocolError extends GauntletSDKError {
   readonly protocol: string;
 
@@ -95,6 +109,22 @@ export class InvalidWithdrawParamsError extends GauntletSDKError {
   }
 }
 
+export type SyncWithdrawBound = 'tokensOut' | 'minTokensOut' | 'unitsIn' | 'maxUnitsIn';
+
+export class InvalidSyncWithdrawBoundError extends GauntletSDKError {
+  readonly bound: SyncWithdrawBound;
+
+  constructor(bound: SyncWithdrawBound) {
+    super(`Sync withdraw cannot submit zero ${bound}; increase the amount or reduce slippage`);
+    this.name = 'InvalidSyncWithdrawBoundError';
+    this.bound = bound;
+  }
+}
+
+export function requireNonZeroSyncWithdrawBound(value: bigint, bound: SyncWithdrawBound) {
+  if (value === 0n) throw new InvalidSyncWithdrawBoundError(bound);
+}
+
 export class UnimplementedFeatureError extends GauntletSDKError {
   readonly feature: string;
 

package/src/evm/abis/priceAndFeeCalculatorV2.ts

@@ -47,6 +47,28 @@ export const priceAndFeeCalculatorV2Abi = [
     outputs: [{ name: 'tokenAmount', internalType: 'uint256', type: 'uint256' }],
     stateMutability: 'view',
   },
+  {
+    type: 'function',
+    inputs: [
+      { name: 'vault', internalType: 'address', type: 'address' },
+      { name: 'token', internalType: 'contract IERC20', type: 'address' },
+      { name: 'tokenAmount', internalType: 'uint256', type: 'uint256' },
+    ],
+    name: 'convertTokenToNumeraire',
+    outputs: [{ name: 'numeraireAmount', internalType: 'uint256', type: 'uint256' }],
+    stateMutability: 'view',
+  },
+  {
+    type: 'function',
+    inputs: [
+      { name: 'vault', internalType: 'address', type: 'address' },
+      { name: 'token', internalType: 'contract IERC20', type: 'address' },
+      { name: 'numeraireAmount', internalType: 'uint256', type: 'uint256' },
+    ],
+    name: 'convertNumeraireToToken',
+    outputs: [{ name: 'tokenAmount', internalType: 'uint256', type: 'uint256' }],
+    stateMutability: 'view',
+  },
   {
     type: 'function',
     inputs: [{ name: 'vault', internalType: 'address', type: 'address' }],