upshift-finance 1.0.0

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

@@ -0,0 +1,66 @@
+import type { IHIstoricalSnapshot } from '../../types';
+export interface IEmberVault {
+    address: string;
+    id: string;
+    name: string;
+    description: string;
+    logoUrl: string;
+    status: 'active' | 'beta' | 'deprecated';
+    publicType: string;
+    strategy: string;
+    createdAt: number;
+    totalDeposits: string;
+    totalDepositsInUsdE9: string;
+    maxDepositsAllowed: string;
+    rateE9: string;
+    managementFeePercentE9: string;
+    weeklyPerformanceFeeBpsE9: string;
+    withdrawalPeriodDays: number;
+    minWithdrawalSharesE9: string;
+    historicalSnapshots?: IHIstoricalSnapshot[];
+    max_drawdown?: number | null;
+    depositCoin: {
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        logoUrl: string;
+        priceE9: string;
+        type: string;
+    };
+    receiptCoin: {
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        logoUrl: string;
+        priceE9: string;
+        type: string;
+    };
+    reportedApy: {
+        apyE9: string;
+        reportedApyE9: string;
+        updatedAt: string;
+    };
+    managers: Array<{
+        id: string;
+        name: string;
+        logoUrl: string;
+        websiteUrl: string;
+    }>;
+    subAccounts: Array<{
+        address: string;
+        manager: {
+            id: string;
+            name: string;
+            logoUrl: string;
+            websiteUrl: string;
+        };
+    }>;
+    rewards: any[];
+}
+export interface IFetchEmberVaultsOptions {
+    limit?: number;
+    offset?: number;
+    status?: string;
+}

package/lib/adapters/sui/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/adapters/sui/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert E9 format to regular number
+ */
+export declare function convertFromE9(value: string | number): number;
+/**
+ * Calculate capacity utilization percentage
+ */
+export declare function calculateUtilization(current: string | number, maximum: string | number): number;
+export { isSuiAddress } from '../../core/helpers/chain-address';
+export declare function isSuiVault(chainId: number): boolean;

package/lib/adapters/sui/utils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSuiAddress = void 0;
+exports.convertFromE9 = convertFromE9;
+exports.calculateUtilization = calculateUtilization;
+exports.isSuiVault = isSuiVault;
+const constants_1 = require("./constants");
+/**
+ * Convert E9 format to regular number
+ */
+function convertFromE9(value) {
+    return Number(value) / constants_1.EMBER_DEFAULTS.E9_DIVISOR;
+}
+/**
+ * Calculate capacity utilization percentage
+ */
+function calculateUtilization(current, maximum) {
+    const currentValue = Number(current) || 0;
+    const maxValue = Number(maximum) || 0;
+    if (maxValue === 0)
+        return 0;
+    return Math.min((currentValue / maxValue) * 100, 100);
+}
+var chain_address_1 = require("../../core/helpers/chain-address");
+Object.defineProperty(exports, "isSuiAddress", { enumerable: true, get: function () { return chain_address_1.isSuiAddress; } });
+function isSuiVault(chainId) {
+    return chainId === constants_1.SUI_CHAIN_ID;
+}
+//# sourceMappingURL=utils.js.map

package/lib/core/analytics/chain-name.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Map a numeric `chainId` to a stable lowercase slug for use as a Sentry tag
+ * value. Resolves both EVM chains ({@link NETWORKS}) and synthetic non-EVM
+ * chain IDs ({@link SPECIAL_CHAINS}); unknown IDs return `'unknown:<id>'`.
+ *
+ * @param chainId - Numeric chain ID, including negative IDs for non-EVM chains.
+ * @returns Slugified chain label (e.g. `'ethereum'`, `'arbitrum-one'`, `'solana'`).
+ */
+export declare function chainIdToTagValue(chainId: number | undefined): string;

