Ethscan

Multi-chain EVM transfer scanner. Query direct transfers between any two addresses across Blockscout-hosted chains in parallel.

Install

# From Jenkins build artifacts
./scripts/install.sh ./bin/ethscan

# Or build locally
make deps build
sudo make install

Usage

# Scan all chains (default since 1970)
ethscan 0xFROM 0xTO

# Since a date or month name (current year)
ethscan 0xFROM 0xTO --since 2026-01-01
ethscan 0xFROM 0xTO --since january

# Limit chains for speed
ethscan 0xFROM 0xTO --since january --chains arbitrum,base,ethereum

# JSON output
ethscan 0xFROM 0xTO --since january --json

# List supported chains
ethscan chains

Example

ethscan 0xb3ed3259256CBB21701F36AC8aE44d8E0D85b31c \
        0x0BfC43909d6B458005ef5E17317028f0CD9e24f5 \
        --since january --chains arbitrum

How it works

• Scans native ETH, internal ETH, and ERC-20 transfers via Blockscout APIs
• Queries chains concurrently (default 8 workers) with retries on rate limits
• Stops pagination early once history is older than --since
• No API keys required for Blockscout public endpoints

CI (Jenkins)

Pipeline (Jenkinsfile):

1. go test + go vet
2. Build bin/ethscan
3. Cross-compile release binaries to dist/
4. Archive artifacts

Create a Pipeline job in Jenkins pointing at https://git.aexoradao.com/epistemophiliac/Ethscan with Jenkinsfile from SCM.

Development

make deps test build

License

MIT