ethereum.arrow_glacier.utils.address
Hardfork Utility Functions For Addresses ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. contents:: Table of Contents :backlinks: none :local:
Introduction
Address specific functions used in this arrow_glacier version of specification.
to_address
Convert a Uint or U256 value to a valid address (20 bytes).
Parameters
data : The string to be converted to bytes.
Returns
address : Address
The obtained address.
def to_address(data: Union[Uint, U256]) -> Address:
26 | """ |
---|---|
27 | Convert a Uint or U256 value to a valid address (20 bytes). |
28 |
|
29 | Parameters |
30 | ---------- |
31 | data : |
32 | The string to be converted to bytes. |
33 |
|
34 | Returns |
35 | ------- |
36 | address : `Address` |
37 | The obtained address. |
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 | computed_address = keccak256(rlp.encode([address, nonce])) |
60 | canonical_address = computed_address[-20:] |
61 | padded_address = left_pad_zero_bytes(canonical_address, 20) |
62 | 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.arrow_glacier.fork_types.Address
The computed address of the new account.
def compute_create2_contract_address(address: Address, salt: Bytes32, call_data: bytearray) -> Address:
68 | """ |
---|---|
69 | Computes address of the new account that needs to be created, which is |
70 | based on the sender address, salt and the call data as well. |
71 |
|
72 | Parameters |
73 | ---------- |
74 | address : |
75 | The address of the account that wants to create the new account. |
76 | salt : |
77 | Address generation salt. |
78 | call_data : |
79 | The code of the new account which is to be created. |
80 |
|
81 | Returns |
82 | ------- |
83 | address: `ethereum.arrow_glacier.fork_types.Address` |
84 | The computed address of the new account. |
85 | """ |
86 | preimage = b"\xff" + address + salt + keccak256(call_data) |
87 | computed_address = keccak256(preimage) |
88 | canonical_address = computed_address[-20:] |
89 | padded_address = left_pad_zero_bytes(canonical_address, 20) |
90 | |
91 | return Address(padded_address) |