package/lib/core/analytics/chain-name.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainIdToTagValue = chainIdToTagValue;
+const web3_1 = require("../constants/web3");
+/**
+ * Map a numeric `chainId` to a stable lowercase slug for use as a Sentry tag
+ * value. Resolves both EVM chains ({@link NETWORKS}) and synthetic non-EVM
+ * chain IDs ({@link SPECIAL_CHAINS}); unknown IDs return `'unknown:<id>'`.
+ *
+ * @param chainId - Numeric chain ID, including negative IDs for non-EVM chains.
+ * @returns Slugified chain label (e.g. `'ethereum'`, `'arbitrum-one'`, `'solana'`).
+ */
+function chainIdToTagValue(chainId) {
+    if (chainId === undefined || chainId === null || Number.isNaN(chainId)) {
+        return 'unknown';
+    }
+    for (const entry of Object.values(web3_1.SPECIAL_CHAINS)) {
+        if (entry.chainId === chainId) {
+            return slugify(entry.name);
+        }
+    }
+    const network = web3_1.NETWORKS[chainId];
+    if (network) {
+        return slugify(network.name);
+    }
+    return `unknown:${chainId}`;
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=chain-name.js.map

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

@@ -0,0 +1,5 @@
+/**
+ * Sentry DSN for SDK analytics.
+ * This is an internal constant - not exposed to SDK users.
+ */
+export declare const SENTRY_DSN = "https://ca39246016d0b43154f0640314cbd3b5@o4507215496609792.ingest.de.sentry.io/4511864614813776";

package/lib/core/analytics/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENTRY_DSN = void 0;
+/**
+ * Sentry DSN for SDK analytics.
+ * This is an internal constant - not exposed to SDK users.
+ */
+exports.SENTRY_DSN = 'https://ca39246016d0b43154f0640314cbd3b5@o4507215496609792.ingest.de.sentry.io/4511864614813776';
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1,29 @@
+/**
+ * Environment-variable gates for analytics. Pure functions — safe to import
+ * anywhere, no Sentry side effects. Tested directly in `analytics.test.js`.
+ */
+/**
+ * Read a process env var without crashing in browsers or in bundles where
+ * `process.env` is a frozen / proxied object that throws on missing keys.
+ */
+export declare function readEnv(name: string): string | undefined;
+/**
+ * `AUGUST_SDK_FORCE_ANALYTICS=1` bypasses the dev/test and localhost gates.
+ * Used by our own smoke-test script and by partners deliberately exercising
+ * telemetry in a non-prod environment.
+ */
+export declare function isAnalyticsForcedOnViaEnv(): boolean;
+/**
+ * `AUGUST_SDK_DISABLE_ANALYTICS=1` is the env equivalent of passing
+ * `analytics: { enabled: false }`. Useful when partners can't easily plumb
+ * config through (CI runners, ops scripts).
+ */
+export declare function isAnalyticsDisabledViaEnv(): boolean;
+/**
+ * True when `NODE_ENV` is `'development'` or `'test'`. The SDK auto-disables
+ * analytics in these environments so partners' local dev runs and Jest suites
+ * don't pollute the production Sentry project.
+ *
+ * `NODE_ENV` undefined / `'production'` / `'staging'` / anything else → false.
+ */
+export declare function isNodeDevOrTestEnv(): boolean;

package/lib/core/analytics/env.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Environment-variable gates for analytics. Pure functions — safe to import
+ * anywhere, no Sentry side effects. Tested directly in `analytics.test.js`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readEnv = readEnv;
+exports.isAnalyticsForcedOnViaEnv = isAnalyticsForcedOnViaEnv;
+exports.isAnalyticsDisabledViaEnv = isAnalyticsDisabledViaEnv;
+exports.isNodeDevOrTestEnv = isNodeDevOrTestEnv;
+/**
+ * Read a process env var without crashing in browsers or in bundles where
+ * `process.env` is a frozen / proxied object that throws on missing keys.
+ */
+function readEnv(name) {
+    try {
+        if (typeof process !== 'undefined' && process.env) {
+            return process.env[name];
+        }
+    }
+    catch {
+        // Bundlers occasionally throw on `process.env` access. Treat as unset.
+    }
+    return undefined;
+}
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    const v = value.toLowerCase();
+    return v === '1' || v === 'true' || v === 'yes' || v === 'on';
+}
+/**
+ * `AUGUST_SDK_FORCE_ANALYTICS=1` bypasses the dev/test and localhost gates.
+ * Used by our own smoke-test script and by partners deliberately exercising
+ * telemetry in a non-prod environment.
+ */
+function isAnalyticsForcedOnViaEnv() {
+    return isTruthyEnv(readEnv('AUGUST_SDK_FORCE_ANALYTICS'));
+}
+/**
+ * `AUGUST_SDK_DISABLE_ANALYTICS=1` is the env equivalent of passing
+ * `analytics: { enabled: false }`. Useful when partners can't easily plumb
+ * config through (CI runners, ops scripts).
+ */
+function isAnalyticsDisabledViaEnv() {
+    return isTruthyEnv(readEnv('AUGUST_SDK_DISABLE_ANALYTICS'));
+}
+/**
+ * True when `NODE_ENV` is `'development'` or `'test'`. The SDK auto-disables
+ * analytics in these environments so partners' local dev runs and Jest suites
+ * don't pollute the production Sentry project.
+ *
+ * `NODE_ENV` undefined / `'production'` / `'staging'` / anything else → false.
+ */
+function isNodeDevOrTestEnv() {
+    const env = readEnv('NODE_ENV');
+    return env === 'development' || env === 'test';
+}
+//# sourceMappingURL=env.js.map

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

