"""

    Encode a transaction into its RLP or typed transaction format.

    Needed because non-legacy transactions aren't RLP.

    Legacy transactions are returned as-is, while other transaction types

    are prefixed with their type identifier and RLP encoded.

    """

    if isinstance(tx, LegacyTransaction):

        return tx

    elif isinstance(tx, AccessListTransaction):

        return b"\x01" + rlp.encode(tx)

    elif isinstance(tx, FeeMarketTransaction):

        return b"\x02" + rlp.encode(tx)

    elif isinstance(tx, BlobTransaction):

        return b"\x03" + rlp.encode(tx)

    elif isinstance(tx, SetCodeTransaction):

        return b"\x04" + rlp.encode(tx)

    else:

        raise Exception(f"Unable to encode transaction of type {type(tx)}")

    """

    Decode a transaction from its RLP or typed transaction format.

    Needed because non-legacy transactions aren't RLP.

    Accept a ``LegacyTransaction`` object (returned as-is) or raw

    bytes.

    EIP-2718 states that the first byte distinguishes the format:

    [0x00, 0x7f] is a typed transaction, [0xc0, 0xfe] is a legacy

    transaction (RLP list prefix).

    """

    if isinstance(tx, Bytes):

        if tx[0] == 1:

            return rlp.decode_to(AccessListTransaction, tx[1:])

        elif tx[0] == 2:

            return rlp.decode_to(FeeMarketTransaction, tx[1:])

        elif tx[0] == 3:

            return rlp.decode_to(BlobTransaction, tx[1:])

        elif tx[0] == 4:

            return rlp.decode_to(SetCodeTransaction, tx[1:])

        elif tx[0] >= 0xC0:

            assert tx[0] <= 0xFE

            return rlp.decode_to(LegacyTransaction, tx)

        else:

            raise TransactionTypeError(tx[0])

    else:

        return tx

    """

    Verifies a transaction.

    The gas in a transaction gets used to pay for the intrinsic cost of

    operations, therefore if there is insufficient gas then it would not

    be possible to execute a transaction and it will be declared invalid.

    Additionally, the nonce of a transaction must not equal or exceed the

    limit defined in [EIP-2681].

    In practice, defining the limit as ``2**64-1`` has no impact because

    sending ``2**64-1`` transactions is improbable. It's not strictly

    impossible though, ``2**64-1`` transactions is the entire capacity of the

    Ethereum blockchain at 2022 gas limits for a little over 22 years.

    Also, the code size of a contract creation transaction must be within

    limits of the protocol.

    This function takes a transaction as a parameter and returns the intrinsic

    gas cost and the minimum calldata gas cost for the transaction after

    validation. It throws an `InsufficientTransactionGasError` exception if

    the transaction does not provide enough gas to cover the intrinsic cost,

    and a `NonceOverflowError` exception if the nonce is greater than

    `2**64 - 2`. It also raises an `InitCodeTooLargeError` if the code size of

    a contract creation transaction exceeds the maximum allowed size.

    [EIP-2681]: https://eips.ethereum.org/EIPS/eip-2681

    [EIP-7623]: https://eips.ethereum.org/EIPS/eip-7623

    """

    from .vm.interpreter import MAX_INIT_CODE_SIZE

    intrinsic_gas, calldata_floor_gas_cost = calculate_intrinsic_cost(tx)

    if max(intrinsic_gas, calldata_floor_gas_cost) > tx.gas:

        raise InsufficientTransactionGasError("Insufficient gas")

    if U256(tx.nonce) >= U256(U64.MAX_VALUE):

        raise NonceOverflowError("Nonce too high")

    if tx.to == Bytes0(b"") and len(tx.data) > MAX_INIT_CODE_SIZE:

        raise InitCodeTooLargeError("Code size too large")

    if tx.gas > TX_MAX_GAS_LIMIT:

        raise TransactionGasLimitExceededError("Gas limit too high")

    return intrinsic_gas, calldata_floor_gas_cost

    """

    Calculates the gas that is charged before execution is started.

    The intrinsic cost of the transaction is charged before execution has

    begun. Functions/operations in the EVM cost money to execute so this

    intrinsic cost is for the operations that need to be paid for as part of

    the transaction. Data transfer, for example, is part of this intrinsic

    cost. It costs ether to send data over the wire and that ether is

    accounted for in the intrinsic cost calculated in this function. This

    intrinsic cost must be calculated and paid for before execution in order

    for all operations to be implemented.

    The intrinsic cost includes:

    1. Base cost (`GAS_TX_BASE`)

    2. Cost for data (zero and non-zero bytes)

    3. Cost for contract creation (if applicable)

    4. Cost for access list entries (if applicable)

    5. Cost for authorizations (if applicable)

    This function takes a transaction as a parameter and returns the intrinsic

    gas cost of the transaction and the minimum gas cost used by the

    transaction based on the calldata size.

    """

    from .vm.eoa_delegation import GAS_AUTH_PER_EMPTY_ACCOUNT

    from .vm.gas import init_code_cost

    num_zeros = Uint(tx.data.count(0))

    num_non_zeros = ulen(tx.data) - num_zeros

    tokens_in_calldata = num_zeros + num_non_zeros * Uint(4)

    # EIP-7623 floor price (note: no EVM costs)

    calldata_floor_gas_cost = (

        tokens_in_calldata * GAS_TX_DATA_TOKEN_FLOOR + GAS_TX_BASE

    )

    data_cost = tokens_in_calldata * GAS_TX_DATA_TOKEN_STANDARD

    if tx.to == Bytes0(b""):

        create_cost = GAS_TX_CREATE + init_code_cost(ulen(tx.data))

    else:

        create_cost = Uint(0)

    access_list_cost = Uint(0)

    if has_access_list(tx):

        for access in tx.access_list:

            access_list_cost += GAS_TX_ACCESS_LIST_ADDRESS

            access_list_cost += (

                ulen(access.slots) * GAS_TX_ACCESS_LIST_STORAGE_KEY

            )

    auth_cost = Uint(0)

    if isinstance(tx, SetCodeTransaction):

        auth_cost += Uint(GAS_AUTH_PER_EMPTY_ACCOUNT * len(tx.authorizations))

    return (

        Uint(

            GAS_TX_BASE

            + data_cost

            + create_cost

            + access_list_cost

            + auth_cost

        ),

        calldata_floor_gas_cost,

    )

    """

    Extracts the sender address from a transaction.

    The v, r, and s values are the three parts that make up the signature

    of a transaction. In order to recover the sender of a transaction the two

    components needed are the signature (``v``, ``r``, and ``s``) and the

    signing hash of the transaction. The sender's public key can be obtained

    with these two values and therefore the sender address can be retrieved.

    This function takes chain_id and a transaction as parameters and returns

    the address of the sender of the transaction. It raises an

    `InvalidSignatureError` if the signature values (r, s, v) are invalid.

    """

    r, s = tx.r, tx.s

    if U256(0) >= r or r >= SECP256K1N:

        raise InvalidSignatureError("bad r")

    if U256(0) >= s or s > SECP256K1N // U256(2):

        raise InvalidSignatureError("bad s")

    if isinstance(tx, LegacyTransaction):

        v = tx.v

        if v == 27 or v == 28:

            public_key = secp256k1_recover(

                r, s, v - U256(27), signing_hash_pre155(tx)

            )

        else:

            chain_id_x2 = U256(chain_id) * U256(2)

            if v != U256(35) + chain_id_x2 and v != U256(36) + chain_id_x2:

                raise InvalidSignatureError("bad v")

            public_key = secp256k1_recover(

                r,

                s,

                v - U256(35) - chain_id_x2,

                signing_hash_155(tx, chain_id),

            )

    elif isinstance(tx, AccessListTransaction):

        if tx.y_parity not in (U256(0), U256(1)):

            raise InvalidSignatureError("bad y_parity")

        public_key = secp256k1_recover(

            r, s, tx.y_parity, signing_hash_2930(tx)

        )

    elif isinstance(tx, FeeMarketTransaction):

        if tx.y_parity not in (U256(0), U256(1)):

            raise InvalidSignatureError("bad y_parity")

        public_key = secp256k1_recover(

            r, s, tx.y_parity, signing_hash_1559(tx)

        )

    elif isinstance(tx, BlobTransaction):

        if tx.y_parity not in (U256(0), U256(1)):

            raise InvalidSignatureError("bad y_parity")

        public_key = secp256k1_recover(

            r, s, tx.y_parity, signing_hash_4844(tx)

        )

    elif isinstance(tx, SetCodeTransaction):

        if tx.y_parity not in (U256(0), U256(1)):

            raise InvalidSignatureError("bad y_parity")

        public_key = secp256k1_recover(

            r, s, tx.y_parity, signing_hash_7702(tx)

        )

    return Address(keccak256(public_key)[12:32])

    """

    Compute the hash of a transaction used in a legacy (pre [EIP-155])

    signature.

    This function takes a legacy transaction as a parameter and returns the

    signing hash of the transaction.

    [EIP-155]: https://eips.ethereum.org/EIPS/eip-155

    """

    return keccak256(

        rlp.encode(

            (

                tx.nonce,

                tx.gas_price,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

            )

        )

    )

    """

    Compute the hash of a transaction used in a [EIP-155] signature.

    This function takes a legacy transaction and a chain ID as parameters

    and returns the hash of the transaction used in an [EIP-155] signature.

    [EIP-155]: https://eips.ethereum.org/EIPS/eip-155

    """

    return keccak256(

        rlp.encode(

            (

                tx.nonce,

                tx.gas_price,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

                chain_id,

                Uint(0),

                Uint(0),

            )

        )

    )

    """

    Compute the hash of a transaction used in a [EIP-2930] signature.

    This function takes an access list transaction as a parameter

    and returns the hash of the transaction used in an [EIP-2930] signature.

    [EIP-2930]: https://eips.ethereum.org/EIPS/eip-2930

    """

    return keccak256(

        b"\x01"

        + rlp.encode(

            (

                tx.chain_id,

                tx.nonce,

                tx.gas_price,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

                tx.access_list,

            )

        )

    )

    """

    Compute the hash of a transaction used in an [EIP-1559] signature.

    This function takes a fee market transaction as a parameter

    and returns the hash of the transaction used in an [EIP-1559] signature.

    [EIP-1559]: https://eips.ethereum.org/EIPS/eip-1559

    """

    return keccak256(

        b"\x02"

        + rlp.encode(

            (

                tx.chain_id,

                tx.nonce,

                tx.max_priority_fee_per_gas,

                tx.max_fee_per_gas,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

                tx.access_list,

            )

        )

    )

    """

    Compute the hash of a transaction used in an [EIP-4844] signature.

    This function takes a transaction as a parameter and returns the

    signing hash of the transaction used in an [EIP-4844] signature.

    [EIP-4844]: https://eips.ethereum.org/EIPS/eip-4844

    """

    return keccak256(

        b"\x03"

        + rlp.encode(

            (

                tx.chain_id,

                tx.nonce,

                tx.max_priority_fee_per_gas,

                tx.max_fee_per_gas,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

                tx.access_list,

                tx.max_fee_per_blob_gas,

                tx.blob_versioned_hashes,

            )

        )

    )

    """

    Compute the hash of a transaction used in a [EIP-7702] signature.

    This function takes a transaction as a parameter and returns the

    signing hash of the transaction used in a [EIP-7702] signature.

    [EIP-7702]: https://eips.ethereum.org/EIPS/eip-7702

    """

    return keccak256(

        b"\x04"

        + rlp.encode(

            (

                tx.chain_id,

                tx.nonce,

                tx.max_priority_fee_per_gas,

                tx.max_fee_per_gas,

                tx.gas,

                tx.to,

                tx.value,

                tx.data,

                tx.access_list,

                tx.authorizations,

            )

        )

    )

    """

    Compute the hash of a transaction.

    This function takes a transaction as a parameter and returns the

    keccak256 hash of the transaction. It can handle both legacy transactions

    and typed transactions (`AccessListTransaction`, `FeeMarketTransaction`,

    etc.).

    """

    assert isinstance(tx, (LegacyTransaction, Bytes))

    if isinstance(tx, LegacyTransaction):

        return keccak256(rlp.encode(tx))

    else:

        return keccak256(tx)

    """

    Return whether the transaction has an [EIP-2930]-style access list.

    [EIP-2930]: https://eips.ethereum.org/EIPS/eip-2930

    """

    return isinstance(

        tx,

        AccessListCapableTransaction,

    )