65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
|
-----
|
||
|
|
|
||
|
|
Documentation: [html](https://docs-beta.ethers.io/)
|
||
|
|
|
||
|
|
-----
|
||
|
|
|
||
|
|
Addresses
|
||
|
|
=========
|
||
|
|
|
||
|
|
Address Formats
|
||
|
|
---------------
|
||
|
|
|
||
|
|
### Address
|
||
|
|
|
||
|
|
### ICAP Address
|
||
|
|
|
||
|
|
Converting and Verifying
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **getAddress**( address ) => *string< [Address](/v5/api/utils/address/#address) >*
|
||
|
|
|
||
|
|
Returns *address* as a Checksum Address.
|
||
|
|
|
||
|
|
If *address* is an invalid 40-nibble [HexString](/v5/api/utils/bytes/#HexString) or if it contains mixed case and the checksum is invalid, an InvalidArgument Error is throw.
|
||
|
|
|
||
|
|
The value of *address* may be any supported address format.
|
||
|
|
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **getIcapAddress**( address ) => *string< [IcapAddress](/v5/api/utils/address/#address-icap) >*
|
||
|
|
|
||
|
|
Returns *address* as an [ICAP address](https://github.com/ethereum/wiki/wiki/Inter-exchange-Client-Address-Protocol-%28ICAP%29). Supports the same restrictions as [utils.getAddress](/v5/api/utils/address/#utils-getAddress).
|
||
|
|
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **isAddress**( address ) => *boolean*
|
||
|
|
|
||
|
|
Returns true if *address* is valid (in any supported format).
|
||
|
|
|
||
|
|
|
||
|
|
Derivation
|
||
|
|
----------
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **computeAddress**( publicOrPrivateKey ) => *string< [Address](/v5/api/utils/address/#address) >*
|
||
|
|
|
||
|
|
Returns the address for *publicOrPrivateKey*. A public key may be compressed or uncompressed, and a private key will be converted automatically to a public key for the derivation.
|
||
|
|
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **recoverAddress**( digest , signature ) => *string< [Address](/v5/api/utils/address/#address) >*
|
||
|
|
|
||
|
|
Use [ECDSA Public Key Recovery](https://en.wikipedia.org/wiki/Elliptic_Curve_Digital_Signature_Algorithm#Public_key_recovery) to determine the address that signed *digest* to which generated *signature*.
|
||
|
|
|
||
|
|
|
||
|
|
Contracts Addresses
|
||
|
|
-------------------
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **getContractAddress**( transaction ) => *string< [Address](/v5/api/utils/address/#address) >*
|
||
|
|
|
||
|
|
Returns the contract address that would result if *transaction* was used to deploy a contract.
|
||
|
|
|
||
|
|
|
||
|
|
#### *ethers* . *utils* . **getCreate2Address**( from , salt , initCodeHash ) => *string< [Address](/v5/api/utils/address/#address) >*
|
||
|
|
|
||
|
|
Returns the contract address that would result from the given [CREATE2](https://eips.ethereum.org/EIPS/eip-1014) call.
|
||
|
|
|
||
|
|
|