Need help with ethereumjs-blockchain?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

119 Stars 60 Forks 245 Commits 0 Opened issues


Project is in active development and has been moved to the EthereumJS VM monorepo.

Services available


Need anything else?

Contributors list


NPM Package Actions Status Coverage Status Gitter or #ethereumjs on freenode

A module to store and interact with blocks.


npm install ethereumjs-blockchain




The following is an example to iterate through an existing Geth DB (needs

to be installed separately).

This module performs write operations. Making a backup of your data before trying it is recommended. Otherwise, you can end up with a compromised DB state.

const level = require('level')
const Blockchain = require('ethereumjs-blockchain').default
const utils = require('ethereumjs-util')

const gethDbPath = './chaindata' // Add your own path here. It will get modified, see remarks. const db = level(gethDbPath)

new Blockchain({ db: db }).iterator( 'i', (block, reorg, cb) => { const blockNumber = utils.bufferToInt(block.header.number) const blockHash = block.hash().toString('hex') console.log(BLOCK ${blockNumber}: ${blockHash}) cb() }, err => console.log(err || 'Done.'), )


is also doing write operations on the DB for safety reasons only run this on a copy of your database, otherwise this might lead to a compromised DB state.


See our organizational documentation for an introduction to

as well as information on current standards and best practices.

If you want to join for work or do improvements on the libraries have a look at our contribution guidelines.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.