wb3-eth 0.0.1-security → 4.10.0

package/lib/commonjs/utils/decode_signed_transaction.d.ts

@@ -0,0 +1,13 @@
+import { DataFormat, HexStringBytes, SignedTransactionInfoAPI } from 'web3-types';
+import { type CustomTransactionSchema } from '../types.js';
+/**
+ * Decodes an [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/#top) encoded transaction.
+ *
+ * @param encodedSignedTransaction The RLP encoded transaction.
+ * @param returnFormat ({@link DataFormat} Specifies how the return data should be formatted.
+ * @returns {@link SignedTransactionInfoAPI}, an object containing the RLP encoded signed transaction (accessed via the `raw` property) and the signed transaction object (accessed via the `tx` property).
+ */
+export declare function decodeSignedTransaction<ReturnFormat extends DataFormat>(encodedSignedTransaction: HexStringBytes, returnFormat: ReturnFormat, options?: {
+    fillInputAndData?: boolean;
+    transactionSchema?: CustomTransactionSchema;
+}): SignedTransactionInfoAPI;

package/lib/commonjs/utils/decode_signed_transaction.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeSignedTransaction = void 0;
+const web3_utils_1 = require("web3-utils");
+const web3_eth_accounts_1 = require("web3-eth-accounts");
+const detect_transaction_type_js_1 = require("./detect_transaction_type.js");
+const format_transaction_js_1 = require("./format_transaction.js");
+/**
+ * Decodes an [RLP](https://ethereum.org/en/developers/docs/data-structures-and-encoding/rlp/#top) encoded transaction.
+ *
+ * @param encodedSignedTransaction The RLP encoded transaction.
+ * @param returnFormat ({@link DataFormat} Specifies how the return data should be formatted.
+ * @returns {@link SignedTransactionInfoAPI}, an object containing the RLP encoded signed transaction (accessed via the `raw` property) and the signed transaction object (accessed via the `tx` property).
+ */
+function decodeSignedTransaction(encodedSignedTransaction, returnFormat, options = {
+    fillInputAndData: false,
+}) {
+    return {
+        raw: (0, web3_utils_1.format)({ format: 'bytes' }, encodedSignedTransaction, returnFormat),
+        tx: (0, format_transaction_js_1.formatTransaction)(Object.assign(Object.assign({}, web3_eth_accounts_1.TransactionFactory.fromSerializedData((0, web3_utils_1.hexToBytes)(encodedSignedTransaction)).toJSON()), { hash: (0, web3_utils_1.bytesToHex)((0, web3_utils_1.keccak256)((0, web3_utils_1.hexToBytes)(encodedSignedTransaction))), type: (0, detect_transaction_type_js_1.detectRawTransactionType)((0, web3_utils_1.hexToBytes)(encodedSignedTransaction)) }), returnFormat, {
+            fillInputAndData: options.fillInputAndData,
+            transactionSchema: options.transactionSchema,
+        }),
+    };
+}
+exports.decodeSignedTransaction = decodeSignedTransaction;
+//# sourceMappingURL=decode_signed_transaction.js.map

package/lib/commonjs/utils/decode_signed_transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode_signed_transaction.js","sourceRoot":"","sources":["../../../src/utils/decode_signed_transaction.ts"],"names":[],"mappings":";;;AAsBA,2CAAuE;AACvE,yDAAuD;AACvD,6EAAwE;AACxE,mEAA4D;AAG5D;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACtC,wBAAwC,EACxC,YAA0B,EAC1B,UAAuF;IACtF,gBAAgB,EAAE,KAAK;CACvB;IAED,OAAO;QACN,GAAG,EAAE,IAAA,mBAAM,EAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,wBAAwB,EAAE,YAAY,CAAC;QACxE,EAAE,EAAE,IAAA,yCAAiB,EACpB,gCACI,sCAAkB,CAAC,kBAAkB,CACvC,IAAA,uBAAU,EAAC,wBAAwB,CAAC,CACpC,CAAC,MAAM,EAAE,KACV,IAAI,EAAE,IAAA,uBAAU,EAAC,IAAA,sBAAS,EAAC,IAAA,uBAAU,EAAC,wBAAwB,CAAC,CAAC,CAAC,EACjE,IAAI,EAAE,IAAA,qDAAwB,EAAC,IAAA,uBAAU,EAAC,wBAAwB,CAAC,CAAC,GAC5C,EACzB,YAAY,EACZ;YACC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC5C,CACD;KACD,CAAC;AACH,CAAC;AAxBD,0DAwBC"}

