Explore Ethereum-like blockchain privately with your RPC URL.
- 🔒 No 3rd party services: only private RPC requests
- 💹 ETH and token balances, transaction history
- 💵 On-chain USD price conversion from oracles
- 🪶 100KB gzipped. 3 files: 1 html, 1 css, 1 js
How is this better than Etherscan?
Etherscan and other other 3rd party block explorers collect and track user data. They create logs every time someone opens an address. Private explorers allow viewing information without logging.
How is this better than Otterscan?
Otterscan does not support token balances or transfer history, which makes it limited in usefulness. ERC20 / ERC721 / ERC1155 tokens & NFTs are one of the most popular features of EVM-like blockchains. Besides that, Otterscan can only be used with one client while esplr strives to support all node types.
Can I verify all network requests?
The explorer only makes requests to specified RPC URL. To audit this, check src/App.vue,
handleConnect. It uses micro-ftch to
ensure no requests are done outside of the URL. You can add custom logging there.
How are USD prices calculated?
Chainlink EVM contract provides onchain prices. No external services are used.
Are ERC-20 tokens fully supported?
Yes. To view full token transfer history for an account, open tx Details tab. First call can take up to 50 seconds because of limitations of ETH nodes. Second call would be cached and instant.
Are ERC-721 NFTs fully supported?
Work in progress. They will be shown in UI in one of the next updates.
Which frontend libraries are used?
micro-eth-signer and micro-ftch empower data retrieval. Vue.js is used as UI framework.
To build the app and launch dev server, execute:
npm install && npm run devTo build for production:
npm install && npm run build
# Output is now in `dist/`
# Example: serve `dist/` directory using built-in Python module
cd dist && python3 -m http.server --bind 127.0.0.1The output is 3 files in dist: 1 html, 1 js, 1 css.
Esplr supports all node types. User-ran Erigon RPC node is adviced to get 100% of functionality. Reth may achieve feature parity soon. See details.
- Download Erigon and start it:
erigon --datadir=/data/erigon --prune.mode='archive' --torrent.download.rate="100mb" --http --http.api=eth,erigon,web3,net,debug,trace,txpool,ots --ws --http.corsdomain='*'- Initial sync will take 8 hours for ETH mainnet on 100Mbps connection (slower ones can still be used). After that RPC will be running on port 8545.
The RPC will be running locally at 127.0.0.1:8545. There are two ways to make it available to outside internet:
- Redirect e.g.
ethnode.comto127.0.0.1:8545- Can be achieved with NGINX:
proxy_pass http://127.0.0.1:8545 - You will probably need domain and SSL certificate. For example, if domain is
ethnode.com, you will be able to specify its RPC. - It is suggested to use basic auth (
user:[email protected]).
- Can be achieved with NGINX:
- Or, use SSH tunneling to forward port 8545 to your local machine:
ssh -L 5678:127.0.0.1:8545 [email protected]where 5678 is port on your local machine,[email protected]is user + hostname of Erigon3 server.
Some features are not present outside of Erigon. The app uses archive node API / trace_filter extensively.
- Self-hosted Erigon 3 works with
prune.mode=archivefor 100% of features - 3rd-party (infura / alchemy / quicknode) Erigon nodes have strict rate limits: tx history is not available
- Reth nodes do not have tx history because of lack of indexes. They indicated willingness to fix the issue
- Geth, Nethermind do not have proper low-resource archive mode, so they are not supported for querying tx history
Most requests are instant. Some requests, like seeing token transfer history, rely on scanning whole blockchain from scratch. This can take 10-50 seconds.
To improve this, in the future, archive node developers can add additional indexes into their software. They can also provide a new RPC method to query history. Best thing one can do is to ask for this in their bug trackers: reth, erigon.
Addons, like Trueblocks, can also speed things up. While the goal of esplr is to use "pure" archive node, we would welcome support for an easy trueblocks integration.
An archive node will need 30Mbps connection & 2.5TB NVME SSD (TLC, not QLC). Such new PC can cost $570 for 32GB RAM & 4-core CPU. Here is another $650 build with 64GB RAM & 8-core CPU.
Similar server can be rented from providers like Hetzner for $60/mo. Make sure to prohibit private IPs in firewall.
Fully validating non-archive node can have <1TB storage requirements. Check out Ress and EIP-7870.
MIT License