@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/utils/decodeSmartContractErrors.js

@@ -0,0 +1,311 @@
+import { decodeErrorResult, isHex, parseAbiItem } from "viem";
+import { EULER_ERROR_SELECTOR_TO_SIGNATURE, EULER_ERROR_SIGNATURES, } from "./eulerErrorSelectors.js";
+const FOURBYTE_LOOKUP_URL = "https://api.4byte.sourcify.dev/signature-database/v1/lookup?function=";
+const HEX_PATTERN = /0x[0-9a-fA-F]{8,}/g;
+const SELECTOR_WITH_PAYLOAD_PATTERN = /0x([0-9a-fA-F]{8})\s*[:|-]?\s*([0-9a-fA-F]{64,})/g;
+const SIGNATURE_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*\([^()]*\)$/;
+const BUILTIN_SELECTOR_TO_SIGNATURE = {
+    "0x08c379a0": "Error(string)",
+    "0x4e487b71": "Panic(uint256)",
+};
+const signatureByName = new Map();
+const selectorBySignature = new Map();
+for (const signature of EULER_ERROR_SIGNATURES) {
+    const openParen = signature.indexOf("(");
+    if (openParen === -1)
+        continue;
+    const name = signature.slice(0, openParen);
+    const list = signatureByName.get(name) ?? [];
+    list.push(signature);
+    signatureByName.set(name, list);
+}
+for (const [selector, signature] of Object.entries(EULER_ERROR_SELECTOR_TO_SIGNATURE)) {
+    selectorBySignature.set(signature, selector);
+}
+for (const [selector, signature] of Object.entries(BUILTIN_SELECTOR_TO_SIGNATURE)) {
+    selectorBySignature.set(signature, selector);
+}
+const lookupCache = new Map();
+const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const normalizeHex = (value) => {
+    if (!value.startsWith("0x"))
+        return null;
+    const clean = value.toLowerCase();
+    if (!isHex(clean, { strict: false }))
+        return null;
+    return (clean.length % 2 === 0 ? clean : clean.slice(0, clean.length - 1));
+};
+const extractHexStrings = (value) => {
+    const out = new Set();
+    const directMatches = value.match(HEX_PATTERN) ?? [];
+    directMatches
+        .map(normalizeHex)
+        .filter((entry) => entry !== null)
+        .forEach((entry) => out.add(entry));
+    for (const match of value.matchAll(SELECTOR_WITH_PAYLOAD_PATTERN)) {
+        const selector = match[1];
+        const payload = match[2];
+        const rebuilt = normalizeHex(`0x${selector}${payload}`);
+        if (rebuilt)
+            out.add(rebuilt);
+    }
+    return [...out];
+};
+const extractSignaturesDeep = (value, out) => {
+    if (typeof value === "string") {
+        if (SIGNATURE_PATTERN.test(value))
+            out.add(value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((entry) => extractSignaturesDeep(entry, out));
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    for (const entry of Object.values(value)) {
+        extractSignaturesDeep(entry, out);
+    }
+};
+const fetchSignaturesBySelector = (selector, fetchTimeout) => {
+    const normalizedSelector = selector.toLowerCase();
+    const cacheKey = `${normalizedSelector}:${fetchTimeout}`;
+    const cached = lookupCache.get(cacheKey);
+    if (cached)
+        return cached;
+    const request = (async () => {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), fetchTimeout);
+        try {
+            const response = await fetch(`${FOURBYTE_LOOKUP_URL}${normalizedSelector}`, { signal: controller.signal });
+            if (!response.ok)
+                return [];
+            const payload = await response.json();
+            const signatures = new Set();
+            extractSignaturesDeep(payload, signatures);
+            return [...signatures];
+        }
+        catch {
+            return [];
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    })();
+    lookupCache.set(cacheKey, request);
+    return request;
+};
+const collectCandidateStrings = (input) => {
+    if (typeof input === "string")
+        return [input];
+    if (!input || typeof input !== "object")
+        return [];
+    const candidates = new Set();
+    const visited = new Set();
+    const walk = (value) => {
+        if (!value)
+            return;
+        if (typeof value === "string")
+            return;
+        if (typeof value !== "object")
+            return;
+        if (visited.has(value))
+            return;
+        visited.add(value);
+        if (Array.isArray(value)) {
+            value.forEach(walk);
+            return;
+        }
+        for (const [key, child] of Object.entries(value)) {
+            const lowerKey = key.toLowerCase();
+            const keyMatches = lowerKey.includes("error") ||
+                lowerKey.includes("message") ||
+                lowerKey.includes("reason");
+            if (typeof child === "string") {
+                if (keyMatches) {
+                    candidates.add(child);
+                }
+            }
+            else {
+                walk(child);
+            }
+        }
+    };
+    walk(input);
+    return [...candidates];
+};
+const addKnownErrorsFromCandidate = (candidate, output) => {
+    const lowered = candidate.toLowerCase();
+    for (const signature of EULER_ERROR_SIGNATURES) {
+        if (lowered.includes(signature.toLowerCase())) {
+            output.add(signature);
+        }
+    }
+    for (const [name, signatures] of signatureByName.entries()) {
+        const regex = new RegExp(`(^|[^A-Za-z0-9_])${escapeRegex(name)}(\\(|[^A-Za-z0-9_]|$)`, "i");
+        if (regex.test(candidate) || lowered.includes(name.toLowerCase())) {
+            signatures.forEach((signature) => output.add(signature));
+        }
+    }
+};
+const collectHexFromDecoded = (value, output) => {
+    if (typeof value === "string") {
+        extractHexStrings(value).forEach((hex) => output.add(hex));
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((entry) => collectHexFromDecoded(entry, output));
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    for (const entry of Object.values(value)) {
+        collectHexFromDecoded(entry, output);
+    }
+};
+const tryDecodeWithSignature = (data, signature) => {
+    try {
+        const abiError = parseAbiItem(`error ${signature}`);
+        const decoded = decodeErrorResult({ abi: [abiError], data });
+        return decoded;
+    }
+    catch {
+        return null;
+    }
+};
+const normalizeForKey = (value) => {
+    if (typeof value === "bigint")
+        return `bigint:${value.toString()}`;
+    if (Array.isArray(value))
+        return value.map((entry) => normalizeForKey(entry));
+    if (!value || typeof value !== "object")
+        return value;
+    const entries = Object.entries(value)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([key, entry]) => [key, normalizeForKey(entry)]);
+    return Object.fromEntries(entries);
+};
+export async function decodeSmartContractErrors(input, options = {}) {
+    const fetchTimeout = typeof options.fetchTimeout === "number" && options.fetchTimeout >= 0
+        ? options.fetchTimeout
+        : 5000;
+    const results = [];
+    const seenResults = new Set();
+    const seenStrings = new Set();
+    const seenHex = new Set();
+    const addResult = (signature, selector, params = []) => {
+        const key = JSON.stringify([signature, selector, normalizeForKey(params)]);
+        if (seenResults.has(key))
+            return;
+        seenResults.add(key);
+        results.push({ signature, selector, params });
+    };
+    const addKnownErrorsFromCandidateToResults = (candidate) => {
+        const signatures = new Set();
+        addKnownErrorsFromCandidate(candidate, signatures);
+        signatures.forEach((signature) => addResult(signature, selectorBySignature.get(signature) ?? null, []));
+    };
+    const processCandidateString = async (candidate) => {
+        if (seenStrings.has(candidate))
+            return;
+        seenStrings.add(candidate);
+        addKnownErrorsFromCandidateToResults(candidate);
+        const hexValues = extractHexStrings(candidate);
+        for (const hexValue of hexValues) {
+            await processHexValue(hexValue);
+        }
+    };
+    const processHexValue = async (hexValue) => {
+        const normalizedHex = normalizeHex(hexValue);
+        if (!normalizedHex || normalizedHex.length < 10)
+            return;
+        if (seenHex.has(normalizedHex))
+            return;
+        seenHex.add(normalizedHex);
+        const selector = normalizedHex.slice(0, 10);
+        const signatures = new Set();
+        const knownSignature = EULER_ERROR_SELECTOR_TO_SIGNATURE[selector];
+        if (knownSignature)
+            signatures.add(knownSignature);
+        const builtinSignature = BUILTIN_SELECTOR_TO_SIGNATURE[selector.toLowerCase()];
+        if (builtinSignature)
+            signatures.add(builtinSignature);
+        if (!knownSignature && !builtinSignature) {
+            const fetched = await fetchSignaturesBySelector(selector, fetchTimeout);
+            fetched.forEach((signature) => signatures.add(signature));
+        }
+        for (const signature of signatures) {
+            if (normalizedHex.length <= 10) {
+                addResult(signature, selector, []);
+                continue;
+            }
+            const decoded = tryDecodeWithSignature(normalizedHex, signature);
+            if (!decoded) {
+                addResult(signature, selector, []);
+                continue;
+            }
+            const args = decoded.args;
+            addResult(signature, selector, Array.isArray(args) ? args : []);
+            const nestedStrings = new Set();
+            const collectStrings = (value) => {
+                if (typeof value === "string") {
+                    nestedStrings.add(value);
+                    return;
+                }
+                if (Array.isArray(value)) {
+                    value.forEach(collectStrings);
+                    return;
+                }
+                if (!value || typeof value !== "object")
+                    return;
+                Object.values(value).forEach(collectStrings);
+            };
+            collectStrings(decoded);
+            for (const nestedString of nestedStrings) {
+                await processCandidateString(nestedString);
+            }
+            const nestedHex = new Set();
+            collectHexFromDecoded(decoded, nestedHex);
+            for (const nested of nestedHex) {
+                await processHexValue(nested);
+            }
+            for (const entry of Object.values(decoded)) {
+                if (typeof entry === "string") {
+                    await processCandidateString(entry);
+                }
+            }
+        }
+    };
+    if (typeof input === "string") {
+        const normalized = normalizeHex(input);
+        if (normalized && normalized.length <= 10) {
+            const selector = normalized.slice(0, 10);
+            const signatures = new Set();
+            const knownSignature = EULER_ERROR_SELECTOR_TO_SIGNATURE[selector];
+            if (knownSignature)
+                signatures.add(knownSignature);
+            const builtinSignature = BUILTIN_SELECTOR_TO_SIGNATURE[selector.toLowerCase()];
+            if (builtinSignature)
+                signatures.add(builtinSignature);
+            if (!knownSignature && !builtinSignature) {
+                const fetched = await fetchSignaturesBySelector(selector, fetchTimeout);
+                fetched.forEach((signature) => signatures.add(signature));
+            }
+            signatures.forEach((signature) => addResult(signature, selector, []));
+            return results;
+        }
+    }
+    const initialCandidates = collectCandidateStrings(input);
+    for (const candidate of initialCandidates) {
+        await processCandidateString(candidate);
+    }
+    const entriesWithParams = new Set(results
+        .filter((entry) => entry.params.length > 0)
+        .map((entry) => JSON.stringify([entry.signature, entry.selector])));
+    return results.filter((entry) => {
+        if (entry.params.length > 0)
+            return true;
+        return !entriesWithParams.has(JSON.stringify([entry.signature, entry.selector]));
+    });
+}
+//# sourceMappingURL=decodeSmartContractErrors.js.map

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

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

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

@@ -0,0 +1,28 @@
+export type DataIssueSeverity = "info" | "warning" | "error";
+export type DataIssueCode = "COERCED_TYPE" | "OUT_OF_RANGE_CLAMPED" | "OUT_OF_RANGE_DROPPED" | "PRECISION_LOSS" | "DEFAULT_APPLIED" | "SOURCE_UNAVAILABLE" | "FALLBACK_USED" | "DECODE_FAILED";
+export interface DataIssue {
+    code: DataIssueCode;
+    severity: DataIssueSeverity;
+    message: string;
+    /** JSONPath-like, relative to a fetch result root entity. */
+    paths: string[];
+    /** Stable entity identifier (address for vault/account/subaccount/wallet/asset when known). */
+    entityId?: string;
+    source?: string;
+    originalValue?: unknown;
+    normalizedValue?: unknown;
+}
+export interface ServiceResult<T> {
+    result: T;
+    errors: DataIssue[];
+}
+export declare function withPathPrefix(path: string, prefix: string): string;
+export declare function mapDataIssuePaths(issue: DataIssue, mapPath: (path: string) => string): DataIssue;
+export declare function prefixDataIssue(issue: DataIssue, prefix: string): DataIssue;
+export declare function prefixDataIssues(errors: DataIssue[], prefix: string): DataIssue[];
+/**
+ * Normalizes list-root diagnostics like "$.vaults[0].x" to "$[0].x" for
+ * service methods that return top-level arrays.
+ */
+export declare function normalizeTopLevelVaultArrayPath(path: string): string;
+export declare function compressDataIssues(errors: DataIssue[]): DataIssue[];

package/dist/src/utils/entityDiagnostics.js

@@ -0,0 +1,72 @@
+export function withPathPrefix(path, prefix) {
+    if (!prefix || prefix === "$")
+        return path;
+    if (path === "$")
+        return prefix;
+    if (path.startsWith("$."))
+        return `${prefix}${path.slice(1)}`;
+    if (path.startsWith("$["))
+        return `${prefix}${path.slice(1)}`;
+    return `${prefix}.${path}`;
+}
+function uniquePaths(paths) {
+    return Array.from(new Set(paths));
+}
+export function mapDataIssuePaths(issue, mapPath) {
+    return {
+        ...issue,
+        paths: uniquePaths(issue.paths.map(mapPath)),
+    };
+}
+export function prefixDataIssue(issue, prefix) {
+    return mapDataIssuePaths(issue, (path) => withPathPrefix(path, prefix));
+}
+export function prefixDataIssues(errors, prefix) {
+    return errors.map((issue) => prefixDataIssue(issue, prefix));
+}
+/**
+ * Normalizes list-root diagnostics like "$.vaults[0].x" to "$[0].x" for
+ * service methods that return top-level arrays.
+ */
+export function normalizeTopLevelVaultArrayPath(path) {
+    return path.replace(/^\$\.(?:vaults|eVaults|eulerEarns)\[(\d+)\](?=\.|$)/, (_match, index) => `$[${index}]`);
+}
+function stableSerialize(value) {
+    if (typeof value === "bigint")
+        return `bigint:${value.toString()}`;
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => stableSerialize(entry)).join(",")}]`;
+    }
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${stableSerialize(entry)}`);
+        return `{${entries.join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+export function compressDataIssues(errors) {
+    const byFingerprint = new Map();
+    for (const issue of errors) {
+        const fingerprint = stableSerialize({
+            code: issue.code,
+            severity: issue.severity,
+            message: issue.message,
+            entityId: issue.entityId,
+            source: issue.source,
+            originalValue: issue.originalValue,
+            normalizedValue: issue.normalizedValue,
+        });
+        const existing = byFingerprint.get(fingerprint);
+        if (!existing) {
+            byFingerprint.set(fingerprint, {
+                ...issue,
+                paths: uniquePaths(issue.paths),
+            });
+            continue;
+        }
+        existing.paths = uniquePaths([...existing.paths, ...issue.paths]);
+    }
+    return Array.from(byFingerprint.values());
+}
+//# sourceMappingURL=entityDiagnostics.js.map

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

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