README.md

Ethereum logs extractor

This application extracting EVM logs from Erigon database(libmdbx) and store it Parquet binary format data file. Example: asset/sepolia_10000_500000_all_logs.parquet

Parquet table schema:

message schema {
    REQUIRED INT64 block_n;
    REQUIRED INT32 tx_n; -- transaction index at block
    REQUIRED BYTE_ARRAY contract; -- contract address
    REQUIRED INT32 op_code; -- EVM opcode LOG0/LOG1/LOG2/LOG3
    OPTIONAL BYTE_ARRAY topic0;
    OPTIONAL BYTE_ARRAY topic1;
    OPTIONAL BYTE_ARRAY topic2;
    OPTIONAL BYTE_ARRAY topic3;
    OPTIONAL BYTE_ARRAY data; -- log data
}

Features:

• Extract logs by block number range: from - to
• Filter logs by contract address: optional
• Execute job by rest api: api/v1/exec-job?job_id=test_1&block_number_start=10000&block_number_end=3000000

start.sh Exmaple:

export DB_PATH=/home/art/dev/sepolia-chaindata/
export HTTP_ADDRESS=0.0.0.0
export HTTP_PORT=9090
export RESULT_PATH=/tmp

./erigon_db_reader