package/lib/commonjs/utils/decoding.d.ts

@@ -0,0 +1,4 @@
+import { AbiEventFragment, LogsInput, DataFormat, EventLog, ContractAbiWithSignature } from 'web3-types';
+export declare const decodeEventABI: (event: AbiEventFragment & {
+    signature: string;
+}, data: LogsInput, jsonInterface: ContractAbiWithSignature, returnFormat?: DataFormat) => EventLog;

package/lib/commonjs/utils/decoding.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeEventABI = void 0;
+const web3_utils_1 = require("web3-utils");
+const web3_types_1 = require("web3-types");
+const web3_eth_abi_1 = require("web3-eth-abi");
+const schemas_js_1 = require("../schemas.js");
+const constants_js_1 = require("../constants.js");
+const decodeEventABI = (event, data, jsonInterface, returnFormat = web3_types_1.DEFAULT_RETURN_FORMAT) => {
+    var _a, _b, _c, _d, _e;
+    let modifiedEvent = Object.assign({}, event);
+    const result = (0, web3_utils_1.format)(schemas_js_1.logSchema, data, returnFormat);
+    // if allEvents get the right event
+    if ([constants_js_1.ALL_EVENTS, 'allEvents'].includes(modifiedEvent.name)) {
+        const matchedEvent = jsonInterface.find(j => j.signature === data.topics[0]);
+        if (matchedEvent) {
+            modifiedEvent = matchedEvent;
+        }
+        else {
+            modifiedEvent = { anonymous: true };
+        }
+    }
+    // create empty inputs if none are present (e.g. anonymous events on allEvents)
+    modifiedEvent.inputs = (_b = (_a = modifiedEvent.inputs) !== null && _a !== void 0 ? _a : event.inputs) !== null && _b !== void 0 ? _b : [];
+    // Handle case where an event signature shadows the current ABI with non-identical
+    // arg indexing. If # of topics doesn't match, event is anon.
+    if (!modifiedEvent.anonymous) {
+        let indexedInputs = 0;
+        ((_c = modifiedEvent.inputs) !== null && _c !== void 0 ? _c : []).forEach(input => {
+            if (input.indexed) {
+                indexedInputs += 1;
+            }
+        });
+        if (indexedInputs > 0 && (data === null || data === void 0 ? void 0 : data.topics) && (data === null || data === void 0 ? void 0 : data.topics.length) !== indexedInputs + 1) {
+            // checks if event is anonymous
+            modifiedEvent = Object.assign(Object.assign({}, modifiedEvent), { anonymous: true, inputs: [] });
+        }
+    }
+    const argTopics = modifiedEvent.anonymous ? data.topics : ((_d = data.topics) !== null && _d !== void 0 ? _d : []).slice(1);
+    return Object.assign(Object.assign({}, result), { returnValues: (0, web3_eth_abi_1.decodeLog)([...((_e = modifiedEvent.inputs) !== null && _e !== void 0 ? _e : [])], data.data, argTopics), event: modifiedEvent.name, signature: modifiedEvent.anonymous || !data.topics || data.topics.length === 0 || !data.topics[0]
+            ? undefined
+            : data.topics[0], raw: {
+            data: data.data,
+            topics: data.topics,
+        } });
+};
+exports.decodeEventABI = decodeEventABI;
+//# sourceMappingURL=decoding.js.map

