"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.EOACodeEIP7702Transaction = void 0; const rlp_1 = require("@ethereumjs/rlp"); const util_1 = require("@ethereumjs/util"); const baseTransaction_js_1 = require("./baseTransaction.js"); const EIP1559 = require("./capabilities/eip1559.js"); const EIP2718 = require("./capabilities/eip2718.js"); const EIP7702 = require("./capabilities/eip7702.js"); const Legacy = require("./capabilities/legacy.js"); const types_js_1 = require("./types.js"); const util_js_1 = require("./util.js"); /** * Typed transaction with the ability to set codes on EOA accounts * * - TransactionType: 4 * - EIP: [EIP-7702](https://github.com/ethereum/EIPs/blob/62419ca3f45375db00b04a368ea37c0bfb05386a/EIPS/eip-7702.md) */ class EOACodeEIP7702Transaction extends baseTransaction_js_1.BaseTransaction { /** * This constructor takes the values, validates them, assigns them and freezes the object. * * It is not recommended to use this constructor directly. Instead use * the static factory methods to assist in creating a Transaction object from * varying data types. */ constructor(txData, opts = {}) { super({ ...txData, type: types_js_1.TransactionType.EOACodeEIP7702 }, opts); const { chainId, accessList, authorizationList, maxFeePerGas, maxPriorityFeePerGas } = txData; this.common = this._getCommon(opts.common, chainId); this.chainId = this.common.chainId(); if (!this.common.isActivatedEIP(7702)) { throw new Error('EIP-7702 not enabled on Common'); } this.activeCapabilities = this.activeCapabilities.concat([1559, 2718, 2930, 7702]); // Populate the access list fields const accessListData = util_js_1.AccessLists.getAccessListData(accessList ?? []); this.accessList = accessListData.accessList; this.AccessListJSON = accessListData.AccessListJSON; // Verify the access list format. util_js_1.AccessLists.verifyAccessList(this.accessList); // Populate the authority list fields const authorizationListData = util_js_1.AuthorizationLists.getAuthorizationListData(authorizationList ?? []); this.authorizationList = authorizationListData.authorizationList; this.AuthorizationListJSON = authorizationListData.AuthorizationListJSON; // Verify the authority list format. util_js_1.AuthorizationLists.verifyAuthorizationList(this.authorizationList); this.maxFeePerGas = (0, util_1.bytesToBigInt)((0, util_1.toBytes)(maxFeePerGas)); this.maxPriorityFeePerGas = (0, util_1.bytesToBigInt)((0, util_1.toBytes)(maxPriorityFeePerGas)); this._validateCannotExceedMaxInteger({ maxFeePerGas: this.maxFeePerGas, maxPriorityFeePerGas: this.maxPriorityFeePerGas, }); baseTransaction_js_1.BaseTransaction._validateNotArray(txData); if (this.gasLimit * this.maxFeePerGas > util_1.MAX_INTEGER) { const msg = this._errorMsg('gasLimit * maxFeePerGas cannot exceed MAX_INTEGER (2^256-1)'); throw new Error(msg); } if (this.maxFeePerGas < this.maxPriorityFeePerGas) { const msg = this._errorMsg('maxFeePerGas cannot be less than maxPriorityFeePerGas (The total must be the larger of the two)'); throw new Error(msg); } EIP2718.validateYParity(this); Legacy.validateHighS(this); const freeze = opts?.freeze ?? true; if (freeze) { Object.freeze(this); } } /** * Instantiate a transaction from a data dictionary. * * Format: { chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, * accessList, v, r, s } * * Notes: * - `chainId` will be set automatically if not provided * - All parameters are optional and have some basic default values */ static fromTxData(txData, opts = {}) { return new EOACodeEIP7702Transaction(txData, opts); } /** * Instantiate a transaction from the serialized tx. * * Format: `0x04 || rlp([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, * accessList, signatureYParity, signatureR, signatureS])` */ static fromSerializedTx(serialized, opts = {}) { if ((0, util_1.equalsBytes)(serialized.subarray(0, 1), (0, util_js_1.txTypeBytes)(types_js_1.TransactionType.EOACodeEIP7702)) === false) { throw new Error(`Invalid serialized tx input: not an EIP-7702 transaction (wrong tx type, expected: ${types_js_1.TransactionType.EOACodeEIP7702}, received: ${(0, util_1.bytesToHex)(serialized.subarray(0, 1))}`); } const values = rlp_1.RLP.decode(serialized.subarray(1)); if (!Array.isArray(values)) { throw new Error('Invalid serialized tx input: must be array'); } return EOACodeEIP7702Transaction.fromValuesArray(values, opts); } /** * Create a transaction from a values array. * * Format: `[chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, * accessList, signatureYParity, signatureR, signatureS]` */ static fromValuesArray(values, opts = {}) { if (values.length !== 10 && values.length !== 13) { throw new Error('Invalid EIP-7702 transaction. Only expecting 10 values (for unsigned tx) or 13 values (for signed tx).'); } const [chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, authorityList, v, r, s,] = values; this._validateNotArray({ chainId, v }); (0, util_1.validateNoLeadingZeroes)({ nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, value, v, r, s }); return new EOACodeEIP7702Transaction({ chainId: (0, util_1.bytesToBigInt)(chainId), nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList: accessList ?? [], authorizationList: authorityList ?? [], v: v !== undefined ? (0, util_1.bytesToBigInt)(v) : undefined, r, s, }, opts); } /** * The amount of gas paid for the data in this tx */ getDataFee() { return EIP7702.getDataFee(this); } /** * Returns the minimum of calculated priority fee (from maxFeePerGas and baseFee) and maxPriorityFeePerGas * @param baseFee Base fee retrieved from block */ getEffectivePriorityFee(baseFee) { return EIP1559.getEffectivePriorityFee(this, baseFee); } /** * The up front amount that an account must have for this transaction to be valid * @param baseFee The base fee of the block (will be set to 0 if not provided) */ getUpfrontCost(baseFee = util_1.BIGINT_0) { return EIP1559.getUpfrontCost(this, baseFee); } /** * Returns a Uint8Array Array of the raw Bytes of the EIP-7702 transaction, in order. * * Format: `[chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, * accessList, authorizationList, signatureYParity, signatureR, signatureS]` * * Use {@link EOACodeEIP7702Transaction.serialize} to add a transaction to a block * with {@link Block.fromValuesArray}. * * For an unsigned tx this method uses the empty Bytes values for the * signature parameters `v`, `r` and `s` for encoding. For an EIP-155 compliant * representation for external signing use {@link EOACodeEIP7702Transaction.getMessageToSign}. */ raw() { return [ (0, util_1.bigIntToUnpaddedBytes)(this.chainId), (0, util_1.bigIntToUnpaddedBytes)(this.nonce), (0, util_1.bigIntToUnpaddedBytes)(this.maxPriorityFeePerGas), (0, util_1.bigIntToUnpaddedBytes)(this.maxFeePerGas), (0, util_1.bigIntToUnpaddedBytes)(this.gasLimit), this.to !== undefined ? this.to.bytes : new Uint8Array(0), (0, util_1.bigIntToUnpaddedBytes)(this.value), this.data, this.accessList, this.authorizationList, this.v !== undefined ? (0, util_1.bigIntToUnpaddedBytes)(this.v) : new Uint8Array(0), this.r !== undefined ? (0, util_1.bigIntToUnpaddedBytes)(this.r) : new Uint8Array(0), this.s !== undefined ? (0, util_1.bigIntToUnpaddedBytes)(this.s) : new Uint8Array(0), ]; } /** * Returns the serialized encoding of the EIP-7702 transaction. * * Format: `0x02 || rlp([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, * accessList, authorizationList, signatureYParity, signatureR, signatureS])` * * Note that in contrast to the legacy tx serialization format this is not * valid RLP any more due to the raw tx type preceding and concatenated to * the RLP encoding of the values. */ serialize() { return EIP2718.serialize(this); } /** * Returns the raw serialized unsigned tx, which can be used * to sign the transaction (e.g. for sending to a hardware wallet). * * Note: in contrast to the legacy tx the raw message format is already * serialized and doesn't need to be RLP encoded any more. * * ```javascript * const serializedMessage = tx.getMessageToSign() // use this for the HW wallet input * ``` */ getMessageToSign() { return EIP2718.serialize(this, this.raw().slice(0, 10)); } /** * Returns the hashed serialized unsigned tx, which can be used * to sign the transaction (e.g. for sending to a hardware wallet). * * Note: in contrast to the legacy tx the raw message format is already * serialized and doesn't need to be RLP encoded any more. */ getHashedMessageToSign() { return EIP2718.getHashedMessageToSign(this); } /** * Computes a sha3-256 hash of the serialized tx. * * This method can only be used for signed txs (it throws otherwise). * Use {@link EOACodeEIP7702Transaction.getMessageToSign} to get a tx hash for the purpose of signing. */ hash() { return Legacy.hash(this); } /** * Computes a sha3-256 hash which can be used to verify the signature */ getMessageToVerifySignature() { return this.getHashedMessageToSign(); } /** * Returns the public key of the sender */ getSenderPublicKey() { return Legacy.getSenderPublicKey(this); } addSignature(v, r, s, convertV = false) { r = (0, util_1.toBytes)(r); s = (0, util_1.toBytes)(s); const opts = { ...this.txOptions, common: this.common }; return EOACodeEIP7702Transaction.fromTxData({ chainId: this.chainId, nonce: this.nonce, maxPriorityFeePerGas: this.maxPriorityFeePerGas, maxFeePerGas: this.maxFeePerGas, gasLimit: this.gasLimit, to: this.to, value: this.value, data: this.data, accessList: this.accessList, authorizationList: this.authorizationList, v: convertV ? v - util_1.BIGINT_27 : v, r: (0, util_1.bytesToBigInt)(r), s: (0, util_1.bytesToBigInt)(s), }, opts); } /** * Returns an object with the JSON representation of the transaction */ toJSON() { const accessListJSON = util_js_1.AccessLists.getAccessListJSON(this.accessList); const baseJson = super.toJSON(); return { ...baseJson, chainId: (0, util_1.bigIntToHex)(this.chainId), maxPriorityFeePerGas: (0, util_1.bigIntToHex)(this.maxPriorityFeePerGas), maxFeePerGas: (0, util_1.bigIntToHex)(this.maxFeePerGas), accessList: accessListJSON, authorizationList: this.AuthorizationListJSON, }; } /** * Return a compact error string representation of the object */ errorStr() { let errorStr = this._getSharedErrorPostfix(); errorStr += ` maxFeePerGas=${this.maxFeePerGas} maxPriorityFeePerGas=${this.maxPriorityFeePerGas}`; return errorStr; } /** * Internal helper function to create an annotated error message * * @param msg Base error message * @hidden */ _errorMsg(msg) { return Legacy.errorMsg(this, msg); } } exports.EOACodeEIP7702Transaction = EOACodeEIP7702Transaction; //# sourceMappingURL=eip7702Transaction.js.map