(if4ddlZddlmZmZmZmZmZmZmZm Z m Z ddl m Z ddl mZddlmZddlmZmZmZmZmZmZmZmZmZmZddlmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%ddl&m'Z'm(Z(dd l)m*Z*m+Z+dd l,m-Z-dd l.m/Z/dd l0m1Z1dd l2m3Z3ddl4m5Z5m6Z6m7Z7ddl8m9Z9ddl:m;Z;ddlZ>m?Z?m@Z@mAZAmBZBddlCmDZDdeEdedeefdZFdeGdedeefdZHde jdeedeeEefdedeef dZJdedefdZKdedefdZLdedefdZMd eEd!eedeEfd"ZNd#ed$eGdedededeEf d%ZO dN) AnyCallableDictListOptionalSequenceTupleUnioncast)codec)ABICodec)registry) ABI ABICallableABIConstructor ABIElementABIElementInfoABIEvent ABIFallback ABIReceiveHexStr Primitives)abi_to_signatureevent_abi_to_log_topicfilter_abi_by_namefilter_abi_by_typefunction_abi_to_4byte_selectorget_abi_input_typesget_aligned_abi_inputsget_normalized_abi_inputs)is_binary_addressis_checksum_address hexstr_if_strto_bytes) encode_hex)pipe) is_list_like)HexBytes)filter_by_argument_nameget_abi_element_signature$get_name_from_abi_element_identifier)deprecated_for) validate_abi)ABIConstructorNotFoundABIFallbackNotFoundABIReceiveNotFound MismatchedABIWeb3ValidationErrorWeb3ValueError)ABIElementIdentifier signature contract_abireturncJ|Dcgc]}t||k(s|c}Scc}wN)r)r6r7abis ?/var/www/br/venv/lib/python3.12/site-packages/web3/utils/abi.py_filter_by_signaturer=Zs#' NC+;C+@I+MC NN Ns   num_argumentsc |Dcgc]2}|ddk7r(|ddk7r t|jdg|k(r|4c}Scc}w)Ntypefallbackreceiveinputs)lenget)r>r7r;s r<_filter_by_argument_countrF^sT     v;* $ K9 $ "% &- 7   s7? abi_codecargskwargscj|Dcgc]#}t|g|d|i|rtt|%c}Scc}w)NrG)!check_if_arguments_can_be_encodedr r)rGrHrIr7 function_abis r<_filter_by_encodabilityrMjsN)   ,   +4 8>  [,'  s(0cptd|}t|dkDr td|r|dStd)@ Return the receive function ABI from the contract ABI. constructorz9Multiple constructor functions found in the contract ABI.rz6No constructor function was found in the contract ABI.)rrDr2r/r7 filtered_abiss r<_get_constructor_function_abirTysG'}lCM =AWXXQ$ D  cptd|}t|dkDr td|r|dStd)rOrBrQz5Multiple receive functions found in the contract ABI.rz2No receive function was found in the contract ABI.)rrDr2r1rRs r<_get_receive_function_abirWsC'y,?M =ASTTQ !UVVrUcptd|}t|dkDr td|r|dStd)zA Return the fallback function ABI from the contract ABI. rArQz6Multiple fallback functions found in the contract ABI.rz3No fallback function was found in the contract ABI.)rrDr2r0rRs r<_get_fallback_function_abirYsC'z<@M =ATUUQ!"WXXrU element_nameelementsc|Dcgc]+}|jddt|k(r t|-}}t|dk(r|dSt|dkDr|d}||vr|dS|Sycc}w)a[ Find an ABI identifier signature by element name. A signature identifier is returned, "name(arg1Type,arg2Type,...)". If multiple ABIs match the name and every one contain arguments, the first result is returned. Otherwise the signature without arguments is returned. Returns None if no ABI exists with the provided name. namerQr()N)rEr,rrD)rZr[elementelement_signatures_with_namesignature_without_argss r< _get_any_abi_signature_with_namercs $  ;;vr "&J<&X X !$ $  '(A-+A.. ) *Q .$0>!4 !)E E/2 2) )#$s0A)r;num_argscHtddddd}|D];}t|}t|}t|} t } t } t ||k(r|dk(r7|ds|dxxd| dz cc<|dxxdt|d|d d z cc<n t |g|i|} t|| \} } d}tt| | dD]6\}\}}|j||r |d|d|dz }(|d|d|d|dz }8|dk7s|dxxd |d|d d |zz cc<|dxxd |d|d dt |d|d z cc<>dj|jS#t$r'} |d xxd |d|d d |d| d z cc<Yd} ~ d} ~ wwxYw)z? Build a string representation of the ABI input error. r^) zero_args invalid_argsencodingunexpected_argsrrfzIThe provided identifier matches multiple elements. If you meant to call `z(()`, please specify the full signature. z - signature: z, type: r@ rgz Signature: z" Arguments do not match types in `z `. Error: NrQ)startz Argument z value `z ` is valid. z` is not compatible with type `z`. rhriz Expected z argument(s) but received  argument(s). )dictrrr,tuplerDr r TypeError enumeratezip is_encodablejoinvalues)r;rdrGrHrIerrors abi_elementabi_element_input_types abi_signatureabi_element_nametypes aligned_args argumentseargument_errorsposition_typeargs r<_build_abi_input_errorrsr"!  F4 "5k"B(5 ? N!&(- & '8 31}k*;'11A0BC??' {#$%5k%B$CD(015#  9+ W WPV WI*@i*X'E<!O*3C|4LTU*V &,5#))%5#8*HSE'WWO##H:XcU;!!&t-O  "$z"!-V9L8MRP%&" $ %m_H[5H4IJ 7899S*O-  %a4l 776==? ##=!>*%m_H[=P>> from web3.utils.abi import get_abi_element_info >>> abi = [ ... { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... {"name": "b", "type": "uint256"}, ... ], ... "name": "multiply", ... "outputs": [{"name": "result", "type": "uint256"}], ... "payable": False, ... "stateMutability": "nonpayable", ... "type": "function", ... } ... ] >>> fn_info = get_abi_element_info(abi, "multiply", *[7, 3]) >>> fn_info["abi"] {'constant': False, 'inputs': [{'name': 'a', 'type': 'uint256'}, {'name': 'b', 'type': 'uint256'}], 'name': 'multiply', 'outputs': [{'name': 'result', 'type': 'uint256'}], 'payable': False, 'stateMutability': 'nonpayable', 'type': 'function'} >>> fn_info["selector"] '0x165c4a16' >>> fn_info["arguments"] (7, 3) rGr@rArB)r;selectorr|)get_abi_elementr&rrnrr r) r;rrGrHrIfn_abi fn_selector fn_inputs_aligned_fn_inputss r<get_abi_element_inforsn #&*6?CIF;FCDK!&I f~#vf~'B&;%'RR-fFtFvF 5fiH 8I  rUc t||tt}t|gt |g|d|i|}t |}|dk7r4t |||t |t |zg|d|i|}t||dS)a Return the interface for an ``ABIElement`` from the ``abi`` that matches the provided identifier and arguments. ``abi`` may be a list of all ABI elements in a contract or a subset of elements. Passing only functions or events can be useful when names are not deterministic. For example, if names overlap between functions and events. The ``ABIElementIdentifier`` value may be a function name, signature, or a ``FallbackFn`` or ``ReceiveFn``. When named arguments (``args``) and/or keyword args (``kwargs``) are provided, they are included in the search filters. The `abi_codec` may be overridden if custom encoding and decoding is required. The default is used if no codec is provided. More details about customizations are in the `eth-abi Codecs Doc `__. :param abi: Contract ABI. :type abi: `ABI` :param abi_element_identifier: Find an element ABI with matching identifier. The identifier may be a function name, signature, or ``FallbackFn`` or ``ReceiveFn``. A function signature is in the form ``name(arg1Type,arg2Type,...)``. :type abi_element_identifier: `ABIElementIdentifier` :param args: Find an element ABI with matching args. :type args: `Optional[Sequence[Any]]` :param abi_codec: Codec used for encoding and decoding. Default with `strict_bytes_type_checking` enabled. :type abi_codec: `Optional[Any]` :param kwargs: Find an element ABI with matching kwargs. :type kwargs: `Optional[Dict[str, Any]]` :return: ABI element for the specific ABI element. :rtype: `ABIElement` .. doctest:: >>> from web3.utils.abi import get_abi_element >>> abi = [ ... { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... {"name": "b", "type": "uint256"}, ... ], ... "name": "multiply", ... "outputs": [{"name": "result", "type": "uint256"}], ... "payable": False, ... "stateMutability": "nonpayable", ... "type": "function", ... } ... ] >>> get_abi_element(abi, "multiply", *[7, 3]) {'constant': False, 'inputs': [{'name': 'a', 'type': 'uint256'}, {'name': 'b', 'type': 'uint256'}], 'name': 'multiply', 'outputs': [{'name': 'result', 'type': 'uint256'}], 'payable': False, 'stateMutability': 'nonpayable', 'type': 'function'} rGrQr)r.r rr'rrDrr2)r;rrGrHrIabi_element_matchesrerror_diagnosiss r<rrs|-. 04 1  "      1)*Ka9 "   IF #       O,, q !!rUrvcP|ddk(s|ddk(ry t|g|i|}t|jddt|k7ry t ||\}}t t tfdt||DS#t$rYywxYw#t$rYywxYw) a Check if the provided arguments can be encoded with the element ABI. :param abi_element: The ABI element. :type abi_element: `ABIElement` :param args: Positional arguments. :type args: `Optional[Sequence[Any]]` :param abi_codec: Codec used for encoding and decoding. Default with `strict_bytes_type_checking` enabled. :type abi_codec: `Optional[Any]` :param kwargs: Keyword arguments. :type kwargs: `Optional[Dict[str, Any]]` :return: True if the arguments can be encoded, False otherwise. :rtype: `bool` .. doctest:: >>> from web3.utils.abi import check_if_arguments_can_be_encoded >>> abi = { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... {"name": "b", "type": "uint256"}, ... ], ... "name": "multiply", ... "outputs": [{"name": "result", "type": "uint256"}], ... "payable": False, ... "stateMutability": "nonpayable", ... "type": "function", ... } >>> check_if_arguments_can_be_encoded(abi, *[7, 3], **{}) True r@rArBTFrCc3HK|]\}}j||ywr:)rr).0rrrGs r< z4check_if_arguments_can_be_encoded..s'/9uc uc*s") r rorDrErr rallrq)rvrGrHrIr|rzr{s ` r<rKrKnsN6j(K,?9,L-kKDKFK  ;??8R ()S^;4[)L|-. =@ =U   s#B B BB B%$B%zuse get_abi_element instead event_nameargument_namesctjtdg}||dk(r td|j tjt ||)|j tjt |tttt|g|}t|dk(r|dSt|dk(r tdtd)a .. warning:: This function is deprecated. It is unable to distinguish between overloaded events. Use ``get_abi_element`` instead. Find the event interface with the given name and/or arguments. :param abi: Contract ABI. :type abi: `ABI` :param event_name: Find an event abi with matching event name. :type event_name: `str` :param argument_names: Find an event abi with matching arguments. :type argument_names: `Optional[Sequence[str]]` :return: ABI for the event interface. :rtype: `ABIEvent` .. doctest:: >>> from web3.utils import get_event_abi >>> abi = [ ... {"type": "function", "name": "myFunction", "inputs": [], "outputs": []}, ... {"type": "function", "name": "myFunction2", "inputs": [], "outputs": []}, ... {"type": "event", "name": "MyEvent", "inputs": []} ... ] >>> get_event_abi(abi, 'MyEvent') {'type': 'event', 'name': 'MyEvent', 'inputs': []} eventr^z6event_name is required in order to match an event ABI.rQrzNo matching events foundzMultiple events found) rrrr3rrr*r rrr'rDr4)r;rrrevent_abi_candidatess r< get_event_abirsD ,g6>GZ2-! D   NN9$$%7DE!y(()@.QR 2D4Gw4GH  A%#A&& ! "a '788455rU event_abitopicsc|dr|S|rt|dk(r tdt|t|dk7r td|ddS)ab Return topics for an event ABI. :param event_abi: Event ABI. :type event_abi: `ABIEvent` :param topics: Transaction topics from a `LogReceipt`. :type topics: `Sequence[HexBytes]` :return: Event topics for the event ABI. :rtype: `Sequence[HexBytes]` .. doctest:: >>> from web3.utils import get_event_log_topics >>> abi = { ... 'type': 'event', ... 'anonymous': False, ... 'name': 'MyEvent', ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ] ... } >>> keccak_signature = b'l+Ff\xba\x8d\xa5\xa9W\x17b\x1d\x87\x9aw\xder_=\x81g\t\xb9\xcb\xe9\xf0Y\xb8\xf8u\xe2\x84' # noqa: E501 >>> get_event_log_topics(abi, [keccak_signature, '0x1', '0x2']) ['0x1', '0x2'] anonymousrz5Expected non-anonymous event to have 1 or more topicsz2The event signature did not match the provided ABIrQN)rDr2rlog_topic_to_bytes)rrs r<get_event_log_topicsrs[@ s6{a'STT  *.@.K KPQQabzrU log_topicc"tt|S)a\ Return topic signature as bytes. :param log_topic: Event topic from a `LogReceipt`. :type log_topic: `Union[Primitives, HexStr, str]` :return: Topic signature as bytes. :rtype: `bytes` .. doctest:: >>> from web3.utils import log_topic_to_bytes >>> log_topic_to_bytes('0xa12fd1') b'\xa1/\xd1' r#)rs r<rrs" 9 --rU)rrr:)\rtypingrrrrrrr r r eth_abir eth_abi.codecr eth_abi.registryrr eth_typingrrrrrrrrrr eth_utils.abirrrrrrrr eth_utils.addressr!r"eth_utils.conversionsr$r%eth_utils.hexadecimalr&eth_utils.toolzr'eth_utils.typesr(hexbytesr)web3._utils.abir*r+r,web3._utils.decoratorsr-web3._utils.validationr.web3.exceptionsr/r0r1r2r3r4 web3.typesr5rr=intrF ABIEncoderrMrTrWrYrcrrrrrrrboolrKrrbytesrrrUr<rsb           OCOsOtJ?OO  &)  *    3-  cN    +    " WC WJ W YS Y[ Y!)*!5>I$ I$I$ I$ I$  I$  I$^ B $ B0B BB B C= B } BsmB BJ$8C=$S$,"S"S" $K0K C=K}Ksm K  (3,, -. Kd $ E E 0E  HSM "E } E tCH~& E  E X $ ]" ]"0]" C=]"} ]" sm ]"  ]"F $<< HSM "<}<tCH~& <  <~-./356 5656Xc]+56 56/56p'' X 'h'T.Z,-. .rU