@@ -0,0 +1,36 @@
+/**
+ * Analytics module for SDK usage tracking via Sentry.
+ *
+ * Features:
+ * - User identification (API key hash, wallet, fingerprint, session)
+ * - Method call tracking with timing
+ * - Cache hit/miss rate monitoring
+ * - API response time tracking
+ * - Chain/network usage distribution
+ *
+ * @example
+ * ```typescript
+ * // Analytics enabled by default
+ * const sdk = new AugustSDK({
+ *   providers: { 1: 'https://...' },
+ *   keys: { august: '...' },
+ * });
+ *
+ * // Opt-out of analytics
+ * const sdk = new AugustSDK({
+ *   providers: { 1: 'https://...' },
+ *   keys: { august: '...' },
+ *   analytics: { enabled: false },
+ * });
+ * ```
+ */
+export type { IAnalyticsConfig, IUserIdentity, IMethodCallMetrics, } from './types';
+export { hashApiKey, getSessionId, generateFingerprint, createUserIdentity, getUserId, } from './user-identity';
+export { initializeSentry, updateUser, clearUser, isAnalyticsEnabled, getSentry, resetAnalytics, captureSdkException, } from './sentry';
+export { getSentrySDK, getSentryRuntime } from './sentry-runtime';
+export { readEnv, isAnalyticsDisabledViaEnv, isAnalyticsForcedOnViaEnv, isNodeDevOrTestEnv, } from './env';
+export { trackApiCall, trackNetworkSwitch, getCacheStats, resetCacheStats, } from './metrics';
+export { sanitizeArgs, sanitizeObject, computeArgShape } from './sanitize';
+export { withMethodTracking, withSyncMethodTracking, instrumentClass, } from './instrumentation';
+export { METHOD_CATEGORIES, getMethodCategory, type MethodCategory, } from './method-taxonomy';
+export { chainIdToTagValue } from './chain-name';

