(ik ddlZddlmZmZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZmZddlmZddlmZddlmZm Z m!Z!m"Z"ddl#m$Z$m%Z%m&Z'dd l(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3dd l4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?dd l@mAZAmBZBdd lCmDZDmEZEdd lFmGZGddlHmIZIddlJmKZKddlLmMZMmNZNmOZOmPZPddlQmRZRmSZSerddlTmUZUde)dee/fdZVde)dee1fdZWde.dee+fdZXde.dee+fdZYde eZde)dee-fdZ[de eZde)dee-fdZ\de eZde)dee-fdZ]d eRdeZfd!Z^ dd eRd"eeeZdeZfd#Z_Gd$d%ejZ`Gd&d'ejZbGd(d)ebZcGd*d+ecZdGd,d-ebZeGd.d/ebZfGd0d1ejZgejd2Zid3eZdeeeZeeZffd4Zjd5ee*e+fd6e dee d7ffd8Zkde)de,fd9Zld:d;gZmendd?ZpeoDcgc]}d@| c}ZqeoDcgc]}dA| c}ZrepDcgc]}d:| c}dBgzZsetejdCdDgeqeresZvdEjdFejevemDZxdGZydHjexeyIZ{dJe3de|fdKZ}dJe3de|fdLZ~dJe3de|fdMZdJe3de|fdNZdJe3de|fdOZdJe3de|fdPZdJe3de|fdQZeAdRedSej de|fdTZdJe3defdUZdVZdJe3deZfdWZdJe3defdXZdYjeyZZdJe3de|fd[Zd\Zd]jee^ZdJe3de|fd_Ze?d`e e.deee.e e3e fffdaZeAdbee e3e gee3e ffdee3dcee de fddZeAdee3dcee dedefdfZeAdge e3e gee3e ffdhe ddefdiZGdjdeededkZdleee3efdme defdnZdoe de fdpZdoe de fdqZde$fdrZde$fdsZdteee*e+e0e.e e3e ffdceee d7fde eZe ffduZdtee*e+e0e.e e3e ffdcee d7fdee eZe fee d7fee ffdvZdce eZe fdee d7ffdwZdxee d7fde d7ee d7fffdyZdzd{dge d{e3e ge e e ee3e fffdhe ddefd|ZeGdzd{dge e ge e e eSffdce deSfd}Zdge e ge e e e ffdSe de fd~Zycc}wcc}wcc}w)N)abc namedtuple) TYPE_CHECKINGAnyCallable Collection CoroutineDictIterableListMappingOptionalSequenceTupleTypeUnioncast)decodingencoding)parse_type_str)ValueOutOfBounds)ABIType BasicType TupleTypeparse) ABIRegistry BaseEqualsregistry) ABI ABIComponentABIComponentIndexedABIConstructor ABIElementABIEvent ABIFallback ABIFunction ABIReceiveHexStrTypeStr) collapse_if_tuple decode_hexfilter_abi_by_typeget_abi_input_namesget_abi_input_typesis_bytes is_list_like is_stringis_textto_textto_tuple)currypipe) FallbackFn ReceiveFn)reject_recursive_repeats) is_ens_name) recursive_map) MismatchedABIWeb3AttributeError Web3TypeErrorWeb3ValueError)ABIElementIdentifierTReturn) AsyncWeb3 contract_abireturnctd|S)Nfallbackr,rCs @/var/www/br/venv/lib/python3.12/site-packages/web3/_utils/abi.pyfallback_func_abi_existsrJms j, 77ctd|S)NreceiverGrHs rIreceive_func_abi_existsrNqs i 66rK event_abicB|dDcgc] }|ddus |c}Scc}w)NinputsindexedTrOargs rIget_indexed_event_inputsrVus&$X. IC#i.D2HC II I cB|dDcgc] }|ddus |c}Scc}w)NrQrRFrSrTs rIexclude_indexed_event_inputsrYys&$X. JC#i.E2IC JJ JrWtypesc<|Dcgc] }|d|vs |c}Scc}w)NtyperS)rZrC abi_elements rIfilter_by_typesr^}s#+7 XK;v;NRW;WK XX Xs argument_namescg}|D]E} t|}t|j|t|k(r|j|G|S#t$rYUwxYw)zd Return a list of each ``ABIElement`` which contains arguments matching provided names. )r-set intersectionappend TypeError)r_rCabis_with_matching_argsr] abi_arg_namess rIfilter_by_argument_namergsr!#   / "// >#nBUU'..{;  #"    AA AAargument_typescg}|D]E} t|}t|j|t|k(r|j|G|S#t$rYUwxYw)zd Return a list of each ``ABIElement`` which contains arguments matching provided types. )r.rarbrc ValueError)rirCrer] abi_arg_typess rIfilter_by_argument_typermsr!#   / "// >#nBUU'..{;  #"    rhabi_element_identifierc|dtfvry|dtfvryt|rt|j ddSt d)NrFrM(rzUnsupported function identifier)r7r8r2strsplitr>)rns rI$get_name_from_abi_element_identifierrssU*j!99 Iy#9 9 ' ()*005a88=>>rKabi_element_argument_typesc^t|}dj|xsg}|dvr|S|d|dS)N,)rFrMrp))rsjoin)rnrt element_nameris rIget_abi_element_signaturerzsF88NOLXX8>B?N..^1^,A ..rKc2eZdZededdffd ZxZS)AddressEncodervaluerDNc<t|ryt| |yN)r:supervalidate_valueclsr} __class__s rIrzAddressEncoder.validate_values u   u%rK__name__ __module__ __qualname__ classmethodrr __classcell__rs@rIr|r|s#&3&4&&rKr|c*eZdZUdZeej ed<dZe ed<dZ e ed<dZ e ed<dZ e ed<dej d eeefd dffd Zed ed ed dfdZed eej fdZded dfdZded efdZded efdZxZS)AcceptsHexStrEncoderNsubencoder_cls is_strictF is_big_endiandata_byte_sizevalue_bit_size subencoderkwargsrDc Tt|di|||_|j|_y)NrS)r__init__r is_dynamic)selfrrrs rIrzAcceptsHexStrEncoder.__init__s) "6"$$//rKabi_typerc|j}ttj|j ||}||Sr)get_subencoder_classrr BaseEncoder from_type_strrrrrrs rIrz"AcceptsHexStrEncoder.from_type_strsB113  .">">x"R :rKcb|jtd|j|jS)NzNo subencoder class is set. )rr=r)rs rIrz)AcceptsHexStrEncoder.get_subencoder_classs1    %$'CCLL>%RS S!!!rKr}c\|j|}|jj|yr)validate_and_normalizerrrr}normalized_values rIrz#AcceptsHexStrEncoder.validate_values&66u= &&'78rKcZ|j|}|jj|Sr)rrencoders rIrzAcceptsHexStrEncoder.encodes)66u=%%&677rKc`t|st|s|j||}t|r4 t|}|dddk7r |jr|j|d |jr|j~t||jkDr(|j|td|jd|St||jkr&|j|td |jd|S#t j $r|j||dYwxYw) N0xz#hex string must be prefixed with 0xmsgz is an invalid hex stringz!exceeds total byte size for bytesz encoding)excrz#less than total byte size for bytes) r/r2invalidate_valuer+rbinasciiErrorrlenr)rr} raw_values rIrz+AcceptsHexStrEncoder.validate_and_normalizesIwu~  ! !% ( 5> "5)Ra=D(T^^))!'L* >>d11=5zD///%%(;DQ>Q=RS& 7>> %% '!:;& s D)D-,D-)rrrrrrr__annotations__rboolrrintrr rqrrrr)rrrrbytesrr(rrrs@rIrrs15ND--.5ItM4NCNC0((0sCx.0  0  *5    "T(*>*>%?"" 9C9D98C8E8#C#F#rKrc(eZdZejZdZy) BytesEncoderFN)rrrrrrrrSrKrIrr s**NIrKrcNeZdZdZdfd ZeddededdfdZxZ S) ExactLengthBytesEncoderTrDcPt||j td|j td|j td|jdzdk7rtd|jd|j|jdzkDr tdy) Nz `value_bit_size` may not be nonez `data_byte_size` may not be nonez`is_big_endian` may not be nonerzInvalid value bit size: z. Must be a multiple of 8z!Value byte size exceeds data size)rvalidaterr?rr)rrs rIrz ExactLengthBytesEncoder.validate(s     & !CD D    & !CD D    % !BC C    "a ' *4+>+>*?@**    !4!4q!8 8 !DE E 9rKrrrc|j}|j|j|}tt|||j dz|j S)Nr)rr)rr to_type_strrrsubrs rIrz%ExactLengthBytesEncoder.from_type_str:s]113#11(2F2F2H(S  # '||a/'||   rK)rDN) rrrrrrrrrrrs@rIrr%s?IF$G   ,7 "  rKrc(eZdZejZdZy)ByteStringEncoderFNrrrrrrrrSrKrIrrMs//NIrKrc(eZdZejZdZy)StrictByteStringEncoderTNrrSrKrIrrRs//NIrKrc2eZdZededdffd ZxZS)TextStringEncoderr}rDNct|r t|}t||y#t$r|j|dY.wxYw)Nznot decodable as unicode stringr)r/r3UnicodeDecodeErrorrrrrs rIrz TextStringEncoder.validate_valueXsQ E?  u% & $$9% s )AArrs@rIrrWs# &3 &4 & &rKrz ^(tuple)((\[([1-9]\d*\b)?])*)??$sc~tj|}|&|jd}|jd}||fSy)z Takes a JSON ABI type string. For tuple type strings, returns the separated prefix and array dimension parts. For all other strings, returns ``None``. Nr)TUPLE_TYPE_STR_REmatchgroup)rr tuple_prefix tuple_dimss rIget_tuple_type_str_partsrisB  # #A &E {{1~ [[^ Z'' rKarg_abirU.c@t|d}|S|\}}||d}nd|jd}tj|}|d|dz zz|d<tj|Dcgc]}t t |}}ttjrtfd|D} n} t| s td|jdd| t| trtn t| } | d t|| DScc}w) z Aligns the values of any mapping at any level of nesting in ``arg`` according to the layout of the corresponding abi spec. r\ components[[]rc3.K|] }|dyw)nameNrS).0abirUs rI z#_align_abi_input..sACF ,Asz"Expected non-string sequence for "z" component type: got c3:K|]\}}t||ywr)_align_abi_input)rsub_abisub_args rIrz#_align_abi_input..s# GW '*s)rcountcopy itertoolsrepeatrr isinstancerr tupler0r>getr\zip) rrU tuple_partsrrsub_abisnum_dimsnew_abir aligned_argtypings ` rIrrys-+76?;K *L*<(##C())G$&A)>>7@7G7G7PQDs+QQ#s{{#AAA   $0V1D0EF##.- 1  !e4U${:KF  #Hk : #Rs,Dc|Dcgc] }|ddk(s |}}t|dk(r|dSt|dk(ryt|dkDr tdycc}w)a0 Find the constructor ABI element in the contract ABI. This function is often used in place of `web3.utils.abi.get_abi_element` to find a constructor without considering its argument types. This is used prior to encoding the abi, since the argument types are not known at that time. r\ constructorrrNzFound multiple constructors.)rr?)rCr candidatess rI$find_constructor_abi_element_by_typersh".N#V 1M#NJN :!!} ZA  Z1 ;<< Os AArstringrir!uintrz bytes32.byteaddressr|c#&K|] }|dz yw)z (?![a-z0-9])NrS)r_types rIrrs$ENsz \[[0-9]*\]z%^(?:{base_type})(?:(?:{sub_type})*)?$) base_typesub_typercHttjt|Sr)rrer TYPE_REGEXrs rIis_recognized_typer X. //rKc |dk(S)NrrSrs rI is_bool_typers v rKc|tvSr) UINT_TYPESrs rI is_uint_typers z !!rKc|tvSr) INT_TYPESrs rI is_int_typers y  rKc |dk(S)NrrSrs rIis_address_typer s y  rKc|tdgzvS)Nr) BYTES_TYPESrs rI is_bytes_typer s {gY. ..rKc |dk(S)NrrSrs rIis_string_typers x rK target_lengthr}ct||k(Sr)r)rr}s rI is_lengthrs u: &&rKcxd|vryd|vryd|vry|dk(ry|dk(ryttjd d |S) z* Returns size in bits of abi_type rNbyterrrrz\D)rrrrs rI size_of_typersR8  h69 rvveR* ++rKz \[[^]]*\]$cnt|std|tjtd|dS)Nz+Cannot parse subtype of nonarray abi-type: rr)r) is_array_typer?rr END_BRACKETS_OF_ARRAY_TYPE_REGEXrs rIsub_type_of_array_typers3  "J8*UVV 662B JJrKct|std|tjt|j dj d}|syt|S)Nz*Cannot parse length of nonarray abi-type: rr)rr?rsearchrrstripr)rinner_bracketss rIlength_of_array_typers\  "I(TUU 2H=CCAFLLTR >""rKz^[a-zA-Z0-9_]+({sub_type})+$)rcHttjt|Sr)rrr ARRAY_REGEXrs rIrr%s h/ 00rKz[a-zA-Z_][a-zA-Z0-9_]*z^{lib_name}\.{enum_name}$)lib_name enum_namecHttjt|Sr)rrr ENUM_REGEXrs rIis_probably_enumr&1rrKabi_argsc#K|D]U}t|dr|t|dr.|jDcic]\}}||dk(rdn|c}}R|Wycc}}ww)Nr\uint8)rr&items)r'rUkvs rInormalize_event_input_typesr-5sg c&k *I c&k *@C L11fg!3L LI Ms:A$AA$ normalizersdatacVt|t|gtt|tS)a Applies normalizers to your data, in the context of the relevant types. Each normalizer is in the format: def normalizer(datatype, data): # Conditionally modify data return (datatype, data) Where datatype is a valid ABI type string, like "uint". In case of an array, like "bool[2]", normalizer will receive `data` as an iterable of typed data, like `[("bool", True), ("bool", False)]`. Internals --- This is accomplished by: 1. Decorating the data tree with types 2. Recursively mapping each of the normalizers to the data 3. Stripping the types back out of the tree )r6 abi_data_treemap data_tree_mapstrip_abi_types)r.rZr/s rI map_abi_datar5Is78  e  ]K (    rK ABITypedDatac6ttt||S)a0 Decorate the data tree with pairs of (type, data). The pair tuple is actually an ABITypedData, but can be accessed as a tuple. As an example: >>> abi_data_tree(types=["bool[2]", "uint"], data=[[True, False], 0]) [("bool[2]", [("bool", True), ("bool", False)]), ("uint256", 0)] )listr2 abi_sub_tree)rZr/s rIr1r1ps L%. //rKfunc data_treec8dtddffd }t||S)zp Map func to every ABITypedData element in the tree. func will receive two args: abi_type, and data elementsrDr6c\t|tr|jt|S|Srrr6r)r=r:s rImap_to_typed_dataz(data_tree_map..map_to_typed_datas, h -(2C2C2Oh0 0OrK)rr;)r:r;r@s` rIr3r3s&CN *I 66rKc2eZdZdZdeeddffd ZxZS)r6a Marks data as having a certain ABI-type. >>> a1 = ABITypedData(['address', addr1]) >>> a2 = ABITypedData(['address', addr2]) >>> addrs = ABITypedData(['address[]', [a1, a2]]) You can access the fields using tuple() interface, or with attributes: >>> assert a1.abi_type == a1[0] >>> assert a1.data == a1[1] Unlike a typical `namedtuple`, you initialize with a single positional argument that is iterable, to match the init interface of all other relevant collections. iterablerDc$t||g|Srr__new__)rrBrs rIrEzABITypedData.__new__sws.X..rK)rrr__doc__r rrErrs@rIr6r6s$$/x}///rKzabi_type, datatype_str_or_abi_type data_valuec| td|gSt|tr t|}n|}|jr4|j j }|Dcgc]}t||}}n?t|tr-t|dt|j|D}n|}t|j |gScc}w)Nc3VK|]!\}}t|j|#ywr)r9r)r comp_type comp_values rIrzabi_sub_tree..s,- % : ..0* =- s')) r6rr)ris_array item_typerr9rr\rr)rGrHr item_type_str item_valuevalue_to_annotates rIr9r9s#T:.//&0-.'!**668 FP 8BL 3   Hi (-D,- ),X-@-@*)M-   '   "    sCr=c>t|tr |jS|Sr)rr6r/r=s rIstrip_abi_typerTs(L)}}rKc"tt|Sr)r;rTrSs rIr4r4s  22rKc>tj}|jd|jd|jd|jd|jt dt t jd|jt ddtt jd|jt ddtt jd|jt dtt jd|S Nrzbytesrr)labelT)with_subF)default_registryr unregisterregisterrr|rAddressDecoderr BytesDecoderrByteStringDecoderr StringDecoderrs rIbuild_non_strict_registryrbs $$&H  "  #   ! 9   7T*   7U+""   8  OrKcRtj}|jd|jd|jd|jd|jt dt t jd|jt ddtt jd|jt ddtt jd|jt dtjt jd|SrW)rZrr[r\rr|rr]rr^rr_rrr`ras rIbuild_strict_registryrds$$&H  "  #   ! 9   7T*   7U+""   8""  OrKrc|Dcgc]}|d }}t||Dcgc] }t| }}tt||Scc}wcc}w)zZ Convert function inputs/outputs or event data tuple to dict with names from ABI. r)r_named_subtreedict)rr/itemnamesr*s rI named_treerj"sS'* *dT&\ *E */23~ >t^T " >E > E5! "" + >s AA c tttttt f|}|j r>|jj}i||dd}|Dcgc]}t||}}|St|tr|jdrtt|}ntt|}|dDcgc]}|d }}t|d|Dcgc] }t| }}t!|t!|k(rt#t||St%d|dt!|d|d t!||Scc}wcc}wcc}w) Nr)r\rrRrrz ABI fields z has length z but received data z with length )rr*rr rqrrMrNrrfrrrr!r rrrgr<)rr/rrNitem_abirhr*ris rIrfrf3sM &tDcNC'@ABH&&224 9c99b9<@AD$/AA Hi ( 779 *C0C|S)C*-l*;<$f<<36s<7H$3OP4&PP u:T "E5)* *eWLU =v]3t9+7  K)B=Ps#E  E"Ecdttttfttfdtt tdfttffd}t ||S)Nr}rD.ct|ts|S|rt|jnd\}}t ||S)N)rSrS)rrgrr*abi_decoded_namedtuple_factory)r}keysvaluess rI_dict_to_namedtuplez9recursive_dict_to_namedtuple.._dict_to_namedtupleVs>%&L.3sEKKM* f3-d3F;;rK)rr rqrr rr;)r/rrs rIrecursive_dict_to_namedtuplersUsS<T#s(^T#Y./< uS#XS ) *< ,d 33rKfieldsc 4Gddtd|d}|S)Nc(eZdZdeddffd ZxZS).ABIDecodedNamedTupleargsrDABIDecodedNamedTuplec$t||g|SrrD)rrxrs rIrEzDabi_decoded_namedtuple_factory..ABIDecodedNamedTuple.__new__fs7?4/$/ /rK)rrrrrErrs@rIryrwes 0 0(> 0 0rKryT)rename)r)rtrys rIrorobs!0z*@&QUV0 rKasync_w3zAsyncWeb3[Any]cZKdtddffd }t||d{S7w)z Map an awaitable method to every ABITypedData element in the tree. The awaitable method should receive three positional args: async_w3, abi_type, and data r=rDr6cKt|tr(|jg|d{}t|S|S7wrr?)r= formattedr|r:s rIasync_map_to_typed_dataz4async_data_tree_map..async_map_to_typed_data}sC h -(2C2C2O"87h77I * *O8s)A>AN)rasync_recursive_map)r|r:r;rs`` rIasync_data_tree_mapros2%X/F R RR Rs +)+cKdtdtffd }t||d{}|d{S77w)z Apply an awaitable method to data and any collection items inside data (using async_map_collection). Define the awaitable method so that it only applies to the type of value that you want it to apply to. rhrDc:Kt|d{S7wr)r)rhr|r:s rI async_recursez*async_recursive_map..async_recurses(4>>>>s N)rrAasync_map_if_collection)r|r:r/r items_mappeds`` rIrrsC?#?'?1EELl# ##F #s#A<A>AAc TKt|}t|tr8||jDcic]\}}|||d{c}}St |r|St|t r$||Dcgc]}||d{c}S|S7Qcc}}w7cc}ww)z Apply an awaitable method to each element of a collection or value of a dictionary. If the value is not a collection, return it unmodified. N)r\rr rqr1r )r:r}datatypekeyvalrhs rIrrsE{H%!ellnM(#sDIo-MNN E8 $er? web3.typesr@rAweb3rBrJrNrVrYrqr^rgrmrsrzr|rrrrrrrcompilerrrr DYNAMIC_TYPESrange INT_SIZES BYTES_SIZESrrr r8chain STATIC_TYPESrxBASE_TYPE_REGEXSUB_TYPE_REGEXformatrrrrrrr r rrSizedrrrrrr!r NAME_REGEXr%r&r-r5r1r3r6r9rTr4rbrdrjrfrsrorrr)is0rIrs  $             8388K3H87#7(:2F7JJT:M5NJKHK>Q9RKY:c?Y#Y$zBRY#sO#36# *#,#sO#36# *#, ?0 ? ?;? /0 / (# 7 /  /&X,,&M8//M`' % l% P, 2 &22 &BJJBC  sHSM7I1J(K  .  F F G 00T07t"7"t"!'!d!!g!$!/G// W  'S''t'',7,s,"$1 KWKK #7 #s #7>>>W 1G11) 7 > > :? 0w040  "  eHd7C<0012   &#(GS>5#3F#FGH# G # 3-# ##L 0 G  0$,SM 0 . 0 07 GS>5##66 77DG777"/:n.>?/.#"5')9#:;#IL##LSS3c3c3";"J { F#  -{Hd7TW5c?DI 56 D 4tCH~ 4%S/ 4 #s(O  c5c?"# SS  7C()CeGSL>Q4Q*RR S  S  S0$$ C5)Cg$566 7$ $ $$( C5)CcM22 3