@upshiftfinance/sdk 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,15 @@
+/**
+ * Fetch the latest USD price for a token symbol from CoinGecko's
+ * `/market_chart/range` endpoint, mapped through `COINGECKO_COIN_ID_MAP`.
+ *
+ * @param symbol - Token symbol (case-insensitive). Must be present in
+ *   `COINGECKO_COIN_ID_MAP`.
+ * @param coinGeckoKey - CoinGecko Pro API key passed as `x-cg-pro-api-key`.
+ * @returns The latest price in USD (a number) on success; `null` when the
+ *   response contains an empty or missing `prices` array. `musd` (mezo-usd)
+ *   is a USD-pegged stablecoin and short-circuits to a price of `1`.
+ * @throws {@link UpshiftValidationError} When `symbol` is not in `COINGECKO_COIN_ID_MAP`.
+ * @throws {@link UpshiftRateLimitError} On a 429 response from CoinGecko.
+ * @throws {@link UpshiftServerError} On any other non-2xx response.
+ */
+export declare function fetchTokenPricesFromCoinGecko(symbol: string, coinGeckoKey: string): Promise<number>;

package/lib/services/coingecko/fetcher.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTokenPricesFromCoinGecko = fetchTokenPricesFromCoinGecko;
+const logger_1 = require("../../core/logger");
+const errors_1 = require("../../core/errors");
+const utils_1 = require("./utils");
+/**
+ * Fetch the latest USD price for a token symbol from CoinGecko's
+ * `/market_chart/range` endpoint, mapped through `COINGECKO_COIN_ID_MAP`.
+ *
+ * @param symbol - Token symbol (case-insensitive). Must be present in
+ *   `COINGECKO_COIN_ID_MAP`.
+ * @param coinGeckoKey - CoinGecko Pro API key passed as `x-cg-pro-api-key`.
+ * @returns The latest price in USD (a number) on success; `null` when the
+ *   response contains an empty or missing `prices` array. `musd` (mezo-usd)
+ *   is a USD-pegged stablecoin and short-circuits to a price of `1`.
+ * @throws {@link UpshiftValidationError} When `symbol` is not in `COINGECKO_COIN_ID_MAP`.
+ * @throws {@link UpshiftRateLimitError} On a 429 response from CoinGecko.
+ * @throws {@link UpshiftServerError} On any other non-2xx response.
+ */
+async function fetchTokenPricesFromCoinGecko(symbol, coinGeckoKey) {
+    const coinId = utils_1.COINGECKO_COIN_ID_MAP[symbol.toLowerCase()];
+    if (coinId === 'mezo-usd') {
+        return 1;
+    }
+    if (!coinId) {
+        throw new errors_1.UpshiftValidationError('INVALID_INPUT', `fetchTokenPricesFromCoinGecko: symbol "${symbol}" is not in COINGECKO_COIN_ID_MAP`, { context: { symbol } });
+    }
+    const sevendDaysInS = 7 * 24 * 60 * 60;
+    const from = Date.now() / 1000 - sevendDaysInS;
+    const url = `https://pro-api.coingecko.com/api/v3/coins/${coinId}/market_chart/range?vs_currency=usd&from=${from}&to=${Math.floor(Date.now() / 1000)}&interval=daily`;
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-cg-pro-api-key': coinGeckoKey,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 429) {
+                throw new errors_1.UpshiftRateLimitError(`CoinGecko rate-limited (429): symbol "${symbol}"`, { context: { symbol, coinId, status: response.status } });
+            }
+            throw new errors_1.UpshiftServerError(response.status, `CoinGecko API error ${response.status} ${response.statusText}: symbol "${symbol}"`, { context: { symbol, coinId } });
+        }
+        const data = (await response.json());
+        // `/market_chart/range` returns `{ prices, market_caps, total_volumes }` —
+        // an object. The previous `data.length` check was always falsy on the
+        // success path and silently collapsed every valid response to `null`.
+        if (data?.prices?.length) {
+            return data.prices[data.prices.length - 1][1];
+        }
+        return null;
+    }
+    catch (error) {
+        logger_1.Logger.log.error('fetchTokenPricesFromCoinGecko', error, {
+            coinId,
+            symbol,
+        });
+        // Re-throw typed SDK errors (UpshiftRateLimitError, UpshiftServerError, etc.)
+        // so callers can distinguish rate-limits and server errors from "no data".
+        if (error instanceof errors_1.UpshiftSDKError)
+            throw error;
+        return null;
+    }
+}
+//# sourceMappingURL=fetcher.js.map

package/lib/services/coingecko/index.d.ts

@@ -0,0 +1,2 @@
+export * from './utils';
+export * from './fetcher';

package/lib/services/coingecko/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./utils"), exports);
+__exportStar(require("./fetcher"), exports);
+//# sourceMappingURL=index.js.map

package/lib/services/coingecko/utils.d.ts

@@ -0,0 +1 @@
+export declare const COINGECKO_COIN_ID_MAP: Record<string, string>;

