Blockchain

Contracts

High-performance interface for querying EVM smart contracts with type-safe Rust abstractions. Supports token metadata, DEX pools, and DeFi protocols through efficient batch operations.

Base (Multicall3)

Batches multiple contract calls into a single RPC request using Multicall3 (0xcA11bde05977b3631167028862bE2a173976CA11).

• Always uses allow_failure: true for partial success and detailed errors
• Executes atomically in the same block
• Errors: RpcError (network issues), AbiDecodingError (decode failures)

ERC20

Inherits from BaseContract to leverage Multicall3 for efficient batch operations. Fetches token metadata with robust handling for non-standard implementations.

Methods:

• fetch_token_info: Single token metadata (uses multicall internally for name, symbol, decimals)
• batch_fetch_token_info: Multiple tokens in one multicall (3 calls per token)
• enforce_token_fields: Validate non-empty name/symbol

Error Types:

1. CallFailed - Contract missing or function not implemented → Skip token
2. DecodingError - Raw bytes instead of ABI encoding (e.g., 0x5269636f...) → Skip token
3. EmptyTokenField - Function returns empty string → Skip if enforced

Best Practices:

• Skip pools with any token errors
• raw_data field preserves original response for debugging
• Non-standard tokens often have other issues (transfer fees, rebasing)