@augustdigital/sdk 8.16.1 → 8.19.0

package/lib/services/subgraph/vaults.js

@@ -29,9 +29,23 @@ const MISSING_SUBGRAPH_ALERT_TTL_MS = 60 * 60 * 1000; // 1 hour
  * would flood the webhook for every metadata-less vault. Deduping per pool
  * surfaces a genuinely-missing subgraph without the flood.
  *
+ * This is the durable signal for BOTH ways a vault's subgraph can be broken — no
+ * URL configured, and a URL that answers non-200 (a deleted subgraph 404s). The
+ * readers deliberately log those per-request at `warn` rather than `error`: at
+ * `error` each one became a billed Sentry issue on every portfolio read, which
+ * cost over 2M events in 30 days across a handful of vaults. The volume is
+ * per-request, but the condition is per-vault, so this alert is where it belongs.
+ *
  * @param args.source - Reader function name, for the alert body.
  * @param args.pool - Vault address (used as the dedupe key, lowercased).
- * @param args.chainId - Chain id for the alert context.
+ * @param args.chainId - Chain id for the alert context, or a thunk resolving
+ *   it. Every current caller has the id in scope and passes it directly. The
+ *   thunk form exists for a caller that would otherwise have to resolve the id
+ *   eagerly on every non-200 response — it is invoked only after the dedupe
+ *   gate passes, so a suppressed alert costs nothing. No such caller exists
+ *   today; if none appears, this union and the deferred branch below can go.
+ * @param args.reason - Why the subgraph is unusable. Defaults to the
+ *   missing-URL case; pass the HTTP status for a URL that resolved but failed.
  * @param args.slackWebookUrl - Optional override webhook URL.
  */
 function alertMissingSubgraphOnce(args) {
@@ -39,13 +53,31 @@ function alertMissingSubgraphOnce(args) {
     if (core_1.CACHE.has(key))
         return;
     core_1.CACHE.set(key, true, { ttl: MISSING_SUBGRAPH_ALERT_TTL_MS });
-    slack_1.SLACK.error({
+    const send = (chainId) => slack_1.SLACK.error({
         title: 'Missing Subgraph',
-        error: `#${args.source}: goldsky url is undefined`,
+        error: `#${args.source}: ${args.reason ?? 'goldsky url is undefined'}`,
         poolAddress: args.pool,
-        chainId: args.chainId,
+        chainId,
         slackWebookUrl: args.slackWebookUrl || '',
     });
+    if (typeof args.chainId === 'number') {
+        send(args.chainId);
+        return;
+    }
+    // Deferred id: the dedupe key is already set, so a rejection here would mute
+    // this pool for the full TTL without ever alerting. Release the key instead,
+    // leaving the next non-200 free to try again.
+    void args
+        .chainId()
+        .then(send, (e) => {
+        core_1.CACHE.delete(key);
+        core_1.Logger.log.warn('alertMissingSubgraphOnce', `chain id unresolved, alert skipped: ${e}`);
+    })
+        // `send` itself can reject (SLACK.error does its own fetch). Without this
+        // it escapes as an unhandled rejection instead of being contained here.
+        .catch((e) => {
+        core_1.Logger.log.warn('alertMissingSubgraphOnce', `alert send failed: ${e}`);
+    });
 }
 /**
  * earnAUSD exists on both Ethereum and Monad, so it needs a _monad suffix
@@ -395,7 +427,16 @@ async function getSubgraphWithdrawRequests(pool, provider, slackWebookUrl = slac
       }
     }`, GOLDSKY_API_KEY);
     if (result.status !== 200) {
-        core_1.Logger.log.error('getSubgraphWithdrawRequests', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+        core_1.Logger.log.warn('getSubgraphWithdrawRequests', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+        alertMissingSubgraphOnce({
+            source: 'getSubgraphWithdrawRequests',
+            pool,
+            // Already resolved at the top of this function — no re-fetch, and the
+            // alert fires synchronously.
+            chainId: network,
+            reason: `subgraph returned ${result.status} ${result.statusText}`,
+            slackWebookUrl,
+        });
         return [];
     }
     const json = (await result.json());
@@ -428,7 +469,7 @@ async function getSubgraphWithdrawProccessed(pool, provider, slackWebookUrl = sl
         const requests = [];
         if (!goldskyUrl) {
             const chainId = await (0, core_1.getChainId)(provider);
-            core_1.Logger.log.error('getSubgraphWithdrawProccessed.missing-subgraph-url', new Error('goldsky url is undefined'), { chainId, vaultSymbol, pool });
+            core_1.Logger.log.warn('getSubgraphWithdrawProccessed.missing-subgraph-url', `goldsky url is undefined: ${vaultSymbol}::${pool}`, { chainId });
             alertMissingSubgraphOnce({
                 source: 'getSubgraphWithdrawProccessed',
                 pool,
@@ -458,7 +499,16 @@ async function getSubgraphWithdrawProccessed(pool, provider, slackWebookUrl = sl
         }
       }`, GOLDSKY_API_KEY);
         if (result.status !== 200) {
-            core_1.Logger.log.error('getSubgraphWithdrawProccessed', new Error(`HTTP ${result.status} ${result.statusText}`), { status: result.status, statusText: result.statusText, pool });
+            core_1.Logger.log.warn('getSubgraphWithdrawProccessed', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+            alertMissingSubgraphOnce({
+                source: 'getSubgraphWithdrawProccessed',
+                pool,
+                // Already resolved at the top of this function — no re-fetch, and the
+                // alert fires synchronously.
+                chainId: network,
+                reason: `subgraph returned ${result.status} ${result.statusText}`,
+                slackWebookUrl,
+            });
             return [];
         }
         const json = (await result.json());
@@ -506,7 +556,7 @@ async function getSubgraphAllWithdrawals(pool, provider, slackWebookUrl = slack_
             (0, core_1.getDefaultSubgraphUrl)(networkValue.name, vaultSymbol);
         if (!goldskyUrl) {
             const chainId = await (0, core_1.getChainId)(provider);
-            core_1.Logger.log.error('getSubgraphAllWithdrawals', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphAllWithdrawals', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
             alertMissingSubgraphOnce({
                 source: 'getSubgraphAllWithdrawals',
                 pool,
@@ -552,7 +602,14 @@ async function getSubgraphAllWithdrawals(pool, provider, slackWebookUrl = slack_
     }`;
         const result = await (0, fetcher_1.fetchSubgraph)(goldskyUrl, query, GOLDSKY_API_KEY);
         if (result.status !== 200) {
-            core_1.Logger.log.error('getSubgraphAllWithdrawals', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphAllWithdrawals', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+            alertMissingSubgraphOnce({
+                source: 'getSubgraphAllWithdrawals',
+                pool,
+                chainId: network,
+                reason: `subgraph returned ${result.status} ${result.statusText}`,
+                slackWebookUrl,
+            });
             return errorReturnObj;
         }
         const json = (await result.json());
@@ -681,7 +738,7 @@ async function getSubgraphUserHistory(user, provider, pool, slackWebookUrl = sla
             core_1.SUBGRAPH_VAULT_URLS[vaultSymbol?.toLowerCase()] ||
             (0, core_1.getDefaultSubgraphUrl)(networkValue.name, vaultSymbol);
         if (!goldskyUrl) {
-            core_1.Logger.log.error('getSubgraphUserHistory', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphUserHistory', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
             alertMissingSubgraphOnce({
                 source: 'getSubgraphUserHistory',
                 pool,
@@ -766,7 +823,14 @@ async function getSubgraphUserHistory(user, provider, pool, slackWebookUrl = sla
     }`;
         const result = await (0, fetcher_1.fetchSubgraph)(goldskyUrl, fullRequest, GOLDSKY_API_KEY);
         if (result.status !== 200) {
-            core_1.Logger.log.error('getSubgraphUserHistory', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphUserHistory', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`);
+            alertMissingSubgraphOnce({
+                source: 'getSubgraphUserHistory',
+                pool,
+                chainId,
+                reason: `subgraph returned ${result.status} ${result.statusText}`,
+                slackWebookUrl,
+            });
             return requests;
         }
         const json = (await result.json());
@@ -807,7 +871,7 @@ async function getSubgraphVaultHistory(provider, pool, slackWebookUrl = slack_1.
             (0, core_1.getDefaultSubgraphUrl)(networkValue.name, vaultSymbol);
         if (!goldskyUrl) {
             const chainId = await (0, core_1.getChainId)(provider);
-            core_1.Logger.log.error('getSubgraphVaultHistory', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphVaultHistory', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
             alertMissingSubgraphOnce({
                 source: 'getSubgraphVaultHistory',
                 pool,
@@ -892,7 +956,14 @@ async function getSubgraphVaultHistory(provider, pool, slackWebookUrl = slack_1.
       }
     }`, GOLDSKY_API_KEY);
             if (result.status !== 200) {
-                core_1.Logger.log.error('getSubgraphVaultHistory', new Error(`HTTP ${result.status} ${result.statusText}`), { status: result.status, statusText: result.statusText, skip });
+                core_1.Logger.log.warn('getSubgraphVaultHistory', `${result.statusText}::${result.status}: ${vaultSymbol}::${pool}`, { skip });
+                alertMissingSubgraphOnce({
+                    source: 'getSubgraphVaultHistory',
+                    pool,
+                    chainId: network,
+                    reason: `subgraph returned ${result.status} ${result.statusText}`,
+                    slackWebookUrl,
+                });
                 // First page failed → nothing to return. A later page failing still
                 // yields whatever earlier pages accumulated.
                 if (skip === 0)
@@ -966,7 +1037,7 @@ async function getSubgraphUserTransfers(user, provider, pool, slackWebookUrl = s
             (0, core_1.getDefaultSubgraphUrl)(networkValue.name, vaultSymbol);
         if (!goldskyUrl) {
             const chainId = await (0, core_1.getChainId)(provider);
-            core_1.Logger.log.error('getSubgraphUserTransfers', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
+            core_1.Logger.log.warn('getSubgraphUserTransfers', `goldsky url is undefined: ${vaultSymbol}::${pool}`);
             alertMissingSubgraphOnce({
                 source: 'getSubgraphUserTransfers',
                 pool,

package/lib/types/vaults.d.ts

@@ -333,6 +333,18 @@ export interface IVault {
         performanceFeeWaivedUntilTvl: number | null;
     };
     lagDuration: number;
+    /**
+     * Backend-configured display buffer in seconds added on top of
+     * `lagDuration` for the withdrawal period shown to users. Null when the
+     * backend has not set a value — consumers apply their own default.
+     */
+    withdrawalMarginSeconds?: number | null;
+    /**
+     * IAT trader wallet addresses for the vault, from the backend
+     * `iat_traders` field. Address format follows the vault's chain
+     * (EVM hex / Solana base58 / Stellar). Null when not configured.
+     */
+    iatTraders?: string[] | null;
     maxDailyDrawdown: number;
     risk: string;
     isWithdrawalPaused: boolean;

package/lib/types/webserver.d.ts

@@ -624,6 +624,17 @@ export interface ITokenizedVault {
     solana_vault_metadata?: ISolanaVaultMetadata | null;
     stellar_vault_metadata?: IStellarVaultMetadata | null;
     lagDuration: number;
+    /**
+     * Display buffer in seconds added on top of the on-chain lag for the
+     * withdrawal period shown to users. Null when not configured.
+     */
+    withdrawal_margin_seconds?: number | null;
+    /**
+     * IAT trader wallet addresses for the vault. Address format follows the
+     * vault's chain (EVM hex / Solana base58 / Stellar). Null when not
+     * configured.
+     */
+    iat_traders?: string[] | null;
     historical_apy: Record<number, number> | null;
     /**
      * Compound-annualized historical APY keyed by horizon in days (1/7/30), as

package/package.json

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