(iT ddlmZddlmZmZmZmZmZmZm Z ddl m Z m Z m Z mZddlmZmZmZmZddlmZddlmZddlmZdd lmZdd lmZmZmZm 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.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5er dd l6m7Z7ddl8m9Z9m:Z:ddl;mZ>ddl?m@Z@GddeZAdeBdddedeBddf dZCdddedeDfdZEy))deepcopy) TYPE_CHECKINGAnyOptionalSequenceTupleUnioncast)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_name init_web3 is_empty_nameis_none_or_zero_address label_to_hashnormal_name_to_hashnormalize_nameraw_name_to_hash)Web3)ContractContractFunction) Middleware) BaseProvider)TxParamsc eZdZUdZded< d6dddedeeed 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);ENSaj 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"`` r/w3Nproviderr3addr middlewarer2returnc|xstdt}t|||_|r|nt}|jj j tj||_ |jj j tj|_ |jj j tj|_ y)aC :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(r7rethcontractrr6ensPUBLIC_RESOLVER_2_EXTENDED_resolver_contractREVERSE_RESOLVER_reverse_resolver_contract)selfr8r9r:ens_addrs 8/var/www/br/venv/lib/python3.12/site-packages/ens/ens.py__init__z ENS.__init__cs*>%%+?+ 'c|jj}|jj}|t d|||}|j |_|S)a+ Generate an ENS instance from a Web3 instance :param `web3.Web3` w3: to infer connection, middleware, and codec information :param hex-string addr: the address of the ENS registry on-chain. If not provided, defaults to the mainnet ENS registry address. r3)r9r:)managerr8middleware_onionr:r strict_bytes_type_checking)clsr7r9r8r:nss rH from_web3z ENS.from_web3|sN::&&((33 nh/dz R)+(E(E% rJname coin_typec| tt|j|dS|j|}t ||t dt |}|jj||}t|ryt|S)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 :raises ResolverNotFound: if no resolver found for `name` :raises UnsupportedFunction: if the resolver does not support the ``addr()`` function Nr9zaddr(bytes32,uint256)) r r _resolveresolver#_validate_resolver_and_interface_idrr.callerr9r*r)rFrRrSrnodeaddress_as_bytess rHr>z ENS.addresss~  tV)DE E d#A /a<>U $D)D xx}}T9= &'78&'78 8rJr>transactr4cD|si}t|}|j||}|j||t|rd}nF|tur|}n;t |rt tt|}nt|s td|j||k(ry|t}||d<|j||}t|}|+|jj!||j#|S|jj!|||j#|S)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\)rFrRr>rSr\ownerrVrZs rH setup_addresszENS.setup_addresss8HH%   9 UD) "7 +G  G w ')$sG*<=G$W- PQ Q <<  ( ?$G #11$1J%  %%--dG<EEhO O%%--dIwGPP rJct|}|j|d}t||j|k(r|SdS)z Look up the name that the address points to, using a reverse lookup. Reverse lookup is opt-in for name owners. :param address: :type address: hex-string rR)fn_nameN)r%rUrr>)rFr>reversed_domainrRs rHrRzENS.namesB4G<}}_f}=+73t||D7IItStSrJc&|si}t|}|s&|j|d|jd||S|j|}t |r|}n"|r ||k7r|t k7rt d|d|dt |r|j|}t |r tdt|r t|}t|s td|j|||s|j||||j|||S) a Set up the address for reverse lookup, aka "caller ID". After successful setup, the method :meth:`~ens.ENS.name` will return `name` when supplied with `address`. :param str name: ENS name that address will point to :param str address: address to set up, in checksum format :param dict transact: the transaction configuration, like in :meth:`~web3.eth.send_transaction` :raises AddressMismatch: if the name does not already point to the address :raises InvalidName: if `name` has invalid syntax :raises UnauthorizedError: if ``'from'`` in `transact` does not own `name` :raises UnownedName: if no one owns `name` zthe reverse recordNr^zCould not set address z0 to point to name, because the name resolves to zI. To change the name for an existing address, call setup_address() first.z+claim subdomain using setup_address() firstr_)rrb_setup_reverser>r*rrrgr"rrrrrh)rFrRr>r\resolveds rH setup_namezENS.setup_names)(HH%  *> ?&&tWx&H H||D)H&w/"g1h.6P%,WK844<<@-- 'w/**T*&w/!"OPP )-g6&w/#$TUU  $ /""48"D&&tWx&H HrJcbt|}|jjj|S)a Get the owner of a name. Note that this may be different from the deed holder in the '.eth' registrar. Learn more about the difference between deed and name ownership in the ENS `Managing Ownership docs `_ :param str name: ENS name to look up :return: owner address :rtype: str )r.rArXrg)rFrRrZs rHrgz ENS.owner's' %xx$$T**rJ new_ownerch|xsttt}|si}t|}|j |\}}}|tur|}n|stt }n t |}|j|}|t k(r|sy||k(r|S|j||||j||||||S)ac 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_ownerrrrgrb_claim_ownership)rFrRrqr\ super_ownerunownedowned current_owners rHrazENS.setup_owner5s<?ow!? HH%(,(9(9$(?%gu  #I'7I+I6I 4(  &} i '  dE :  ! !7E; "  rJr0c@t|}|j|dS)zZ Get the resolver for an ENS name. :param str name: The ENS name r)r- _get_resolver)rFrR normal_names rHrVz ENS.resolverks$ %T* !!+.q11rJtarget_addressc:t|}|j|SN)r%rV)rFr|rks rHreverserz ENS.reverserts3NC}}_--rJkeyct|}|j|}t||td|jj ||S)a Get the value of a text record by key from an ENS name. :param str name: ENS name to look up :param str key: ENS name's text record key :return: ENS name's text record value :rtype: str :raises UnsupportedFunction: If the resolver does not support the "0x59d1d43c" interface id :raises ResolverNotFound: If no resolver is found for the provided name text)r.rVrWrrXr)rFrRrrZrYs rHget_textz ENS.get_textzs@ % MM$ +D!5JFSxx}}T3''rJvaluec|j|}t||tdt|}|j ||j j |||f|S)aC Set the value of a text record of an ENS name. :param str name: ENS name :param str key: Name of the attribute to set :param str value: Value to set the attribute to :param dict transact: The transaction configuration, like in :meth:`~web3.eth.Eth.send_transaction` :return: Transaction hash :rtype: HexBytes :raises UnsupportedFunction: If the resolver does not support the "0x59d1d43c" interface id :raises ResolverNotFound: If no resolver is found for the provided name r)rVrWrr. _set_propertyresetText)rFrRrrr\rYrZs rHset_textz ENS.set_textsX* MM$ +D!5JFS%!! !++%%c5'98  rJr{rjc|} t|rd|fS|jjjt |}t |s t d|j||}||fS|j|}z)Nr0) r)rArXrVr,r*r _type_aware_resolverparent)rFr{rj current_name resolver_addrrVs rHrzzENS._get_resolvers # \*\)) HHOO445H5VWM*=9 9 9- Q -- ;;|4LrJrc`|si}t|}t|r|jd}t|}|jj j ||k7r5|jjj||j|td|j|S)Nz resolver.ethr0)r>) rr*r>r.rArXrVre setResolverr\r rC)rFrRrr\namehashs rHrdzENS._set_resolvers HH% "= 1 LL8M#D) 88?? # #H - > HH   * *8] C L LX VJ 7 7 7 NOOrJct|}|j||\}}|sy|j|}t|trd||gf}|j |}|j jt||} |j| ||} t| r t| S| S||k(rPt|j|} | |j} t| ryt| r t| S| Syr~)r-rzr_resolver_supports_interfacer encode_abirXresolver'_decode_ensip10_resolve_datarrgetattrrecallr*) rFrRrjr{rVrrZcontract_func_with_argscalldatacontract_call_resultresultlookup_functions rHrUz ENS._resolves %T* !%!3!3K!I,}}[) (2T U'.&7 #*x**,CDH#+??#:#: ,$ 66$hF3=V2D&v. P& P L (%h&8&8'BO$T*//1F&v.2r\s rHrmzENS._setup_reverse&sY (,~d#HH%"&&(22::4@II(SSrJc|jjjtt}|j j j|tjS)N)r>r=) rArXrgr,rr7r?r@rREVERSE_REGISTRAR)rFr9s rHrzENS._reverse_registrar3sExx$$%89Q%RSww{{##Dd6L6L#MMrJfuncr1argscp|si}|j|}td|i|}||j|S)Nr`)rgrr\)rFrRrrr\rgtransact_from_owners rHrzENS._set_property7sAH 4 #VUOX>T{##$788rJ)NNNr~)NN)r9)r;r0)(__name__ __module__ __qualname____doc____annotations__r rrrrcrI classmethodrQintr>r r&r r r rrhrRrorgrarVrrrrzrdrUrbrsrtrmrrrrJrHr6r6Vs, J$( $CG     XeL#,=&>?@    26E($(99C=9 / " 9B@D W@ $()-88w;<8 C= 8:&8 ( 8t TO T T$.2)- 0I0I/*0I:& 0I  0Id +# +/ +"&*)- 44#4:& 4 / " 4l2S2Xj%92..8J;O. (S(s(s(. $          D555 x #S( ) 5:48)- PP 0P:& P  P")/"% %,- .F'+    sm   && x((3-< =&.04)- ''#' ' O, ' :& ' '0*. Tsm T! T:& T  TN $ 9 9! 9sm 9  9  9rJr6ens_namerVr0ens_interface_idinterface_namer;Ncb|std|dt||std|d|dy)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#)rrVrrs rHrWrWGs_ *8*5> >  *(4D E!!(+CNCST   FrJc|td|jDxr|jj|S)Nc36K|]}dt|vyw)supportsInterfaceN)repr).0rs rH z/_resolver_supports_interface..]s.2tDz)s)any all_functionsrXr)rVrs rHrrYs? 6>6L6L6N  > // + +,< =>rJ)Fcopyrtypingrrrrrr r eth_typingr r r r eth_utilsrrrreth_utils.toolzrhexbytesrrrbase_ensr constantsrrrrrr exceptionsrrr r!r"r#utilsr$r%r&r'r(r)r*r+r,r-r.web3r/web3.contract.contractr0r1web3.middleware.baser2web3.providersr3 web3.typesr4r6rcrWboolrrrJrHrs       n9'n9b        $>>> >rJ