Skip to main content
EVM chains have different block intervals depending on the network (Ethereum mainnet ~12 seconds/block), supporting Ethereum, BSC, Base, Polygon (Matic), Optimism and other networks, sharing a unified Protobuf Schema. Schema Repository: github.com/chainstream-io/streaming_protobuf/evm

Message Types Overview

EVM Streams provides the following message types:

Block-Level Data

Each block contains BlockHeader with core fields: BlockMessage also contains:

Transaction-Level Data

TransactionHeader — Core Transaction Metadata

ReceiptHeader — Execution Result

TransactionFee — Fee Details

Calls — Internal Call Traces

Contains all nested contract calls, each call includes:
  • From, To: Caller and callee
  • Input, Output: Input and output data
  • GasUsed: Gas consumption
  • Opcode: Operation code (CALL/DELEGATECALL/STATICCALL)
  • Signature: Function signature
  • Logs: Event logs
  • StateChanges: State changes
  • ReturnValues: Return values

Balance Updates

ERC-20/721/1155 Token balance changes:

Transfer Data

TransfersMessage provides EVM chain transfer information (Topic: {chain}.v1.transfers.proto).

TransfersMessage Structure

Transfer Structure

TokenInfo Structure

Supported Token Standards


DEX Data

TradeEvents provides DEX trade data (Topic: {chain}.dex.trades).

TradeEvent Structure

Trade Core Fields

TradeProcessed Enhanced Fields

.processed topic includes additional fields:

DexPoolEvent - Liquidity Pools

DexPoolEvents provides liquidity pool events (Topic: {chain}.dex.pools).

EVM Chain Characteristics

Gas & EIP-1559 Fee Model

EVM uses Gas mechanism to measure computational resources. EIP-1559 introduced dynamic BaseFee adjustment and fee burning, transaction fees split into:
  • Validator reward: MinerReward
  • Burnt portion: Burnt

Layer 2 Support

EVM Streams provides dedicated fields for L2 chains:

Topic → Message Type Mapping

Replace {chain} with eth or bsc. E.g., eth.dex.trades, bsc.tokens.processed.

Code Examples

Python Example: Consume DEX Trade Data

JavaScript Example


Concepts & Integration Guide

Kafka Streams integration basics

Solana Streams

Solana high-throughput data streams

TRON Streams

TRON network data streams

WebSocket Real-time Data

WebSocket integration