@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/utils/accountComputations.js

@@ -0,0 +1,297 @@
+/**
+ * Pure computation functions for sub-account metrics and leverage utilities.
+ * All functions return `undefined` when prerequisites are missing.
+ */
+const WAD = 10n ** 18n;
+// ---------------------------------------------------------------------------
+// Sub-account risk metrics (oracle-denominated, not USD)
+// ---------------------------------------------------------------------------
+/**
+ * Health factor for a sub-account's borrow position.
+ * `totalCollateralValue.liquidation / liabilityValue.liquidation` (WAD, 18 dec).
+ * `> 1e18` = healthy, `< 1e18` = liquidatable.
+ */
+export function computeHealthFactor(subAccount) {
+    const liq = findLiquidity(subAccount);
+    if (!liq)
+        return undefined;
+    if (liq.liabilityValue.liquidation === 0n)
+        return undefined;
+    return ((liq.totalCollateralValue.liquidation * WAD) /
+        liq.liabilityValue.liquidation);
+}
+/**
+ * Current loan-to-value ratio for a sub-account.
+ * `liabilityValue.oracleMid / totalCollateralValue.oracleMid` (WAD).
+ */
+export function computeCurrentLTV(subAccount) {
+    const liq = findLiquidity(subAccount);
+    if (!liq)
+        return undefined;
+    if (liq.totalCollateralValue.oracleMid === 0n)
+        return undefined;
+    return ((liq.liabilityValue.oracleMid * WAD) / liq.totalCollateralValue.oracleMid);
+}
+/**
+ * Weighted-average liquidation LTV threshold.
+ * `totalCollateralValue.liquidation / totalCollateralValue.oracleMid` (WAD).
+ */
+export function computeLiquidationLTV(subAccount) {
+    const liq = findLiquidity(subAccount);
+    if (!liq)
+        return undefined;
+    if (liq.totalCollateralValue.oracleMid === 0n)
+        return undefined;
+    return ((liq.totalCollateralValue.liquidation * WAD) /
+        liq.totalCollateralValue.oracleMid);
+}
+// ---------------------------------------------------------------------------
+// Sub-account USD metrics (require populated market prices)
+// ---------------------------------------------------------------------------
+/**
+ * Leverage multiplier for a sub-account (WAD, 1e18 = 1x).
+ * `totalCollateralValueUsd / (totalCollateralValueUsd - borrowedValueUsd)`.
+ */
+export function computeMultiplier(subAccount) {
+    const liq = findLiquidity(subAccount);
+    if (!liq?.totalCollateralValueUsd)
+        return undefined;
+    const borrowedUsd = findBorrowedValueUsd(subAccount);
+    if (borrowedUsd == null)
+        return undefined;
+    const equity = liq.totalCollateralValueUsd - borrowedUsd;
+    if (equity <= 0n)
+        return undefined;
+    return (liq.totalCollateralValueUsd * WAD) / equity;
+}
+/**
+ * Total collateral value in USD for a sub-account (18 dec).
+ * Sourced from sub-account liquidity and populated by `populateMarketPrices`.
+ */
+export function computeSubAccountTotalCollateralValueUsd(subAccount) {
+    return findLiquidity(subAccount)?.totalCollateralValueUsd;
+}
+/**
+ * Liability value in USD for a sub-account (18 dec).
+ * Sourced from sub-account liquidity and populated by `populateMarketPrices`.
+ */
+export function computeSubAccountLiabilityValueUsd(subAccount) {
+    return findLiquidity(subAccount)?.liabilityValueUsd;
+}
+/**
+ * Net value in USD for a sub-account: sum(suppliedValueUsd) - sum(borrowedValueUsd).
+ */
+export function computeSubAccountNetValueUsd(subAccount) {
+    let supplied;
+    let borrowed;
+    for (const p of subAccount.positions) {
+        if (p.suppliedValueUsd != null)
+            supplied = (supplied ?? 0n) + p.suppliedValueUsd;
+        if (p.borrowedValueUsd != null)
+            borrowed = (borrowed ?? 0n) + p.borrowedValueUsd;
+    }
+    if (supplied == null)
+        return undefined;
+    return supplied - (borrowed ?? 0n);
+}
+// ---------------------------------------------------------------------------
+// Liquidation price multipliers (oracle-denominated)
+// ---------------------------------------------------------------------------
+/**
+ * Per-collateral liquidation price multipliers.
+ * For each collateral: `(liability - otherCollateral) / thisCollateral` (WAD).
+ * `< 1` means the price can drop by this factor before liquidation.
+ */
+export function computeCollateralLiquidationPrices(liquidity) {
+    const result = {};
+    const totalColl = liquidity.totalCollateralValue.liquidation;
+    const liability = liquidity.liabilityValue.liquidation;
+    for (const c of liquidity.collaterals) {
+        if (c.value.liquidation === 0n)
+            continue;
+        const otherColl = totalColl - c.value.liquidation;
+        const gap = liability - otherColl;
+        if (gap <= 0n)
+            continue;
+        result[c.address] = (gap * WAD) / c.value.liquidation;
+    }
+    return result;
+}
+/**
+ * Borrow liquidation price multiplier (WAD).
+ * `totalCollateralValue.liquidation / liabilityValue.liquidation`.
+ * `> 1` = borrow price can increase by this factor before liquidation.
+ */
+export function computeBorrowLiquidationPrice(liquidity) {
+    if (liquidity.liabilityValue.liquidation === 0n)
+        return undefined;
+    return ((liquidity.totalCollateralValue.liquidation * WAD) /
+        liquidity.liabilityValue.liquidation);
+}
+/**
+ * Computes the ROE breakdown for a sub-account.
+ * Requires populated vaults (for APY data) and market prices (for USD values).
+ * Returns `undefined` when prerequisites are missing or equity <= 0.
+ */
+export function computeSubAccountRoe(subAccount) {
+    let totalLendingYield = 0;
+    let totalBorrowingYield = 0;
+    let totalRewardYield = 0;
+    let totalIntrinsicYield = 0;
+    let totalSupplyUsd = 0;
+    let totalBorrowUsd = 0;
+    let hasData = false;
+    for (const p of subAccount.positions) {
+        const vault = p.vault;
+        if (!vault)
+            continue;
+        const intrinsicApyDecimal = getVaultIntrinsicApy(vault);
+        // Supply side
+        if (p.suppliedValueUsd != null && p.suppliedValueUsd > 0n) {
+            const supplyUsd = Number(p.suppliedValueUsd) / 1e18;
+            const supplyApy = getVaultSupplyApy(vault);
+            if (supplyApy != null) {
+                hasData = true;
+                totalSupplyUsd += supplyUsd;
+                totalLendingYield += supplyUsd * supplyApy;
+                totalRewardYield += supplyUsd * getVaultRewardApr(vault, "LEND");
+                totalIntrinsicYield += supplyUsd * intrinsicApyDecimal;
+            }
+        }
+        // Borrow side
+        if (p.borrowedValueUsd != null && p.borrowedValueUsd > 0n) {
+            const borrowUsd = Number(p.borrowedValueUsd) / 1e18;
+            const borrowApy = getVaultBorrowApy(vault);
+            if (borrowApy != null) {
+                hasData = true;
+                totalBorrowUsd += borrowUsd;
+                totalBorrowingYield += borrowUsd * borrowApy;
+                totalRewardYield += borrowUsd * getVaultRewardApr(vault, "BORROW");
+                totalIntrinsicYield -= borrowUsd * intrinsicApyDecimal;
+            }
+        }
+    }
+    if (!hasData)
+        return undefined;
+    const equity = totalSupplyUsd - totalBorrowUsd;
+    if (equity <= 0)
+        return undefined;
+    const lending = totalLendingYield / equity;
+    const borrowing = -totalBorrowingYield / equity;
+    const rewards = totalRewardYield / equity;
+    const intrinsicApy = totalIntrinsicYield / equity;
+    return {
+        lending,
+        borrowing,
+        rewards,
+        intrinsicApy,
+        total: lending + borrowing + rewards + intrinsicApy,
+    };
+}
+// ---------------------------------------------------------------------------
+// Yield computations (use `number` since APYs are percentages)
+// ---------------------------------------------------------------------------
+/**
+ * Net APY relative to total supply.
+ * `(supplyUsd * (supplyApy + supplyReward) - borrowUsd * (borrowApy - borrowReward)) / supplyUsd`
+ */
+export function getNetApy(supplyUsd, supplyApy, borrowUsd, borrowApy, supplyRewardApy = 0, borrowRewardApy = 0) {
+    if (supplyUsd === 0)
+        return 0;
+    return ((supplyUsd * (supplyApy + supplyRewardApy) -
+        borrowUsd * (borrowApy - borrowRewardApy)) /
+        supplyUsd);
+}
+/**
+ * Return on equity (ROE): net yield relative to equity (NAV).
+ * Same numerator as getNetApy, but divided by `equity = supplyUsd - borrowUsd`.
+ */
+export function getRoe(supplyUsd, supplyApy, borrowUsd, borrowApy, supplyRewardApy = 0, borrowRewardApy = 0) {
+    const equity = supplyUsd - borrowUsd;
+    if (equity === 0)
+        return 0;
+    return ((supplyUsd * (supplyApy + supplyRewardApy) -
+        borrowUsd * (borrowApy - borrowRewardApy)) /
+        equity);
+}
+// ---------------------------------------------------------------------------
+// Leverage utilities
+// ---------------------------------------------------------------------------
+/**
+ * Maximum multiplier for a given borrow LTV.
+ * `1 / (1 - (borrowLtv - safetyMargin))` where borrowLtv is decimal (0.85 = 85%).
+ * Floored to 2 decimal places, minimum 1.
+ */
+export function getMaxMultiplier(borrowLtv, safetyMargin = 0.005) {
+    const effective = borrowLtv - safetyMargin;
+    if (effective >= 1)
+        return 1;
+    const raw = 1 / (1 - effective);
+    return Math.max(1, Math.floor(raw * 100) / 100);
+}
+/**
+ * Maximum ROE at max leverage.
+ * `supplyApy + (maxMultiplier - 1) * (supplyApy - borrowApy)`
+ */
+export function getMaxRoe(maxMultiplier, supplyApy, borrowApy) {
+    return supplyApy + (maxMultiplier - 1) * (supplyApy - borrowApy);
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function findLiquidity(subAccount) {
+    for (const p of subAccount.positions) {
+        if (p.liquidity)
+            return p.liquidity;
+    }
+    return undefined;
+}
+function findBorrowedValueUsd(subAccount) {
+    for (const p of subAccount.positions) {
+        if (p.borrowedValueUsd != null)
+            return p.borrowedValueUsd;
+    }
+    return undefined;
+}
+/** Duck-type supply APY from a vault entity (EVault string or EulerEarn number getter). */
+function getVaultSupplyApy(vault) {
+    // EVault: interestRates.supplyAPY (string, decimal fraction via formatUnits(_, 27))
+    if (vault.interestRates?.supplyAPY != null) {
+        const val = parseFloat(vault.interestRates.supplyAPY);
+        return Number.isFinite(val) ? val : undefined;
+    }
+    // EulerEarn: supplyApy (number getter)
+    if (typeof vault.supplyApy === "number") {
+        return vault.supplyApy;
+    }
+    return undefined;
+}
+/** Duck-type borrow APY from a vault entity (EVault only). */
+function getVaultBorrowApy(vault) {
+    if (vault.interestRates?.borrowAPY != null) {
+        const val = parseFloat(vault.interestRates.borrowAPY);
+        return Number.isFinite(val) ? val : undefined;
+    }
+    return undefined;
+}
+/** Intrinsic APY as a decimal fraction from vault's populated intrinsicApy field. */
+function getVaultIntrinsicApy(vault) {
+    if (vault.intrinsicApy?.apy != null &&
+        typeof vault.intrinsicApy.apy === "number") {
+        return vault.intrinsicApy.apy / 100;
+    }
+    return 0;
+}
+/** Sum reward APRs for a given action (LEND or BORROW) from vault campaigns. */
+function getVaultRewardApr(vault, action) {
+    if (!vault.rewards?.campaigns)
+        return 0;
+    let total = 0;
+    for (const c of vault.rewards.campaigns) {
+        if (c.action === action && typeof c.apr === "number") {
+            total += c.apr;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=accountComputations.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { EVCBatchItem } from "src/services/executionService/executionServiceTypes.js";
+export declare const encodeEVCBatch: (items: EVCBatchItem[]) => `0x${string}`;

package/dist/src/utils/batch.js

@@ -0,0 +1,51 @@
+import { encodeFunctionData } from "viem";
+export const encodeEVCBatch = (items) => {
+    return encodeFunctionData({
+        abi: [
+            {
+                type: "function",
+                name: "batch",
+                inputs: [
+                    {
+                        name: "items",
+                        type: "tuple[]",
+                        internalType: "struct IEVC.BatchItem[]",
+                        components: [
+                            {
+                                name: "targetContract",
+                                type: "address",
+                                internalType: "address",
+                            },
+                            {
+                                name: "onBehalfOfAccount",
+                                type: "address",
+                                internalType: "address",
+                            },
+                            {
+                                name: "value",
+                                type: "uint256",
+                                internalType: "uint256",
+                            },
+                            {
+                                name: "data",
+                                type: "bytes",
+                                internalType: "bytes",
+                            },
+                        ],
+                    },
+                ],
+                outputs: [],
+                stateMutability: "payable",
+            },
+        ],
+        args: [
+            items.map((item) => ({
+                targetContract: item.targetContract,
+                onBehalfOfAccount: item.onBehalfOfAccount,
+                value: item.value ?? 0n,
+                data: item.data,
+            })),
+        ],
+    });
+};
+//# sourceMappingURL=batch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../src/utils/batch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAqB,EAAE,EAAE;IACvD,OAAO,kBAAkB,CAAC;QACzB,GAAG,EAAE;YACJ;gBACC,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE;oBACP;wBACC,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,SAAS;wBACf,YAAY,EAAE,yBAAyB;wBACvC,UAAU,EAAE;4BACX;gCACC,IAAI,EAAE,gBAAgB;gCACtB,IAAI,EAAE,SAAS;gCACf,YAAY,EAAE,SAAS;6BACvB;4BACD;gCACC,IAAI,EAAE,mBAAmB;gCACzB,IAAI,EAAE,SAAS;gCACf,YAAY,EAAE,SAAS;6BACvB;4BACD;gCACC,IAAI,EAAE,OAAO;gCACb,IAAI,EAAE,SAAS;gCACf,YAAY,EAAE,SAAS;6BACvB;4BACD;gCACC,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,OAAO;gCACb,YAAY,EAAE,OAAO;6BACrB;yBACD;qBACD;iBACD;gBACD,OAAO,EAAE,EAAE;gBACX,eAAe,EAAE,SAAS;aAC1B;SACD;QACD,IAAI,EAAE;YACL,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACpB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;aACf,CAAC,CAAC;SACH;KACD,CAAC,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * A function that wraps a query function, returning a decorated version.
+ * Used to inject logging, caching, profiling, etc. into all queries globally.
+ *
+ * @param queryName - The name of the query property (e.g. "queryEVaultInfoFull")
+ * @param fn - The original query function
+ * @returns A wrapped version of the query function
+ */
+export type BuildQueryFn = <T extends (...args: any[]) => Promise<any>>(queryName: string, fn: T, target: object) => T;
+export interface QueryCacheConfig {
+    enabled?: boolean;
+    ttlMs?: number;
+}
+export declare function createQueryCacheBuildQuery(config?: QueryCacheConfig): BuildQueryFn;
+/**
+ * Applies a buildQuery decorator to all `query*` properties on a target object.
+ * Call this at the end of a constructor to decorate all queries.
+ */
+export declare function applyBuildQuery(target: object, buildQuery: BuildQueryFn): void;

package/dist/src/utils/buildQuery.js

@@ -0,0 +1,72 @@
+const DEFAULT_QUERY_CACHE_TTL_MS = 5_000;
+function serializeQueryArgs(args) {
+    try {
+        return JSON.stringify(args, (_key, value) => {
+            if (typeof value === "bigint") {
+                return { __type: "bigint", value: value.toString() };
+            }
+            if (typeof value === "function")
+                return "[function]";
+            return value;
+        });
+    }
+    catch {
+        return null;
+    }
+}
+export function createQueryCacheBuildQuery(config) {
+    const enabled = config?.enabled ?? true;
+    const ttlMs = config?.ttlMs ?? DEFAULT_QUERY_CACHE_TTL_MS;
+    return (_queryName, fn, _target) => {
+        if (!enabled || ttlMs <= 0)
+            return fn;
+        const cache = new Map();
+        const wrapped = (async (...args) => {
+            const cacheKey = serializeQueryArgs(args);
+            if (cacheKey === null) {
+                return fn(...args);
+            }
+            const now = Date.now();
+            const cached = cache.get(cacheKey);
+            if (cached && cached.expiresAt > now) {
+                if (cached.promise)
+                    return cached.promise;
+                if ("value" in cached)
+                    return cached.value;
+            }
+            const promise = fn(...args)
+                .then((value) => {
+                cache.set(cacheKey, {
+                    expiresAt: Date.now() + ttlMs,
+                    value,
+                });
+                return value;
+            })
+                .catch((error) => {
+                const current = cache.get(cacheKey);
+                if (current?.promise === promise) {
+                    cache.delete(cacheKey);
+                }
+                throw error;
+            });
+            cache.set(cacheKey, {
+                expiresAt: now + ttlMs,
+                promise,
+            });
+            return promise;
+        });
+        return wrapped;
+    };
+}
+/**
+ * Applies a buildQuery decorator to all `query*` properties on a target object.
+ * Call this at the end of a constructor to decorate all queries.
+ */
+export function applyBuildQuery(target, buildQuery) {
+    for (const key of Object.getOwnPropertyNames(target)) {
+        if (key.startsWith("query") && typeof target[key] === "function") {
+            target[key] = buildQuery(key, target[key], target);
+        }
+    }
+}
+//# sourceMappingURL=buildQuery.js.map

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

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

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

@@ -0,0 +1,32 @@
+export type BatchFn<K, V> = (keys: K[]) => Promise<V[]>;
+export interface CallBundlerOptions {
+    maxBatchSize?: number;
+    debounceMs?: number;
+    maxConcurrentBatches?: number;
+}
+/**
+ * Creates a load function that bundles individual calls within the same
+ * debounce window into a single batch invocation.
+ */
+export declare function createCallBundler<K, V>(batchFn: BatchFn<K, V>, options?: CallBundlerOptions): (key: K) => Promise<V>;
+/**
+ * Wraps a batch function `(keys: K[]) => Promise<V>` into a function with the
+ * same signature, where keys from concurrent calls within the same debounce
+ * window are merged into a single batch invocation. All callers receive the same
+ * result.
+ */
+export declare function createBundledCall<K, V>(batchFn: (keys: K[]) => Promise<V>, options?: CallBundlerOptions): (keys: K[]) => Promise<V>;
+export declare class CallBundler<K, V> {
+    private batchFn;
+    private maxBatchSize;
+    private debounceMs;
+    private maxConcurrentBatches;
+    private queue;
+    private scheduled;
+    private activeBatchCount;
+    constructor(batchFn: BatchFn<K, V>, options?: CallBundlerOptions);
+    load(key: K): Promise<V>;
+    private scheduleDispatch;
+    private drainQueue;
+    private dispatchBatch;
+}

package/dist/src/utils/callBundler.js

@@ -0,0 +1,93 @@
+/**
+ * Creates a load function that bundles individual calls within the same
+ * debounce window into a single batch invocation.
+ */
+export function createCallBundler(batchFn, options) {
+    const bundler = new CallBundler(batchFn, options);
+    return (key) => bundler.load(key);
+}
+/**
+ * Wraps a batch function `(keys: K[]) => Promise<V>` into a function with the
+ * same signature, where keys from concurrent calls within the same debounce
+ * window are merged into a single batch invocation. All callers receive the same
+ * result.
+ */
+export function createBundledCall(batchFn, options) {
+    const load = createCallBundler(async (keys) => {
+        const result = await batchFn(keys);
+        return keys.map(() => result);
+    }, options);
+    return async (keys) => {
+        if (!keys.length)
+            return batchFn([]);
+        const results = await Promise.all(keys.map(load));
+        return results[0];
+    };
+}
+export class CallBundler {
+    batchFn;
+    maxBatchSize;
+    debounceMs;
+    maxConcurrentBatches;
+    queue = [];
+    scheduled = false;
+    activeBatchCount = 0;
+    constructor(batchFn, options) {
+        this.batchFn = batchFn;
+        this.maxBatchSize = options?.maxBatchSize ?? Infinity;
+        this.debounceMs = Math.max(0, options?.debounceMs ?? 5);
+        this.maxConcurrentBatches = Math.max(1, options?.maxConcurrentBatches ?? 4);
+    }
+    load(key) {
+        return new Promise((resolve, reject) => {
+            this.queue.push({ key, resolve, reject });
+            this.scheduleDispatch();
+        });
+    }
+    scheduleDispatch() {
+        if (this.scheduled)
+            return;
+        this.scheduled = true;
+        if (this.debounceMs === 0) {
+            queueMicrotask(() => this.drainQueue());
+            return;
+        }
+        setTimeout(() => this.drainQueue(), this.debounceMs);
+    }
+    drainQueue() {
+        this.scheduled = false;
+        while (this.activeBatchCount < this.maxConcurrentBatches &&
+            this.queue.length > 0) {
+            const batch = this.queue.splice(0, this.maxBatchSize);
+            if (batch.length === 0)
+                break;
+            this.dispatchBatch(batch);
+        }
+        if (this.queue.length > 0) {
+            this.scheduleDispatch();
+        }
+    }
+    dispatchBatch(batch) {
+        this.activeBatchCount += 1;
+        const keys = batch.map((item) => item.key);
+        this.batchFn(keys)
+            .then((values) => {
+            if (values.length !== keys.length) {
+                const error = new Error(`CallBundler: batch function returned ${values.length} results for ${keys.length} keys`);
+                batch.forEach((item) => item.reject(error));
+                return;
+            }
+            batch.forEach((item, i) => item.resolve(values[i]));
+        })
+            .catch((error) => {
+            batch.forEach((item) => item.reject(error));
+        })
+            .finally(() => {
+            this.activeBatchCount -= 1;
+            if (this.queue.length > 0) {
+                this.scheduleDispatch();
+            }
+        });
+    }
+}
+//# sourceMappingURL=callBundler.js.map

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

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

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

@@ -0,0 +1,13 @@
+export type DecodedSmartContractError = {
+    signature: string;
+    selector: string | null;
+    params: unknown[];
+};
+export type DecodeSmartContractErrorsOptions = {
+    /**
+     * Timeout in milliseconds for unknown-selector signature lookup (OpenChain/Sourcify API).
+     * Defaults to 2000ms.
+     */
+    fetchTimeout?: number;
+};
+export declare function decodeSmartContractErrors(input: unknown, options?: DecodeSmartContractErrorsOptions): Promise<DecodedSmartContractError[]>;