package/lib/core/analytics/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Analytics module for SDK usage tracking via Sentry.
+ *
+ * Features:
+ * - User identification (API key hash, wallet, fingerprint, session)
+ * - Method call tracking with timing
+ * - Cache hit/miss rate monitoring
+ * - API response time tracking
+ * - Chain/network usage distribution
+ *
+ * @example
+ * ```typescript
+ * // Analytics enabled by default
+ * const sdk = new AugustSDK({
+ *   providers: { 1: 'https://...' },
+ *   keys: { august: '...' },
+ * });
+ *
+ * // Opt-out of analytics
+ * const sdk = new AugustSDK({
+ *   providers: { 1: 'https://...' },
+ *   keys: { august: '...' },
+ *   analytics: { enabled: false },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chainIdToTagValue = exports.getMethodCategory = exports.METHOD_CATEGORIES = exports.instrumentClass = exports.withSyncMethodTracking = exports.withMethodTracking = exports.computeArgShape = exports.sanitizeObject = exports.sanitizeArgs = exports.resetCacheStats = exports.getCacheStats = exports.trackNetworkSwitch = exports.trackApiCall = exports.isNodeDevOrTestEnv = exports.isAnalyticsForcedOnViaEnv = exports.isAnalyticsDisabledViaEnv = exports.readEnv = exports.getSentryRuntime = exports.getSentrySDK = exports.captureSdkException = exports.resetAnalytics = exports.getSentry = exports.isAnalyticsEnabled = exports.clearUser = exports.updateUser = exports.initializeSentry = exports.getUserId = exports.createUserIdentity = exports.generateFingerprint = exports.getSessionId = exports.hashApiKey = void 0;
+// User identity utilities
+var user_identity_1 = require("./user-identity");
+Object.defineProperty(exports, "hashApiKey", { enumerable: true, get: function () { return user_identity_1.hashApiKey; } });
+Object.defineProperty(exports, "getSessionId", { enumerable: true, get: function () { return user_identity_1.getSessionId; } });
+Object.defineProperty(exports, "generateFingerprint", { enumerable: true, get: function () { return user_identity_1.generateFingerprint; } });
+Object.defineProperty(exports, "createUserIdentity", { enumerable: true, get: function () { return user_identity_1.createUserIdentity; } });
+Object.defineProperty(exports, "getUserId", { enumerable: true, get: function () { return user_identity_1.getUserId; } });
+// Sentry core
+var sentry_1 = require("./sentry");
+Object.defineProperty(exports, "initializeSentry", { enumerable: true, get: function () { return sentry_1.initializeSentry; } });
+Object.defineProperty(exports, "updateUser", { enumerable: true, get: function () { return sentry_1.updateUser; } });
+Object.defineProperty(exports, "clearUser", { enumerable: true, get: function () { return sentry_1.clearUser; } });
+Object.defineProperty(exports, "isAnalyticsEnabled", { enumerable: true, get: function () { return sentry_1.isAnalyticsEnabled; } });
+Object.defineProperty(exports, "getSentry", { enumerable: true, get: function () { return sentry_1.getSentry; } });
+Object.defineProperty(exports, "resetAnalytics", { enumerable: true, get: function () { return sentry_1.resetAnalytics; } });
+Object.defineProperty(exports, "captureSdkException", { enumerable: true, get: function () { return sentry_1.captureSdkException; } });
+// Isomorphic Sentry runtime resolver
+var sentry_runtime_1 = require("./sentry-runtime");
+Object.defineProperty(exports, "getSentrySDK", { enumerable: true, get: function () { return sentry_runtime_1.getSentrySDK; } });
+Object.defineProperty(exports, "getSentryRuntime", { enumerable: true, get: function () { return sentry_runtime_1.getSentryRuntime; } });
+// Env-variable gates
+var env_1 = require("./env");
+Object.defineProperty(exports, "readEnv", { enumerable: true, get: function () { return env_1.readEnv; } });
+Object.defineProperty(exports, "isAnalyticsDisabledViaEnv", { enumerable: true, get: function () { return env_1.isAnalyticsDisabledViaEnv; } });
+Object.defineProperty(exports, "isAnalyticsForcedOnViaEnv", { enumerable: true, get: function () { return env_1.isAnalyticsForcedOnViaEnv; } });
+Object.defineProperty(exports, "isNodeDevOrTestEnv", { enumerable: true, get: function () { return env_1.isNodeDevOrTestEnv; } });
+// Metrics tracking
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "trackApiCall", { enumerable: true, get: function () { return metrics_1.trackApiCall; } });
+Object.defineProperty(exports, "trackNetworkSwitch", { enumerable: true, get: function () { return metrics_1.trackNetworkSwitch; } });
+Object.defineProperty(exports, "getCacheStats", { enumerable: true, get: function () { return metrics_1.getCacheStats; } });
+Object.defineProperty(exports, "resetCacheStats", { enumerable: true, get: function () { return metrics_1.resetCacheStats; } });
+// Sanitization utilities
+var sanitize_1 = require("./sanitize");
+Object.defineProperty(exports, "sanitizeArgs", { enumerable: true, get: function () { return sanitize_1.sanitizeArgs; } });
+Object.defineProperty(exports, "sanitizeObject", { enumerable: true, get: function () { return sanitize_1.sanitizeObject; } });
+Object.defineProperty(exports, "computeArgShape", { enumerable: true, get: function () { return sanitize_1.computeArgShape; } });
+// Method instrumentation
+var instrumentation_1 = require("./instrumentation");
+Object.defineProperty(exports, "withMethodTracking", { enumerable: true, get: function () { return instrumentation_1.withMethodTracking; } });
+Object.defineProperty(exports, "withSyncMethodTracking", { enumerable: true, get: function () { return instrumentation_1.withSyncMethodTracking; } });
+Object.defineProperty(exports, "instrumentClass", { enumerable: true, get: function () { return instrumentation_1.instrumentClass; } });
+// Method taxonomy
+var method_taxonomy_1 = require("./method-taxonomy");
+Object.defineProperty(exports, "METHOD_CATEGORIES", { enumerable: true, get: function () { return method_taxonomy_1.METHOD_CATEGORIES; } });
+Object.defineProperty(exports, "getMethodCategory", { enumerable: true, get: function () { return method_taxonomy_1.getMethodCategory; } });
+// Chain name helper
+var chain_name_1 = require("./chain-name");
+Object.defineProperty(exports, "chainIdToTagValue", { enumerable: true, get: function () { return chain_name_1.chainIdToTagValue; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,29 @@
+/**
+ * Higher-order function to wrap SDK methods with performance tracking.
+ * Tracks method calls, timing, chain usage, and errors.
+ *
+ * @param methodName - Name of the method being wrapped
+ * @param method - The original async method
+ * @param getChainId - Function to get current chain ID
+ * @returns Wrapped method with tracking
+ */
+export declare function withMethodTracking<T extends (...args: unknown[]) => Promise<unknown>>(methodName: string, method: T, getChainId?: () => number | undefined): T;
+/**
+ * Higher-order function to wrap synchronous SDK methods with tracking.
+ * Uses breadcrumbs for tracking since spans require async context.
+ *
+ * @param methodName - Name of the method being wrapped
+ * @param method - The original sync method
+ * @param getChainId - Function to get current chain ID
+ * @returns Wrapped method with tracking
+ */
+export declare function withSyncMethodTracking<T extends (...args: unknown[]) => unknown>(methodName: string, method: T, getChainId?: () => number | undefined): T;
+/**
+ * Instrument all methods on a class instance with tracking.
+ * This auto-wraps all public methods (both async and sync) without boilerplate.
+ *
+ * @param instance - The class instance to instrument
+ * @param getChainId - Function to get current chain ID
+ * @returns The same instance with instrumented methods
+ */
+export declare function instrumentClass<T extends object>(instance: T, getChainId: () => number | undefined): T;