Metadata Tables

AddressMeta Table


Table Name: AddressMeta

Description: Comprehensive address metadata.

Key: Address

Value: AddressMetadata

Fields:

  • entity_name, nametag: Entity name and alias.
  • labels: List of address labels.
  • address_type: Type of address (DEX, CEX, Aggregator...).
  • contract_info: ContractInfo - Details about the contract if the address is a smart contract.
  • ens: Optional ENS name associated with the address.
  • social_metadata: Socials - Links to social media profiles related to the entity.

Searcher Info Tables


Table Names: SearcherEOAs and SearcherContracts

Description: Searcher EOA & Contract Metadata.

Key: Address

Value: SearcherInfo

Fields:

  • fund: Fund the searcher address is associated with.
  • mev_count: TollByType - MEV bundle count by type.
  • pnl: TollByType - Aggregate Pnl by MEV type.
  • gas_bids: TollByType - Gas bids by MEV type.
  • builder: If the searcher is vertically integrated, the builder's address.
  • config_labels: Types of MEV this searcher address captures. This is set at the config level in config/searcher_config.toml.
  • sibling_searchers: Addresses of searcher accounts associated with this address. This is needed so that we can accurately calculate PnL when searchers send their profit to a bank address or on of their other searcher addresses.

Builder Table


Table Name: Builder

Description: Contains information about Ethereum block builders.

Key: Address (Coinbase transfer address)

Value: BuilderInfo

Fields:

  • name, fund, pub_keys: Basic identification and operational details.
  • searchers_eoas, searchers_contracts: Lists of the builder's searcher addresses.
  • ultrasound_relay_collateral_address: Address used to deposit collateral for the optimistic ultrasound relay.