@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/services/oracleAdapterService/oracleAdapterService.d.ts

@@ -0,0 +1,40 @@
+import type { Address } from "viem";
+import type { BuildQueryFn } from "../../utils/buildQuery.js";
+import type { OracleAdapterEntry } from "../../utils/oracle.js";
+export type OracleAdapterCheck = {
+    id?: string;
+    pass?: boolean;
+    [key: string]: unknown;
+};
+export type OracleAdapterMetadata = {
+    address: Address;
+    provider?: string;
+    methodology?: string;
+    label?: string;
+    name?: string;
+    checks?: OracleAdapterCheck[];
+    [key: string]: unknown;
+};
+export type EnrichedOracleAdapterEntry = OracleAdapterEntry & {
+    metadata?: OracleAdapterMetadata;
+};
+export interface OracleAdapterServiceConfig {
+    baseUrl?: string;
+    cacheMs?: number;
+}
+export interface IOracleAdapterService {
+    fetchOracleAdapters(chainId: number): Promise<OracleAdapterMetadata[]>;
+    fetchOracleAdapterMap(chainId: number): Promise<Record<string, OracleAdapterMetadata>>;
+    enrichAdapters(chainId: number, adapters: OracleAdapterEntry[]): Promise<EnrichedOracleAdapterEntry[]>;
+}
+export declare class OracleAdapterService implements IOracleAdapterService {
+    private readonly config;
+    private cache;
+    constructor(config?: OracleAdapterServiceConfig, buildQuery?: BuildQueryFn);
+    queryOracleAdapters: (chainId: number) => Promise<unknown>;
+    setQueryOracleAdapters(fn: typeof this.queryOracleAdapters): void;
+    fetchOracleAdapters(chainId: number): Promise<OracleAdapterMetadata[]>;
+    fetchOracleAdapterMap(chainId: number): Promise<Record<string, OracleAdapterMetadata>>;
+    enrichAdapters(chainId: number, adapters: OracleAdapterEntry[]): Promise<EnrichedOracleAdapterEntry[]>;
+    private parseOracleAdapters;
+}

package/dist/src/services/oracleAdapterService/oracleAdapterService.js

