@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/utils/irm.js

@@ -0,0 +1,213 @@
+import { decodeAbiParameters, formatUnits } from "viem";
+export var InterestRateModelType;
+(function (InterestRateModelType) {
+    InterestRateModelType[InterestRateModelType["UNKNOWN"] = 0] = "UNKNOWN";
+    InterestRateModelType[InterestRateModelType["KINK"] = 1] = "KINK";
+    InterestRateModelType[InterestRateModelType["ADAPTIVE_CURVE"] = 2] = "ADAPTIVE_CURVE";
+    InterestRateModelType[InterestRateModelType["KINKY"] = 3] = "KINKY";
+    InterestRateModelType[InterestRateModelType["FIXED_CYCLICAL_BINARY"] = 4] = "FIXED_CYCLICAL_BINARY";
+})(InterestRateModelType || (InterestRateModelType = {}));
+const UINT32_MAX = 2n ** 32n - 1n;
+const SECONDS_PER_YEAR = 31_556_952;
+/**
+ * Decodes IRM parameters from the encoded bytes returned by IRMLens.getInterestRateModelInfo
+ * @param type The interest rate model type
+ * @param params The encoded parameters as a hex string
+ * @returns The decoded IRM parameters matching the specified type
+ * @throws Error if the type is UNKNOWN or invalid
+ */
+export function decodeIRMParams(type, params) {
+    switch (type) {
+        case InterestRateModelType.KINK: {
+            const [baseRate, slope1, slope2, kink] = decodeAbiParameters([
+                { name: "baseRate", type: "uint256" },
+                { name: "slope1", type: "uint256" },
+                { name: "slope2", type: "uint256" },
+                { name: "kink", type: "uint256" },
+            ], params);
+            return { baseRate, slope1, slope2, kink };
+        }
+        case InterestRateModelType.ADAPTIVE_CURVE: {
+            const [targetUtilization, initialRateAtTarget, minRateAtTarget, maxRateAtTarget, curveSteepness, adjustmentSpeed,] = decodeAbiParameters([
+                { name: "targetUtilization", type: "int256" },
+                { name: "initialRateAtTarget", type: "int256" },
+                { name: "minRateAtTarget", type: "int256" },
+                { name: "maxRateAtTarget", type: "int256" },
+                { name: "curveSteepness", type: "int256" },
+                { name: "adjustmentSpeed", type: "int256" },
+            ], params);
+            return {
+                targetUtilization,
+                initialRateAtTarget,
+                minRateAtTarget,
+                maxRateAtTarget,
+                curveSteepness,
+                adjustmentSpeed,
+            };
+        }
+        case InterestRateModelType.KINKY: {
+            const [baseRate, slope, shape, kink, cutoff] = decodeAbiParameters([
+                { name: "baseRate", type: "uint256" },
+                { name: "slope", type: "uint256" },
+                { name: "shape", type: "uint256" },
+                { name: "kink", type: "uint256" },
+                { name: "cutoff", type: "uint256" },
+            ], params);
+            return { baseRate, slope, shape, kink, cutoff };
+        }
+        case InterestRateModelType.FIXED_CYCLICAL_BINARY: {
+            const [primaryRate, secondaryRate, primaryDuration, secondaryDuration, startTimestamp,] = decodeAbiParameters([
+                { name: "primaryRate", type: "uint256" },
+                { name: "secondaryRate", type: "uint256" },
+                { name: "primaryDuration", type: "uint256" },
+                { name: "secondaryDuration", type: "uint256" },
+                { name: "startTimestamp", type: "uint256" },
+            ], params);
+            return {
+                primaryRate,
+                secondaryRate,
+                primaryDuration,
+                secondaryDuration,
+                startTimestamp,
+            };
+        }
+        default:
+            throw new Error(`Cannot decode IRM params for type: ${InterestRateModelType[type]}`);
+    }
+}
+export function normalizeIRMParams(type, data) {
+    if (!data || typeof data !== "object")
+        return null;
+    switch (type) {
+        case InterestRateModelType.KINK: {
+            const baseRate = toBigIntValue(data, "baseRate");
+            const slope1 = toBigIntValue(data, "slope1");
+            const slope2 = toBigIntValue(data, "slope2");
+            const kink = toBigIntValue(data, "kink");
+            return baseRate !== null &&
+                slope1 !== null &&
+                slope2 !== null &&
+                kink !== null
+                ? { baseRate, slope1, slope2, kink }
+                : null;
+        }
+        case InterestRateModelType.ADAPTIVE_CURVE: {
+            const targetUtilization = toBigIntValue(data, "targetUtilization");
+            const initialRateAtTarget = toBigIntValue(data, "initialRateAtTarget");
+            const minRateAtTarget = toBigIntValue(data, "minRateAtTarget");
+            const maxRateAtTarget = toBigIntValue(data, "maxRateAtTarget");
+            const curveSteepness = toBigIntValue(data, "curveSteepness");
+            const adjustmentSpeed = toBigIntValue(data, "adjustmentSpeed");
+            return targetUtilization !== null &&
+                initialRateAtTarget !== null &&
+                minRateAtTarget !== null &&
+                maxRateAtTarget !== null &&
+                curveSteepness !== null &&
+                adjustmentSpeed !== null
+                ? {
+                    targetUtilization,
+                    initialRateAtTarget,
+                    minRateAtTarget,
+                    maxRateAtTarget,
+                    curveSteepness,
+                    adjustmentSpeed,
+                }
+                : null;
+        }
+        case InterestRateModelType.KINKY: {
+            const baseRate = toBigIntValue(data, "baseRate");
+            const slope = toBigIntValue(data, "slope");
+            const shape = toBigIntValue(data, "shape");
+            const kink = toBigIntValue(data, "kink");
+            const cutoff = toBigIntValue(data, "cutoff");
+            return baseRate !== null &&
+                slope !== null &&
+                shape !== null &&
+                kink !== null &&
+                cutoff !== null
+                ? { baseRate, slope, shape, kink, cutoff }
+                : null;
+        }
+        case InterestRateModelType.FIXED_CYCLICAL_BINARY: {
+            const primaryRate = toBigIntValue(data, "primaryRate");
+            const secondaryRate = toBigIntValue(data, "secondaryRate");
+            const primaryDuration = toBigIntValue(data, "primaryDuration");
+            const secondaryDuration = toBigIntValue(data, "secondaryDuration");
+            const startTimestamp = toBigIntValue(data, "startTimestamp");
+            return primaryRate !== null &&
+                secondaryRate !== null &&
+                primaryDuration !== null &&
+                secondaryDuration !== null &&
+                startTimestamp !== null
+                ? {
+                    primaryRate,
+                    secondaryRate,
+                    primaryDuration,
+                    secondaryDuration,
+                    startTimestamp,
+                }
+                : null;
+        }
+        default:
+            return null;
+    }
+}
+export function decorateIRMParams(type, data, interestFee) {
+    if (!data)
+        return null;
+    switch (type) {
+        case InterestRateModelType.KINK: {
+            const kinkData = data;
+            const baseSPY = kinkData.baseRate;
+            const kinkSPY = kinkData.baseRate + kinkData.kink * kinkData.slope1;
+            const maxSPY = kinkData.baseRate +
+                kinkData.kink * kinkData.slope1 +
+                (UINT32_MAX - kinkData.kink) * kinkData.slope2;
+            const kinkUtilization = Number(kinkData.kink) / Number(UINT32_MAX);
+            const baseBorrowAPY = spyToApyPercent(baseSPY);
+            const kinkBorrowAPY = spyToApyPercent(kinkSPY);
+            const maxBorrowAPY = spyToApyPercent(maxSPY);
+            return {
+                kinkPct: bigintToPercent(kinkData.kink, UINT32_MAX),
+                baseBorrowAPY,
+                kinkBorrowAPY,
+                maxBorrowAPY,
+                baseSupplyAPY: supplyApyFromBorrowApy(baseBorrowAPY, 0, interestFee),
+                kinkSupplyAPY: supplyApyFromBorrowApy(kinkBorrowAPY, kinkUtilization, interestFee),
+                maxSupplyAPY: supplyApyFromBorrowApy(maxBorrowAPY, 1, interestFee),
+            };
+        }
+        case InterestRateModelType.ADAPTIVE_CURVE:
+        case InterestRateModelType.KINKY:
+        case InterestRateModelType.FIXED_CYCLICAL_BINARY:
+        default:
+            return null;
+    }
+}
+function toBigIntValue(data, key) {
+    const value = data[key];
+    if (typeof value === "bigint")
+        return value;
+    if (typeof value === "string" || typeof value === "number") {
+        try {
+            return BigInt(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function spyToApyPercent(spy) {
+    const spyPerSecond = Number(formatUnits(spy, 27));
+    if (!Number.isFinite(spyPerSecond))
+        return Number.POSITIVE_INFINITY;
+    return ((1 + spyPerSecond) ** SECONDS_PER_YEAR - 1) * 100;
+}
+function bigintToPercent(value, scale) {
+    return Number(formatUnits(value * 10000n, 2)) / Number(scale);
+}
+function supplyApyFromBorrowApy(borrowAPY, utilization, interestFee) {
+    return borrowAPY * utilization * (1 - interestFee);
+}
+//# sourceMappingURL=irm.js.map

package/dist/src/utils/irm.js.map

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

package/dist/src/utils/normalization.d.ts

@@ -0,0 +1,30 @@
+import type { DataIssue } from "./entityDiagnostics.js";
+type BigintToSafeNumberParams = {
+    path: string;
+    errors: DataIssue[];
+    source: string;
+    entityId?: string;
+    message?: string;
+};
+export declare function bigintToSafeNumber(value: bigint, params: BigintToSafeNumberParams): number;
+type NumberLikeToSafeFiniteNumberParams = {
+    path: string;
+    errors: DataIssue[];
+    source: string;
+    entityId?: string;
+    fallback?: number;
+    message?: string;
+};
+export declare function numberLikeToSafeFiniteNumber(value: bigint | number, params: NumberLikeToSafeFiniteNumberParams): number;
+type BigintToScaledNumberParams = {
+    path: string;
+    errors: DataIssue[];
+    source: string;
+    entityId?: string;
+    scale: number;
+    maxUnscaled?: bigint;
+    minUnscaled?: bigint;
+    overflowMessage?: string;
+};
+export declare function bigintToScaledNumber(value: bigint, params: BigintToScaledNumberParams): number;
+export {};

package/dist/src/utils/normalization.js

@@ -0,0 +1,79 @@
+export function bigintToSafeNumber(value, params) {
+    const { path, errors, source, entityId } = params;
+    if (value <= BigInt(Number.MAX_SAFE_INTEGER) &&
+        value >= BigInt(Number.MIN_SAFE_INTEGER)) {
+        return Number(value);
+    }
+    const clamped = value > 0n ? Number.MAX_SAFE_INTEGER : Number.MIN_SAFE_INTEGER;
+    errors.push({
+        code: "OUT_OF_RANGE_CLAMPED",
+        severity: "warning",
+        message: params.message ??
+            "BigInt value exceeded JavaScript safe number range and was clamped.",
+        paths: [path],
+        source,
+        entityId,
+        originalValue: value.toString(),
+        normalizedValue: clamped,
+    });
+    return clamped;
+}
+export function numberLikeToSafeFiniteNumber(value, params) {
+    const fallback = params.fallback ?? 0;
+    if (typeof value === "bigint") {
+        return bigintToSafeNumber(value, {
+            path: params.path,
+            errors: params.errors,
+            source: params.source,
+            entityId: params.entityId,
+            message: params.message,
+        });
+    }
+    if (Number.isFinite(value))
+        return value;
+    params.errors.push({
+        code: "DEFAULT_APPLIED",
+        severity: "warning",
+        message: params.message ??
+            "Non-finite number encountered and fallback value applied.",
+        paths: [params.path],
+        source: params.source,
+        entityId: params.entityId,
+        originalValue: String(value),
+        normalizedValue: fallback,
+    });
+    return fallback;
+}
+export function bigintToScaledNumber(value, params) {
+    const { path, errors, source, entityId, maxUnscaled, minUnscaled, scale } = params;
+    if (maxUnscaled !== undefined && value > maxUnscaled) {
+        errors.push({
+            code: "OUT_OF_RANGE_CLAMPED",
+            severity: "warning",
+            message: params.overflowMessage ??
+                "Value exceeded maximum allowed range and was clamped.",
+            paths: [path],
+            source,
+            entityId,
+            originalValue: value.toString(),
+            normalizedValue: maxUnscaled.toString(),
+        });
+        return Number(maxUnscaled) / scale;
+    }
+    if (minUnscaled !== undefined && value < minUnscaled) {
+        errors.push({
+            code: "OUT_OF_RANGE_CLAMPED",
+            severity: "warning",
+            message: params.overflowMessage ??
+                "Value exceeded minimum allowed range and was clamped.",
+            paths: [path],
+            source,
+            entityId,
+            originalValue: value.toString(),
+            normalizedValue: minUnscaled.toString(),
+        });
+        return Number(minUnscaled) / scale;
+    }
+    return Number(value) / scale;
+}
+//# sourceMappingURL=normalization.js.map

package/dist/src/utils/normalization.js.map

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

package/dist/src/utils/oracle.d.ts

@@ -0,0 +1,107 @@
+import { type Address, type Hex } from "viem";
+export type OracleInfo = {
+    oracle: Address;
+    name: string;
+    adapters: OracleAdapterEntry[];
+    resolvedVaults: OracleResolvedVault[];
+};
+export type OracleDetailedInfo = {
+    oracle: Address;
+    name: string;
+    oracleInfo: Hex;
+};
+export interface OraclePrice {
+    queryFailure: boolean;
+    queryFailureReason: Hex;
+    amountIn: bigint;
+    amountOutMid: bigint;
+    amountOutBid: bigint;
+    amountOutAsk: bigint;
+    timestamp: number;
+}
+export type EulerRouterInfo = {
+    governor: Address;
+    fallbackOracle: Address;
+    fallbackOracleInfo: OracleDetailedInfo;
+    bases: Address[];
+    quotes: Address[];
+    resolvedAssets: Address[][];
+    resolvedOracles: Address[];
+    resolvedOraclesInfo: OracleDetailedInfo[];
+};
+export type CrossAdapterInfo = {
+    base: Address;
+    cross: Address;
+    quote: Address;
+    oracleBaseCross: Address;
+    oracleCrossQuote: Address;
+    oracleBaseCrossInfo: OracleDetailedInfo;
+    oracleCrossQuoteInfo: OracleDetailedInfo;
+};
+export type PythOracleInfo = {
+    pyth: Address;
+    base: Address;
+    quote: Address;
+    feedId: Hex;
+    maxStaleness: bigint;
+    maxConfWidth: bigint;
+};
+export type PythFeed = {
+    pythAddress: Address;
+    feedId: Hex;
+};
+export type OracleAdapterEntry = {
+    oracle: Address;
+    name: string;
+    base: Address;
+    quote: Address;
+    pythDetail?: PythOracleInfo;
+    chainlinkDetail?: {
+        oracle: Address;
+    };
+};
+/**
+ * A vault-address price route configured on EulerRouter.
+ *
+ * Some routers price an ERC4626/EVault share token by resolving it to the
+ * vault's underlying asset path instead of using a leaf oracle adapter for the
+ * vault address itself. `resolvedAssets` is that unwrap chain, not necessarily
+ * the full price path to `quote`.
+ *
+ * vault: the base being priced, usually a collateral vault/share token address.
+ * quote: the target denomination, i.e. the EVault unitOfAccount.
+ * asset: the first underlying asset the router resolves the vault into.
+ * resolvedAssets: the recursive ERC4626 unwrap chain from vault toward something the router can price against quote.
+ */
+export type OracleResolvedVault = {
+    vault: Address;
+    quote: Address;
+    asset: Address;
+    resolvedAssets: Address[];
+};
+export declare function getOracleAdapterSortKey(adapter: OracleAdapterEntry): string;
+export declare function sortOracleAdapters(adapters: OracleAdapterEntry[]): OracleAdapterEntry[];
+export declare function sortOracleResolvedVaults(resolvedVaults: OracleResolvedVault[]): OracleResolvedVault[];
+type OracleAdapterOptions = {
+    base?: Address;
+    quote?: Address;
+    leafOnly?: boolean;
+};
+export declare const decodeEulerRouterInfo: (oracleInfo: Hex | string | Uint8Array) => EulerRouterInfo | null;
+export declare const decodeCrossAdapterInfo: (oracleInfo: Hex | string | Uint8Array) => CrossAdapterInfo | null;
+export declare const decodePythOracleInfo: (oracleInfo: Hex | string | Uint8Array) => PythOracleInfo | null;
+export declare const collectPythFeedIds: (oracleInfo: OracleDetailedInfo | null | undefined, maxDepth?: number) => PythFeed[];
+export declare const decodeOracleInfo: (oracleInfo: OracleDetailedInfo | null | undefined, maxDepth?: number, options?: OracleAdapterOptions) => OracleAdapterEntry[];
+export declare const decodeOracleResolvedVaults: (oracleInfo: OracleDetailedInfo | null | undefined, maxDepth?: number) => OracleResolvedVault[];
+export declare const collectChainlinkOracles: (oracleInfo: OracleDetailedInfo | null | undefined, maxDepth?: number) => Address[];
+/**
+ * Extract unique PythFeed entries from already-decoded oracle adapters.
+ * Use this instead of collectPythFeedIds when you have OracleAdapterEntry[] (e.g. from vault.oracle.adapters).
+ */
+export declare const collectPythFeedsFromAdapters: (adapters: OracleAdapterEntry[]) => PythFeed[];
+/**
+ * Select adapters representing leaf pricing route(s) for a base->quote pair.
+ * Falls back to direct pair matches when no leaf route is found.
+ */
+export declare const selectLeafAdaptersForPair: (adapters: OracleAdapterEntry[], base: Address, quote: Address, maxDepth?: number) => OracleAdapterEntry[];
+export {};