290 lines
12 KiB
JavaScript
290 lines
12 KiB
JavaScript
"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
|