@@ -0,0 +1,65 @@
+import { applyBuildQuery } from "../../utils/buildQuery.js";
+const DEFAULT_BASE_URL = "https://oracle-checks-data.euler.finance";
+const DEFAULT_CACHE_MS = 10 * 60 * 1000;
+export class OracleAdapterService {
+    config;
+    cache = new Map();
+    constructor(config = {}, buildQuery) {
+        this.config = config;
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    queryOracleAdapters = async (chainId) => {
+        const base = this.config.baseUrl ?? DEFAULT_BASE_URL;
+        const res = await fetch(`${base}/${chainId}/adapters/all.json`);
+        if (!res.ok) {
+            throw new Error(`Oracle adapters request failed: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    };
+    setQueryOracleAdapters(fn) {
+        this.queryOracleAdapters = fn;
+    }
+    async fetchOracleAdapters(chainId) {
+        const now = Date.now();
+        const cached = this.cache.get(chainId);
+        if (cached && cached.expiresAt > now)
+            return cached.value;
+        const raw = await this.queryOracleAdapters(chainId);
+        const parsed = this.parseOracleAdapters(raw);
+        this.cache.set(chainId, {
+            expiresAt: now + (this.config.cacheMs ?? DEFAULT_CACHE_MS),
+            value: parsed,
+        });
+        return parsed;
+    }
+    async fetchOracleAdapterMap(chainId) {
+        const adapters = await this.fetchOracleAdapters(chainId);
+        return Object.fromEntries(adapters.map((adapter) => [adapter.address.toLowerCase(), adapter]));
+    }
+    async enrichAdapters(chainId, adapters) {
+        if (adapters.length === 0)
+            return [];
+        const metadata = await this.fetchOracleAdapterMap(chainId);
+        return adapters.map((adapter) => ({
+            ...adapter,
+            metadata: metadata[adapter.oracle.toLowerCase()],
+        }));
+    }
+    parseOracleAdapters(raw) {
+        if (!Array.isArray(raw))
+            return [];
+        return raw
+            .filter((item) => typeof item === "object" &&
+            item !== null &&
+            typeof item.address === "string")
+            .map((item) => ({
+            ...item,
+            address: item.address,
+            checks: Array.isArray(item.checks)
+                ? item.checks
+                : undefined,
+        }));
+    }
+}
+//# sourceMappingURL=oracleAdapterService.js.map

package/dist/src/services/oracleAdapterService/oracleAdapterService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracleAdapterService.js","sourceRoot":"","sources":["../../../../src/services/oracleAdapterService/oracleAdapterService.ts"],"names":[],"mappings":"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"}

package/dist/src/services/priceService/backendClient.d.ts

@@ -0,0 +1,70 @@
+import type { Address } from "viem";
+import { type BuildQueryFn } from "../../utils/buildQuery.js";
+/**
+ * Normalized response shape from the price backend.
+ */
+export type BackendPriceData = {
+    address: string;
+    price: number;
+    source: string;
+    symbol?: string;
+    timestamp?: number;
+};
+/**
+ * Legacy response from /v1/prices endpoint.
+ * Flat object keyed by lowercase address.
+ */
+export type BackendPriceResponse = Record<string, BackendPriceData>;
+export type V3PriceRow = {
+    address?: string;
+    price?: number;
+    priceUsd?: number;
+    source?: string;
+    symbol?: string;
+    timestamp?: string;
+};
+export type V3PriceResponse = {
+    data?: V3PriceRow[];
+    meta?: {
+        total?: number;
+        offset?: number;
+        limit?: number;
+        timestamp?: string;
+        chainId?: string;
+    };
+};
+/**
+ * Backend configuration for the price service.
+ */
+export type BackendConfig = {
+    /** Backend API endpoint URL. */
+    endpoint: string;
+    /** Optional API key sent as `X-API-Key` for V3-style backend requests. */
+    apiKey?: string;
+    /** Default chain ID for requests. */
+    chainId?: number;
+};
+/**
+ * Convert backend price (number) to bigint with 18 decimals.
+ */
+export declare const backendPriceToBigInt: (price: string | number) => bigint;
+/**
+ * Instance-based backend price client with batching.
+ */
+export declare class PricingBackendClient {
+    private readonly endpoint;
+    private readonly apiKey?;
+    constructor(config: BackendConfig, buildQuery?: BuildQueryFn);
+    get isConfigured(): boolean;
+    private getHeaders;
+    private parseResponse;
+    /**
+     * Fetch a single asset price. Concurrent calls within the same microtask
+     * are bundled into a single request per chainId.
+     */
+    queryV3Price: (key: {
+        address: Address;
+        chainId: number;
+    }) => Promise<BackendPriceData | undefined>;
+    setQueryV3Price(fn: typeof this.queryV3Price): void;
+}

package/dist/src/services/priceService/backendClient.js

@@ -0,0 +1,108 @@
+import { applyBuildQuery } from "../../utils/buildQuery.js";
+import { createCallBundler } from "../../utils/callBundler.js";
+/**
+ * Convert backend price (number) to bigint with 18 decimals.
+ */
+export const backendPriceToBigInt = (price) => {
+    try {
+        const priceNum = typeof price === "number" ? price : parseFloat(price);
+        if (Number.isNaN(priceNum) || priceNum < 0) {
+            return 0n;
+        }
+        const priceString = priceNum.toFixed(18);
+        const [intPart, decPart = ""] = priceString.split(".");
+        const paddedDec = decPart.slice(0, 18);
+        return BigInt(intPart + paddedDec);
+    }
+    catch {
+        return 0n;
+    }
+};
+/**
+ * Instance-based backend price client with batching.
+ */
+export class PricingBackendClient {
+    endpoint;
+    apiKey;
+    constructor(config, buildQuery) {
+        this.endpoint = config.endpoint;
+        this.apiKey = config.apiKey;
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    get isConfigured() {
+        return !!this.endpoint;
+    }
+    getHeaders() {
+        return {
+            Accept: "application/json",
+            ...(this.apiKey ? { "X-API-Key": this.apiKey } : {}),
+        };
+    }
+    parseResponse(data) {
+        const map = new Map();
+        if (data &&
+            typeof data === "object" &&
+            "data" in data &&
+            Array.isArray(data.data)) {
+            for (const row of data.data ?? []) {
+                if (!row.address)
+                    continue;
+                const price = row.priceUsd ?? row.price;
+                if (typeof price !== "number")
+                    continue;
+                const timestamp = row.timestamp
+                    ? Math.floor(new Date(row.timestamp).getTime() / 1000)
+                    : undefined;
+                map.set(row.address.toLowerCase(), {
+                    address: row.address,
+                    price,
+                    source: row.source ?? "v3",
+                    symbol: row.symbol,
+                    timestamp,
+                });
+            }
+            return map;
+        }
+        for (const [addr, priceData] of Object.entries(data)) {
+            map.set(addr.toLowerCase(), priceData);
+        }
+        return map;
+    }
+    /**
+     * Fetch a single asset price. Concurrent calls within the same microtask
+     * are bundled into a single request per chainId.
+     */
+    queryV3Price = createCallBundler(async (keys) => {
+        // Group by chainId
+        const byChain = new Map();
+        for (const key of keys) {
+            const arr = byChain.get(key.chainId) ?? [];
+            arr.push(key.address);
+            byChain.set(key.chainId, arr);
+        }
+        // One request per chainId
+        const chainResults = new Map();
+        for (const [chainId, addresses] of byChain) {
+            const unique = [
+                ...new Set(addresses.map((a) => a.toLowerCase())),
+            ];
+            const url = new URL("/v3/prices", this.endpoint);
+            url.searchParams.set("chainId", String(chainId));
+            url.searchParams.set("assets", unique.join(","));
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers: this.getHeaders(),
+            });
+            if (response.ok) {
+                const data = (await response.json());
+                chainResults.set(chainId, this.parseResponse(data));
+            }
+        }
+        return keys.map((key) => chainResults.get(key.chainId)?.get(key.address.toLowerCase()));
+    });
+    setQueryV3Price(fn) {
+        this.queryV3Price = fn;
+    }
+}
+//# sourceMappingURL=backendClient.js.map

package/dist/src/services/priceService/backendClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backendClient.js","sourceRoot":"","sources":["../../../../src/services/priceService/backendClient.ts"],"names":[],"mappings":"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"}

package/dist/src/services/priceService/index.d.ts

@@ -0,0 +1,2 @@
+export { PriceService, type IPriceService, type PriceResult, type FormattedAssetValue, type FormatAssetValueOptions, ONE_18, USD_ADDRESS, getAssetOraclePrice, getCollateralShareOraclePrice, getCollateralOraclePrice, } from "./priceService.js";
+export { PricingBackendClient, backendPriceToBigInt, type BackendConfig, type BackendPriceData, type BackendPriceResponse, } from "./backendClient.js";

package/dist/src/services/priceService/index.js

@@ -0,0 +1,3 @@
+export { PriceService, ONE_18, USD_ADDRESS, getAssetOraclePrice, getCollateralShareOraclePrice, getCollateralOraclePrice, } from "./priceService.js";
+export { PricingBackendClient, backendPriceToBigInt, } from "./backendClient.js";
+//# sourceMappingURL=index.js.map

package/dist/src/services/priceService/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/priceService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EAKZ,MAAM,EACN,WAAW,EACX,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,GAIpB,MAAM,oBAAoB,CAAC"}

package/dist/src/services/priceService/priceService.d.ts

@@ -0,0 +1,133 @@
+import { type Address } from "viem";
+import type { OraclePrice } from "../../utils/oracle.js";
+import type { EVault } from "../../entities/EVault.js";
+import type { ERC4626Vault } from "../../entities/ERC4626Vault.js";
+import type { ProviderService } from "../providerService/providerService.js";
+import type { DeploymentService } from "../deploymentService/deploymentService.js";
+import { type PricingBackendClient } from "./backendClient.js";
+import { type BuildQueryFn } from "../../utils/buildQuery.js";
+import { type ServiceResult } from "../../utils/entityDiagnostics.js";
+export declare const ONE_18: bigint;
+/** Euler virtual USD address (decimal 840 = ISO-4217 USD). */
+export declare const USD_ADDRESS: Address;
+/**
+ * Price result with mid, ask, and bid prices.
+ * `decimals` indicates the precision of the quote (output) asset —
+ * e.g. 18 for USD amounts, or the UoA decimals for Layer-1 oracle prices.
+ */
+export type PriceResult = {
+    amountOutMid: bigint;
+    amountOutAsk: bigint;
+    amountOutBid: bigint;
+    decimals: number;
+};
+export type FormatAssetValueOptions = {
+    maxDecimals?: number;
+    minDecimals?: number;
+};
+export type FormattedAssetValue = {
+    /** Formatted display string: "1,234.56 USDC" when no price available, empty when price available (caller formats USD). */
+    display: string;
+    /** Whether a USD price was available. */
+    hasPrice: boolean;
+    /** USD value of the amount (0 when no price). */
+    usdValue: number;
+    /** Human-readable token amount. */
+    assetAmount: number;
+    /** Token symbol. */
+    assetSymbol: string;
+};
+export interface IPriceService {
+    getAssetOraclePrice(vault: EVault): PriceResult | undefined;
+    getCollateralShareOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): OraclePrice | undefined;
+    getCollateralOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): PriceResult | undefined;
+    fetchUnitOfAccountUsdRate(vault: EVault): Promise<bigint | undefined>;
+    fetchUnitOfAccountUsdRateWithDiagnostics(vault: EVault, path?: string): Promise<ServiceResult<bigint | undefined>>;
+    fetchAssetUsdPrice(vault: ERC4626Vault): Promise<PriceResult | undefined>;
+    fetchAssetUsdPriceWithDiagnostics(vault: ERC4626Vault, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    fetchAssetUsdPriceByAddress(chainId: number, assetAddress: Address): Promise<PriceResult | undefined>;
+    fetchAssetUsdPriceByAddressWithDiagnostics(chainId: number, assetAddress: Address, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    fetchCollateralUsdPrice(liabilityVault: EVault, collateralVault: ERC4626Vault): Promise<PriceResult | undefined>;
+    fetchCollateralUsdPriceWithDiagnostics(liabilityVault: EVault, collateralVault: ERC4626Vault, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    formatAssetValue(amount: bigint, vault: ERC4626Vault, options?: FormatAssetValueOptions): Promise<FormattedAssetValue>;
+}
+export declare class PriceService implements IPriceService {
+    private providerService;
+    private deploymentService;
+    private backendClient?;
+    constructor(providerService: ProviderService, deploymentService: DeploymentService, backendClient?: PricingBackendClient | undefined, buildQuery?: BuildQueryFn);
+    setProviderService(providerService: ProviderService): void;
+    setBackendClient(backendClient: PricingBackendClient | undefined): void;
+    queryAssetPriceInfo: (provider: ReturnType<ProviderService["getProvider"]>, utilsLensAddress: Address, assetAddress: Address) => Promise<{
+        queryFailure: boolean;
+        amountOutMid: bigint;
+    }>;
+    setQueryAssetPriceInfo(fn: typeof this.queryAssetPriceInfo): void;
+    getAssetOraclePrice(vault: EVault): PriceResult | undefined;
+    getCollateralShareOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): OraclePrice | undefined;
+    getCollateralOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): PriceResult | undefined;
+    /**
+     * Get the USD rate for a vault's unit of account.
+     * Always tries backend first (UoA is a common denominator —
+     * using off-chain rates doesn't affect health factor/LTV ratios).
+     * Falls back to on-chain utilsLens call.
+     */
+    fetchUnitOfAccountUsdRate(vault: EVault): Promise<bigint | undefined>;
+    fetchUnitOfAccountUsdRateWithDiagnostics(vault: EVault, path?: string): Promise<ServiceResult<bigint | undefined>>;
+    /**
+     * Get asset price in USD.
+     * Tries backend first, falls back to on-chain oracle.
+     * EVault: oraclePrice × uoaRate.
+     * EulerEarn / SecuritizeCollateral: utilsLens or backend.
+     */
+    fetchAssetUsdPrice(vault: ERC4626Vault): Promise<PriceResult | undefined>;
+    fetchAssetUsdPriceWithDiagnostics(vault: ERC4626Vault, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    /**
+     * Get a standalone asset price in USD by token address.
+     * Tries backend first, then falls back to utilsLens.getAssetPriceInfo(asset, USD).
+     */
+    fetchAssetUsdPriceByAddress(chainId: number, assetAddress: Address): Promise<PriceResult | undefined>;
+    fetchAssetUsdPriceByAddressWithDiagnostics(chainId: number, assetAddress: Address, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    /**
+     * Get collateral price in USD in the context of a liability vault.
+     * Tries backend first, falls back to on-chain oracle.
+     * Collateral pricing ALWAYS uses the liability vault's oracle for on-chain fallback.
+     */
+    fetchCollateralUsdPrice(liabilityVault: EVault, collateralVault: ERC4626Vault): Promise<PriceResult | undefined>;
+    fetchCollateralUsdPriceWithDiagnostics(liabilityVault: EVault, collateralVault: ERC4626Vault, path?: string): Promise<ServiceResult<PriceResult | undefined>>;
+    /**
+     * Format an asset amount for UI display.
+     * Returns USD value when price is available, falls back to token amount + symbol.
+     */
+    formatAssetValue(amount: bigint, vault: ERC4626Vault, options?: FormatAssetValueOptions): Promise<FormattedAssetValue>;
+    /**
+     * Get asset USD price from on-chain oracles.
+     * EVault: oraclePriceRaw × UoA rate.
+     * EulerEarn / SecuritizeCollateral: utilsLens.getAssetPriceInfo.
+     */
+    private fetchAssetUsdPriceFromOracle;
+    private fetchDirectAssetUsdPriceFromOracle;
+    /**
+     * Get collateral USD price from on-chain oracles.
+     */
+    private fetchCollateralUsdPriceFromOracle;
+    /**
+     * Call utilsLens.getAssetPriceInfo(asset, USD_ADDRESS) on-chain.
+     */
+    private fetchAssetPriceInfo;
+}
+/**
+ * Get raw oracle price for a vault's asset in the vault's unit of account.
+ * Uses oraclePriceRaw (liabilityPriceInfo from the vault lens).
+ */
+export declare function getAssetOraclePrice(vault: EVault): PriceResult | undefined;
+/**
+ * Get collateral share price from the liability vault's perspective.
+ * Returns the raw OraclePrice in the liability vault's unit of account.
+ */
+export declare function getCollateralShareOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): OraclePrice | undefined;
+/**
+ * Get collateral ASSET price from the liability vault's perspective.
+ * Converts share price to asset price using totalShares/totalAssets.
+ */
+export declare function getCollateralOraclePrice(liabilityVault: EVault, collateralVault: ERC4626Vault): PriceResult | undefined;