package/lib/commonjs/utils/decoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoding.js","sourceRoot":"","sources":["../../../src/utils/decoding.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;AAEF,2CAAoC;AAEpC,2CAOoB;AAEpB,+CAAyC;AAEzC,8CAA0C;AAC1C,kDAA6C;AAEtC,MAAM,cAAc,GAAG,CAC7B,KAA+C,EAC/C,IAAe,EACf,aAAuC,EACvC,eAA2B,kCAAqB,EACrC,EAAE;;IACb,IAAI,aAAa,qBAAQ,KAAK,CAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,IAAA,mBAAM,EAAC,sBAAS,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAErD,mCAAmC;IACnC,IAAI,CAAC,yBAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE;QAC3D,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,IAAI,YAAY,EAAE;YACjB,aAAa,GAAG,YAAwD,CAAC;SACzE;aAAM;YACN,aAAa,GAAG,EAAE,SAAS,EAAE,IAAI,EAEhC,CAAC;SACF;KACD;IAED,+EAA+E;IAC/E,aAAa,CAAC,MAAM,GAAG,MAAA,MAAA,aAAa,CAAC,MAAM,mCAAI,KAAK,CAAC,MAAM,mCAAI,EAAE,CAAC;IAElE,kFAAkF;IAClF,6DAA6D;IAC7D,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE;QAC7B,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,CAAC,MAAA,aAAa,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC5C,IAAI,KAAK,CAAC,OAAO,EAAE;gBAClB,aAAa,IAAI,CAAC,CAAC;aACnB;QACF,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,GAAG,CAAC,KAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,CAAA,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,CAAC,MAAM,MAAK,aAAa,GAAG,CAAC,EAAE;YACnF,+BAA+B;YAC/B,aAAa,mCACT,aAAa,KAChB,SAAS,EAAE,IAAI,EACf,MAAM,EAAE,EAAE,GACV,CAAC;SACF;KACD;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvF,uCACI,MAAM,KACT,YAAY,EAAE,IAAA,wBAAS,EAAC,CAAC,GAAG,CAAC,MAAA,aAAa,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAChF,KAAK,EAAE,aAAa,CAAC,IAAI,EACzB,SAAS,EACR,aAAa,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACrF,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAElB,GAAG,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,IACA;AACH,CAAC,CAAC;AA7DW,QAAA,cAAc,kBA6DzB"}

package/lib/commonjs/utils/detect_transaction_type.d.ts

@@ -0,0 +1,6 @@
+import { TransactionTypeParser, Web3Context } from 'web3-core';
+import { EthExecutionAPI } from 'web3-types';
+import { InternalTransaction } from '../types.js';
+export declare const defaultTransactionTypeParser: TransactionTypeParser;
+export declare const detectTransactionType: (transaction: InternalTransaction, web3Context?: Web3Context<EthExecutionAPI>) => string | undefined;
+export declare const detectRawTransactionType: (transaction: Uint8Array) => string;

package/lib/commonjs/utils/detect_transaction_type.js

