(ig ddlmZddlmZmZmZddlZddlZddlZddl m Z m Z m Z m Z ddlmZmZmZmZmZmZmZmZmZddlmZddlmZd ed e d e ee d fzfd Zded eeedzfdzfdZded dfdZ ded dfdZ!dee"ee fzezd efdZ#ded efdZ$deded eefdZ%e de dded eefdZ&e de dded eefdZ&e de dded eefdZ&e de d ded eefd!Z&e de d"ded eefd#Z&e de d$ded eefd%Z&de d&ded eeezezezezezfd'Z&ded eefd(Z'ded eefd)Z(ded*ee dzd+e"ee fdzd ee d ffd,Z)ded-ee d fee e fzd eeed fee d fffd.Z*ded e+edzfd/Z,ded e+efd0Z-ded e+edzfd1Z.ded e+efd2Z/d3ed e0fd4Z1ded e0fd5Z2d6ed e0fd7Z3d8ed e0fd9Z4y):)abc)IterableMappingSequenceN)AnyLiteralcastoverload) ABI ABIComponentABIConstructor ABIElementABIErrorABIEvent ABIFallback ABIFunction ABIReceive) is_list_like)keccakarg_abinormalized_argreturn.c^t|jdd}|S|\}}|(ttt|jdg}nI|j d}t j |}|d|dz zz|d<tj|}ttjrtfd|D}n}t|s td|jdd |t|trtn t|} | d t!||DS) z Aligns the values of any mapping at any level of nesting in ``normalized_arg`` according to the layout of the corresponding abi spec. type components[z[]rc3.K|] }|dywnameN).0abirs >/var/www/br/venv/lib/python3.12/site-packages/eth_utils/abi.py z#_align_abi_input..FsLCN3v;7Lz"Expected non-string sequence for "z" component type: got c3:K|]\}}t||ywN_align_abi_input)r#sub_abisub_args r%r&z#_align_abi_input..Ss# GW '*)_get_tuple_type_str_and_dimsgetr rr countcopy itertoolsrepeat isinstancerrtupler TypeErrorrzip) rr tuple_parts tuple_prefix tuple_dimssub_abisnum_dimsnew_abi aligned_argtypings ` r%r+r+(s,/w{{62/FGK*L*. L"0MN##C())G$&A)>>##G,.#++.L8LL $  $0V1D0EF##.- 1  !e4U${:KF  #Hk : scd}tj|j|}|&|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``. z^(tuple)((\[([1-9]\d*)?])*)??$Nr)recompilematchgroup)rBtuple_type_str_rerGr:r;s r%r/r/YsR = JJ( ) / / 2E {{1~ [[^ Z'' rA abi_elementct|ddk7r0td|jdd|jddy)NrfunctionzGOutputs only supported for ABI type `function`. Provided ABI type was `z` and outputs were `outputs`. ValueErrorr0rJs r%_raise_if_not_function_abirRjsP6j()oof567 *+2 /  )rAc|ddk(s|ddk(r0td|jdd|jddy)NrfallbackreceivezXInputs not supported for function types `fallback` or `receive`. Provided ABI type was `z` with inputs `inputsrNrOrQs r%!_raise_if_fallback_or_receive_abirWss]6j(K,?9,L)oof567)*" .  -MrAr$c(t|tr|S|jd}t|ts#tdt |dt ||j ds|Sdjd|dD}|dd }d |d |}|S) aV Extract argument types from a function or event ABI parameter. With tuple argument types, return a Tuple of each type. Returns the param if `abi` is an instance of str or another non-tuple type. :param abi: A Function or Event ABI component or a string with type info. :type abi: `Union[ABIComponent, Dict[str, Any], str]` :return: Type(s) for the function or event ABI param. :rtype: `str` .. doctest:: >>> from eth_utils.abi import collapse_if_tuple >>> abi = { ... 'components': [ ... {'name': 'anAddress', 'type': 'address'}, ... {'name': 'anInt', 'type': 'uint256'}, ... {'name': 'someBytes', 'type': 'bytes'}, ... ], ... 'type': 'tuple', ... } >>> collapse_if_tuple(abi) '(address,uint256,bytes)' rz%The 'type' must be a string, but got z of type r6,c32K|]}t|ywr)collapse_if_tuple)r#cs r%r&z$collapse_if_tuple..sI!*1-IrN())r5strr0r7reprr startswithjoin)r$ element_type delimited array_dim collapseds r%r\r\|s6#s 776?L lC (3D4F3GyL!" $   $ $W -Is<7HIIIQR II;a {+I rAcd}t|jdd}|dk(s|dk(r|j|dS|dk(r|}nt|jd|}|j|d jt |S) a5 Returns a string signature representation of the function or event ABI and arguments. Signatures consist of the name followed by a list of arguments. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: Stringified ABI signature :rtype: `str` .. doctest:: >>> from eth_utils import abi_to_signature >>> abi_element = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> abi_to_signature(abi_element) 'f(uint256)' z{name}({input_types})rrrTrU)r! input_types constructorr!rY)rbr0formatreget_abi_input_types)rJ signatureabi_typefn_names r%abi_to_signaturerrs@(I;??62./H:Y!6X2>>= koofh78    #((+>{+K"L  rAabi_name contract_abicl|Dcgc]$}|ddk(s|ddk(s|ddk(r |d|k(r|&c}Scc}w)a Get one or more function and event ABIs by name. :param abi_name: Name of the function, event or error. :type abi_name: `str` :param contract_abi: Contract ABI. :type contract_abi: `ABI` :return: Function or event ABIs with matching name. :rtype: `Sequence[ABIElement]` .. doctest:: >>> from eth_utils.abi import filter_abi_by_name >>> abi = [ ... { ... "constant": False, ... "inputs": [], ... "name": "func_1", ... "outputs": [], ... "type": "function", ... }, ... { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... ], ... "name": "func_2", ... "outputs": [], ... "type": "function", ... }, ... { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... {"name": "b", "type": "uint256"}, ... ], ... "name": "func_3", ... "outputs": [], ... "type": "function", ... }, ... { ... "constant": False, ... "inputs": [ ... {"name": "a", "type": "uint256"}, ... {"name": "b", "type": "uint256"}, ... {"name": "c", "type": "uint256"}, ... ], ... "name": "func_4", ... "outputs": [], ... "type": "function", ... }, ... ] >>> filter_abi_by_name("func_1", abi) [{'constant': False, 'inputs': [], 'name': 'func_1', 'outputs': [], 'type': 'function'}] rrLeventerrorr!r")rsrtr$s r%filter_abi_by_namerxsWv   F z)v;')v;')F x'    s)1rprLcyr)r"rprts r%filter_abi_by_typer{#  rArlcyr)r"rzs r%r{r{+r|rArTcyr)r"rzs r%r{r{3r|rArUcyr)r"rzs r%r{r{;r|rArvcyr)r"rzs r%r{r{Cr|rArwcyr)r"rzs r%r{r{Kr|rA)rLrlrTrUrvrwc|dk(r|Dcgc] }|ddk(s |c}S|dk(r|Dcgc] }|ddk(s |c}S|dk(r|Dcgc] }|ddk(s |c}S|dk(r|Dcgc] }|ddk(s |c}S|dk(r|Dcgc] }|ddk(s |c}S|dk(r|Dcgc] }|ddk(s |c}Std|cc}wcc}wcc}wcc}wcc}wcc}w) as Return a list of each ``ABIElement`` that is of type ``abi_type``. For mypy, function overloads ensures the correct type is returned based on the ``abi_type``. For example, if ``abi_type`` is "function", the return type will be ``Sequence[ABIFunction]``. :param abi_type: Type of ABI element to filter by. :type abi_type: `str` :param contract_abi: Contract ABI. :type contract_abi: `ABI` :return: List of ABI elements of the specified type. :rtype: `Sequence[Union[ABIFunction, ABIConstructor, ABIFallback, ABIReceive, ABIEvent, ABIError]]` .. doctest:: >>> from eth_utils import filter_abi_by_type >>> abi = [ ... {"type": "function", "name": "myFunction", "inputs": [], "outputs": []}, ... {"type": "function", "name": "myFunction2", "inputs": [], "outputs": []}, ... {"type": "event", "name": "MyEvent", "inputs": []} ... ] >>> filter_abi_by_type("function", abi) [{'type': 'function', 'name': 'myFunction', 'inputs': [], 'outputs': []}, {'type': 'function', 'name': 'myFunction2', 'inputs': [], 'outputs': []}] rLrrlrTrUrvrwzUnsupported ABI type: )rP)rprtr$s r%r{r{SsF:+Is6{j/HII ] "+Ls6{m/KLL Z +Is6{j/HII Y +Hs6{i/GHH W +Fs6{g/EFF W +Fs6{g/EFF1(<==JLIHFFsD CC CC C C $ C2C CC C.Cctd|S)a Return interfaces for each function in the contract ABI. :param contract_abi: Contract ABI. :type contract_abi: `ABI` :return: List of ABIs for each function interface. :rtype: `Sequence[ABIFunction]` .. doctest:: >>> from eth_utils import get_all_function_abis >>> contract_abi = [ ... {"type": "function", "name": "myFunction", "inputs": [], "outputs": []}, ... {"type": "function", "name": "myFunction2", "inputs": [], "outputs": []}, ... {"type": "event", "name": "MyEvent", "inputs": []} ... ] >>> get_all_function_abis(contract_abi) [{'type': 'function', 'name': 'myFunction', 'inputs': [], 'outputs': []}, {'type': 'function', 'name': 'myFunction2', 'inputs': [], 'outputs': []}] rLr{rts r%get_all_function_abisrs* j, 77rActd|S)a Return interfaces for each event in the contract ABI. :param contract_abi: Contract ABI. :type contract_abi: `ABI` :return: List of ABIs for each event interface. :rtype: `Sequence[ABIEvent]` .. doctest:: >>> from eth_utils import get_all_event_abis >>> contract_abi = [ ... {"type": "function", "name": "myFunction", "inputs": [], "outputs": []}, ... {"type": "function", "name": "myFunction2", "inputs": [], "outputs": []}, ... {"type": "event", "name": "MyEvent", "inputs": []} ... ] >>> get_all_event_abis(contract_abi) [{'type': 'event', 'name': 'MyEvent', 'inputs': []}] rvrrs r%get_all_event_abisrs( g| 44rAargskwargsc  t|ttt|j dg}t |t |zt |k7r0t dt |dt |t |zd|stttdf|St|j}td|D tt |}|j|j}|r/t |j ddd j|dtt|j! }|rd }|j dr>> from eth_utils import get_normalized_abi_inputs >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 'name', ... 'type': 'string' ... }, ... { ... 'name': 's', ... 'type': 'uint256' ... }, ... { ... 'name': 't', ... 'components': [ ... {'name': 'anAddress', 'type': 'address'}, ... {'name': 'anInt', 'type': 'uint256'}, ... {'name': 'someBytes', 'type': 'bytes'}, ... ], ... 'type': 'tuple' ... } ... ], ... 'name': 'f', ... 'outputs': [], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_normalized_abi_inputs( ... abi, *('myName', 123), **{'t': ('0x1', 1, b'\x01')} ... ) ('myName', 123, ('0x1', 1, b'\x01')) rVz$Incorrect argument count. Expected 'z', got 'z'..c3&K|] }|d ywr r")r#rs r%r&z,get_normalized_abi_inputs..sLWV_Lsr!z(() got multiple values for argument(s) 'z, z+{} got unexpected keyword argument(s) '{}'.z()zType: 'r'c,j|dS)Nr)index)kvsorted_arg_namess r%z+get_normalized_abi_inputs..s/55be<rA)keyrr)rWr rr r0lenr7r6rsetkeysdictr8 intersectionresorted differencermr3chainitems) rJrrfunction_inputs kwarg_namesargs_as_kwargsduplicate_args unknown_argsmessage sorted_argsrs @r%get_normalized_abi_inputsrs#r&k28L1;??8R3PQO 4y3v;#o"66233G2HI$i#f+-.b 2  E#s(OT**fkkm$KLOLL#.56N!--n.A.A.CDNv&'( .)*" .   6 67G HIJL? ??6 "+//&"9!:"=tyy?VW  NN+//&12!4dii 6M     0D0D0FG< K ;![^$$wrAnormalized_argsc,t|ttt|j dg}t t jrtfd|Dtd|Dtdt|DfS)a6 Returns a pair of nested Tuples containing a list of types and a list of input values sorted by the order specified by the ``abi``. ``normalized_args`` can be obtained by using :py:meth:`eth_utils.abi.get_normalized_abi_inputs`, which returns nested mappings or sequences corresponding to tuple-encoded values in ``abi``. :param abi_element: ABI element. :type abi_element: `ABIElement` :param normalized_args: Normalized arguments for the function. :type normalized_args: `Union[Tuple[Any, ...], Mapping[Any, Any]]` :return: Tuple of types and aligned arguments. :rtype: `Tuple[Tuple[str, ...], Tuple[Any, ...]]` .. doctest:: >>> from eth_utils import get_aligned_abi_inputs >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 'name', ... 'type': 'string' ... }, ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_aligned_abi_inputs(abi, ('myName', 123)) (('string', 'uint256'), ('myName', 123)) rVc3.K|] }|dywr r")r#r$rs r%r&z)get_aligned_abi_inputs..Ws -0OCK ( r'c32K|]}t|ywr)r[)r#r$s r%r&z)get_aligned_abi_inputs..\s C$ Cr^c3:K|]\}}t||ywr)r*)r#r$args r%r&z)get_aligned_abi_inputs..]s# S S# & r.) rWr rr r0r5rrr6rr8)rJrabi_element_inputss ` r%get_aligned_abi_inputsr'sV&k2h|4koohPR6ST/3;;/ 4F    C0B CC_  2OD   rAct|ttt|j dgDcgc]}|j ddc}Scc}w)a Return names for each input from the function or event ABI. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: Names for each input in the function or event ABI. :rtype: `List[Optional[str]]` .. doctest:: >>> from eth_utils import get_abi_input_names >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_abi_input_names(abi) ['s'] rVr!N)rWr rr r0rJrs r%get_abi_input_namesrdsP:&k2. "0MN     Act|ttt|j dgDcgc] }t |c}Scc}w)a Return types for each input from the function or event ABI. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: Types for each input in the function or event ABI. :rtype: `List[str]` .. doctest:: >>> from eth_utils import get_abi_input_types >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_abi_input_types(abi) ['uint256'] rV)rWr rr r0r\rs r%rnrnsJ:&k2. "0MN   #  A ct|ttt|j dgDcgc]}|j ddc}Scc}w)a Return names for each output from the ABI element. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: Names for each function output in the function ABI. :rtype: `List[Optional[str]]` .. doctest:: >>> from eth_utils import get_abi_output_names >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [ ... { ... 'name': 'name', ... 'type': 'string' ... }, ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_abi_output_names(abi) ['name', 's'] rMr!N)rRr rr r0rs r%get_abi_output_namesrsQL{+.  20NO     rct|ttt|j dgDcgc] }t |c}Scc}w)a Return types for each output from the function ABI. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: Types for each function output in the function ABI. :rtype: `List[str]` .. doctest:: >>> from eth_utils import get_abi_output_types >>> abi = { ... 'constant': False, ... 'inputs': [ ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'name': 'f', ... 'outputs': [ ... { ... 'name': 'name', ... 'type': 'string' ... }, ... { ... 'name': 's', ... 'type': 'uint256' ... } ... ], ... 'payable': False, ... 'stateMutability': 'nonpayable', ... 'type': 'function' ... } >>> get_abi_output_types(abi) ['string', 'uint256'] rM)rRr rr r0r\rs r%get_abi_output_typesrsKN{+.  20NO   #  rfunction_signaturec@t|jddddS)a Return the 4-byte function selector from a function signature string. :param function_signature: String representation of the function name and arguments. :type function_signature: `str` :return: 4-byte function selector. :rtype: `bytes` .. doctest:: >>> from eth_utils import function_signature_to_4byte_selector >>> function_signature_to_4byte_selector('myFunction()') b'\xc3x\n:'  rtextNrreplace)rs r%$function_signature_to_4byte_selectorrs$ )11#r: ;BQ ??rAc.t|}t|S)a Return the 4-byte function signature of the provided function ABI. :param abi_element: ABI element. :type abi_element: `ABIElement` :return: 4-byte function signature. :rtype: `bytes` .. doctest:: >>> from eth_utils import function_abi_to_4byte_selector >>> abi_element = { ... 'type': 'function', ... 'name': 'myFunction', ... 'inputs': [], ... 'outputs': [] ... } >>> function_abi_to_4byte_selector(abi_element) b'\xc3x\n:' )rrr)rJrs r%function_abi_to_4byte_selectorrs**+6 /0B CCrAevent_signaturec:t|jddS)a Return the 32-byte keccak signature of the log topic for an event signature. :param event_signature: String representation of the event name and arguments. :type event_signature: `str` :return: Log topic bytes. :rtype: `bytes` .. doctest:: >>> from eth_utils import event_signature_to_log_topic >>> event_signature_to_log_topic('MyEvent()') b'M\xbf\xb6\x8bC\xdd\xdf\xa1+Q\xeb\xe9\x9a\xb8\xfd\xedb\x0f\x9a\n\xc21B\x87\x9aO\x19*\x1byR\xd2' rrrr)rs r%event_signature_to_log_topicr2s ..sB7 88rA event_abic.t|}t|S)aA Return the 32-byte keccak signature of the log topic from an event ABI. :param event_abi: Event ABI. :type event_abi: `ABIEvent` :return: Log topic bytes. :rtype: `bytes` .. doctest:: >>> from eth_utils import event_abi_to_log_topic >>> abi = { ... 'type': 'event', ... 'anonymous': False, ... 'name': 'MyEvent', ... 'inputs': [] ... } >>> event_abi_to_log_topic(abi) b'M\xbf\xb6\x8bC\xdd\xdf\xa1+Q\xeb\xe9\x9a\xb8\xfd\xedb\x0f\x9a\n\xc21B\x87\x9aO\x19*\x1byR\xd2' )rrr)rrs r%event_abi_to_log_topicrDs*'y1O ' 88rA)5 collectionsrcollections.abcrrrr2r3rEr@rrr r eth_typingr r r rrrrrreth_utils.typesrcryptorr6r+rbr/rRrWrr\rrrxr{rrrrlistrrnrrbytesrrrrr"rAr%rs:       . .+..5c?.bCE#sTz/,BT,I" J 4  : $ -<$sCx.83>-3-`-*--`DDCDHZJ0> 0> . ;.;hFQ 0>f880E805S5Xh-?5.oo C=4 o38nt#o 38_ od::38_wsCx'88: 5c?E#s(O +,:z!Z!Dt4D!H!Z!DI!H*j*T#*5E*Z+j+T#Y+\@S@U@$D DuD29#9%9$9h959rA