Skip to content

voyager-state-module-ethereum

This module provides state querying functionality for the Union IBC stack deployed on an EVM-compatible chain. IBC state is read via eth_call on the core contract, and queries are performed via eth_getLogs.

  • rpc_url: String. The Ethereum JSON-RPC RPC url for this EVM-compatible chain.
  • ibc_handler_address: H160. The address of the deployed IBCHandler.sol contract on this chain. Canonical deployments can be found here.
  • max_query_window: Option. The maximum query window to use when calling the RPC with eth_getLogs. If not provided, the full chain will be queried (i.e. earliest..latest), which is not supported by many RPC providers.
  • max_cache_size: u32. The cache size to use for RPC-level caching via alloy’s CacheLayer. Defaults to 0 if not provided.

This module only provides state for the ibc-union IBC specification, and the EVM IBC Interface.