This module walks the Ethereum blockchain, keeping track of the latest block. It uses a web3 provider as a data source and will continuously poll for the next block.

const HttpProvider = require('ethjs-provider-http')
const BlockTracker = require('eth-block-tracker')

const provider = new HttpProvider('https://mainnet.infura.io')
const blockTracker = new BlockTracker({ provider })
blockTracker.on('block', console.log)
blockTracker.start()

creates a new block tracker with provider as a data source and pollingInterval (ms) timeout between polling for the latest block.

synchronous returns the current block. may be null.

console.log(blockTracker.getCurrentBlock())

Start walking from the fromBlock (default: 'latest') forward. fromBlock should be a number as a hex encoded string.

blockTracker.start()

blockTracker.start({ fromBlock: '0x00' })

Stop walking the blockchain.

blockTracker.stop()

The block event is emitted for every block in order. Use this event if you want to operate on every block without missing any.

blockTracker.on('block', (newBlock) => console.log(newBlock))

The latest event is emitted for every that is detected to be the latest block. This means skipping a block if there were two created since the last polling period. Use this event if you don't care about stale blocks.

blockTracker.on('latest', (newBlock) => console.log(newBlock))

The sync event is emitted the same as "latest" but includes the previous block.

blockTracker.on('sync', ({ newBlock, oldBlock }) => console.log(newBlock, oldBlock))

Does not currently handle forks.