ethereum.forks.amsterdam.utils.address
Hardfork Utility Functions For Addresses.
.. contents:: Table of Contents :backlinks: none :local:
Introduction
Address specific functions used in this amsterdam version of specification.
to_address_masked
Convert a Uint or U256 value to a valid address (20 bytes).
Parameters
data : The numeric value to be converted to address.
Returns
address : Address
The obtained address.
def to_address_masked(data: Uint | U256) -> Address:
| 25 | """ |
|---|---|
| 26 | Convert a Uint or U256 value to a valid address (20 bytes). |
| 27 | |
| 28 | Parameters |
| 29 | ---------- |
| 30 | data : |
| 31 | The numeric value to be converted to address. |
| 32 | |
| 33 | Returns |
| 34 | ------- |
| 35 | address : `Address` |
| 36 | The obtained address. |
| 37 | |
| 38 | """ |
| 39 | return Address(data.to_be_bytes32()[-20:]) |
compute_contract_address
Computes address of the new account that needs to be created.
Parameters
address : The address of the account that wants to create the new account. nonce : The transaction count of the account that wants to create the new account.
Returns
address: Address
The computed address of the new account.
def compute_contract_address(address: Address, nonce: Uint) -> Address:
| 43 | """ |
|---|---|
| 44 | Computes address of the new account that needs to be created. |
| 45 | |
| 46 | Parameters |
| 47 | ---------- |
| 48 | address : |
| 49 | The address of the account that wants to create the new account. |
| 50 | nonce : |
| 51 | The transaction count of the account that wants to create the new |
| 52 | account. |
| 53 | |
| 54 | Returns |
| 55 | ------- |
| 56 | address: `Address` |
| 57 | The computed address of the new account. |
| 58 | |
| 59 | """ |
| 60 | computed_address = keccak256(rlp.encode([address, nonce])) |
| 61 | canonical_address = computed_address[-20:] |
| 62 | padded_address = left_pad_zero_bytes(canonical_address, 20) |
| 63 | return Address(padded_address) |
compute_create2_contract_address
Computes address of the new account that needs to be created, which is based on the sender address, salt and the call data as well.
Parameters
address : The address of the account that wants to create the new account. salt : Address generation salt. call_data : The code of the new account which is to be created.
Returns
address: ethereum.forks.amsterdam.fork_types.Address
The computed address of the new account.
def compute_create2_contract_address(address: Address, salt: Bytes32, call_data: Bytes) -> Address:
| 69 | """ |
|---|---|
| 70 | Computes address of the new account that needs to be created, which is |
| 71 | based on the sender address, salt and the call data as well. |
| 72 | |
| 73 | Parameters |
| 74 | ---------- |
| 75 | address : |
| 76 | The address of the account that wants to create the new account. |
| 77 | salt : |
| 78 | Address generation salt. |
| 79 | call_data : |
| 80 | The code of the new account which is to be created. |
| 81 | |
| 82 | Returns |
| 83 | ------- |
| 84 | address: `ethereum.forks.amsterdam.fork_types.Address` |
| 85 | The computed address of the new account. |
| 86 | |
| 87 | """ |
| 88 | preimage = b"\xff" + address + salt + keccak256(call_data) |
| 89 | computed_address = keccak256(preimage) |
| 90 | canonical_address = computed_address[-20:] |
| 91 | padded_address = left_pad_zero_bytes(canonical_address, 20) |
| 92 | |
| 93 | return Address(padded_address) |