# ETH Transactions Storage

> Self-hosted Ethereum indexer storing native ETH and ERC-20 transfers in PostgreSQL with a read-only PostgREST API and optional address filtering.

- **Category:** Blockchain
- **Licence:** GPL-3.0
- **Latest version:** v2.5.0
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker Compose, Systemd
- **Tags:** PostgreSQL, REST API, Ethereum, Web3, Docker, Open Source, Python, Self Hosted, Postgrest, Geth, Blockchain Indexer, Erc20, Transaction History, Nethermind, Besu, Erigon, Ethereum Transactions, Cryptocurrency Wallet, Address Indexer, Ethereum Indexer

## Description

This self-hosted Ethereum transaction indexer serves wallets, block explorers, accounting tools, and compliance systems needing per-address transaction history. It connects to any Ethereum execution client — Geth, Nethermind, Besu, or Erigon — via HTTP, WebSocket, or IPC, parses token and ether transfers, and stores them in a PostgreSQL table. A bundled PostgREST instance exposes the data as a read-only REST API supporting filters, sort order, and page navigation, eliminating the need for custom API code. An optional address filter lets operators store only transfers involving a known address list, dramatically reducing disk usage. The project provides a Docker Compose stack with PostgreSQL, PostgREST, the indexer, and an optional Geth dev node, a manual installation guide with systemd units, and a published multi-architecture container image on ghcr.io. The indexer is written in Python using web3.py and psycopg2, and is licensed under GPL-3.0. ADAMANT runs it in production for its wallets, but no ADAMANT components are required to operate it.

## Links

- [Homepage](https://github.com/adamant-im/eth-transactions-storage)
- [Website](https://eth-indexer.docs.adamant.im)
- [Docker](ghcr.io/adamant-im/eth-transactions-storage)
- [GitHub Repository](https://github.com/Adamant-im/ETH-transactions-storage)
- [Docker Image (GHCR)](https://github.com/Adamant-im/ETH-transactions-storage/pkgs/container/eth-transactions-storage)
- [REST API Reference](https://eth-indexer.docs.adamant.im/reference/api)
- [Database and Indexes Reference](https://eth-indexer.docs.adamant.im/reference/database)
- [Docker Image Reference](https://eth-indexer.docs.adamant.im/reference/docker-image)
- [Used by ADAMANT](https://eth-indexer.docs.adamant.im/project/adamant)
- [Contributing and Releases](https://eth-indexer.docs.adamant.im/project/contributing)

---
Source: https://selfhost.directory/project/eth-transactions-storage