@augustdigital/sdk 6.0.1 → 7.0.0

package/lib/core/analytics/sentry.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initializeSentry = initializeSentry;
 exports.updateUser = updateUser;
@@ -39,8 +6,11 @@ exports.clearUser = clearUser;
 exports.isAnalyticsEnabled = isAnalyticsEnabled;
 exports.getSentry = getSentry;
 exports.resetAnalytics = resetAnalytics;
-const Sentry = __importStar(require("@sentry/browser"));
+exports.captureSdkException = captureSdkException;
+const logger_1 = require("../logger");
 const constants_1 = require("./constants");
+const env_1 = require("./env");
+const sentry_runtime_1 = require("./sentry-runtime");
 const user_identity_1 = require("./user-identity");
 let isInitialized = false;
 let isEnabled = true;
@@ -72,46 +42,89 @@ function isLocalhost() {
 }
 function safeSetTag(key, value) {
     try {
-        Sentry.setTag(key, value);
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        sdk?.setTag(key, value);
     }
     catch {
     }
 }
 function safeSetUser(user) {
     try {
-        Sentry.setUser(user);
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        sdk?.setUser(user);
     }
     catch {
     }
 }
 function initializeSentry(config, environment, walletAddress, apiKey, appName) {
+    if (isInitialized) {
+        if (isEnabled) {
+            if (apiKey !== undefined && apiKey !== cachedApiKey) {
+                cachedApiKey = apiKey;
+                updateUser(walletAddress, environment);
+            }
+            else if (walletAddress !== currentIdentity?.walletAddress ||
+                environment !== currentIdentity?.environment) {
+                updateUser(walletAddress, environment);
+            }
+        }
+        return;
+    }
     if (config.enabled === false) {
         isEnabled = false;
-        console.log('August SDK: Analytics disabled');
+        isInitialized = true;
+        logger_1.Logger.log.info('analytics.disabled', { reason: 'config' });
         return;
     }
-    if (isLocalhost()) {
+    const forced = (0, env_1.isAnalyticsForcedOnViaEnv)();
+    if (!forced && (0, env_1.isAnalyticsDisabledViaEnv)()) {
         isEnabled = false;
-        console.log('August SDK: Analytics disabled on localhost');
+        isInitialized = true;
+        logger_1.Logger.log.info('analytics.disabled', {
+            reason: 'AUGUST_SDK_DISABLE_ANALYTICS',
+        });
         return;
     }
-    cachedApiKey = apiKey;
-    if (isInitialized) {
-        if (walletAddress !== currentIdentity?.walletAddress ||
-            environment !== currentIdentity?.environment) {
-            updateUser(walletAddress, environment);
-        }
+    if (!forced && (0, env_1.isNodeDevOrTestEnv)()) {
+        isEnabled = false;
+        isInitialized = true;
+        logger_1.Logger.log.info('analytics.disabled', {
+            reason: 'NODE_ENV',
+            nodeEnv: (0, env_1.readEnv)('NODE_ENV'),
+            hint: 'set AUGUST_SDK_FORCE_ANALYTICS=1 to override',
+        });
+        return;
+    }
+    if (!forced && isLocalhost()) {
+        isEnabled = false;
+        isInitialized = true;
+        logger_1.Logger.log.info('analytics.disabled', { reason: 'localhost' });
         return;
     }
+    cachedApiKey = apiKey;
     try {
-        Sentry.init({
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk) {
+            logger_1.Logger.log.warn('analytics.init.sentry-unavailable', {
+                runtime: (0, sentry_runtime_1.getSentryRuntime)(),
+                hint: 'Confirm @sentry/browser (or @sentry/node) is installed and reachable.',
+            });
+            isEnabled = false;
+            return;
+        }
+        const rawSampleRate = typeof config.tracesSampleRate === 'number' &&
+            Number.isFinite(config.tracesSampleRate)
+            ? config.tracesSampleRate
+            : 1.0;
+        const tracesSampleRate = Math.max(0, Math.min(1, rawSampleRate));
+        sdk.init({
             dsn: constants_1.SENTRY_DSN,
-            tracesSampleRate: 1.0,
+            tracesSampleRate,
             enableTracing: true,
             environment: environment.toLowerCase(),
             release: `august-sdk@${getSDKVersion()}`,
             sendDefaultPii: true,
-            integrations: [Sentry.captureConsoleIntegration({ levels: ['error'] })],
+            integrations: [sdk.captureConsoleIntegration({ levels: ['error'] })],
             beforeSend(event) {
                 if (event.tags?.sdk !== 'august-digital') {
                     return null;
@@ -125,13 +138,23 @@ function initializeSentry(config, environment, walletAddress, apiKey, appName) {
         updateUser(walletAddress, environment);
         safeSetTag('sdk', 'august-digital');
         safeSetTag('sdk.version', getSDKVersion());
+        safeSetTag('sdk.runtime', (0, sentry_runtime_1.getSentryRuntime)());
         if (appName) {
             safeSetTag('app.name', appName);
         }
+        safeSetTag('partner.id', appName ? `unverified:${appName}` : 'unverified:anonymous');
+        safeSetTag('partner.tier', 'unverified');
         isInitialized = true;
-        console.log('August SDK: Analytics initialized. Disable with { analytics: { enabled: false } }');
+        logger_1.Logger.log.info('analytics.initialized', {
+            runtime: (0, sentry_runtime_1.getSentryRuntime)(),
+            hint: 'Disable with { analytics: { enabled: false } } or AUGUST_SDK_DISABLE_ANALYTICS=1',
+        });
     }
-    catch {
+    catch (err) {
+        logger_1.Logger.log.warn('analytics.init.failed', {
+            runtime: (0, sentry_runtime_1.getSentryRuntime)(),
+            error: err instanceof Error ? err.message : String(err),
+        });
         isEnabled = false;
     }
 }
@@ -189,12 +212,45 @@ function isAnalyticsEnabled() {
 function getSentry() {
     if (!isAnalyticsEnabled())
         return null;
-    return Sentry;
+    return (0, sentry_runtime_1.getSentrySDK)();
 }
 function resetAnalytics() {
     isInitialized = false;
     isEnabled = true;
     currentIdentity = null;
     cachedApiKey = undefined;
+    (0, sentry_runtime_1.resetSentryRuntime)();
+}
+async function captureSdkException(error, options) {
+    if (!isAnalyticsEnabled())
+        return;
+    try {
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk)
+            return;
+        sdk.withScope((scope) => {
+            scope.setTag('sdk', 'august-digital');
+            if (options?.surface) {
+                scope.setTag('sdk.surface', options.surface);
+            }
+            if (options?.tags) {
+                for (const [k, v] of Object.entries(options.tags)) {
+                    scope.setTag(k, v);
+                }
+            }
+            if (options?.extra) {
+                for (const [k, v] of Object.entries(options.extra)) {
+                    scope.setExtra(k, v);
+                }
+            }
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            sdk.captureException(normalized);
+        });
+        if (options?.flushTimeoutMs && options.flushTimeoutMs > 0) {
+            await sdk.flush(options.flushTimeoutMs);
+        }
+    }
+    catch {
+    }
 }
 //# sourceMappingURL=sentry.js.map

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

@@ -1,6 +1,7 @@
 import { IEnv } from '../../types';
 export interface IAnalyticsConfig {
     enabled?: boolean;
+    tracesSampleRate?: number;
 }
 export interface IUserIdentity {
     apiKeyHash?: string;
@@ -12,6 +13,7 @@ export interface IUserIdentity {
 }
 export interface IMethodCallMetrics {
     method: string;
+    category?: string;
     chainId?: number;
     duration: number;
     success: boolean;

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

@@ -1 +1 @@
-export declare const SDK_VERSION = "6.0.1";
+export declare const SDK_VERSION = "7.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 = '6.0.1';
+exports.SDK_VERSION = '7.0.0';
 //# sourceMappingURL=version.js.map

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

@@ -19,6 +19,7 @@ export interface IAugustBase {
     monitoring?: IMonitoring;
     analytics?: IAnalyticsConfig;
     versionCheck?: IVersionCheckConfig;
+    timeoutMs?: number;
 }
 interface IActiveNetwork {
     chainId: IChainId;
@@ -31,7 +32,7 @@ export declare class AugustBase {
     activeNetwork?: IActiveNetwork;
     providers: IProvidersConfig;
     appName: string;
-    constructor({ appName, providers, keys, monitoring, analytics, versionCheck, }: IAugustBase);
+    constructor({ appName, providers, keys, monitoring, analytics, versionCheck, timeoutMs, }: IAugustBase);
     init(): Promise<void>;
     protected requireActiveNetwork(): IActiveNetwork;
     switchNetwork(chainId: IChainId): void;

package/lib/core/base.class.js

@@ -5,6 +5,7 @@ const auth_1 = require("./auth");
 const logger_1 = require("./logger");
 const analytics_1 = require("./analytics");
 const version_check_1 = require("./version-check");
+const fetcher_1 = require("./fetcher");
 function validateAppName(value) {
     const docsHint = 'See https://docs.augustdigital.io/developers/typescript-sdk#app-name';
     if (typeof value !== 'string' || value.trim().length === 0) {
@@ -20,7 +21,7 @@ function validateAppName(value) {
     return trimmed;
 }
 class AugustBase {
-    constructor({ appName, providers = {}, keys, monitoring, analytics, versionCheck, }) {
+    constructor({ appName, providers = {}, keys, monitoring, analytics, versionCheck, timeoutMs, }) {
         this.monitoring = {
             'x-user-id': undefined,
             'x-environment': undefined,
@@ -43,6 +44,9 @@ class AugustBase {
         logger_1.Logger.setDevMode(environment === 'DEV');
         (0, analytics_1.initializeSentry)(analytics ?? { enabled: true }, environment, monitoring?.['x-user-id'], keys?.august, this.appName);
         (0, version_check_1.runVersionCheck)(versionCheck);
+        if (typeof timeoutMs === 'number') {
+            (0, fetcher_1.setSdkRequestTimeout)(timeoutMs);
+        }
     }
     async init() {
         const [augustCheck] = await Promise.all([

package/lib/core/cache.d.ts

@@ -0,0 +1,4 @@
+import { LRUCache } from 'lru-cache';
+export declare const CACHE: LRUCache<string, any, unknown>;
+export declare const getSafeCache: <T>(key: string) => Promise<T | null>;
+export declare const setSafeCache: <T>(key: string, value: T) => Promise<void>;

package/lib/core/cache.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSafeCache = exports.getSafeCache = exports.CACHE = void 0;
+const lru_cache_1 = require("lru-cache");
+exports.CACHE = new lru_cache_1.LRUCache({
+    max: 1000,
+    ttl: 1000 * 60 * 60 * 24,
+    allowStale: true,
+});
+const getSafeCache = async (key) => {
+    if (!key)
+        return null;
+    if (exports.CACHE.has(key)) {
+        return exports.CACHE.get(key);
+    }
+    return null;
+};
+exports.getSafeCache = getSafeCache;
+const setSafeCache = async (key, value) => {
+    if (key && value) {
+        exports.CACHE.set(key, value);
+    }
+};
+exports.setSafeCache = setSafeCache;
+//# sourceMappingURL=cache.js.map

package/lib/core/fetcher.d.ts

@@ -1,5 +1,4 @@
 import { IAddress, IContractRunner, IHistoricalTimeseriesResponse, ITokenizedVault, IWSMonitorHeaders, IWSVaultLoan, VaultAddress } from '../types';
-import { LRUCache } from 'lru-cache';
 import { WEBSERVER_URL } from './constants/core';
 export type IFetchAugustMethods = 'get' | 'post' | 'put';
 export type IFetchAugustOptions = {
@@ -11,9 +10,10 @@ export type IFetchAugustOptions = {
     timeoutMs?: number;
     override?: boolean;
 };
-export declare const CACHE: LRUCache<string, any, unknown>;
-export declare const getSafeCache: <T>(key: string) => Promise<T | null>;
-export declare const setSafeCache: <T>(key: string, value: T) => Promise<void>;
+export declare function setSdkRequestTimeout(ms?: number | null): void;
+export declare function getSdkRequestTimeout(): number;
+import { CACHE, getSafeCache, setSafeCache } from './cache';
+export { CACHE, getSafeCache, setSafeCache };
 export declare function fetchAugustWithKey(apiKey: string, relativeUrl: string, options?: IFetchAugustOptions): Promise<Response>;
 export declare function fetchAugustPublic(relativeUrl: string, options?: IFetchAugustOptions): Promise<Response>;
 export declare function fetchAugustWithBearer(bearerToken: string, relativeUrl: string, options?: IFetchAugustOptions): Promise<Response>;

package/lib/core/fetcher.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setSafeCache = exports.getSafeCache = exports.CACHE = void 0;
+exports.setSdkRequestTimeout = setSdkRequestTimeout;
+exports.getSdkRequestTimeout = getSdkRequestTimeout;
 exports.fetchAugustWithKey = fetchAugustWithKey;
 exports.fetchAugustPublic = fetchAugustPublic;
 exports.fetchAugustWithBearer = fetchAugustWithBearer;
@@ -18,13 +20,13 @@ const core_1 = require("./helpers/core");
 const ethers_1 = require("ethers");
 const abis_1 = require("../abis");
 const lru_cache_1 = require("lru-cache");
-const utils_1 = require("../adapters/solana/utils");
-const utils_2 = require("../adapters/stellar/utils");
+const chain_address_1 = require("./helpers/chain-address");
 const fetcher_1 = require("../services/coingecko/fetcher");
 const logger_1 = require("./logger");
-const web3_1 = require("./helpers/web3");
+const ethers_2 = require("ethers");
+const web3_1 = require("./constants/web3");
 const core_2 = require("./constants/core");
-const vaults_1 = require("./helpers/vaults");
+const vault_version_1 = require("./helpers/vault-version");
 const analytics_1 = require("./analytics");
 const sanitize_1 = require("./analytics/sanitize");
 const errors_1 = require("./errors");
@@ -40,8 +42,25 @@ function errorFromResponseStatus(status, message, options) {
     }
     return new errors_1.AugustServerError(status, message, options);
 }
+let SDK_REQUEST_TIMEOUT_OVERRIDE = null;
+function setSdkRequestTimeout(ms = null) {
+    if (ms === null) {
+        SDK_REQUEST_TIMEOUT_OVERRIDE = null;
+        return;
+    }
+    if (!Number.isFinite(ms) || ms <= 0) {
+        logger_1.Logger.log.warn('setSdkRequestTimeout', 'Ignoring non-positive timeout', {
+            ms,
+        });
+        return;
+    }
+    SDK_REQUEST_TIMEOUT_OVERRIDE = ms;
+}
+function getSdkRequestTimeout() {
+    return SDK_REQUEST_TIMEOUT_OVERRIDE ?? core_2.REQUEST_TIMEOUT_MS;
+}
 function buildRequestAbortSignal(options) {
-    const timeoutMs = options?.timeoutMs ?? core_2.REQUEST_TIMEOUT_MS;
+    const timeoutMs = options?.timeoutMs ?? SDK_REQUEST_TIMEOUT_OVERRIDE ?? core_2.REQUEST_TIMEOUT_MS;
     const timeoutController = new AbortController();
     let didTimeout = false;
     const timeoutId = setTimeout(() => {
@@ -91,26 +110,10 @@ function readResponseHeader(headers, name) {
     const v = headers[name];
     return typeof v === 'string' ? v : undefined;
 }
-exports.CACHE = new lru_cache_1.LRUCache({
-    max: 1000,
-    ttl: 1000 * 60 * 60 * 24,
-    allowStale: true,
-});
-const getSafeCache = async (key) => {
-    if (!key)
-        return null;
-    if (exports.CACHE.has(key)) {
-        return exports.CACHE.get(key);
-    }
-    return null;
-};
-exports.getSafeCache = getSafeCache;
-const setSafeCache = async (key, value) => {
-    if (key && value) {
-        exports.CACHE.set(key, value);
-    }
-};
-exports.setSafeCache = setSafeCache;
+const cache_1 = require("./cache");
+Object.defineProperty(exports, "CACHE", { enumerable: true, get: function () { return cache_1.CACHE; } });
+Object.defineProperty(exports, "getSafeCache", { enumerable: true, get: function () { return cache_1.getSafeCache; } });
+Object.defineProperty(exports, "setSafeCache", { enumerable: true, get: function () { return cache_1.setSafeCache; } });
 const PRICE_CACHE = new lru_cache_1.LRUCache({
     max: 500,
     ttl: 1000 * 30,
@@ -338,7 +341,7 @@ async function fetchTokenizedVault(pool, headers, loadSubaccounts, loadSnapshots
         keyParts.push('no-snapshots');
     const key = keyParts.join('-');
     let tokenizedVault;
-    const cachedResponse = await (0, exports.getSafeCache)(key);
+    const cachedResponse = await (0, cache_1.getSafeCache)(key);
     if (cachedResponse) {
         tokenizedVault = cachedResponse;
     }
@@ -359,12 +362,10 @@ async function fetchTokenizedVault(pool, headers, loadSubaccounts, loadSnapshots
             headers: headers,
         });
         tokenizedVault = (await tokenizedVaultsResponse.json());
-        exports.CACHE.set(key, tokenizedVault, { ttl: 1000 * 60 * 10 });
+        cache_1.CACHE.set(key, tokenizedVault, { ttl: 1000 * 60 * 10 });
     }
     if (pool &&
-        ((0, ethers_1.isAddress)(pool) ||
-            utils_1.SolanaUtils.isSolanaAddress(pool) ||
-            (0, utils_2.isStellarAddress)(pool))) {
+        ((0, ethers_1.isAddress)(pool) || (0, chain_address_1.isSolanaAddress)(pool) || (0, chain_address_1.isStellarAddress)(pool))) {
         return tokenizedVault ? [tokenizedVault] : [];
     }
     return [tokenizedVault];
@@ -379,7 +380,7 @@ async function fetchTokenizedVaults(pool, headers, loadSubaccounts, loadSnapshot
         keyParts.push('no-snapshots');
     const key = keyParts.join('-');
     let tokenizedVaults;
-    const cachedResponse = await (0, exports.getSafeCache)(key);
+    const cachedResponse = await (0, cache_1.getSafeCache)(key);
     if (cachedResponse) {
         tokenizedVaults = cachedResponse;
     }
@@ -402,12 +403,10 @@ async function fetchTokenizedVaults(pool, headers, loadSubaccounts, loadSnapshot
         tokenizedVaults =
             (await tokenizedVaultsResponse.json());
         const ttl = 1000 * 60 * 15;
-        exports.CACHE.set(key, tokenizedVaults, { ttl });
+        cache_1.CACHE.set(key, tokenizedVaults, { ttl });
     }
     if (pool &&
-        ((0, ethers_1.isAddress)(pool) ||
-            utils_1.SolanaUtils.isSolanaAddress(pool) ||
-            (0, utils_2.isStellarAddress)(pool))) {
+        ((0, ethers_1.isAddress)(pool) || (0, chain_address_1.isSolanaAddress)(pool) || (0, chain_address_1.isStellarAddress)(pool))) {
         const foundObj = tokenizedVaults.find((t) => t.address.toLowerCase() === pool.toLowerCase());
         return foundObj ? [foundObj] : [];
     }
@@ -465,15 +464,13 @@ async function _fetchTokenPriceInternal(symbol, provider, coinGeckoKey, headers)
     }));
     const foundVaultLpAsset = vaultArray.find((v) => v.symbol?.toLowerCase() === symbol?.toLowerCase());
     const tokenizedVault = tokenizedVaults.find((vault) => vault.address === foundVaultLpAsset?.vault);
-    const version = (0, vaults_1.getVaultVersionV2)(tokenizedVault);
+    const version = (0, vault_version_1.getVaultVersionV2)(tokenizedVault);
     if (foundVaultLpAsset?.vault && provider && version === 'evm-2') {
         try {
-            const vaultContract = (0, web3_1.createContract)({
-                provider,
-                address: (0, ethers_1.getAddress)(foundVaultLpAsset?.vault),
-                abi: abis_1.ABI_TOKENIZED_VAULT_V2,
-            });
-            const decimals = await (0, web3_1.getDecimals)(provider, await (0, web3_1.getReceiptTokenAddress)(provider, foundVaultLpAsset?.vault), false);
+            const vaultContract = new ethers_2.Contract((0, ethers_1.getAddress)(foundVaultLpAsset?.vault), abis_1.ABI_TOKENIZED_VAULT_V2, provider);
+            const receiptAddress = (await vaultContract.lpTokenAddress());
+            const receiptContract = new ethers_2.Contract(receiptAddress, [web3_1.MIN_ABIS.decimals], provider);
+            const decimals = Number(await receiptContract.decimals());
             const sharePrice = await vaultContract.getSharePrice();
             return Number((0, core_1.toNormalizedBn)(sharePrice, decimals).normalized);
         }
@@ -491,11 +488,7 @@ async function _fetchTokenPriceInternal(symbol, provider, coinGeckoKey, headers)
         }
         const json = (await res.json());
         if (foundVaultLpAsset && provider) {
-            const vaultContract = (0, web3_1.createContract)({
-                provider,
-                address: (0, ethers_1.getAddress)(foundVaultLpAsset.vault),
-                abi: abis_1.ABI_LENDING_POOL_V2,
-            });
+            const vaultContract = new ethers_2.Contract((0, ethers_1.getAddress)(foundVaultLpAsset.vault), abis_1.ABI_LENDING_POOL_V2, provider);
             const [totalAssets, totalSupply, rawDecimals] = await Promise.all([
                 vaultContract.totalAssets(),
                 vaultContract.totalSupply(),
@@ -510,11 +503,7 @@ async function _fetchTokenPriceInternal(symbol, provider, coinGeckoKey, headers)
     catch (e) {
         const fallbackPrice = await (0, fetcher_1.fetchTokenPricesFromCoinGecko)(symbol, coinGeckoKey);
         if (foundVaultLpAsset && provider) {
-            const vaultContract = (0, web3_1.createContract)({
-                provider,
-                address: (0, ethers_1.getAddress)(foundVaultLpAsset.vault),
-                abi: abis_1.ABI_LENDING_POOL_V2,
-            });
+            const vaultContract = new ethers_2.Contract((0, ethers_1.getAddress)(foundVaultLpAsset.vault), abis_1.ABI_LENDING_POOL_V2, provider);
             const [totalAssets, totalSupply, rawDecimals] = await Promise.all([
                 vaultContract.totalAssets(),
                 vaultContract.totalSupply(),
@@ -561,32 +550,32 @@ async function fetchTokenPriceByAddress(address, chainId, headers) {
 async function fetchTokenizedVaultLoans(pool, chainId, headers) {
     const key = `loans-${chainId}-${pool}`;
     let loans;
-    if (exports.CACHE.get(key)) {
-        loans = exports.CACHE.get(key);
+    if (cache_1.CACHE.get(key)) {
+        loans = cache_1.CACHE.get(key);
     }
     else {
         const tokenizedVaultsResponse = await fetchAugustPublic(core_2.WEBSERVER_ENDPOINTS.public.tokenizedVault.loans(pool, chainId, true), { headers: headers });
         loans = (await tokenizedVaultsResponse.json()).loans;
-        exports.CACHE.set(key, loans);
+        cache_1.CACHE.set(key, loans);
     }
     return loans?.filter((l) => l.state.toLowerCase() === 'active');
 }
 async function fetchTokenizedVaultSubaccountLoans(pool, chainId, headers) {
     const key = `subaccount-loans-${chainId}-${pool}`;
     let loans;
-    if (exports.CACHE.get(key)) {
-        loans = exports.CACHE.get(key);
+    if (cache_1.CACHE.get(key)) {
+        loans = cache_1.CACHE.get(key);
     }
     else {
         const tokenizedVaultsResponse = await fetchAugustPublic(core_2.WEBSERVER_ENDPOINTS.public.tokenizedVault.subaccountLoans(pool, chainId, true), { headers: headers });
         loans = (await tokenizedVaultsResponse.json()).loans;
-        exports.CACHE.set(key, loans);
+        cache_1.CACHE.set(key, loans);
     }
     return loans?.filter((l) => l.state.toLowerCase() === 'active');
 }
 async function fetchVaultHistoricalTimeseries(vaultAddress, nDays, headers) {
     const key = `vault-historical-timeseries-${vaultAddress}-${nDays}`;
-    const cachedResponse = await (0, exports.getSafeCache)(key);
+    const cachedResponse = await (0, cache_1.getSafeCache)(key);
     if (cachedResponse) {
         return cachedResponse;
     }
@@ -595,7 +584,7 @@ async function fetchVaultHistoricalTimeseries(vaultAddress, nDays, headers) {
         throw new Error(`Failed to fetch historical timeseries data: ${response.statusText}`);
     }
     const json = (await response.json());
-    exports.CACHE.set(key, json, { ttl: 1000 * 60 * 10 });
+    cache_1.CACHE.set(key, json, { ttl: 1000 * 60 * 10 });
     return json;
 }
 async function promiseSettle(promises, maxRetries = 3, baseDelay = 1000) {

package/lib/core/helpers/chain-address.d.ts

@@ -0,0 +1,3 @@
+export declare function isSolanaAddress(address: string): boolean;
+export declare function isStellarAddress(address: string): boolean;
+export declare function isSuiAddress(address: string): boolean;

package/lib/core/helpers/chain-address.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSolanaAddress = isSolanaAddress;
+exports.isStellarAddress = isStellarAddress;
+exports.isSuiAddress = isSuiAddress;
+const ethers_1 = require("ethers");
+const web3_js_1 = require("@solana/web3.js");
+const STELLAR_ADDRESS_RE = /^[A-Z2-7]{56}$/;
+function isSolanaAddress(address) {
+    if (!address)
+        return false;
+    if ((0, ethers_1.isAddress)(address))
+        return false;
+    try {
+        new web3_js_1.PublicKey(address);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isStellarAddress(address) {
+    if (!address || typeof address !== 'string')
+        return false;
+    if (address.length !== 56)
+        return false;
+    if (address[0] !== 'G' && address[0] !== 'C')
+        return false;
+    return STELLAR_ADDRESS_RE.test(address);
+}
+function isSuiAddress(address) {
+    if (!address || typeof address !== 'string')
+        return false;
+    return /^0x[a-fA-F0-9]{64}$/.test(address);
+}
+//# sourceMappingURL=chain-address.js.map

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

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

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

@@ -0,0 +1,11 @@
+"use strict";
+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}`;
+};
+exports.explorerLink = explorerLink;
+//# sourceMappingURL=explorer-link.js.map

package/lib/core/helpers/vault-version.d.ts

@@ -0,0 +1,4 @@
+import { ITokenizedVault, IVaultVersion, ChainType } from '../../types';
+export declare function getAddressChainType(address: string): ChainType;
+export declare function getVaultVersion(vault: string): IVaultVersion | undefined;
+export declare function getVaultVersionV2(vault: ITokenizedVault): IVaultVersion | undefined;