@@ -0,0 +1,125 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRawTransactionType = exports.detectTransactionType = exports.defaultTransactionTypeParser = void 0;
+const web3_utils_1 = require("web3-utils");
+const web3_types_1 = require("web3-types");
+const web3_validator_1 = require("web3-validator");
+const web3_errors_1 = require("web3-errors");
+// undefined is treated as null for JSON schema validator
+const transactionType0x0Schema = {
+    type: 'object',
+    properties: {
+        accessList: {
+            type: 'null',
+        },
+        maxFeePerGas: {
+            type: 'null',
+        },
+        maxPriorityFeePerGas: {
+            type: 'null',
+        },
+    },
+};
+const transactionType0x1Schema = {
+    type: 'object',
+    properties: {
+        maxFeePerGas: {
+            type: 'null',
+        },
+        maxPriorityFeePerGas: {
+            type: 'null',
+        },
+    },
+};
+const transactionType0x2Schema = {
+    type: 'object',
+    properties: {
+        gasPrice: {
+            type: 'null',
+        },
+    },
+};
+const validateTxTypeAndHandleErrors = (txSchema, tx, txType) => {
+    try {
+        web3_validator_1.validator.validateJSONSchema(txSchema, tx);
+    }
+    catch (error) {
+        if (error instanceof web3_validator_1.Web3ValidatorError)
+            // Erroneously reported error
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            throw new web3_errors_1.InvalidPropertiesForTransactionTypeError(error.errors, txType);
+        throw error;
+    }
+};
+const defaultTransactionTypeParser = transaction => {
+    var _a, _b;
+    const tx = transaction;
+    if (!(0, web3_validator_1.isNullish)(tx.type)) {
+        let txSchema;
+        switch (tx.type) {
+            case '0x0':
+                txSchema = transactionType0x0Schema;
+                break;
+            case '0x1':
+                txSchema = transactionType0x1Schema;
+                break;
+            case '0x2':
+                txSchema = transactionType0x2Schema;
+                break;
+            default:
+                return (0, web3_utils_1.format)({ format: 'uint' }, tx.type, web3_types_1.ETH_DATA_FORMAT);
+        }
+        validateTxTypeAndHandleErrors(txSchema, tx, tx.type);
+        return (0, web3_utils_1.format)({ format: 'uint' }, tx.type, web3_types_1.ETH_DATA_FORMAT);
+    }
+    if (!(0, web3_validator_1.isNullish)(tx.maxFeePerGas) || !(0, web3_validator_1.isNullish)(tx.maxPriorityFeePerGas)) {
+        validateTxTypeAndHandleErrors(transactionType0x2Schema, tx, '0x2');
+        return '0x2';
+    }
+    if (!(0, web3_validator_1.isNullish)(tx.accessList)) {
+        validateTxTypeAndHandleErrors(transactionType0x1Schema, tx, '0x1');
+        return '0x1';
+    }
+    const givenHardfork = (_a = tx.hardfork) !== null && _a !== void 0 ? _a : (_b = tx.common) === null || _b === void 0 ? void 0 : _b.hardfork;
+    if (!(0, web3_validator_1.isNullish)(givenHardfork)) {
+        const hardforkIndex = Object.keys(web3_types_1.HardforksOrdered).indexOf(givenHardfork);
+        // givenHardfork is London or later, so EIP-2718 is supported
+        if (hardforkIndex >= Object.keys(web3_types_1.HardforksOrdered).indexOf('london'))
+            return !(0, web3_validator_1.isNullish)(tx.gasPrice) ? '0x0' : '0x2';
+        // givenHardfork is Berlin, tx.accessList is undefined, assume type is 0x0
+        if (hardforkIndex === Object.keys(web3_types_1.HardforksOrdered).indexOf('berlin'))
+            return '0x0';
+    }
+    // gasprice is defined
+    if (!(0, web3_validator_1.isNullish)(tx.gasPrice)) {
+        validateTxTypeAndHandleErrors(transactionType0x0Schema, tx, '0x0');
+        return '0x0';
+    }
+    // no transaction type can be inferred from properties, use default transaction type
+    return undefined;
+};
+exports.defaultTransactionTypeParser = defaultTransactionTypeParser;
+const detectTransactionType = (transaction, web3Context) => {
+    var _a;
+    return ((_a = web3Context === null || web3Context === void 0 ? void 0 : web3Context.transactionTypeParser) !== null && _a !== void 0 ? _a : exports.defaultTransactionTypeParser)(transaction);
+};
+exports.detectTransactionType = detectTransactionType;
+const detectRawTransactionType = (transaction) => transaction[0] > 0x7f ? '0x0' : (0, web3_utils_1.toHex)(transaction[0]);
+exports.detectRawTransactionType = detectRawTransactionType;
+//# sourceMappingURL=detect_transaction_type.js.map

package/lib/commonjs/utils/detect_transaction_type.js.map

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

package/lib/commonjs/utils/format_transaction.d.ts

@@ -0,0 +1,7 @@
+import { Transaction, DataFormat, DEFAULT_RETURN_FORMAT, FormatType } from 'web3-types';
+import { ValidationSchemaInput } from 'web3-validator';
+import { type CustomTransactionSchema } from '../types.js';
+export declare function formatTransaction<ReturnFormat extends DataFormat = typeof DEFAULT_RETURN_FORMAT, TransactionType extends Transaction = Transaction>(transaction: TransactionType, returnFormat?: ReturnFormat, options?: {
+    transactionSchema?: ValidationSchemaInput | CustomTransactionSchema | undefined;
+    fillInputAndData?: boolean;
+}): FormatType<TransactionType, ReturnFormat>;

package/lib/commonjs/utils/format_transaction.js

