UpstreamRPCProviderStatistics

Documentation for eth_defi.provider.rpc_proxy.UpstreamRPCProviderStatistics Python class.

class UpstreamRPCProviderStatistics

Bases: object

Per-provider statistics collected during proxy operation.

Tracks request counts, failure counts, and method-level breakdowns for each upstream RPC provider. Instances are keyed by provider URL in RPCProxy.provider_stats.

Attributes summary

url
request_count
failure_count
last_failure
method_counts
method_failure_counts
error_replies

Methods summary

__init__(url[, request_count, ...])
record_failure(method, error_summary[, ...])	Record a failed request to this provider.
record_request(method)	Record a request being sent to this provider.

__init__(url, request_count=0, failure_count=0, last_failure=None, method_counts=<factory>, method_failure_counts=<factory>, error_replies=<factory>, _lock=<factory>)

Parameters

• url (str) –

• request_count (int) –

• failure_count (int) –

• last_failure (Optional[datetime.datetime]) –

• method_counts (dict[str, int]) –

• method_failure_counts (dict[str, int]) –

• error_replies (list[dict]) –

• _lock (_thread.lock) –

Return type

None

record_failure(method, error_summary, http_status=None, max_error_replies=100)

Record a failed request to this provider.

Parameters

• method (str) –

• error_summary (str) –

• http_status (Optional[int]) –

• max_error_replies (int) –

Return type

None

record_request(method)

Record a request being sent to this provider.

Parameters

method (str) –

Return type

None