(iX ddlmZddlmZmZmZmZmZmZm Z m Z ddl m Z m Z mZmZddlmZmZmZmZddlmZddlmZddlmZddlmZdd lmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*dd l+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6er"dd l7m8Z8m9Z9dd l:m;Z;ddlm?Z?m@Z@ddlAmBZBGddeZCdddedeDfdZEdeFdddedeFddf dZGy))deepcopy) TYPE_CHECKINGAny CoroutineOptionalSequenceTupleUnioncast)AddressChecksumAddress HexAddressHexStr) is_addressis_binary_addressis_checksum_addressto_checksum_address)merge)HexBytes)abis)BaseENS)EMPTY_ADDR_HEX"ENS_EXTENDED_RESOLVER_INTERFACE_IDENS_MAINNET_ADDR#ENS_MULTICHAIN_ADDRESS_INTERFACE_IDENS_TEXT_INTERFACE_IDREVERSE_REGISTRAR_DOMAIN)AddressMismatch ENSValueErrorResolverNotFoundUnauthorizedError UnownedNameUnsupportedFunction) address_inaddress_to_reverse_domaindefaultdns_encode_nameinit_async_web3 is_empty_nameis_none_or_zero_address label_to_hashnormal_name_to_hashnormalize_nameraw_name_to_hash) AsyncContractAsyncContractFunction) AsyncWeb3) Middleware)AsyncBaseProvider BaseProvider)TxParamsc eZdZUdZded< d6deddeedeeed e fd dfd Z e d7ddded dfd Z d7d e dee d eefdZeeeddfd e deeeefdee dedd eef dZded ee fdZ d8d e deededd efdZd e d efdZ d8d e dededd eefdZd e d edfdZded edfdZd e de d e fdZ d7d e de de ddd ef d Z d9d!e d"e d eede ffd#Z d8d e d$eededd dfd%Z d9d e d"e d eeee ffd&Z d7d'ed e d(ee d dfd)Z!d e d eeeee e ffd*Z" d8d+ed,ee d-e d.eededd df d/Z# d7d ee dededd efd0Z$d:d1Z% d7d e d2d3d4ee&ddd ef d5Z'y);AsyncENSaj Quick access to common Ethereum Name Service functions, like getting the address for a name. Unless otherwise specified, all addresses are assumed to be a `str` in `checksum format `_, # blocklint: pragma # noqa: E501 like: ``"0x314159265dD8dbb310642f98f50C066173C1259b"`` zAsyncWeb3[Any]w3Nproviderr3addr middlewarer2returnc|xstdt}t|||_|r|nt}|jj j tj||_ |jj j tj|_ |jj j tj|_ y)a7 :param provider: a single provider used to connect to Ethereum :type provider: instance of `web3.providers.base.BaseProvider` :param hex-string addr: the address of the ENS registry on-chain. If not provided, ENS.py will default to the mainnet ENS registry address. r3)abiaddress)r>N)r r&r(r8rethcontractrENSensPUBLIC_RESOLVER_2_EXTENDED_resolver_contractREVERSE_RESOLVER_reverse_resolver_contract)selfr9r:r;ens_addrs >/var/www/br/venv/lib/python3.12/site-packages/ens/async_ens.py__init__zAsyncENS.__init__gsAt$7A!(J74%577;;''DHHh'G"&''++"6"6//#7# +/''++*>*>%%+?+ 'c|jj}|jj}|t d|||}|j |_|S)a Generate an AsyncENS instance with web3 :param `web3.Web3` w3: to infer connection information :param hex-string addr: the address of the ENS registry on-chain. If not provided, defaults to the mainnet ENS registry address. r3)r:r;)managerr9middleware_onionr;r strict_bytes_type_checking)clsr8r:r9r;nss rJ from_web3zAsyncENS.from_web3sO::&&((33 )844J W)+(E(E% rLname coin_typec`K|(tt|j|dd{S|j|d{}t ||t dd{t |}|jj||d{}t|ryt|S77f7N7!w)a  Look up the Ethereum address that `name` currently points to. :param str name: an ENS name to look up :param int coin_type: if provided, look up the address for this coin type :raises InvalidName: if `name` has invalid syntax Nr:zaddr(bytes32,uint256)) r r _resolveresolver)_async_validate_resolver_and_interface_idrr.callerr:r*r)rHrTrUrnodeaddress_as_bytess rJr?zAsyncENS.addresss  t}}T6/J)JK KmmD))A;a<>U  $D)D%&XX]]4%CC &'78&'78 8*K)  DsE"B.B& B.B(B.B*.B. B, B.(B.*B.,B.r?transactr5cK|si}t|}|j||d{}|j||d{t|rd}nF|tur|}n;t |rt tt|}nt|s td|j|d{|k(ry|t}||d<|j||d{}t|}|3|jj!||j#|d{S|jj!|||j#|d{S7,7777B7w)a Set up the name to point to the supplied address. The sender of the transaction must own the name, or its parent name. Example: If the caller owns ``parentname.eth`` with no subdomains and calls this method with ``sub.parentname.eth``, then ``sub`` will be created as part of this call. :param str name: ENS name to set up :param str address: name will point to this address, in checksum format. If ``None``, erase the record. If not specified, name will point to the owner's address. :param int coin_type: if provided, set up the address for this coin type :param dict transact: the transaction configuration, like in :meth:`~web3.eth.Eth.send_transaction` :raises InvalidName: if ``name`` has invalid syntax :raises UnauthorizedError: if ``'from'`` in `transact` does not own `name` r^N.You must supply the address in checksum formatfrom)r setup_owner_assert_controlr*r&rrr strrrr?r _set_resolverr. functionssetAddrr^)rHrTr?rUr^ownerrXr\s rJ setup_addresszAsyncENS.setup_addresss]8HH%&&th&??""5$/// "7 +G  G w ')$sG*<=G$W- PQ Qd# #w . ?$G *.*<*`_ :param str name: ENS name to look up :return: owner address :rtype: str N)r.rCrZri)rHrTr\s rJrizAsyncENS.owner*s1 %XX__**40000s 4=;= new_ownercK|xsttt}|si}t|}|j |d{\}}}|tur|}n|stt }n t |}|j|d{}|t k(r|sy||k(r|S|j|||d{|j|||||d{|S77T7(7 w)ad Set the owner of the supplied name to `new_owner`. For typical scenarios, you'll never need to call this method directly, simply call :meth:`setup_name` or :meth:`setup_address`. This method does *not* set up the name to point to an address. If `new_owner` is not supplied, then this will assume you want the same owner as the parent domain. If the caller owns ``parentname.eth`` with no subdomains and calls this method with ``sub.parentname.eth``, then ``sub`` will be created as part of this call. :param str name: ENS name to set up :param new_owner: account that will own `name`. If ``None``, set owner to empty addr. If not specified, name will point to the parent domain owner's address. :param dict transact: the transaction configuration, like in :meth:`~web3.eth.Eth.send_transaction` :raises InvalidName: if `name` has invalid syntax :raises UnauthorizedError: if ``'from'`` in `transact` does not own `name` :returns: the new owner's address Nr`) r r r&r _first_ownerrrrird_claim_ownership)rHrTrsr^ super_ownerunownedowned current_owners rJrczAsyncENS.setup_owner8s<?ow!? HH%.2.?.?.E(E%gu  #I'7I+I6I"jj..  &} i ' &&{D%@ @ @''7E;(   #)F/ A sF%>}g%V -- ;;|4L# sAB BAB rcK|si}t|}t|r|jdd{}t|}|jj j |d{|k7r_tttttf|jjj||j|}|d{td|j|S777$w)Nz resolver.ethr/)r?)rr*r?r.rCrZrXr rrrrg setResolverr^rE)rHrTrr^namehashcoros rJrfzAsyncENS._set_resolvers HH% "= 1"&,,~">>M#D)))(3 3} D#sH,-""..xGPPD JJOT%<%<]%<%STT? 3 s4/C2C,7C2)C.*A!C2 C0 !C2.C20C2cVKt|}|j||d{\}}|sy|j|}t|td{rl||gf}|j |}|j jt||d{} |j| ||} t| r t| S| S||k(rXt|j|} | |jd{} t| ryt| r t| S| Sy7777/wr)r-r|r"_async_resolver_supports_interfacer encode_abirZresolver'_decode_ensip10_resolve_datarrgetattrrgcallr*) rHrTrlr}rXrr\contract_func_with_argscalldatacontract_call_resultresultlookup_functions rJrWzAsyncENS._resolvesB %T* '+'9'9+w'O!O,}}[)4 8   (/&7 #*x**,CDH)1)@)@ ,*$ 66$hF3=V2D&v. P& P L (%h&8&8'BO*405577F&v.2#%dX.;mL,@D+CE ?#=s*AA "Ac4Kd}g}t|jd}|rnt|rcdj|}|j |d{}t|r |j |j d|r t|rc|||fS7Bw)z Takes a name, and returns the owner of the deepest subdomain that has an owner :returns: (owner or None, list(unowned_subdomain_labels), first_owned_domain) N.r)r-splitr*joinriappendpop)rHrTrirxpiecess rJruzAsyncENS._first_owners%++C00788F#D**T**E&u-vzz!}- 07 w%%+sABBGGQQQ<Qs!7A4A01A4+A2,A42A4cK|jjjttd{}|j j j|tjS79w)N)r?r>) rCrZrir,rr8r@rArREVERSE_REGISTRAR)rHr:s rJrzAsyncENS._reverse_registrarNsWXX__**  8 9  ww{{##Dd6L6L#MM s6A4A2:A4funcr0argscK|si}|j|d{}td|i|}||j|d{S7.7w)Nrb)rirr^)rHrTrrr^ritransact_from_owners rJrzAsyncENS._set_propertyTsVHjj&&#VUOX>4[))*=>>>'?s!AA )AA A A)NNNr)NN)r:)r<r/)(__name__ __module__ __qualname____doc____annotations__rr rr rerK classmethodrSintr?r r&r r rrrjrTrqrircrXrrrr|rfrWrdrurvrorrrrLrJr7r7Zs@ 37*.CG  ./ ' XeL#,=&>?@    0;?!)8 ,$(99C=9 / " 9<@D W@ $()-77w;<7 C= 7:&7 ( 7r / hsm (.2)- 0O0O/*0O:& 0O  0Od 1 1 1"&*)- 33#3:& 3 / " 3j38O+D4-4 / "4.3.S.S.2 $          H555 x(#- . 5>48)- UU 0U:& U  U2""" %,- . "P'+    sm   && x((3-< =&.04)- ''#' ' O, ' :& ' '8*. Rsm R! R:& R  RN $ ? ?& ?sm ?  ?  ?rLr7rXr/ interface_idr<cKtd|jDxr#|jj|d{S7w)Nc36K|]}dt|vyw)supportsInterfaceN)repr).0rs rJ z5_async_resolver_supports_interface..hs.2tDz)s)any all_functionsrZr)rXrs rJrrdsJ 6>6L6L6N  @11,? ?@ ?sAA AA ens_nameens_interface_idinterface_nameNc~K|std|dt||d{std|d|dy7w)NzNo resolver found for name `zH`. It is likely the name contains an unsupported top level domain (tld).zResolver for name `z` does not support the `z ` interface.)r rr#)rrXrrs rJrYrYmsi *8*5> >  6h@PQ Q Q!!(+CNCST   Rs !=;=)Hcopyrtypingrrrrrr r r eth_typingr r rr eth_utilsrrrreth_utils.toolzrhexbytesrrCr ens.base_ensr ens.constantsrrrrrrens.exceptionsrrr r!r"r# ens.utilsr$r%r&r'r(r)r*r+r,r-r.web3.contract.async_contractr/r0 web3.mainr1web3.middleware.baser2web3.providersr3r4 web3.typesr5r7boolrrerYrrLrJrs          G?wG?T@@@ @        rL