@@ -0,0 +1,61 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTransaction = void 0;
+const web3_types_1 = require("web3-types");
+const web3_validator_1 = require("web3-validator");
+const web3_utils_1 = require("web3-utils");
+const web3_errors_1 = require("web3-errors");
+const schemas_js_1 = require("../schemas.js");
+function formatTransaction(transaction, returnFormat = web3_types_1.DEFAULT_RETURN_FORMAT, options = {
+    transactionSchema: schemas_js_1.transactionInfoSchema,
+    fillInputAndData: false,
+}) {
+    var _a, _b;
+    let formattedTransaction = (0, web3_utils_1.mergeDeep)({}, transaction);
+    if (!(0, web3_validator_1.isNullish)(transaction === null || transaction === void 0 ? void 0 : transaction.common)) {
+        formattedTransaction.common = Object.assign({}, transaction.common);
+        if (!(0, web3_validator_1.isNullish)((_a = transaction.common) === null || _a === void 0 ? void 0 : _a.customChain))
+            formattedTransaction.common.customChain = Object.assign({}, transaction.common.customChain);
+    }
+    formattedTransaction = (0, web3_utils_1.format)((_b = options.transactionSchema) !== null && _b !== void 0 ? _b : schemas_js_1.transactionInfoSchema, formattedTransaction, returnFormat);
+    if (!(0, web3_validator_1.isNullish)(formattedTransaction.data) &&
+        !(0, web3_validator_1.isNullish)(formattedTransaction.input) &&
+        // Converting toHex is accounting for data and input being Uint8Arrays
+        // since comparing Uint8Array is not as straightforward as comparing strings
+        (0, web3_utils_1.toHex)(formattedTransaction.data) !== (0, web3_utils_1.toHex)(formattedTransaction.input))
+        throw new web3_errors_1.TransactionDataAndInputError({
+            data: (0, web3_utils_1.bytesToHex)(formattedTransaction.data),
+            input: (0, web3_utils_1.bytesToHex)(formattedTransaction.input),
+        });
+    if (options.fillInputAndData) {
+        if (!(0, web3_validator_1.isNullish)(formattedTransaction.data)) {
+            formattedTransaction.input = formattedTransaction.data;
+        }
+        else if (!(0, web3_validator_1.isNullish)(formattedTransaction.input)) {
+            formattedTransaction.data = formattedTransaction.input;
+        }
+    }
+    if (!(0, web3_validator_1.isNullish)(formattedTransaction.gasLimit)) {
+        formattedTransaction.gas = formattedTransaction.gasLimit;
+        delete formattedTransaction.gasLimit;
+    }
+    return formattedTransaction;
+}
+exports.formatTransaction = formatTransaction;
+//# sourceMappingURL=format_transaction.js.map

package/lib/commonjs/utils/format_transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_transaction.js","sourceRoot":"","sources":["../../../src/utils/format_transaction.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;AAEF,2CAAwF;AACxF,mDAAkE;AAClE,2CAAkE;AAClE,6CAA2D;AAE3D,8CAAsD;AAGtD,SAAgB,iBAAiB,CAIhC,WAA4B,EAC5B,eAA6B,kCAAqC,EAClE,UAGI;IACH,iBAAiB,EAAE,kCAAqB;IACxC,gBAAgB,EAAE,KAAK;CACvB;;IAED,IAAI,oBAAoB,GAAG,IAAA,sBAAS,EAAC,EAAE,EAAE,WAAsC,CAAgB,CAAC;IAChG,IAAI,CAAC,IAAA,0BAAS,EAAC,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,MAAM,CAAC,EAAE;QACpC,oBAAoB,CAAC,MAAM,qBAAQ,WAAW,CAAC,MAAM,CAAE,CAAC;QACxD,IAAI,CAAC,IAAA,0BAAS,EAAC,MAAA,WAAW,CAAC,MAAM,0CAAE,WAAW,CAAC;YAC9C,oBAAoB,CAAC,MAAM,CAAC,WAAW,qBAAQ,WAAW,CAAC,MAAM,CAAC,WAAW,CAAE,CAAC;KACjF;IACD,oBAAoB,GAAG,IAAA,mBAAM,EAC5B,MAAA,OAAO,CAAC,iBAAiB,mCAAI,kCAAqB,EAClD,oBAAoB,EACpB,YAAY,CACZ,CAAC;IACF,IACC,CAAC,IAAA,0BAAS,EAAC,oBAAoB,CAAC,IAAI,CAAC;QACrC,CAAC,IAAA,0BAAS,EAAC,oBAAoB,CAAC,KAAK,CAAC;QACtC,sEAAsE;QACtE,4EAA4E;QAC5E,IAAA,kBAAK,EAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,IAAA,kBAAK,EAAC,oBAAoB,CAAC,KAAK,CAAC;QAEtE,MAAM,IAAI,0CAA4B,CAAC;YACtC,IAAI,EAAE,IAAA,uBAAU,EAAC,oBAAoB,CAAC,IAAI,CAAC;YAC3C,KAAK,EAAE,IAAA,uBAAU,EAAC,oBAAoB,CAAC,KAAK,CAAC;SAC7C,CAAC,CAAC;IAEJ,IAAI,OAAO,CAAC,gBAAgB,EAAE;QAC7B,IAAI,CAAC,IAAA,0BAAS,EAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE;YAC1C,oBAAoB,CAAC,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC;SACvD;aAAM,IAAI,CAAC,IAAA,0BAAS,EAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE;YAClD,oBAAoB,CAAC,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC;SACvD;KACD;IAED,IAAI,CAAC,IAAA,0BAAS,EAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE;QAC9C,oBAAoB,CAAC,GAAG,GAAG,oBAAoB,CAAC,QAAQ,CAAC;QACzD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;KACrC;IAED,OAAO,oBAAiE,CAAC;AAC1E,CAAC;AAnDD,8CAmDC"}

