660 lines
22 KiB
TypeScript
660 lines
22 KiB
TypeScript
import { RLP } from '@ethereumjs/rlp'
|
|
import {
|
|
BIGINT_0,
|
|
BIGINT_27,
|
|
MAX_INTEGER,
|
|
bigIntToHex,
|
|
bigIntToUnpaddedBytes,
|
|
blobsToCommitments,
|
|
blobsToProofs,
|
|
bytesToBigInt,
|
|
bytesToHex,
|
|
commitmentsToVersionedHashes,
|
|
computeVersionedHash,
|
|
equalsBytes,
|
|
getBlobs,
|
|
toBytes,
|
|
validateNoLeadingZeroes,
|
|
} from '@ethereumjs/util'
|
|
|
|
import { BaseTransaction } from './baseTransaction.js'
|
|
import * as EIP1559 from './capabilities/eip1559.js'
|
|
import * as EIP2718 from './capabilities/eip2718.js'
|
|
import * as EIP2930 from './capabilities/eip2930.js'
|
|
import * as Legacy from './capabilities/legacy.js'
|
|
import { LIMIT_BLOBS_PER_TX } from './constants.js'
|
|
import { TransactionType } from './types.js'
|
|
import { AccessLists, txTypeBytes } from './util.js'
|
|
|
|
import type {
|
|
AccessList,
|
|
AccessListBytes,
|
|
TxData as AllTypesTxData,
|
|
TxValuesArray as AllTypesTxValuesArray,
|
|
BlobEIP4844NetworkValuesArray,
|
|
JsonBlobTxNetworkWrapper,
|
|
JsonTx,
|
|
TxOptions,
|
|
} from './types.js'
|
|
import type { Common } from '@ethereumjs/common'
|
|
import type { Kzg } from '@ethereumjs/util'
|
|
|
|
type TxData = AllTypesTxData[TransactionType.BlobEIP4844]
|
|
type TxValuesArray = AllTypesTxValuesArray[TransactionType.BlobEIP4844]
|
|
|
|
const validateBlobTransactionNetworkWrapper = (
|
|
blobVersionedHashes: Uint8Array[],
|
|
blobs: Uint8Array[],
|
|
commitments: Uint8Array[],
|
|
kzgProofs: Uint8Array[],
|
|
version: number,
|
|
kzg: Kzg
|
|
) => {
|
|
if (!(blobVersionedHashes.length === blobs.length && blobs.length === commitments.length)) {
|
|
throw new Error('Number of blobVersionedHashes, blobs, and commitments not all equal')
|
|
}
|
|
if (blobVersionedHashes.length === 0) {
|
|
throw new Error('Invalid transaction with empty blobs')
|
|
}
|
|
|
|
let isValid
|
|
try {
|
|
isValid = kzg.verifyBlobKzgProofBatch(blobs, commitments, kzgProofs)
|
|
} catch (error) {
|
|
throw new Error(`KZG verification of blobs fail with error=${error}`)
|
|
}
|
|
if (!isValid) {
|
|
throw new Error('KZG proof cannot be verified from blobs/commitments')
|
|
}
|
|
|
|
for (let x = 0; x < blobVersionedHashes.length; x++) {
|
|
const computedVersionedHash = computeVersionedHash(commitments[x], version)
|
|
if (!equalsBytes(computedVersionedHash, blobVersionedHashes[x])) {
|
|
throw new Error(`commitment for blob at index ${x} does not match versionedHash`)
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Typed transaction with a new gas fee market mechanism for transactions that include "blobs" of data
|
|
*
|
|
* - TransactionType: 3
|
|
* - EIP: [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844)
|
|
*/
|
|
export class BlobEIP4844Transaction extends BaseTransaction<TransactionType.BlobEIP4844> {
|
|
public readonly chainId: bigint
|
|
public readonly accessList: AccessListBytes
|
|
public readonly AccessListJSON: AccessList
|
|
public readonly maxPriorityFeePerGas: bigint
|
|
public readonly maxFeePerGas: bigint
|
|
public readonly maxFeePerBlobGas: bigint
|
|
|
|
public readonly common: Common
|
|
public blobVersionedHashes: Uint8Array[]
|
|
blobs?: Uint8Array[] // This property should only be populated when the transaction is in the "Network Wrapper" format
|
|
kzgCommitments?: Uint8Array[] // This property should only be populated when the transaction is in the "Network Wrapper" format
|
|
kzgProofs?: Uint8Array[] // This property should only be populated when the transaction is in the "Network Wrapper" format
|
|
|
|
/**
|
|
* 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 constructors or factory methods to assist in creating a Transaction object from
|
|
* varying data types.
|
|
*/
|
|
constructor(txData: TxData, opts: TxOptions = {}) {
|
|
super({ ...txData, type: TransactionType.BlobEIP4844 }, opts)
|
|
const { chainId, accessList, maxFeePerGas, maxPriorityFeePerGas, maxFeePerBlobGas } = txData
|
|
|
|
this.common = this._getCommon(opts.common, chainId)
|
|
this.chainId = this.common.chainId()
|
|
|
|
if (!this.common.isActivatedEIP(1559)) {
|
|
throw new Error('EIP-1559 not enabled on Common')
|
|
}
|
|
|
|
if (!this.common.isActivatedEIP(4844)) {
|
|
throw new Error('EIP-4844 not enabled on Common')
|
|
}
|
|
this.activeCapabilities = this.activeCapabilities.concat([1559, 2718, 2930])
|
|
|
|
// Populate the access list fields
|
|
const accessListData = AccessLists.getAccessListData(accessList ?? [])
|
|
this.accessList = accessListData.accessList
|
|
this.AccessListJSON = accessListData.AccessListJSON
|
|
// Verify the access list format.
|
|
AccessLists.verifyAccessList(this.accessList)
|
|
|
|
this.maxFeePerGas = bytesToBigInt(toBytes(maxFeePerGas))
|
|
this.maxPriorityFeePerGas = bytesToBigInt(toBytes(maxPriorityFeePerGas))
|
|
|
|
this._validateCannotExceedMaxInteger({
|
|
maxFeePerGas: this.maxFeePerGas,
|
|
maxPriorityFeePerGas: this.maxPriorityFeePerGas,
|
|
})
|
|
|
|
BaseTransaction._validateNotArray(txData)
|
|
|
|
if (this.gasLimit * this.maxFeePerGas > 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)
|
|
}
|
|
|
|
this.maxFeePerBlobGas = bytesToBigInt(
|
|
toBytes((maxFeePerBlobGas ?? '') === '' ? '0x' : maxFeePerBlobGas)
|
|
)
|
|
|
|
this.blobVersionedHashes = (txData.blobVersionedHashes ?? []).map((vh) => toBytes(vh))
|
|
EIP2718.validateYParity(this)
|
|
Legacy.validateHighS(this)
|
|
|
|
for (const hash of this.blobVersionedHashes) {
|
|
if (hash.length !== 32) {
|
|
const msg = this._errorMsg('versioned hash is invalid length')
|
|
throw new Error(msg)
|
|
}
|
|
if (BigInt(hash[0]) !== this.common.param('sharding', 'blobCommitmentVersionKzg')) {
|
|
const msg = this._errorMsg('versioned hash does not start with KZG commitment version')
|
|
throw new Error(msg)
|
|
}
|
|
}
|
|
if (this.blobVersionedHashes.length > LIMIT_BLOBS_PER_TX) {
|
|
const msg = this._errorMsg(`tx can contain at most ${LIMIT_BLOBS_PER_TX} blobs`)
|
|
throw new Error(msg)
|
|
} else if (this.blobVersionedHashes.length === 0) {
|
|
const msg = this._errorMsg(`tx should contain at least one blob`)
|
|
throw new Error(msg)
|
|
}
|
|
if (this.to === undefined) {
|
|
const msg = this._errorMsg(
|
|
`tx should have a "to" field and cannot be used to create contracts`
|
|
)
|
|
throw new Error(msg)
|
|
}
|
|
|
|
this.blobs = txData.blobs?.map((blob) => toBytes(blob))
|
|
this.kzgCommitments = txData.kzgCommitments?.map((commitment) => toBytes(commitment))
|
|
this.kzgProofs = txData.kzgProofs?.map((proof) => toBytes(proof))
|
|
const freeze = opts?.freeze ?? true
|
|
if (freeze) {
|
|
Object.freeze(this)
|
|
}
|
|
}
|
|
|
|
public static fromTxData(txData: TxData, opts?: TxOptions) {
|
|
if (opts?.common?.customCrypto?.kzg === undefined) {
|
|
throw new Error(
|
|
'A common object with customCrypto.kzg initialized required to instantiate a 4844 blob tx'
|
|
)
|
|
}
|
|
const kzg = opts!.common!.customCrypto!.kzg!
|
|
if (txData.blobsData !== undefined) {
|
|
if (txData.blobs !== undefined) {
|
|
throw new Error('cannot have both raw blobs data and encoded blobs in constructor')
|
|
}
|
|
if (txData.kzgCommitments !== undefined) {
|
|
throw new Error('cannot have both raw blobs data and KZG commitments in constructor')
|
|
}
|
|
if (txData.blobVersionedHashes !== undefined) {
|
|
throw new Error('cannot have both raw blobs data and versioned hashes in constructor')
|
|
}
|
|
if (txData.kzgProofs !== undefined) {
|
|
throw new Error('cannot have both raw blobs data and KZG proofs in constructor')
|
|
}
|
|
txData.blobs = getBlobs(txData.blobsData.reduce((acc, cur) => acc + cur))
|
|
txData.kzgCommitments = blobsToCommitments(kzg, txData.blobs as Uint8Array[])
|
|
txData.blobVersionedHashes = commitmentsToVersionedHashes(
|
|
txData.kzgCommitments as Uint8Array[]
|
|
)
|
|
txData.kzgProofs = blobsToProofs(
|
|
kzg,
|
|
txData.blobs as Uint8Array[],
|
|
txData.kzgCommitments as Uint8Array[]
|
|
)
|
|
}
|
|
|
|
return new BlobEIP4844Transaction(txData, opts)
|
|
}
|
|
|
|
/**
|
|
* Returns the minimum of calculated priority fee (from maxFeePerGas and baseFee) and maxPriorityFeePerGas
|
|
* @param baseFee Base fee retrieved from block
|
|
*/
|
|
getEffectivePriorityFee(baseFee: bigint): bigint {
|
|
return EIP1559.getEffectivePriorityFee(this, baseFee)
|
|
}
|
|
|
|
/**
|
|
* Creates the minimal representation of a blob transaction from the network wrapper version.
|
|
* The minimal representation is used when adding transactions to an execution payload/block
|
|
* @param txData a {@link BlobEIP4844Transaction} containing optional blobs/kzg commitments
|
|
* @param opts - dictionary of {@link TxOptions}
|
|
* @returns the "minimal" representation of a BlobEIP4844Transaction (i.e. transaction object minus blobs and kzg commitments)
|
|
*/
|
|
public static minimalFromNetworkWrapper(
|
|
txData: BlobEIP4844Transaction,
|
|
opts?: TxOptions
|
|
): BlobEIP4844Transaction {
|
|
if (opts?.common?.customCrypto?.kzg === undefined) {
|
|
throw new Error(
|
|
'A common object with customCrypto.kzg initialized required to instantiate a 4844 blob tx'
|
|
)
|
|
}
|
|
|
|
const tx = BlobEIP4844Transaction.fromTxData(
|
|
{
|
|
...txData,
|
|
...{ blobs: undefined, kzgCommitments: undefined, kzgProofs: undefined },
|
|
},
|
|
opts
|
|
)
|
|
return tx
|
|
}
|
|
|
|
/**
|
|
* Instantiate a transaction from the serialized tx.
|
|
*
|
|
* Format: `0x03 || rlp([chain_id, nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, to, value, data,
|
|
* access_list, max_fee_per_data_gas, blob_versioned_hashes, y_parity, r, s])`
|
|
*/
|
|
public static fromSerializedTx(serialized: Uint8Array, opts: TxOptions = {}) {
|
|
if (opts.common?.customCrypto?.kzg === undefined) {
|
|
throw new Error(
|
|
'A common object with customCrypto.kzg initialized required to instantiate a 4844 blob tx'
|
|
)
|
|
}
|
|
|
|
if (
|
|
equalsBytes(serialized.subarray(0, 1), txTypeBytes(TransactionType.BlobEIP4844)) === false
|
|
) {
|
|
throw new Error(
|
|
`Invalid serialized tx input: not an EIP-4844 transaction (wrong tx type, expected: ${
|
|
TransactionType.BlobEIP4844
|
|
}, received: ${bytesToHex(serialized.subarray(0, 1))}`
|
|
)
|
|
}
|
|
|
|
const values = RLP.decode(serialized.subarray(1))
|
|
|
|
if (!Array.isArray(values)) {
|
|
throw new Error('Invalid serialized tx input: must be array')
|
|
}
|
|
|
|
return BlobEIP4844Transaction.fromValuesArray(values as TxValuesArray, opts)
|
|
}
|
|
|
|
/**
|
|
* Create a transaction from a values array.
|
|
*
|
|
* Format: `[chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data,
|
|
* accessList, signatureYParity, signatureR, signatureS]`
|
|
*/
|
|
public static fromValuesArray(values: TxValuesArray, opts: TxOptions = {}) {
|
|
if (opts.common?.customCrypto?.kzg === undefined) {
|
|
throw new Error(
|
|
'A common object with customCrypto.kzg initialized required to instantiate a 4844 blob tx'
|
|
)
|
|
}
|
|
|
|
if (values.length !== 11 && values.length !== 14) {
|
|
throw new Error(
|
|
'Invalid EIP-4844 transaction. Only expecting 11 values (for unsigned tx) or 14 values (for signed tx).'
|
|
)
|
|
}
|
|
|
|
const [
|
|
chainId,
|
|
nonce,
|
|
maxPriorityFeePerGas,
|
|
maxFeePerGas,
|
|
gasLimit,
|
|
to,
|
|
value,
|
|
data,
|
|
accessList,
|
|
maxFeePerBlobGas,
|
|
blobVersionedHashes,
|
|
v,
|
|
r,
|
|
s,
|
|
] = values
|
|
|
|
this._validateNotArray({ chainId, v })
|
|
validateNoLeadingZeroes({
|
|
nonce,
|
|
maxPriorityFeePerGas,
|
|
maxFeePerGas,
|
|
gasLimit,
|
|
value,
|
|
maxFeePerBlobGas,
|
|
v,
|
|
r,
|
|
s,
|
|
})
|
|
|
|
return new BlobEIP4844Transaction(
|
|
{
|
|
chainId: bytesToBigInt(chainId),
|
|
nonce,
|
|
maxPriorityFeePerGas,
|
|
maxFeePerGas,
|
|
gasLimit,
|
|
to,
|
|
value,
|
|
data,
|
|
accessList: accessList ?? [],
|
|
maxFeePerBlobGas,
|
|
blobVersionedHashes,
|
|
v: v !== undefined ? bytesToBigInt(v) : undefined, // EIP2930 supports v's with value 0 (empty Uint8Array)
|
|
r,
|
|
s,
|
|
},
|
|
opts
|
|
)
|
|
}
|
|
|
|
/**
|
|
* Creates a transaction from the network encoding of a blob transaction (with blobs/commitments/proof)
|
|
* @param serialized a buffer representing a serialized BlobTransactionNetworkWrapper
|
|
* @param opts any TxOptions defined
|
|
* @returns a BlobEIP4844Transaction
|
|
*/
|
|
public static fromSerializedBlobTxNetworkWrapper(
|
|
serialized: Uint8Array,
|
|
opts?: TxOptions
|
|
): BlobEIP4844Transaction {
|
|
if (!opts || !opts.common) {
|
|
throw new Error('common instance required to validate versioned hashes')
|
|
}
|
|
|
|
if (opts.common?.customCrypto?.kzg === undefined) {
|
|
throw new Error(
|
|
'A common object with customCrypto.kzg initialized required to instantiate a 4844 blob tx'
|
|
)
|
|
}
|
|
|
|
if (
|
|
equalsBytes(serialized.subarray(0, 1), txTypeBytes(TransactionType.BlobEIP4844)) === false
|
|
) {
|
|
throw new Error(
|
|
`Invalid serialized tx input: not an EIP-4844 transaction (wrong tx type, expected: ${
|
|
TransactionType.BlobEIP4844
|
|
}, received: ${bytesToHex(serialized.subarray(0, 1))}`
|
|
)
|
|
}
|
|
|
|
// Validate network wrapper
|
|
const networkTxValues = RLP.decode(serialized.subarray(1))
|
|
if (networkTxValues.length !== 4) {
|
|
throw Error(`Expected 4 values in the deserialized network transaction`)
|
|
}
|
|
const [txValues, blobs, kzgCommitments, kzgProofs] =
|
|
networkTxValues as BlobEIP4844NetworkValuesArray
|
|
|
|
// Construct the tx but don't freeze yet, we will assign blobs etc once validated
|
|
const decodedTx = BlobEIP4844Transaction.fromValuesArray(txValues, { ...opts, freeze: false })
|
|
if (decodedTx.to === undefined) {
|
|
throw Error('BlobEIP4844Transaction can not be send without a valid `to`')
|
|
}
|
|
|
|
const version = Number(opts.common.param('sharding', 'blobCommitmentVersionKzg'))
|
|
validateBlobTransactionNetworkWrapper(
|
|
decodedTx.blobVersionedHashes,
|
|
blobs,
|
|
kzgCommitments,
|
|
kzgProofs,
|
|
version,
|
|
opts.common.customCrypto.kzg
|
|
)
|
|
|
|
// set the network blob data on the tx
|
|
decodedTx.blobs = blobs
|
|
decodedTx.kzgCommitments = kzgCommitments
|
|
decodedTx.kzgProofs = kzgProofs
|
|
|
|
// freeze the tx
|
|
const freeze = opts?.freeze ?? true
|
|
if (freeze) {
|
|
Object.freeze(decodedTx)
|
|
}
|
|
|
|
return decodedTx
|
|
}
|
|
|
|
/**
|
|
* The amount of gas paid for the data in this tx
|
|
*/
|
|
getDataFee(): bigint {
|
|
return EIP2930.getDataFee(this)
|
|
}
|
|
|
|
/**
|
|
* 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: bigint = BIGINT_0): bigint {
|
|
return EIP1559.getUpfrontCost(this, baseFee)
|
|
}
|
|
|
|
/**
|
|
* Returns a Uint8Array Array of the raw Bytes of the EIP-4844 transaction, in order.
|
|
*
|
|
* Format: [chain_id, nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, to, value, data,
|
|
* access_list, max_fee_per_data_gas, blob_versioned_hashes, y_parity, r, s]`.
|
|
*
|
|
* Use {@link BlobEIP4844Transaction.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 BlobEIP4844Transaction.getMessageToSign}.
|
|
*/
|
|
raw(): TxValuesArray {
|
|
return [
|
|
bigIntToUnpaddedBytes(this.chainId),
|
|
bigIntToUnpaddedBytes(this.nonce),
|
|
bigIntToUnpaddedBytes(this.maxPriorityFeePerGas),
|
|
bigIntToUnpaddedBytes(this.maxFeePerGas),
|
|
bigIntToUnpaddedBytes(this.gasLimit),
|
|
this.to !== undefined ? this.to.bytes : new Uint8Array(0),
|
|
bigIntToUnpaddedBytes(this.value),
|
|
this.data,
|
|
this.accessList,
|
|
bigIntToUnpaddedBytes(this.maxFeePerBlobGas),
|
|
this.blobVersionedHashes,
|
|
this.v !== undefined ? bigIntToUnpaddedBytes(this.v) : new Uint8Array(0),
|
|
this.r !== undefined ? bigIntToUnpaddedBytes(this.r) : new Uint8Array(0),
|
|
this.s !== undefined ? bigIntToUnpaddedBytes(this.s) : new Uint8Array(0),
|
|
]
|
|
}
|
|
|
|
/**
|
|
* Returns the serialized encoding of the EIP-4844 transaction.
|
|
*
|
|
* Format: `0x03 || rlp([chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data,
|
|
* access_list, max_fee_per_data_gas, blob_versioned_hashes, y_parity, r, s])`.
|
|
*
|
|
* 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(): Uint8Array {
|
|
return EIP2718.serialize(this)
|
|
}
|
|
|
|
/**
|
|
* @returns the serialized form of a blob transaction in the network wrapper format (used for gossipping mempool transactions over devp2p)
|
|
*/
|
|
serializeNetworkWrapper(): Uint8Array {
|
|
if (
|
|
this.blobs === undefined ||
|
|
this.kzgCommitments === undefined ||
|
|
this.kzgProofs === undefined
|
|
) {
|
|
throw new Error(
|
|
'cannot serialize network wrapper without blobs, KZG commitments and KZG proofs provided'
|
|
)
|
|
}
|
|
|
|
return EIP2718.serialize(this, [this.raw(), this.blobs, this.kzgCommitments, this.kzgProofs])
|
|
}
|
|
|
|
/**
|
|
* 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(): Uint8Array {
|
|
return EIP2718.serialize(this, this.raw().slice(0, 11))
|
|
}
|
|
|
|
/**
|
|
* 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(): Uint8Array {
|
|
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 BlobEIP4844Transaction.getMessageToSign} to get a tx hash for the purpose of signing.
|
|
*/
|
|
public hash(): Uint8Array {
|
|
return Legacy.hash(this)
|
|
}
|
|
|
|
getMessageToVerifySignature(): Uint8Array {
|
|
return this.getHashedMessageToSign()
|
|
}
|
|
|
|
/**
|
|
* Returns the public key of the sender
|
|
*/
|
|
public getSenderPublicKey(): Uint8Array {
|
|
return Legacy.getSenderPublicKey(this)
|
|
}
|
|
|
|
/**
|
|
* Returns the EIP 4844 transaction network wrapper in JSON format similar to toJSON, including
|
|
* blobs, commitments, and proofs fields
|
|
* @param serialized a buffer representing a serialized BlobTransactionNetworkWrapper
|
|
* @param opts any TxOptions defined
|
|
* @returns JsonBlobTxNetworkWrapper with blobs, KZG commitments, and KZG proofs fields
|
|
*/
|
|
public static networkWrapperToJson(
|
|
serialized: Uint8Array,
|
|
opts?: TxOptions
|
|
): JsonBlobTxNetworkWrapper {
|
|
const tx = this.fromSerializedBlobTxNetworkWrapper(serialized, opts)
|
|
|
|
const accessListJSON = AccessLists.getAccessListJSON(tx.accessList)
|
|
const baseJson = tx.toJSON()
|
|
|
|
return {
|
|
...baseJson,
|
|
chainId: bigIntToHex(tx.chainId),
|
|
maxPriorityFeePerGas: bigIntToHex(tx.maxPriorityFeePerGas),
|
|
maxFeePerGas: bigIntToHex(tx.maxFeePerGas),
|
|
accessList: accessListJSON,
|
|
maxFeePerBlobGas: bigIntToHex(tx.maxFeePerBlobGas),
|
|
blobVersionedHashes: tx.blobVersionedHashes.map((hash) => bytesToHex(hash)),
|
|
blobs: tx.blobs!.map((bytes) => bytesToHex(bytes)),
|
|
kzgCommitments: tx.kzgCommitments!.map((bytes) => bytesToHex(bytes)),
|
|
kzgProofs: tx.kzgProofs!.map((bytes) => bytesToHex(bytes)),
|
|
}
|
|
}
|
|
|
|
toJSON(): JsonTx {
|
|
const accessListJSON = AccessLists.getAccessListJSON(this.accessList)
|
|
const baseJson = super.toJSON()
|
|
|
|
return {
|
|
...baseJson,
|
|
chainId: bigIntToHex(this.chainId),
|
|
maxPriorityFeePerGas: bigIntToHex(this.maxPriorityFeePerGas),
|
|
maxFeePerGas: bigIntToHex(this.maxFeePerGas),
|
|
accessList: accessListJSON,
|
|
maxFeePerBlobGas: bigIntToHex(this.maxFeePerBlobGas),
|
|
blobVersionedHashes: this.blobVersionedHashes.map((hash) => bytesToHex(hash)),
|
|
}
|
|
}
|
|
|
|
addSignature(
|
|
v: bigint,
|
|
r: Uint8Array | bigint,
|
|
s: Uint8Array | bigint,
|
|
convertV: boolean = false
|
|
): BlobEIP4844Transaction {
|
|
r = toBytes(r)
|
|
s = toBytes(s)
|
|
const opts = { ...this.txOptions, common: this.common }
|
|
|
|
return BlobEIP4844Transaction.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,
|
|
v: convertV ? v - BIGINT_27 : v, // This looks extremely hacky: @ethereumjs/util actually adds 27 to the value, the recovery bit is either 0 or 1.
|
|
r: bytesToBigInt(r),
|
|
s: bytesToBigInt(s),
|
|
maxFeePerBlobGas: this.maxFeePerBlobGas,
|
|
blobVersionedHashes: this.blobVersionedHashes,
|
|
blobs: this.blobs,
|
|
kzgCommitments: this.kzgCommitments,
|
|
kzgProofs: this.kzgProofs,
|
|
},
|
|
opts
|
|
)
|
|
}
|
|
/**
|
|
* Return a compact error string representation of the object
|
|
*/
|
|
public 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
|
|
*/
|
|
protected _errorMsg(msg: string) {
|
|
return Legacy.errorMsg(this, msg)
|
|
}
|
|
|
|
/**
|
|
* @returns the number of blobs included with this transaction
|
|
*/
|
|
public numBlobs(): number {
|
|
return this.blobVersionedHashes.length
|
|
}
|
|
}
|