ape-ens 0.8.0

Description:

apeens 0.8.0

Quick Start
Ape plugin for ENS argument conversion and contracts
Dependencies

python3 version 3.9 up to 3.12.

Installation
via pip
You can install the latest release via pip:
pip install ape-ens

via setuptools
You can clone the repository and use setuptools for the most up-to-date version:
git clone https://github.com/ApeWorX/ape-ens.git
cd ape-ens
python3 setup.py install

Quick Usage
The ENS plugin requires a mainnet connection to resolve ENS names because ENS contracts are only deployed to mainnet.
Thus, the first thing you should do is ensure you have configured a mainnet provider.
For example, if you use infura or alchemy, install the associated plugin:
ape plugins install infura

Afterwards, you should see it in the output of the list command:
$ ape plugins list

Installed Plugins:
infura 0.4.0
...

After your provider plugin of choice is installed, configure it to be your default mainnet provider in your ape-config.yaml file:
ethereum:
mainnet:
default_provider: infura

Finally, you can start the ape console using any network of your choice:
ape console --network :rinkeby:infura

Then, convert an ens domain to an AddressType:
In [1]: from ape.types import AddressType
In [2]: convert("vitalik.eth", AddressType)
Out[2]: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'

Get the Ethereum Name Service (ENS) namehash using the namehash function:
from ape_ens.utils import namehash
# or
# from ape_ens.utils.namehash import namehash
>> namehash("eth").hex()
"0x93cdeb708b7545dc668eb9280176169d1c33cfd8ed6f04690a0bcc88a93fc4ae"

>> namehash("foo.eth")
HexBytes("0xde9b09fd7c5f901e23a3f19fecc54828e9c848539801e86591bd9801b019f84f")

>> namehash("ape.rocks.eth").hex()
"0x6294e43e29c5c1573554a68e6ff302fa867ab0d56b800f623c1abb77609d2b8d"

The ENS plugin temporarily connects to mainnet, caches the address resolution, and then your original network uses the result.