Module logs 

Re-exports

use super::MAX_CONCURRENT_RPC_REQUESTS; 🔒

use crate::args::encode_event_topic; 🔒

use alloy_consensus::BlockHeader; 🔒

use alloy_dyn_abi::EventExt; 🔒

use alloy_dyn_abi::Specifier; 🔒

use alloy_ens::NameOrAddress; 🔒

use alloy_json_abi::Event; 🔒

use alloy_json_rpc::RpcError; 🔒

use alloy_network::AnyNetwork; 🔒

use alloy_network::BlockResponse; 🔒

use alloy_network::Network; 🔒

use alloy_primitives::Address; 🔒

use alloy_primitives::B256; 🔒

use alloy_primitives::TxHash; 🔒

use alloy_provider::Provider; 🔒

use alloy_rpc_types::BlockId; 🔒

use alloy_rpc_types::BlockNumberOrTag; 🔒

use alloy_rpc_types::Filter; 🔒

use alloy_rpc_types::FilterBlockOption; 🔒

use alloy_rpc_types::Log; 🔒

use alloy_rpc_types::Topic; 🔒

use clap::Parser; 🔒

use eyre::Result; 🔒

use foundry_cli::opts::RpcOpts; 🔒

use foundry_cli::utils; 🔒

use foundry_cli::utils::LoadConfig; 🔒

use foundry_common::fmt::UIfmt; 🔒

use foundry_common::fmt::format_token; 🔒

use foundry_common::shell; 🔒

use futures::FutureExt; 🔒

use futures::StreamExt; 🔒

use futures::TryStreamExt; 🔒

use futures::future::Either; 🔒

use std::fmt::Write as _; 🔒

use std::io::Write as _; 🔒

use std::str::FromStr; 🔒

use tokio::signal::ctrl_c; 🔒

Structs

LogQueryArgs

Arguments shared by commands that query logs with eth_getLogs.

LogsArgs

CLI arguments for cast logs.

Functions

build_filter 🔒

Builds a Filter by first trying to parse the sig_or_topic as an event signature. If successful, topics_or_args is parsed as indexed inputs and converted to topics. Otherwise, sig_or_topic is prepended to topics_or_args and used as raw topics.

convert_block_number 🔒

event_topics 🔒

Encodes args as the indexed topics of event; empty arguments match any value. Anonymous events have no selector topic, so their indexed inputs start at the first topic.

format_log 🔒

format_log_params 🔒

Formats decoded event parameters in declaration order.

format_logs 🔒

get_logs_bisecting 🔒

Fetches logs for the inclusive [from, to] range, recursively bisecting on failure.

get_logs_chunked 🔒

Retrieves logs, splitting the request into fixed-size block chunks when needed.

get_logs_chunked_concurrent 🔒

Retrieves logs for the inclusive [from, to] range using concurrent chunked requests.

is_range_limit_error 🔒

Returns true if err is a provider range/result-size limit that retrying over a smaller range can fix. Network, auth, rate-limit, and malformed-response errors return false.

raw_topics 🔒

Parses raw topic hashes; empty topics match any value.

resolve_block_range 🔒

Resolves the filter’s block range to concrete block numbers.

resolve_block_tag 🔒

Resolves a [BlockNumberOrTag] to a concrete block number, querying the provider for tags.