package/lib/commonjs/utils/get_revert_reason.d.ts

@@ -0,0 +1,12 @@
+import { Web3Context } from 'web3-core';
+import { ContractAbi, DataFormat, DEFAULT_RETURN_FORMAT, EthExecutionAPI, TransactionCall } from 'web3-types';
+import { RevertReason, RevertReasonWithCustomError } from '../types.js';
+export declare const parseTransactionError: (error: unknown, contractAbi?: ContractAbi) => string | RevertReason;
+/**
+ *	Returns the revert reason generated by the EVM if the transaction were to be executed.
+ *
+ * @param web3Context - ({@link Web3Context}) Web3 configuration object that contains things such as the provider, request manager, wallet, etc.
+ * @param transaction - A transaction object where all properties are optional except `to`, however it's recommended to include the `from` property or it may default to `0x0000000000000000000000000000000000000000` depending on your node or provider.
+ * @returns `undefined` if no revert reason was given, a revert reason object, a revert reason string, or an `unknown` error
+ */
+export declare function getRevertReason<ReturnFormat extends DataFormat = typeof DEFAULT_RETURN_FORMAT>(web3Context: Web3Context<EthExecutionAPI>, transaction: TransactionCall, contractAbi?: ContractAbi, returnFormat?: ReturnFormat): Promise<undefined | RevertReason | RevertReasonWithCustomError | string>;

package/lib/commonjs/utils/get_revert_reason.js

@@ -0,0 +1,81 @@
+"use strict";
+/*
+This file is part of web3.js.
+
+web3.js is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+web3.js is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with web3.js.  If not, see <http://www.gnu.org/licenses/>.
+*/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRevertReason = exports.parseTransactionError = void 0;
+const web3_errors_1 = require("web3-errors");
+const web3_eth_abi_1 = require("web3-eth-abi");
+// eslint-disable-next-line import/no-cycle
+const rpc_method_wrappers_js_1 = require("../rpc_method_wrappers.js");
+const parseTransactionError = (error, contractAbi) => {
+    var _a, _b, _c, _d, _e;
+    if (error instanceof web3_errors_1.ContractExecutionError && error.cause instanceof web3_errors_1.Eip838ExecutionError) {
+        if (contractAbi !== undefined) {
+            const errorsAbi = contractAbi.filter(abi => (0, web3_eth_abi_1.isAbiErrorFragment)(abi));
+            (0, web3_eth_abi_1.decodeContractErrorData)(errorsAbi, error.cause);
+            return {
+                reason: error.cause.message,
+                signature: (_a = error.cause.data) === null || _a === void 0 ? void 0 : _a.slice(0, 10),
+                data: (_b = error.cause.data) === null || _b === void 0 ? void 0 : _b.substring(10),
+                customErrorName: error.cause.errorName,
+                customErrorDecodedSignature: error.cause.errorSignature,
+                customErrorArguments: error.cause.errorArgs,
+            };
+        }
+        return {
+            reason: error.cause.message,
+            signature: (_c = error.cause.data) === null || _c === void 0 ? void 0 : _c.slice(0, 10),
+            data: (_d = error.cause.data) === null || _d === void 0 ? void 0 : _d.substring(10),
+        };
+    }
+    if (error instanceof web3_errors_1.InvalidResponseError &&
+        !Array.isArray((_e = error.cause) === null || _e === void 0 ? void 0 : _e.errors) &&
+        error.cause !== undefined) {
+        return error.cause.message;
+    }
+    throw error;
+};
+exports.parseTransactionError = parseTransactionError;
+/**
+ *	Returns the revert reason generated by the EVM if the transaction were to be executed.
+ *
+ * @param web3Context - ({@link Web3Context}) Web3 configuration object that contains things such as the provider, request manager, wallet, etc.
+ * @param transaction - A transaction object where all properties are optional except `to`, however it's recommended to include the `from` property or it may default to `0x0000000000000000000000000000000000000000` depending on your node or provider.
+ * @returns `undefined` if no revert reason was given, a revert reason object, a revert reason string, or an `unknown` error
+ */
+function getRevertReason(web3Context, transaction, contractAbi, returnFormat = web3Context.defaultReturnFormat) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield (0, rpc_method_wrappers_js_1.call)(web3Context, transaction, web3Context.defaultBlock, returnFormat);
+            return undefined;
+        }
+        catch (error) {
+            return (0, exports.parseTransactionError)(error, contractAbi);
+        }
+    });
+}
+exports.getRevertReason = getRevertReason;
+//# sourceMappingURL=get_revert_reason.js.map

