@raac/rpc 1.1.0-beta.53 → 1.1.0-beta.54

package/dist/RPCLibrary.js

@@ -120,6 +120,7 @@ const vaultOpened_1 = __importDefault(require("./pools/lendingPool/vaultOpened")
 const getWithdrawRequestInfo_2 = require("./pools/stabilityPool/getWithdrawRequestInfo");
 const requestWithdraw_2 = require("./pools/stabilityPool/requestWithdraw");
 const artifacts_1 = require("./utils/artifacts");
+const errorDecoder_1 = require("./utils/errorDecoder");
 class RPCLibrary {
     signer;
     isConnected;
@@ -139,6 +140,7 @@ class RPCLibrary {
     checkAllowance;
     getChainsConfig;
     setChainsConfig;
+    errors;
     constructor(privateKey) {
         this.signer = null;
         this.isConnected = false;
@@ -282,6 +284,11 @@ class RPCLibrary {
             createZeno: createZeno_1.default,
             getZenos: getZenos_1.default,
         };
+        this.errors = {
+            decodeErrorName: errorDecoder_1.decodeErrorName,
+            getErrorInfo: errorDecoder_1.getErrorInfo,
+            attachDecodedError: errorDecoder_1.attachDecodedError,
+        };
     }
     async getWallet(privateKey, provider) {
         // @ts-ignore

package/dist/pools/lendingPool/depositToLendingPool.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
+const errorDecoder_1 = require("../../utils/errorDecoder");
 // checked
 async function depositToLendingPool(chainId, amount, signer) {
     if (!signer) {
@@ -22,7 +23,8 @@ async function depositToLendingPool(chainId, amount, signer) {
     }
     catch (error) {
         console.error(`Lending Pool Deposit error:`, error);
-        throw new Error(`Lending Pool Deposit failed: ${error.message}`);
+        const message = (0, errorDecoder_1.attachDecodedError)("Lending Pool Deposit failed", error);
+        throw new Error(`${message}: ${error.message}`);
     }
 }
 exports.default = depositToLendingPool;

package/dist/scripts/index.js

@@ -10,6 +10,7 @@ const RPCLibrary_1 = __importDefault(require("../RPCLibrary"));
 const contracts_1 = require("../utils/contracts");
 const artifacts_1 = require("../utils/artifacts");
 const _helpers_1 = require("../pools/rwaVault/_helpers");
+const errorDecoder_1 = require("../utils/errorDecoder");
 const chainId = 8453;
 const config = chains_1.default[chainId];
 const TEST_MNEMONIC = process.env.TEST_MNEMONIC;
@@ -33,6 +34,8 @@ async function createWallet(mnemonic, provider) {
     }
 }
 async function setup() {
+    console.log((0, errorDecoder_1.decodeErrorName)("Encoded error signature 0xa9b65aba not found on ABI."));
+    return;
     const provider = await getProvider();
     const signer = await createWallet(TEST_MNEMONIC, provider);
     const rpc = new RPCLibrary_1.default();

package/dist/types/RPCLibrary.d.ts

@@ -95,6 +95,7 @@ import vaultOpened from "./pools/lendingPool/vaultOpened";
 import { getWithdrawRequestInfo as getStabilityPoolWithdrawRequestInfo } from "./pools/stabilityPool/getWithdrawRequestInfo";
 import { requestWithdraw as requestStabilityPoolWithdraw } from "./pools/stabilityPool/requestWithdraw";
 import { getABI } from "./utils/artifacts";
+import { decodeErrorName, getErrorInfo, attachDecodedError } from "./utils/errorDecoder";
 declare class RPCLibrary {
     signer: Signer | null;
     isConnected: boolean;
@@ -236,6 +237,11 @@ declare class RPCLibrary {
     checkAllowance: typeof checkAllowance;
     getChainsConfig: typeof getChainsConfig;
     setChainsConfig: typeof setChainConfig;
+    errors: {
+        decodeErrorName: typeof decodeErrorName;
+        getErrorInfo: typeof getErrorInfo;
+        attachDecodedError: typeof attachDecodedError;
+    };
     constructor(privateKey?: string);
     getWallet(privateKey: string, provider: Provider): Promise<ethers.JsonRpcSigner | ethers.Wallet>;
     getProvider(chainId: ChainId, providerRpc?: string): Promise<ethers.BrowserProvider | ethers.JsonRpcProvider>;

package/dist/types/utils/errorDecoder.d.ts

@@ -0,0 +1,21 @@
+interface ErrorInfo {
+    name: string;
+    signature: string;
+    abiItem: any;
+}
+/**
+ * Returns detailed information about the error encoded in the given data blob.
+ * @param data The revert data returned by the EVM (e.g., error.data).
+ */
+export declare function getErrorInfo(data?: string): ErrorInfo | null;
+/**
+ * Returns only the error name, or null if it cannot be decoded.
+ */
+export declare function decodeErrorName(data?: string): string | null;
+/**
+ * Builds a user-friendly error prefix with decoded error name (if available).
+ * Usage example:
+ *   const msg = attachDecodedError("Deposit failed", caughtError);
+ */
+export declare function attachDecodedError(prefix: string, error: any): string;
+export {};

package/dist/utils/errorDecoder.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorInfo = getErrorInfo;
+exports.decodeErrorName = decodeErrorName;
+exports.attachDecodedError = attachDecodedError;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("./artifacts");
+const ERROR_SIGNATURE_MAP = {};
+(function buildErrorSignatureMap() {
+    for (const abiKey in artifacts_1.ABIS) {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore – ABIS may contain unknown items
+        const abi = artifacts_1.ABIS[abiKey];
+        if (!Array.isArray(abi))
+            continue;
+        for (const item of abi) {
+            if (item.type !== "error")
+                continue;
+            const inputs = (item.inputs || []);
+            const signature = `${item.name}(${inputs.map((input) => input.type).join(",")})`;
+            const selector = (0, ethers_1.id)(signature).slice(0, 10).toLowerCase();
+            if (!ERROR_SIGNATURE_MAP[selector]) {
+                ERROR_SIGNATURE_MAP[selector] = {
+                    name: item.name,
+                    signature,
+                    abiItem: item,
+                };
+            }
+        }
+    }
+})();
+/**
+ * Returns detailed information about the error encoded in the given data blob.
+ * @param data The revert data returned by the EVM (e.g., error.data).
+ */
+function getErrorInfo(data) {
+    if (!data || typeof data !== "string")
+        return null;
+    let selector;
+    if (data.startsWith("0x")) {
+        selector = data.slice(0, 10).toLowerCase();
+    }
+    else {
+        // look for first 4-byte hex inside the string (e.g., error message)
+        const match = data.match(/0x[0-9a-fA-F]{8}/);
+        if (match)
+            selector = match[0].toLowerCase();
+    }
+    if (!selector)
+        return null;
+    return ERROR_SIGNATURE_MAP[selector] ?? null;
+}
+/**
+ * Returns only the error name, or null if it cannot be decoded.
+ */
+function decodeErrorName(data) {
+    const info = getErrorInfo(data);
+    return info?.name ?? null;
+}
+/**
+ * Builds a user-friendly error prefix with decoded error name (if available).
+ * Usage example:
+ *   const msg = attachDecodedError("Deposit failed", caughtError);
+ */
+function attachDecodedError(prefix, error) {
+    // ethers@6 nests the original error under error.error
+    // viem/ethcall surface it directly on error.data
+    const data = (error && ((error.data ?? error.error?.data) ||
+        // viem error format: error.shortMessage
+        undefined));
+    // If data not found, attempt to extract selector from message like
+    // "Encoded error signature \"0xa9b65aba\" not found on ABI"
+    let selector;
+    if (data && data.startsWith("0x")) {
+        selector = data.slice(0, 10).toLowerCase();
+    }
+    else if (typeof error?.message === "string") {
+        const SIGNATURE_REGEX = /Encoded error signature \"(0x[0-9a-fA-F]{8})\"/;
+        const match = error.message.match(SIGNATURE_REGEX);
+        if (match)
+            selector = match[1].toLowerCase();
+    }
+    if (!selector)
+        return prefix; // unable to determine
+    const decodedName = ERROR_SIGNATURE_MAP[selector]?.name ?? null;
+    // console.debug("Decoded", selector, decodedName);
+    return decodedName ? `${prefix} (${decodedName})` : prefix;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@raac/rpc",
-	"version": "1.1.0-beta.53",
+	"version": "1.1.0-beta.54",
 	"description": "RPC Library for RAAC ",
 	"main": "dist/index.js",
 	"types": "dist/types/index.d.ts",