ethereum.gray_glacier.transactions
Transactions are atomic units of work created externally to Ethereum and submitted to be executed. If Ethereum is viewed as a state machine, transactions are the events that move between states.
TX_BASE_COST
22 | TX_BASE_COST = 21000 |
---|
TX_DATA_COST_PER_NON_ZERO
23 | TX_DATA_COST_PER_NON_ZERO = 16 |
---|
TX_DATA_COST_PER_ZERO
24 | TX_DATA_COST_PER_ZERO = 4 |
---|
TX_CREATE_COST
25 | TX_CREATE_COST = 32000 |
---|
TX_ACCESS_LIST_ADDRESS_COST
26 | TX_ACCESS_LIST_ADDRESS_COST = 2400 |
---|
TX_ACCESS_LIST_STORAGE_KEY_COST
27 | TX_ACCESS_LIST_STORAGE_KEY_COST = 1900 |
---|
LegacyTransaction
Atomic operation performed on the block chain.
30 | @slotted_freezable |
---|
31 | @dataclass |
---|
class LegacyTransaction:
nonce
37 | nonce: U256 |
---|
gas_price
38 | gas_price: Uint |
---|
gas
39 | gas: Uint |
---|
to
40 | to: Union[Bytes0, Address] |
---|
value
41 | value: U256 |
---|
data
42 | data: Bytes |
---|
v
43 | v: U256 |
---|
r
44 | r: U256 |
---|
s
45 | s: U256 |
---|
AccessListTransaction
The transaction type added in EIP-2930 to support access lists.
48 | @slotted_freezable |
---|
49 | @dataclass |
---|
class AccessListTransaction:
chain_id
55 | chain_id: U64 |
---|
nonce
56 | nonce: U256 |
---|
gas_price
57 | gas_price: Uint |
---|
gas
58 | gas: Uint |
---|
to
59 | to: Union[Bytes0, Address] |
---|
value
60 | value: U256 |
---|
data
61 | data: Bytes |
---|
access_list
62 | access_list: Tuple[Tuple[Address, Tuple[Bytes32, ...]], ...] |
---|
y_parity
63 | y_parity: U256 |
---|
r
64 | r: U256 |
---|
s
65 | s: U256 |
---|
FeeMarketTransaction
The transaction type added in EIP-1559.
68 | @slotted_freezable |
---|
69 | @dataclass |
---|
class FeeMarketTransaction:
chain_id
75 | chain_id: U64 |
---|
nonce
76 | nonce: U256 |
---|
max_priority_fee_per_gas
77 | max_priority_fee_per_gas: Uint |
---|
max_fee_per_gas
78 | max_fee_per_gas: Uint |
---|
gas
79 | gas: Uint |
---|
to
80 | to: Union[Bytes0, Address] |
---|
value
81 | value: U256 |
---|
data
82 | data: Bytes |
---|
access_list
83 | access_list: Tuple[Tuple[Address, Tuple[Bytes32, ...]], ...] |
---|
y_parity
84 | y_parity: U256 |
---|
r
85 | r: U256 |
---|
s
86 | s: U256 |
---|
Transaction
89 | Transaction = Union[ |
---|---|
90 | LegacyTransaction, AccessListTransaction, FeeMarketTransaction |
91 | ] |
encode_transaction
Encode a transaction. Needed because non-legacy transactions aren't RLP.
def encode_transaction(tx: Transaction) -> Union[LegacyTransaction, Bytes]:
95 | """ |
---|---|
96 | Encode a transaction. Needed because non-legacy transactions aren't RLP. |
97 | """ |
98 | if isinstance(tx, LegacyTransaction): |
99 | return tx |
100 | elif isinstance(tx, AccessListTransaction): |
101 | return b"\x01" + rlp.encode(tx) |
102 | elif isinstance(tx, FeeMarketTransaction): |
103 | return b"\x02" + rlp.encode(tx) |
104 | else: |
105 | raise Exception(f"Unable to encode transaction of type {type(tx)}") |
decode_transaction
Decode a transaction. Needed because non-legacy transactions aren't RLP.
def decode_transaction(tx: Union[LegacyTransaction, Bytes]) -> Transaction:
109 | """ |
---|---|
110 | Decode a transaction. Needed because non-legacy transactions aren't RLP. |
111 | """ |
112 | if isinstance(tx, Bytes): |
113 | if tx[0] == 1: |
114 | return rlp.decode_to(AccessListTransaction, tx[1:]) |
115 | elif tx[0] == 2: |
116 | return rlp.decode_to(FeeMarketTransaction, tx[1:]) |
117 | else: |
118 | raise InvalidBlock |
119 | else: |
120 | return tx |