package/lib/commonjs/utils/get_revert_reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_revert_reason.js","sourceRoot":"","sources":["../../../src/utils/get_revert_reason.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;EAeE;;;;;;;;;;;;AAGF,6CAKqB;AACrB,+CAA2E;AAU3E,2CAA2C;AAC3C,sEAAiD;AAG1C,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAE,WAAyB,EAAE,EAAE;;IAClF,IAAI,KAAK,YAAY,oCAAsB,IAAI,KAAK,CAAC,KAAK,YAAY,kCAAoB,EAAE;QAC3F,IAAI,WAAW,KAAK,SAAS,EAAE;YAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC1C,IAAA,iCAAkB,EAAC,GAAG,CAAC,CACU,CAAC;YACnC,IAAA,sCAAuB,EAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEhD,OAAO;gBACN,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;gBAC3B,SAAS,EAAE,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,0CAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACzC,IAAI,EAAE,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,0CAAE,SAAS,CAAC,EAAE,CAAC;gBACrC,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;gBACtC,2BAA2B,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc;gBACvD,oBAAoB,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;aACZ,CAAC;SACjC;QAED,OAAO;YACN,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;YAC3B,SAAS,EAAE,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,0CAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,EAAE,MAAA,KAAK,CAAC,KAAK,CAAC,IAAI,0CAAE,SAAS,CAAC,EAAE,CAAC;SACrB,CAAC;KAClB;IAED,IACC,KAAK,YAAY,kCAAoB;QACrC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAC,KAAK,CAAC,KAAwB,0CAAE,MAAM,CAAC;QACvD,KAAK,CAAC,KAAK,KAAK,SAAS,EACxB;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;KAC3B;IAED,MAAM,KAAK,CAAC;AACb,CAAC,CAAC;AAlCW,QAAA,qBAAqB,yBAkChC;AAEF;;;;;;GAMG;AACH,SAAsB,eAAe,CAGpC,WAAyC,EACzC,WAA4B,EAC5B,WAAyB,EACzB,eAA6B,WAAW,CAAC,mBAAmC;;QAE5E,IAAI;YACH,MAAM,IAAA,6BAAI,EAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YAC7E,OAAO,SAAS,CAAC;SACjB;QAAC,OAAO,KAAK,EAAE;YACf,OAAO,IAAA,6BAAqB,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC;SACjD;IACF,CAAC;CAAA;AAdD,0CAcC"}

package/lib/commonjs/utils/get_transaction_error.d.ts

