hub / github.com/SorellaLabs/brontes

github.com/SorellaLabs/brontes @main

Chat with this repo

repository ↗ · DeepWiki ↗ · + Follow

3,217 symbols 9,861 edges 468 files 452 documented · 14%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Brontes

Brontes – Illuminate to Eliminate

Install | User Book | Crate Docs | Methodology

Why Brontes?

Brontes is a blockchain analytics pipeline built on top of Reth. It addresses a critical challenge in blockchain research: the overwhelming flood of data and tedious preprocessing that often derail researchers from their core focus.

Key features:

Transforms raw Ethereum data into a structured, analyzable format
Enhances analysis with off-chain data (metadata, CEX prices, p2p data...)
Provides a modular framework to easily implement user-defined inspectors for custom analytics

Blockchain data analysis, especially at the trace level, can overwhelm even seasoned researchers. While a few masochists might find satisfaction in the chore of data preprocessing and normalization, most of us are captivated by the intellectual challenge of crafting innovative analytical techniques.

Our Inspector Framework allows you to focus on developing and applying novel methodologies. By eliminating initial hurdles, Brontes frees you to immerse yourself in creative analysis rather than getting bogged down in preprocessing.

Who is this for?

Brontes is designed for:

Blockchain researchers and data scientists
MEV analysts and strategists
DeFi protocol developers
Anyone working with large-scale Ethereum data

Extension points exported contracts — how you extend this code

MultiCallFrameClassifier (Interface)

for multi call-frame classifier [11 implementers]

crates/brontes-classifier/src/multi_frame_classification/mod.rs

TokenAccounting (Interface)

apply's the given actions token deltas to the map; [11 implementers]

crates/brontes-types/src/normalized_actions/accounting.rs

TableObject (Interface)

Implement this to be able to decode data values [5 implementers]

crates/brontes-database/libmdbx-rs/src/codec.rs

Inspector (Interface)

(no doc) [9 implementers]

crates/brontes-inspect/src/lib.rs

ProtocolState (Interface)

(no doc) [2 implementers]

crates/brontes-pricing/src/types.rs

Hook (Interface)

(no doc) [1 implementers]

crates/brontes-metrics/src/prometheus_exporter.rs

Processor (Interface)

(no doc) [1 implementers]

crates/bin/src/executors/processors/mod.rs

ActionCollection (Interface)

(no doc)

crates/brontes-classifier/src/lib.rs

Core symbols most depended-on inside this repo

map

called by 868

crates/brontes-types/src/tree/util/scope/core.rs

iter

called by 738

crates/brontes-database/libmdbx-rs/src/cursor.rs

clone

called by 665

crates/brontes-core/src/decoding/parser.rs

to_string

called by 331

crates/brontes-types/src/block_metadata/relays-openapi/src/models/order_by.rs

into_iter

called by 270

crates/brontes-database/libmdbx-rs/src/cursor.rs

len

called by 252

crates/brontes-types/src/channel_alerts.rs

collect

called by 206

crates/brontes-types/src/tree/mod.rs

into_iter

called by 184

crates/brontes-types/src/db/address_to_protocol_info.rs

Shape

Method 2,035

Function 575

Class 457

Enum 81

Interface 69

Languages

Rust100%

Python1%

Modules by API surface

crates/brontes-database/libmdbx-rs/src/environment.rs69 symbols

crates/brontes-database/brontes-db/src/libmdbx/libmdbx_read_write.rs67 symbols

crates/brontes-database/brontes-db/src/clickhouse/db_client.rs59 symbols

crates/brontes-database/libmdbx-rs/src/transaction.rs56 symbols

crates/brontes-pricing/src/graphs/subgraph.rs48 symbols

crates/brontes-types/src/normalized_actions/mod.rs47 symbols

crates/brontes-database/libmdbx-rs/src/cursor.rs45 symbols

crates/brontes-database/brontes-db/src/clickhouse/middleware.rs44 symbols

crates/reth-tracing-ext/src/reth_tracer/types.rs42 symbols

crates/brontes-inspect/src/mev_inspectors/sandwich/mod.rs40 symbols

crates/brontes-types/src/db/block_analysis.rs39 symbols

crates/brontes-types/src/tree/root.rs38 symbols

For agents

$ claude mcp add brontes \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact