TrueBlocks/trueblocks-core logo

TrueBlocks/trueblocks-core

Free

The main repository for the TrueBlocks system

FreeFree tier
Type
Open Source

About TrueBlocks/trueblocks-core

TrueBlocks is a local-first tool suite for accessing blockchain data on EVM-compatible chains, particularly Ethereum mainnet. It builds the Unchained Index, a local index of address appearances that enables lightning-fast queries to transactional histories without relying on centralized APIs. Features include a command-line interface (chifra) for scraping, indexing, and querying data, an optional binary cache to accelerate RPC interactions, and advanced tools for data extraction such as retrieving all logs from a smart contract or viewing ERC-20 holdings. It also provides a simple API server (chifra serve) and supports producing reconciled bank statements and accounting exports for any token. TrueBlocks is open-source and designed for data scientists, analysts, and power users who need fast, local, and complete access to blockchain data.

Key Features

Builds the Unchained Index: local index of address appearances for lightning-fast transactional history queries
Optional binary cache to speed up RPC queries by orders of magnitude
Enhanced command-line interface (chifra) for data extraction: logs, ERC-20 holdings, etc.
Tools for producing reconciled bank statements and accounting exports for any token including ETH
API server (chifra serve) providing REST-like access to the same tools as the CLI
Fully local operation: no reliance on third-party APIs or cloud services

Pros & Cons

Pros
  • Entirely local: no dependency on third-party APIs, enhancing privacy and reliability
  • Lightning-fast access to transactional histories via the Unchained Index
  • Open-source and free to use
  • Provides both CLI and API for flexible integration
  • Advanced filtering and extraction options for data scientists
Cons
  • API server is designed for single-user environments, not cloud-scale multi-user
  • Requires command-line familiarity for full functionality
  • Setup and initial index building may take time and disk space
  • Primarily focused on Ethereum mainnet; support for other EVM chains may be limited

Best For

Data science and analytics on Ethereum transaction historiesAccounting and auditing: generate reconciled bank statements for tokens and ETHAccount history exploration: quickly retrieve all transactions for a given addressSmart contract log extraction and analysisPortfolio tracking: view all ERC-20 holdings for an account

FAQ

What is TrueBlocks?
TrueBlocks is an open-source tool that provides local access to blockchain data for EVM-compatible chains (especially Ethereum). It builds an index of address appearances called the Unchained Index to enable fast queries of transactional histories.
How do I install TrueBlocks?
Installation instructions are available on the TrueBlocks website. The project is also available on GitHub under the TrueBlocks organization.
Is TrueBlocks free?
Yes, TrueBlocks is free and open-source software.
Can I use TrueBlocks with other blockchains besides Ethereum?
TrueBlocks is designed for EVM-compatible chains, with a primary focus on Ethereum mainnet.