package/lib/services/coingecko/utils.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COINGECKO_COIN_ID_MAP = void 0;
+exports.COINGECKO_COIN_ID_MAP = {
+    rseth: 'kelp-dao-restaked-eth',
+    usdc: 'usd-coin',
+    cbbtc: 'coinbase-wrapped-btc',
+    lbtc: 'lombard-staked-btc',
+    wsteth: 'wrapped-steth',
+    susde: 'ethena-staked-usde',
+    ausd: 'agora-dollar',
+    wavax: 'wrapped-avax',
+    cusdo: 'compounding-open-dollar',
+    whype: 'wrapped-hype',
+    usdt: 'binance-bridged-usdt-bnb-smart-chain',
+    usr: 'resolv-usr',
+    tbtc: 'tbtc',
+    ubtc: 'unit-bitcoin',
+    weth: 'weth',
+    teth: 'treehouse-eth',
+    musd: 'mezo-usd',
+    xbtc: 'tbtc',
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1,126 @@
+import type { IAddress, IWSMonitorHeaders } from '../../types';
+export interface IDebankStatsObject {
+    asset_usd_value: number;
+    debt_usd_value: number;
+    net_usd_value: number;
+}
+export interface IDebankPoolObject {
+    controller: string;
+    id: string;
+    chain: string;
+    project_id: string;
+    adapter_id?: string | null;
+    time_at?: number | null;
+}
+export interface IDebankProxyDetailObject {
+    project?: Record<string, unknown> | null;
+    proxy_contract_id?: string | null;
+}
+export interface IDebankTokenObject {
+    id: string;
+    chain: string;
+    name: string;
+    symbol: string;
+    display_symbol: unknown;
+    optimized_symbol: string;
+    decimals: number;
+    protocol_id: string;
+    is_core?: boolean | null;
+    price: number;
+    time_at?: number | null;
+    logo_url?: string | null;
+    price_24h_change?: number | null;
+    credit_score?: number | null;
+    is_verified?: boolean | null;
+    is_scam?: boolean | null;
+    is_suspicious?: boolean | null;
+    is_wallet?: boolean | null;
+    amount?: number | null;
+    raw_amount?: number | null;
+}
+export interface IDebankAppTokenObject {
+    id: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    logo_url?: string | null;
+    app_id?: string | null;
+    price: number;
+    amount?: number | null;
+    [key: string]: unknown;
+}
+export interface IDebankDetailObject {
+    supply_token_list?: IDebankTokenObject[];
+    reward_token_list?: IDebankTokenObject[];
+    borrow_token_list?: IDebankTokenObject[];
+    health_rate?: number | null;
+}
+export interface IDebankAppPortfolioDetailObject {
+    supply_token_list?: IDebankAppTokenObject[];
+    reward_token_list?: IDebankAppTokenObject[];
+    borrow_token_list?: IDebankAppTokenObject[];
+    description?: string | null;
+}
+export type IDebankPortfolioItemName = 'Yield' | 'Deposit' | 'Staked' | 'Locked' | 'Farming' | 'Leveraged Farming' | 'Lending' | 'Vesting' | 'Rewards' | 'Airdrop' | 'Liquidity Pool' | 'Options Seller' | 'Options Buyer' | 'Insurance' | 'Investment' | 'Governance' | 'Perpetuals' | 'NFT Staked' | 'NFT Liquidity Pool' | 'NFT Lending' | 'NFT Fraction' | 'NFT P2P Borrower' | 'NFT P2P Lender';
+export interface IDebankPortfolioItemObject {
+    stats: IDebankStatsObject;
+    update_at: number;
+    name: IDebankPortfolioItemName;
+    detail_types: string[];
+    detail: IDebankDetailObject;
+    proxy_detail?: IDebankProxyDetailObject | null;
+    position_index?: string | null;
+    pool: IDebankPoolObject;
+}
+export interface IDebankAppPortfolioItemObject {
+    stats: IDebankStatsObject;
+    update_at: number;
+    name: string;
+    detail_types: string[];
+    detail: IDebankAppPortfolioDetailObject;
+    proxy_detail?: IDebankProxyDetailObject | null;
+    position_index?: string | null;
+    [key: string]: unknown;
+}
+export interface IDebankUserProtocol {
+    id: string;
+    chain: string;
+    name: string;
+    logo_url?: string | null;
+    site_url: string;
+    has_supported_portfolio: boolean;
+    portfolio_item_list: IDebankPortfolioItemObject[];
+}
+export interface IDebankAppProtocol {
+    id: string;
+    name: string;
+    logo_url?: string | null;
+    site_url: string;
+    has_supported_portfolio: boolean;
+    portfolio_item_list: IDebankAppPortfolioItemObject[];
+}
+export interface IDebankAccountData {
+    positions: IDebankUserProtocol[];
+    app_positions: IDebankAppProtocol[];
+    tokens: IDebankTokenObject[];
+}
+export interface IDebankAccountDataError {
+    error: string;
+}
+/**
+ * Response type for vault-level DeBank data.
+ * Keys are subaccount addresses, values are either DeBank data or error objects.
+ */
+export type IVaultDebankResponse = Record<string, IDebankAccountData | IDebankAccountDataError>;
+/**
+ * Fetch DeBank data for all subaccounts of a vault in a single request.
+ * @param vaultAddress The vault contract address
+ * @param headers Optional monitoring headers
+ * @returns Dictionary of subaccount addresses to DeBank data, or false on error
+ */
+export declare function fetchVaultDebankResponse(vaultAddress: IAddress, headers?: IWSMonitorHeaders): Promise<IVaultDebankResponse | false>;
+/**
+ * @deprecated Use fetchVaultDebankResponse for vault-level queries.
+ * Fetch DeBank data for a single subaccount address.
+ */
+export declare function fetchDebankResponse(address: IAddress, headers?: IWSMonitorHeaders): Promise<any>;

package/lib/services/debank/fetcher.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchVaultDebankResponse = fetchVaultDebankResponse;
+exports.fetchDebankResponse = fetchDebankResponse;
+const core_1 = require("../../core");
+/**
+ * Fetch DeBank data for all subaccounts of a vault in a single request.
+ * @param vaultAddress The vault contract address
+ * @param headers Optional monitoring headers
+ * @returns Dictionary of subaccount addresses to DeBank data, or false on error
+ */
+async function fetchVaultDebankResponse(vaultAddress, headers) {
+    try {
+        const response = await (0, core_1.fetchUpshiftPublic)(core_1.WEBSERVER_ENDPOINTS.public.tokenizedVault.debank(vaultAddress), { headers: headers });
+        // 200 = success, 207 = partial success (some subaccounts failed)
+        if (response.status === 200 || response.status === 207) {
+            const data = (await response.json());
+            return data;
+        }
+        core_1.Logger.log.error('fetchVaultDebankResponse', new Error(`HTTP ${response.status} ${response.statusText}`), { status: response.status, statusText: response.statusText });
+        return false;
+    }
+    catch (e) {
+        core_1.Logger.log.error('fetchVaultDebankResponse', e);
+        return false;
+    }
+}
+/**
+ * @deprecated Use fetchVaultDebankResponse for vault-level queries.
+ * Fetch DeBank data for a single subaccount address.
+ */
+async function fetchDebankResponse(address, headers) {
+    // filter out hyperevm since debank does not yet support hyperevm
+    const debankResponse = await (0, core_1.fetchUpshiftWithKey)(undefined, core_1.WEBSERVER_ENDPOINTS.subaccount.debank(address), { headers: headers });
+    if (debankResponse.status !== 200) {
+        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) {
+        const debankRes = await debankResponse.json();
+        return debankRes;
+    }
+}
+//# sourceMappingURL=fetcher.js.map

package/lib/services/debank/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fetcher';
+export * from './utils';

package/lib/services/debank/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fetcher"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/lib/services/debank/utils.d.ts

@@ -0,0 +1,50 @@
+import type { IAddress, IDebankProtocolExposure, IDebankTokenExposure, IExposurePerCategory } from '../../types';
+import type { IDebankAppProtocol, IDebankTokenObject, IDebankUserProtocol } from './fetcher';
+/**
+ * DeBank-shaped exposure for one subaccount. Produced from DeBank directly
+ * and by the Octav.fi / Untangled transformers, which map their data into
+ * this same shape so one parser handles every source.
+ */
+export interface IDebankNormalizedResponse {
+    subaccount: {
+        /** Protocol positions (DeBank `user_protocol` objects). */
+        positions: IDebankUserProtocol[];
+        /** App positions; only present on DeBank-sourced responses. */
+        app_positions?: IDebankAppProtocol[];
+        /** Wallet (idle) token balances. */
+        tokens: IDebankTokenObject[];
+    };
+}
+export declare function parseVaultLevelDebank(debankRes: IDebankNormalizedResponse, protocolExposure: IDebankProtocolExposure[], tokenExposure: IDebankTokenExposure[], borrower: IAddress, exposurePerCategory: IExposurePerCategory, netValue: {
+    value: number;
+}): {
+    tokenMap: Record<string, string>;
+    protocolTokenMap: Record<string, string[]>;
+    protocolExposures: IDebankUserProtocol[];
+    tokenExposures: IDebankTokenObject[];
+    loansExposure: {
+        exposure: any[];
+        positions: any[];
+    };
+};
+export declare function getVaultExposure(debankResponse: IDebankNormalizedResponse): {
+    borrowing_exposure: {
+        symbol: string;
+        chain: string;
+        amount: number;
+    }[];
+    supplying_exposure: {
+        symbol: string;
+        chain: string;
+        amount: number;
+    }[];
+    wallet_exposure: {
+        symbol: string;
+        chain: string;
+        amount: number;
+    }[];
+};
+export declare function parseLoanLevelDebank(debankRes: any): {
+    exposure: any[];
+    positions: any[];
+};