@@ -0,0 +1,152 @@
+import { Web3Context } from 'web3-core';
+import { TransactionRevertedWithoutReasonError, TransactionRevertInstructionError, TransactionRevertWithCustomError } from 'web3-errors';
+import { DataFormat, FormatType, ContractAbi, TransactionCall, TransactionReceipt } from 'web3-types';
+import { RevertReason, RevertReasonWithCustomError } from '../types.js';
+export declare function getTransactionError<ReturnFormat extends DataFormat>(web3Context: Web3Context, transactionFormatted?: TransactionCall, transactionReceiptFormatted?: FormatType<TransactionReceipt, ReturnFormat>, receivedError?: unknown, contractAbi?: ContractAbi, knownReason?: string | RevertReason | RevertReasonWithCustomError): Promise<TransactionRevertedWithoutReasonError<{
+    readonly transactionHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly transactionIndex: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly blockHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly blockNumber: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly from: string;
+    readonly to: string;
+    readonly cumulativeGasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly gasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly effectiveGasPrice?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    readonly contractAddress?: string | undefined;
+    readonly logs: {
+        readonly id?: string | undefined;
+        readonly removed?: boolean | undefined;
+        readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly address?: string | undefined;
+        readonly data?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly topics?: import("web3-types").ByteTypes[ReturnFormat["bytes"]][] | undefined;
+    }[];
+    readonly logsBloom: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly root: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly status: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly type?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    events?: {
+        [x: string]: {
+            readonly event: string;
+            readonly id?: string | undefined;
+            readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionHash?: string | undefined;
+            readonly blockHash?: string | undefined;
+            readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly address: string;
+            readonly topics: string[];
+            readonly data: string;
+            readonly raw?: {
+                data: string;
+                topics: unknown[];
+            } | undefined;
+            readonly returnValues: {
+                [x: string]: unknown;
+            };
+            readonly signature?: string | undefined;
+        };
+    } | undefined;
+}> | TransactionRevertInstructionError<{
+    readonly transactionHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly transactionIndex: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly blockHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly blockNumber: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly from: string;
+    readonly to: string;
+    readonly cumulativeGasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly gasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly effectiveGasPrice?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    readonly contractAddress?: string | undefined;
+    readonly logs: {
+        readonly id?: string | undefined;
+        readonly removed?: boolean | undefined;
+        readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly address?: string | undefined;
+        readonly data?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly topics?: import("web3-types").ByteTypes[ReturnFormat["bytes"]][] | undefined;
+    }[];
+    readonly logsBloom: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly root: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly status: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly type?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    events?: {
+        [x: string]: {
+            readonly event: string;
+            readonly id?: string | undefined;
+            readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionHash?: string | undefined;
+            readonly blockHash?: string | undefined;
+            readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly address: string;
+            readonly topics: string[];
+            readonly data: string;
+            readonly raw?: {
+                data: string;
+                topics: unknown[];
+            } | undefined;
+            readonly returnValues: {
+                [x: string]: unknown;
+            };
+            readonly signature?: string | undefined;
+        };
+    } | undefined;
+}> | TransactionRevertWithCustomError<{
+    readonly transactionHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly transactionIndex: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly blockHash: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly blockNumber: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly from: string;
+    readonly to: string;
+    readonly cumulativeGasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly gasUsed: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly effectiveGasPrice?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    readonly contractAddress?: string | undefined;
+    readonly logs: {
+        readonly id?: string | undefined;
+        readonly removed?: boolean | undefined;
+        readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly transactionHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockHash?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+        readonly address?: string | undefined;
+        readonly data?: import("web3-types").ByteTypes[ReturnFormat["bytes"]] | undefined;
+        readonly topics?: import("web3-types").ByteTypes[ReturnFormat["bytes"]][] | undefined;
+    }[];
+    readonly logsBloom: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly root: import("web3-types").ByteTypes[ReturnFormat["bytes"]];
+    readonly status: import("web3-types").NumberTypes[ReturnFormat["number"]];
+    readonly type?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+    events?: {
+        [x: string]: {
+            readonly event: string;
+            readonly id?: string | undefined;
+            readonly logIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionIndex?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly transactionHash?: string | undefined;
+            readonly blockHash?: string | undefined;
+            readonly blockNumber?: import("web3-types").NumberTypes[ReturnFormat["number"]] | undefined;
+            readonly address: string;
+            readonly topics: string[];
+            readonly data: string;
+            readonly raw?: {
+                data: string;
+                topics: unknown[];
+            } | undefined;
+            readonly returnValues: {
+                [x: string]: unknown;
+            };
+            readonly signature?: string | undefined;
+        };
+    } | undefined;
+}>>;