(iRP:ddlmZmZmZmZmZmZmZmZm Z m Z ddl m Z m Z ddlmZmZmZmZddlmZddlmZddlmZmZddlmZmZddlmZdd lm Z dd l!m"Z"dd l#m$Z$m%Z%dd l&m'Z'dd l(m)Z)m*Z*m+Z+ddl,m-Z-ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7ddl8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@ddlAmBZBmCZCmDZDmEZEddlFmGZGmHZHmIZImJZJer ddlKmLZLddlMmNZNGdde2ZOGdde3eOZPGdde4ZQGdde5eQZRGdde/ZSGdd e0ZTGd!d"e1ZUy#)$) TYPE_CHECKINGAnyCallableDictIterableListOptionalSequenceTypecast)ABIChecksumAddress)abi_to_signature combomethodfilter_abi_by_typeget_abi_input_names)partial)HexBytes)fallback_func_abi_existsreceive_func_abi_exists) FallbackFn ReceiveFn)Self)parse_block_identifier)PropertyCheckingFactory)EventFilterBuilderget_event_data) LogFilter) normalize_abinormalize_addressnormalize_bytecode)fill_transaction_defaults) BaseContractBaseContractCallerBaseContractConstructorBaseContractEventBaseContractEventsBaseContractFunctionBaseContractFunctionsNonExistentFallbackFunctionNonExistentReceiveFunction)build_transaction_for_functioncall_contract_functionestimate_gas_for_functionfind_events_by_identifierfind_functions_by_identifierget_event_by_identifierget_function_by_identifiertransact_with_contract_function)Web3AttributeError Web3TypeErrorWeb3ValidationErrorWeb3ValueError)BlockIdentifier EventData StateOverrideTxParams)ENS)Web3ceZdZUded<e ddeeeefdee dee dee de e f d Z eddd ddd deeeefdee de d eed eeedef dZedefdZy) ContractEventr=w3Nargument_filters from_blockto_block block_hashreturnc j |8t  t fd|jDs t dj ||||}j jj|}t fd|D}j ||}t|d} t| d} | S)a/ Get events for this contract instance using eth_getLogs API. This is a stateless method, as opposed to create_filter. It can be safely called against nodes which do not provide eth_newFilter API, like Infura nodes. If there are many events, like ``Transfer`` events for a popular token, the Ethereum node might be overloaded and timeout on the underlying JSON-RPC call. Example - how to get all ERC-20 token transactions for the latest 10 blocks: .. code-block:: python from = max(my_contract.web3.eth.block_number - 10, 1) to = my_contract.web3.eth.block_number events = my_contract.events.Transfer.get_logs(from_block=from, to_block=to) for e in events: print(e["args"]["from"], e["args"]["to"], e["args"]["value"]) The returned processed log values will look like: .. code-block:: python ( AttributeDict({ 'args': AttributeDict({}), 'event': 'LogNoArguments', 'logIndex': 0, 'transactionIndex': 0, 'transactionHash': HexBytes('...'), 'address': '0xF2E246BB76DF876Cef8b38ae84130F4F55De395b', 'blockHash': HexBytes('...'), 'blockNumber': 3 }), AttributeDict(...), ... ) See also: :func:`web3.middleware.filter.LocalFilterMiddleware`. :param argument_filters: Filter by argument values. Indexed arguments are filtered by the node while non-indexed arguments are filtered by the library. :param from_block: block number or "latest", defaults to "latest" :param to_block: block number or "latest". Defaults to "latest" :param block_hash: block hash. block_hash cannot be set at the same time as ``from_block`` or ``to_block`` :yield: Tuple of :class:`AttributeDict` instances c3&K|]}|v ywN).0argevent_arg_namess G/var/www/br/venv/lib/python3.12/site-packages/web3/contract/contract.py z)ContractEvent.get_logs..sQ#so-QszaWhen filtering by argument names, all argument names must be present in the contract's event ABI.c3`K|]%}tjj|'ywrH)rr@codec)rJentry event_abiselfs rMrNz)ContractEvent.get_logs..s' @EN477==)U ; s+.c |dS)NlogIndexrIes rMz(ContractEvent.get_logs..s !J-)keyc |dS)N blockNumberrIrVs rMrXz(ContractEvent.get_logs..s -8HrY) _get_event_abirallkeysr6_get_event_filter_paramsr@ethget_logstuple"_process_get_logs_argument_filterssorted) rSrArBrCrD_filter_paramslogsall_event_logs filtered_logs sorted_logsrRrLs ` @@rMrbzContractEvent.get_logsjs@'')  '1)2Z_-Z?+ Z X& Z )  ZZx6:04$,-1*.#4S>2_-  "  /* #' 80rYr?c :eZdZ ddedddeeddffd ZxZS) ContractEventsNrsr@r=rlrEc2t|||t|yrH)super__init__r?)rSrsr@rl __class__s rMrzContractEvents.__init__s b-9rYrH)r{r|r}r r rr __classcell__rs@rMrrs5IM::":-5o-F: ::rYrc eZdZUded< ddeedeedeedeede f d Z ddeede fd Z ddeedeedeede fd Zddeedefd Ze dd edddeeddfdZe dd edddeeddfdZy)ContractFunctionr=r@N transactionblock_identifierstate_overrideccip_read_enabledrEc \|j|}t|j|}t|j}t |j|j |j||||j|j|||jg |jxsdi|jxsiS)aE Execute a contract function call using the `eth_call` interface. This method prepares a ``Caller`` object that exposes the contract functions and public variables as callable Python functions. Reading a public ``owner`` address variable example: .. code-block:: python ContractFactory = w3.eth.contract( abi=wallet_contract_definition["abi"] ) # Not a real contract address contract = ContractFactory("0x2f70d3d26829e412A602E83FE8EeBF80255AEeA5") # Read "owner" public variable addr = contract.functions.owner().call() :param transaction: Dictionary of transaction info for web3 interface :param block_identifier: Block number or string "latest", "pending", "earliest" :param state_override: Dictionary of state override values :param ccip_read_enabled: Enable CCIP read operations for the call :return: ``Caller`` object that has contract public functions and variables exposed as Python methods rI) _get_call_txparamsrr@rrsr-rl_return_data_normalizers contract_abi decode_tuplesargskwargs)rSrrrrcall_transactionblock_idabi_element_identifiers rMcallzContractFunction.callsD 22;?)$''3CD!1$((!;% GG LL  ) ) "      HH      YY_" kkR  rYc|j|}t|j}t|j|j |||j |jg|jxsdi|jxsiSNrI) _transactrrsr3rlr@rrr)rSrsetup_transactionrs rMtransactzContractFunction.transact3sv NN;7!1$((!;. LL GG "     HH  YY_"  kkR  rYc |j|}t|j}t|j|j |||j |j||g|jxsdi|jxsiSr) _estimate_gasrrsr.rlr@rrr)rSrrrrrs rM estimate_gaszContractFunction.estimate_gasBs !..{;!1$((!;( LL GG "     HH    YY_"  kkR  rYc|j|}t|j}t|j|j |||j |jg|jxsdi|jxsiSr) _build_transactionrrsr,rlr@rrr)rSrbuilt_transactionrs rMbuild_transactionz"ContractFunction.build_transactionWsx 33K@!1$((!;- LL GG "     HH  YY_"  kkR  rYrsrlc |r=t|r2td|d}tjd|||t|St tt S)Nfallbackrr@rrlrrs)rrrfactoryrr r*)rsr@rl fallback_abis rMget_fallback_functionz&ContractFunction.get_fallback_functionfsc +C0-j#>qAL#++ '1 , $&A&CDDrYc |r=t|r2td|d}tjd|||t|St tt S)Nreceiverr)rrrrrr r+)rsr@rl receive_abis rMget_receive_functionz%ContractFunction.get_receive_functionxsc *3/,Y 6 6 p  HX$6  (  "+/6:26  h' #?3 !/   *  Xh-?  8  .2E E E/*E  EE".2D D D/*D  DDrYrc FeZdZ d dedddeedeeddf fd ZxZS) ContractFunctionsNrsr@r=rlrrEc4t|||t||yrH)rrr)rSrsr@rlrrs rMrzContractFunctions.__init__s b"2G]KrY)NF) r{r|r}r r rrrrrs@rMrrsU .2(- L L L/* L  ~ L  LLrYrc ^eZdZUded<dZeed<dZded<dZeed<dde e d dfd Z e dddd e e d ed eefd Ze ded ed dfdZededdde dedefd edf dZededde d dfdZededdde dedefd edf dZededde d dfdZy)Contractr=r@N functionsContractCallercallereventsrlrEc|j}| td|r%ttd|j||_|j s t dt|j||j |j|_ t|j||j |j|j|_ t|j||j |_tj!|j|t"|j |_tj'|j|t"|j |_y)zu Create a new smart contract proxy object. :param address: Contract address as 0x hex string NzwThe `Contract` class has not been initialized. Please use the `web3.contract` interface to create your contract class.r<z;The address argument is required to instantiate a contract.rrcontract_functions)r@r4r r _ensrlr5rrsrrrrrrrrrrrr)rSrl_w3s rMrzContract.__init__s gg ;$K  ,T%-BGLDL||M + HHc4<;K   rYfns identifierct||SrH)r2)rrrs rMr2z#Contract.get_function_by_identifier#s*#z::rYr?c(t||||tSrH)r/r?rs rMr/z"Contract.find_events_by_identifier)s) "g~}  rYct||SrH)r1)rSrrs rMr1z Contract.get_event_by_identifier5s'vz::rYrH)r{r|r}r~rrrrrr rr classmethodrrr rrrrr rrr0r r2r/r1rIrYrMrrsJ#'I '#F #"FN!+  9+ T+ Z5966%-c]6EH6 d66p S Ss S7L S S       !  !c*   !    ;-.;yy)Nr)rlr)rrr) rrrsr _functions__iter__r call_functionsetattrrr) rSrsr@rlrrrrrfn caller_methodrs rMrzContractCaller.__init__@s b'G 88" !)%6WM&"1;;DO(113 M '&& +%5&7 ! c"";";M M M! M h' M * M$D>M ~M%%67M MF+/,0,0  h' * $D>    rYrceZdZUded<ed deedefdZed deedefdZ e d deedee de fd Z y) rr=r@NrrEcj|jjj|j|SrH)r@rasend_transaction_get_transaction)rSrs rMrzContractConstructor.transactys&ww{{++D,A,A+,NOOrYcP|j|}t|j|S)zB Build the transaction dictionary without sending )rr"r@)rSrrs rMrz%ContractConstructor.build_transaction}s' !33K@(2CDDrYrcr|j|}|jjj||S)N)r)rr@rar)rSrrs rMrz ContractConstructor.estimate_gass3 ((5 ww{{'' FV'WWrYrH)NN) r{r|r}r~rr r;rrrr8rrrIrYrMrrusJPHX$6P(PPEXh-?E8EE+/6:Xh'X#?3X XXrYrN)Vtypingrrrrrrr r r r eth_typingr r eth_utilsrrrreth_utils.toolzrhexbytesrweb3._utils.abirr#web3._utils.abi_element_identifiersrrweb3._utils.compatrweb3._utils.contractsrweb3._utils.datatypesrweb3._utils.eventsrrweb3._utils.filtersrweb3._utils.normalizersrr r!web3._utils.transactionsr"web3.contract.base_contractr#r$r%r&r'r(r)r*r+web3.contract.utilsr,r-r.r/r0r1r2r3web3.exceptionsr4r5r6r7 web3.typesr8r9r:r;ensr<web3r=r?rrrrrrrIrYrMrs            G%GT:' 6:QD+QDhL-.>?Lc;|c;L6 '6 rX1XrY