@augustdigital/sdk 7.0.0 → 8.0.0

package/lib/adapters/stellar/types.d.ts

@@ -1,6 +1,5 @@
 import type { IStellarNetwork } from '../../types/web3';
 export type { IStellarNetwork };
-export type { IStellarNetwork as StellarNetwork };
 export interface IStellarDepositParams {
     contractId: string;
     amount: string;

package/lib/core/analytics/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "7.0.0";
+export declare const SDK_VERSION = "8.0.0";

package/lib/core/analytics/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '7.0.0';
+exports.SDK_VERSION = '8.0.0';
 //# sourceMappingURL=version.js.map

package/lib/core/base.class.d.ts

@@ -5,7 +5,6 @@ interface IKeys {
     august?: string;
     graph?: string;
     coingecko?: string;
-    octavfi?: string;
 }
 interface IMonitoring extends IWSMonitorHeaders {
     slackWebhookUrl?: string;

package/lib/core/helpers/explorer-link.d.ts

@@ -1,2 +1,2 @@
 import { IAddress, IChainId, IExplorerType } from '../../types';
-export declare const explorerLink: (hex: IAddress, chain: IChainId, type: IExplorerType) => string | undefined;
+export declare const explorerLink: (hex: IAddress, chain: IChainId, type: IExplorerType) => string;

package/lib/core/helpers/explorer-link.js

@@ -3,9 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.explorerLink = void 0;
 const web3_1 = require("../constants/web3");
 const explorerLink = (hex, chain, type) => {
-    if (!chain)
-        return;
-    return `${web3_1.NETWORKS[chain].explorer}/${type}/${hex}`;
+    const network = chain ? web3_1.NETWORKS[chain] : undefined;
+    if (!network)
+        return '';
+    return `${network.explorer}/${type}/${hex}`;
 };
 exports.explorerLink = explorerLink;
 //# sourceMappingURL=explorer-link.js.map

package/lib/main.d.ts

@@ -138,7 +138,8 @@ export declare class AugustSDK extends AugustBase {
     }): Promise<import("./types").IActiveStakingPosition[]>;
     getVaultBorrowerHealthFactor(props?: {
         chainId?: IChainId;
-    }): Promise<{}>;
+        vault?: IAddress;
+    }): Promise<Record<string, import("./types").IVaultBorrowerHealthFactor[]> | Record<string, import("./types").IVaultBorrowerHealthFactor[]>[]>;
     getUserPoints(userAddress: IAddress): Promise<any>;
     registerUserForPoints(userAddress: IAddress, referrerAddress: IAddress | undefined, chainId: number, signature: string, nonce: string, expiry: number): Promise<Response>;
     fetchPointsLeaderboard(params?: {

package/lib/main.js

@@ -170,7 +170,7 @@ class AugustSDK extends core_1.AugustBase {
         return await this.vaults.getStakingPositions(props.wallet, props.chainId);
     }
     async getVaultBorrowerHealthFactor(props) {
-        return await this.vaults.getVaultBorrowerHealthFactor(props?.chainId);
+        return await this.vaults.getVaultBorrowerHealthFactor(props?.chainId, props?.vault);
     }
     async getUserPoints(userAddress) {
         return await this.vaults.getUserPoints(userAddress);

package/lib/modules/vaults/fetcher.js

@@ -54,7 +54,7 @@ async function fetchVaultsBatch(vaults, options = {}) {
                     maxRetries,
                     baseDelay,
                 });
-                if (result.success && result.data) {
+                if (result.success) {
                     successful.push({
                         index: globalIndex,
                         data: result.data,
@@ -64,7 +64,7 @@ async function fetchVaultsBatch(vaults, options = {}) {
                 else {
                     failed.push({
                         index: globalIndex,
-                        error: result.error || new Error('Unknown failure'),
+                        error: result.error ?? new Error('Unknown failure'),
                         address: vault.address,
                     });
                 }

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

@@ -1,4 +1,4 @@
-import { IAddress, IHistoricalTimeseriesResponse, INormalizedNumber, ISubgraphWithdrawProccessed, IVault, IVaultAllocations, IVaultAnnualizedApy, IVaultAvailableRedemption, IVaultLoan, IVaultPosition, IVaultRedemptionHistoryItem, IVaultSummary, IVaultWithdrawals, IVaultPendingRedemptions, IActiveStakingPosition, IVaultHistoricalParams, IVaultUserLifetimePnl, IVaultPnl, VaultAddress } from '../../types';
+import { IAddress, IHistoricalTimeseriesResponse, INormalizedNumber, ISubgraphWithdrawProccessed, IVault, IVaultAllocations, IVaultAnnualizedApy, IVaultAvailableRedemption, IVaultLoan, IVaultPosition, IVaultRedemptionHistoryItem, IVaultSummary, IVaultWithdrawals, IVaultPendingRedemptions, IActiveStakingPosition, IVaultHistoricalParams, IVaultUserLifetimePnl, IVaultBorrowerHealthFactor, IVaultPnl, VaultAddress } from '../../types';
 import { IVaultBaseOptions } from './types';
 export declare function getVault({ vault, loans, allocations, options, loadSubaccounts, loadSnapshots, }: {
     vault: IAddress;
@@ -60,20 +60,11 @@ export declare function getVaultTvl({ vault, options, historical, }: {
 export declare function getVaultBorrowerHealthFactor({ vault, options, }: {
     vault: IAddress;
     options: IVaultBaseOptions;
-}): Promise<{
-    borrower: IAddress;
-    loan: IAddress;
-    health_factor?: {
-        datetime: string;
-        health_factor: number;
-        id: string;
-        total_collateral_value: number;
-        total_loan_value: number;
-    };
-}[]>;
-export declare function getHealthFactorOfBorrowersByVault({ options, }: {
+}): Promise<IVaultBorrowerHealthFactor[]>;
+export declare function getHealthFactorOfBorrowersByVault({ options, vault, }: {
     options: IVaultBaseOptions;
-}): Promise<{}>;
+    vault?: IAddress;
+}): Promise<Record<string, IVaultBorrowerHealthFactor[]>>;
 export declare function getUserPoints({ userAddress, options, }: {
     userAddress: IAddress;
     options?: IVaultBaseOptions;

package/lib/modules/vaults/getters.js

@@ -1281,7 +1281,7 @@ async function getVaultTvl({ vault, options, historical, }) {
 async function getVaultBorrowerHealthFactor({ vault, options, }) {
     const provider = (0, core_1.createProvider)(options.rpcUrl);
     const loans = await getVaultLoans(vault, options);
-    const activeLoans = (await Promise.all(loans.map(async (l) => {
+    const activeLoanResults = await Promise.allSettled(loans.map(async (l) => {
         const loanContract = (0, core_1.createContract)({
             provider,
             address: l.address,
@@ -1289,10 +1289,21 @@ async function getVaultBorrowerHealthFactor({ vault, options, }) {
         });
         const loanState = await loanContract.loanState();
         if ((0, core_1.loanStateToReadable)(loanState) !== 'ACTIVE')
-            return;
+            return undefined;
         return l.address;
-    }))).filter((l) => l !== undefined);
-    const formattedLoansArray = await Promise.all(activeLoans.map(async (l) => {
+    }));
+    const activeLoans = activeLoanResults
+        .map((r, i) => {
+        if (r.status === 'fulfilled')
+            return r.value;
+        core_1.Logger.log.warn('getVaultBorrowerHealthFactor:loanState', r.reason, {
+            vault,
+            loan: loans[i]?.address,
+        });
+        return undefined;
+    })
+        .filter((l) => l !== undefined);
+    const formattedSettled = await Promise.allSettled(activeLoans.map(async (l) => {
         const loanContract = (0, core_1.createContract)({
             provider,
             address: l,
@@ -1303,32 +1314,62 @@ async function getVaultBorrowerHealthFactor({ vault, options, }) {
             loan: l,
         };
     }));
+    const formattedLoansArray = formattedSettled
+        .map((r, i) => {
+        if (r.status === 'fulfilled')
+            return r.value;
+        core_1.Logger.log.warn('getVaultBorrowerHealthFactor:borrower', r.reason, {
+            vault,
+            loan: activeLoans[i],
+        });
+        return undefined;
+    })
+        .filter((entry) => entry !== undefined);
     const uniqueBorrowers = [
         ...new Set(formattedLoansArray.map((l) => l.borrower)),
     ];
     const borrowerResponses = {};
     for (const b of uniqueBorrowers) {
-        const response = await (0, core_1.fetchAugustWithKey)(options.augustKey, core_1.WEBSERVER_ENDPOINTS.subaccount.health_factor(b));
-        if (response.status === 200) {
-            borrowerResponses[b] = await response.json();
+        try {
+            const response = await (0, core_1.fetchAugustWithKey)(options.augustKey, core_1.WEBSERVER_ENDPOINTS.subaccount.health_factor(b));
+            if (response.status === 200) {
+                borrowerResponses[b] = await response.json();
+            }
+        }
+        catch (err) {
+            core_1.Logger.log.warn('getVaultBorrowerHealthFactor:health_factor', err, {
+                vault,
+                borrower: b,
+            });
         }
     }
-    formattedLoansArray?.map((loan) => {
+    formattedLoansArray.forEach((loan) => {
         loan.health_factor = borrowerResponses[loan.borrower];
     });
     return formattedLoansArray;
 }
-async function getHealthFactorOfBorrowersByVault({ options, }) {
-    const vaults = await (0, core_1.fetchTokenizedVaults)(undefined, options?.headers, false, false);
-    const healthFactors = await Promise.all(vaults.map(async (v) => {
+async function getHealthFactorOfBorrowersByVault({ options, vault, }) {
+    const vaults = vault
+        ? ((await (0, core_1.fetchTokenizedVault)(vault, options?.headers)) ?? [])
+        : await (0, core_1.fetchTokenizedVaults)(undefined, options?.headers, false, false);
+    const healthFactorResults = await Promise.allSettled(vaults.map(async (v) => {
         return getVaultBorrowerHealthFactor({
             vault: v.address,
             options,
         });
     }));
     const healthFactorsByPool = {};
-    vaults.map((pool, index) => {
-        healthFactorsByPool[pool.address] = healthFactors[index];
+    vaults.forEach((pool, index) => {
+        const result = healthFactorResults[index];
+        const key = pool.address.toLowerCase();
+        if (result?.status === 'fulfilled') {
+            healthFactorsByPool[key] = result.value;
+            return;
+        }
+        core_1.Logger.log.warn('getHealthFactorOfBorrowersByVault:vault', result?.reason, {
+            vault: pool.address,
+        });
+        healthFactorsByPool[key] = [];
     });
     return healthFactorsByPool;
 }

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

@@ -125,7 +125,7 @@ export declare class AugustVaults extends AugustBase {
         vault: IAddress;
         chainId?: IChainId;
     }): Promise<number>;
-    getVaultBorrowerHealthFactor(chainId?: IChainId): Promise<{}>;
+    getVaultBorrowerHealthFactor(chainId?: IChainId, vault?: IAddress): Promise<Record<string, import("../../types").IVaultBorrowerHealthFactor[]> | Record<string, import("../../types").IVaultBorrowerHealthFactor[]>[]>;
     getUserPoints(userAddress: IAddress): Promise<any>;
     registerUserForPoints(userAddress: IAddress, referrerAddress: IAddress | undefined, chainId: number, signature: string, nonce: string, expiry: number): Promise<Response>;
     fetchPointsLeaderboard(params?: {

package/lib/modules/vaults/main.js

@@ -740,7 +740,7 @@ class AugustVaults extends core_1.AugustBase {
             },
         });
     }
-    async getVaultBorrowerHealthFactor(chainId) {
+    async getVaultBorrowerHealthFactor(chainId, vault) {
         if (chainId) {
             const health_factors = await (0, getters_1.getHealthFactorOfBorrowersByVault)({
                 options: {
@@ -748,6 +748,7 @@ class AugustVaults extends core_1.AugustBase {
                     env: this.monitoring?.env,
                     augustKey: this.keys?.august,
                 },
+                vault,
             });
             return health_factors;
         }
@@ -763,6 +764,7 @@ class AugustVaults extends core_1.AugustBase {
                     subgraphKey: this.keys?.graph,
                     headers: this.headers,
                 },
+                vault,
             });
         }));
         return health_factors.flat();

package/lib/services/coingecko/fetcher.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchTokenPricesFromCoinGecko = fetchTokenPricesFromCoinGecko;
+const logger_1 = require("../../core/logger");
 const utils_1 = require("./utils");
 async function fetchTokenPricesFromCoinGecko(symbol, coinGeckoKey) {
     const coinId = utils_1.COINGECKO_COIN_ID_MAP[symbol.toLowerCase()];
@@ -19,17 +20,26 @@ async function fetchTokenPricesFromCoinGecko(symbol, coinGeckoKey) {
             },
         });
         if (!response.ok) {
-            console.error('\n\n❌ CoinGecko API Error:', response.statusText, coinId, '\n\n');
-            throw new Error(`❌ CoinGecko API Error: ${response.statusText}`);
+            const err = new Error(`CoinGecko API error: ${response.status} ${response.statusText}`);
+            logger_1.Logger.log.error('fetchTokenPricesFromCoinGecko', err, {
+                status: response.status,
+                statusText: response.statusText,
+                coinId,
+                symbol,
+            });
+            throw err;
         }
         const data = (await response.json());
-        if (data && data.length) {
-            return data.prices[data.length - 1][1];
+        if (data?.prices?.length) {
+            return data.prices[data.prices.length - 1][1];
         }
         return null;
     }
     catch (error) {
-        console.error('❌ Error fetching CoinGecko prices:', `${error} for ${coinId} ${symbol}`);
+        logger_1.Logger.log.error('fetchTokenPricesFromCoinGecko', error, {
+            coinId,
+            symbol,
+        });
         return null;
     }
 }

package/lib/services/debank/fetcher.js

@@ -10,18 +10,21 @@ async function fetchVaultDebankResponse(vaultAddress, headers) {
             const data = (await response.json());
             return data;
         }
-        console.error('#fetchVaultDebankResponse::', response.status, response.statusText);
+        core_1.Logger.log.error('fetchVaultDebankResponse', new Error(`HTTP ${response.status} ${response.statusText}`), { status: response.status, statusText: response.statusText });
         return false;
     }
     catch (e) {
-        console.error('#fetchVaultDebankResponse::', e);
+        core_1.Logger.log.error('fetchVaultDebankResponse', e);
         return false;
     }
 }
 async function fetchDebankResponse(address, headers) {
     const debankResponse = await (0, core_1.fetchAugustWithKey)(undefined, core_1.WEBSERVER_ENDPOINTS.subaccount.debank(address), { override: true, headers: headers });
     if (debankResponse.status !== 200) {
-        console.error('#getVaultAllocations::defi:', debankResponse.status, debankResponse.statusText);
+        core_1.Logger.log.error('fetchDebankResponse', new Error(`HTTP ${debankResponse.status} ${debankResponse.statusText}`), {
+            status: debankResponse.status,
+            statusText: debankResponse.statusText,
+        });
         return false;
     }
     else if (debankResponse.status === 200) {

package/lib/services/debank/utils.js

@@ -3,12 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseVaultLevelDebank = parseVaultLevelDebank;
 exports.getVaultExposure = getVaultExposure;
 exports.parseLoanLevelDebank = parseLoanLevelDebank;
-const core_1 = require("../../core/helpers/core");
+const core_1 = require("../../core");
+const core_2 = require("../../core/helpers/core");
 function addToTokenExposure(token, tokenExposure, exposureType, protocol, exposurePerCategory, netValue, borrower) {
     const usdAmount = Number(token?.price || 0) * Number(token?.amount);
     if (exposureType === 'wallet'
-        ? !(0, core_1.filterOutBySize)(usdAmount)
-        : !(0, core_1.filterOutBySize)(usdAmount))
+        ? !(0, core_2.filterOutBySize)(usdAmount)
+        : !(0, core_2.filterOutBySize)(usdAmount))
         return;
     if (exposureType === 'borrow') {
         netValue.value -= usdAmount;
@@ -73,7 +74,7 @@ function parseVaultLevelDebank(debankRes, protocolExposure, tokenExposure, borro
         });
         const foundExistingProtocolExposure = protocolExposure.find((exp) => exp.id === pos.id);
         if (!foundExistingProtocolExposure &&
-            (0, core_1.filterOutBySize)(protoReturnObj.netUsdValue)) {
+            (0, core_2.filterOutBySize)(protoReturnObj.netUsdValue)) {
             protocolExposure.push(protoReturnObj);
         }
         else if (foundExistingProtocolExposure) {
@@ -126,7 +127,7 @@ function parseVaultLevelDebank(debankRes, protocolExposure, tokenExposure, borro
         });
         const foundExistingProtocolExposure = protocolExposure.find((exp) => exp.id === pos.id);
         if (!foundExistingProtocolExposure &&
-            (0, core_1.filterOutBySize)(protoReturnObj.netUsdValue)) {
+            (0, core_2.filterOutBySize)(protoReturnObj.netUsdValue)) {
             protocolExposure.push(protoReturnObj);
         }
         else if (foundExistingProtocolExposure) {
@@ -272,7 +273,7 @@ function parseLoanLevelDebank(debankRes) {
         exposure = uniqueExposure;
     }
     catch (err) {
-        console.error('#getPoolLoansData::strategies:', err);
+        core_1.Logger.log.error('getPoolLoansData.strategies', err);
     }
     return { exposure, positions };
 }

package/lib/services/octavfi/fetcher.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchOctavfiPortfolios = fetchOctavfiPortfolios;
 const ethers_1 = require("ethers");
 const utils_1 = require("../../adapters/solana/utils");
+const core_1 = require("../../core");
 const BASE_URL = 'https://api.octav.fi';
 const OCTAVFI_API_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwczovL2hhc3VyYS5pby9qd3QvY2xhaW1zIjp7IngtaGFzdXJhLWRlZmF1bHQtcm9sZSI6InVzZXIiLCJ4LWhhc3VyYS1hbGxvd2VkLXJvbGVzIjpbInVzZXIiXSwieC1oYXN1cmEtdXNlci1pZCI6ImF1Z3VzdDEyMjM0In19.zaMUtrtdC82uaDh6XSZrsneEcKO3PFOE6FyX3G-MR6c';
 function filterEvmAndSolanaAddresses(addresses) {
@@ -15,7 +16,7 @@ function filterEvmAndSolanaAddresses(addresses) {
         if (utils_1.SolanaUtils.isSolanaAddress(address)) {
             return true;
         }
-        console.log(`Excluding address: ${address} (not EVM or Solana)`);
+        core_1.Logger.log.info('filterEvmAndSolanaAddresses.excluded', { address });
         return false;
     });
 }
@@ -30,16 +31,20 @@ async function fetchSinglePortfolio(address) {
         });
         if (!response.ok) {
             const errorText = await response.text();
-            console.error(`Failed to fetch portfolio for ${address}: ${response.status} ${response.statusText}. ${errorText}`);
+            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') {
-            console.error(`Unexpected response type for ${address}:`, typeof data);
+            core_1.Logger.log.error('fetchSinglePortfolio.unexpected-type', new Error(`unexpected response type: ${typeof data}`), { address });
             return null;
         }
         if (data.error) {
-            console.error(`API error for ${address}:`, data.error);
+            core_1.Logger.log.error('fetchSinglePortfolio.api-error', new Error(String(data.error)), { address });
             return null;
         }
         let portfolio = data;
@@ -57,7 +62,7 @@ async function fetchSinglePortfolio(address) {
         return portfolio;
     }
     catch (error) {
-        console.error(`Error fetching portfolio for ${address}:`, error);
+        core_1.Logger.log.error('fetchSinglePortfolio', error, { address });
         return null;
     }
 }

package/lib/services/subgraph/vaults.js

@@ -297,7 +297,7 @@ async function getSubgraphWithdrawProccessed(pool, provider, slackWebookUrl = sl
         const requests = [];
         if (!goldskyUrl) {
             const chainId = await (0, core_1.getChainId)(provider);
-            console.error('#getSubgraphWithdrawProccessed: goldsky url is undefined:', chainId, vaultSymbol, pool);
+            core_1.Logger.log.error('getSubgraphWithdrawProccessed.missing-subgraph-url', new Error('goldsky url is undefined'), { chainId, vaultSymbol, pool });
             slack_1.SLACK.error({
                 title: 'Missing Subgraph',
                 error: '#getSubgraphWithdrawProccessed: goldsky url is undefined',
@@ -326,7 +326,7 @@ async function getSubgraphWithdrawProccessed(pool, provider, slackWebookUrl = sl
         }
       }`, GOLDSKY_API_KEY);
         if (result.status !== 200) {
-            console.error('#getSubgraphWithdrawProccessed:', result.status, result.statusText, pool);
+            core_1.Logger.log.error('getSubgraphWithdrawProccessed', new Error(`HTTP ${result.status} ${result.statusText}`), { status: result.status, statusText: result.statusText, pool });
             return [];
         }
         const json = (await result.json());
@@ -334,7 +334,7 @@ async function getSubgraphWithdrawProccessed(pool, provider, slackWebookUrl = sl
         return requests;
     }
     catch (e) {
-        console.error('#getSubgraphWithdrawProccessed::', pool, e);
+        core_1.Logger.log.error('getSubgraphWithdrawProccessed', e, { pool });
         return [];
     }
 }
@@ -638,7 +638,7 @@ async function getSubgraphVaultHistory(provider, pool, slackWebookUrl = slack_1.
       }
     }`, GOLDSKY_API_KEY);
         if (result.status !== 200) {
-            console.error('#getSubgraphVaultHistory:', result.status, result.statusText);
+            core_1.Logger.log.error('getSubgraphVaultHistory', new Error(`HTTP ${result.status} ${result.statusText}`), { status: result.status, statusText: result.statusText });
             return requests;
         }
         const json = (await result.json());
@@ -648,7 +648,7 @@ async function getSubgraphVaultHistory(provider, pool, slackWebookUrl = slack_1.
         return formattedRequests;
     }
     catch (e) {
-        console.error('#getSubgraphVaultHistory::', pool, e);
+        core_1.Logger.log.error('getSubgraphVaultHistory', e, { pool });
         return [];
     }
 }
@@ -740,7 +740,7 @@ async function getSubgraphUserTransfers(user, provider, pool, slackWebookUrl = s
         return userTransfers;
     }
     catch (e) {
-        console.error('#getSubgraphUserTransfers::', pool, ':', e);
+        core_1.Logger.log.error('getSubgraphUserTransfers', e, { pool });
         return [];
     }
 }

package/lib/types/vaults.d.ts

@@ -22,6 +22,17 @@ export interface IVaultLoan {
     isIdleCapital: boolean;
     allocation: number;
 }
+export interface IVaultBorrowerHealthFactor {
+    borrower: IAddress;
+    loan: IAddress;
+    health_factor?: {
+        datetime: string;
+        health_factor: number;
+        id: string;
+        total_collateral_value: number;
+        total_loan_value: number;
+    };
+}
 export type IVaultUserHistoryItem = {
     timestamp: number;
     address: IAddress;

package/lib/types/web3.d.ts

@@ -22,7 +22,6 @@ export type IInfuraOptions = {
 };
 export type ISolanaNetwork = 'devnet' | 'mainnet-beta' | 'testnet' | 'localnet';
 export type IStellarNetwork = 'mainnet' | 'testnet';
-export type StellarNetwork = IStellarNetwork;
 export interface ISolanaConfig {
     rpcUrl: string;
     network: ISolanaNetwork;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "main": "lib/index.js",
   "keywords": [
     "augustdigital",