@augustdigital/sdk 9.9.0 → 9.9.1

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 = "9.9.0";
+export declare const SDK_VERSION = "9.9.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 = '9.9.0';
+exports.SDK_VERSION = '9.9.1';
 //# sourceMappingURL=version.js.map

package/lib/core/constants/core.d.ts

@@ -117,6 +117,7 @@ export declare const WEBSERVER_ENDPOINTS: {
             summary: (vaultAddress: IAddress) => string;
             withdrawals: (chain: string, vaultAddress: IAddress) => string;
             debank: (vaultAddress: IAddress) => string;
+            octav: (vaultAddress: IAddress) => string;
             userHistory: (vaultAddress: IAddress, wallet: IAddress) => string;
             archivedVaults: string;
         };

package/lib/core/constants/core.js

@@ -184,6 +184,7 @@ exports.WEBSERVER_ENDPOINTS = {
             summary: (vaultAddress) => `/tokenized_vault/vault_summary/${(0, ethers_1.getAddress)(vaultAddress)}`,
             withdrawals: (chain, vaultAddress) => `/withdrawals/${chain}/${(0, ethers_1.getAddress)(vaultAddress)}`,
             debank: (vaultAddress) => `/tokenized_vault/${(0, ethers_1.getAddress)(vaultAddress)}/debank`,
+            octav: (vaultAddress) => `/tokenized_vault/${subaccountSegment(vaultAddress)}/octav`,
             // Mongo-backed deposit/withdraw history for archived vaults whose
             // subgraph has been (or will be) retired. See fetchArchivedVaults.
             userHistory: (vaultAddress, wallet) => `/upshift/vault_history/${(0, ethers_1.getAddress)(vaultAddress)}?wallet=${(0, ethers_1.getAddress)(wallet)}`,

package/lib/modules/vaults/getters.js

@@ -641,11 +641,14 @@ async function getVaultAllocations(vault, options, tokenizedVault) {
     // afterwards, and a borrower on a chain with portfolio coverage would otherwise
     // have its rows silently dropped rather than double-counted.
     let untangledTokenCount = 0;
+    let vaultOctav;
     const borrowerPortfolioFetchers = {
         solana: async (borrower) => {
-            const portfolios = await (0, octavfi_1.fetchOctavfiPortfolios)([borrower]);
-            return portfolios.length > 0
-                ? (0, octavfi_1.transformOctavfiToDebank)(portfolios[0])
+            vaultOctav ??= (0, octavfi_1.fetchVaultOctavResponse)(vault, options?.headers);
+            const response = await vaultOctav;
+            const portfolio = response ? response[borrower] : undefined;
+            return portfolio && !('error' in portfolio)
+                ? (0, octavfi_1.transformOctavfiToDebank)(portfolio)
                 : null;
         },
     };

package/lib/sdk.d.ts

@@ -29074,6 +29074,7 @@ declare type AsArray<T> = T extends readonly unknown[] ? T : never;
                                                                                                                  summary: (vaultAddress: IAddress) => string;
                                                                                                                  withdrawals: (chain: string, vaultAddress: IAddress) => string;
                                                                                                                  debank: (vaultAddress: IAddress) => string;
+                                                                                                                 octav: (vaultAddress: IAddress) => string;
                                                                                                                  userHistory: (vaultAddress: IAddress, wallet: IAddress) => string;
                                                                                                                  archivedVaults: string;
                                                                                                              };

package/lib/services/octavfi/fetcher.d.ts

@@ -1,9 +1,33 @@
+import type { IAddress, IWSMonitorHeaders } from '../../types';
 import type { IOctavfiPortfolio } from './types';
 /**
- * Fetches portfolio data from Octavfi API.
- * Note: The API currently doesn't support multiple addresses in a single request,
- * so individual requests are made for each address.
- * @param addresses - Array of addresses to fetch data for.
- * @returns Array of portfolio data (may be empty if all requests fail).
+ * Response of the August API's vault-level Octav endpoint.
+ *
+ * Keys are the vault's Solana operator addresses (case-sensitive base58).
+ * Values are the operator's raw Octav portfolio, or an `{ error }` object when
+ * the backend holds no usable portfolio for that operator.
  */
-export declare function fetchOctavfiPortfolios(addresses: string[]): Promise<IOctavfiPortfolio[]>;
+export type IVaultOctavResponse = Record<string, IOctavfiPortfolio | {
+    error: string;
+}>;
+/**
+ * Fetch the Octav portfolios of every Solana operator of a vault in a single
+ * request to the August public API.
+ *
+ * The API serves these from a cache that a backend cron refreshes, so this
+ * function never calls Octav and needs no Octav credentials. It makes exactly
+ * one HTTP request per call and never throws.
+ *
+ * @param vaultAddress - Vault address: EVM hex or Solana base58.
+ * @param headers - Optional monitoring headers forwarded with the request.
+ * @returns Dictionary of operator address to portfolio or error on a 200 or
+ *   207 (partial success) response; `false` on any other status or when the
+ *   request fails.
+ *
+ * @example
+ * ```ts
+ * const response = await fetchVaultOctavResponse(vaultAddress);
+ * const portfolio = response ? response[borrower] : undefined;
+ * ```
+ */
+export declare function fetchVaultOctavResponse(vaultAddress: IAddress, headers?: IWSMonitorHeaders): Promise<IVaultOctavResponse | false>;

package/lib/services/octavfi/fetcher.js

@@ -1,103 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchOctavfiPortfolios = fetchOctavfiPortfolios;
-const ethers_1 = require("ethers");
-const utils_1 = require("../../adapters/solana/utils");
+exports.fetchVaultOctavResponse = fetchVaultOctavResponse;
 const core_1 = require("../../core");
-const BASE_URL = 'https://api.octav.fi';
-const OCTAVFI_API_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwczovL2hhc3VyYS5pby9qd3QvY2xhaW1zIjp7IngtaGFzdXJhLWRlZmF1bHQtcm9sZSI6InVzZXIiLCJ4LWhhc3VyYS1hbGxvd2VkLXJvbGVzIjpbInVzZXIiXSwieC1oYXN1cmEtdXNlci1pZCI6ImF1Z3VzdDEyMjM0In19.zaMUtrtdC82uaDh6XSZrsneEcKO3PFOE6FyX3G-MR6c';
 /**
- * Filters addresses to only include EVM and Solana wallet addresses.
- * Excludes Sui addresses and other non-supported address formats.
+ * Fetch the Octav portfolios of every Solana operator of a vault in a single
+ * request to the August public API.
  *
- * @param addresses - Array of addresses to filter
- * @returns Array containing only EVM and Solana addresses
- */
-function filterEvmAndSolanaAddresses(addresses) {
-    return addresses.filter((address) => {
-        if (!address || typeof address !== 'string')
-            return false;
-        if ((0, ethers_1.isAddress)(address)) {
-            return true;
-        }
-        if (utils_1.SolanaUtils.isSolanaAddress(address)) {
-            return true;
-        }
-        core_1.Logger.log.info('filterEvmAndSolanaAddresses.excluded', { address });
-        return false;
-    });
-}
-/**
- * Fetches portfolio data for a single address from Octavfi API.
- * @param address - Single address to fetch data for.
- * @returns Portfolio data or null if request fails.
+ * The API serves these from a cache that a backend cron refreshes, so this
+ * function never calls Octav and needs no Octav credentials. It makes exactly
+ * one HTTP request per call and never throws.
+ *
+ * @param vaultAddress - Vault address: EVM hex or Solana base58.
+ * @param headers - Optional monitoring headers forwarded with the request.
+ * @returns Dictionary of operator address to portfolio or error on a 200 or
+ *   207 (partial success) response; `false` on any other status or when the
+ *   request fails.
+ *
+ * @example
+ * ```ts
+ * const response = await fetchVaultOctavResponse(vaultAddress);
+ * const portfolio = response ? response[borrower] : undefined;
+ * ```
  */
-async function fetchSinglePortfolio(address) {
+async function fetchVaultOctavResponse(vaultAddress, headers) {
     try {
-        const response = await fetch(`${BASE_URL}/v1/portfolio?addresses=${address}`, {
-            method: 'GET',
-            headers: {
-                'Content-Type': 'application/json',
-                Authorization: `Bearer ${OCTAVFI_API_KEY}`,
-            },
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            core_1.Logger.log.error('fetchSinglePortfolio', new Error(`HTTP ${response.status} ${response.statusText}: ${errorText}`), {
-                address,
-                status: response.status,
-                statusText: response.statusText,
-            });
-            return null;
-        }
-        const data = await response.json();
-        if (!data || typeof data !== 'object') {
-            core_1.Logger.log.error('fetchSinglePortfolio.unexpected-type', new Error(`unexpected response type: ${typeof data}`), { address });
-            return null;
+        const response = await (0, core_1.fetchAugustPublic)(core_1.WEBSERVER_ENDPOINTS.public.tokenizedVault.octav(vaultAddress), { headers: headers });
+        if (response.status === 200 || response.status === 207) {
+            return (await response.json());
         }
-        if (data.error) {
-            core_1.Logger.log.error('fetchSinglePortfolio.api-error', new Error(String(data.error)), { address });
-            return null;
-        }
-        // Handle nested array response: [[portfolio]] or [portfolio] or portfolio
-        let portfolio = data;
-        if (Array.isArray(data)) {
-            if (data.length > 0 && Array.isArray(data[0])) {
-                // Nested array: [[portfolio]]
-                portfolio = data[0][0];
-            }
-            else if (data.length > 0) {
-                // Single array: [portfolio]
-                portfolio = data[0];
-            }
-            else {
-                return null;
-            }
-        }
-        // Return raw Octavfi data (transformation should happen separately when needed)
-        return portfolio;
-    }
-    catch (error) {
-        core_1.Logger.log.error('fetchSinglePortfolio', error, { address });
-        return null;
+        core_1.Logger.log.error('fetchVaultOctavResponse', new Error(`HTTP ${response.status} ${response.statusText}`), { status: response.status, statusText: response.statusText });
+        return false;
     }
-}
-/**
- * Fetches portfolio data from Octavfi API.
- * Note: The API currently doesn't support multiple addresses in a single request,
- * so individual requests are made for each address.
- * @param addresses - Array of addresses to fetch data for.
- * @returns Array of portfolio data (may be empty if all requests fail).
- */
-async function fetchOctavfiPortfolios(addresses) {
-    const filteredAddresses = filterEvmAndSolanaAddresses(addresses);
-    if (filteredAddresses.length === 0) {
-        return [];
+    catch (e) {
+        core_1.Logger.log.error('fetchVaultOctavResponse', e);
+        return false;
     }
-    // Fetch portfolios for each address in parallel
-    const portfolioPromises = filteredAddresses.map((address) => fetchSinglePortfolio(address));
-    const portfolios = await Promise.all(portfolioPromises);
-    // Filter out null results (failed requests)
-    return portfolios.filter((portfolio) => portfolio !== null);
 }
 //# sourceMappingURL=fetcher.js.map

package/package.json

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