bitapeslabs

espo

“Explore programmable Bitcoin”

tagline, verbatim from espo.sh

espo is an explorer and indexer for Alkanes. It builds its own indices from Bitcoin block data, serves them over an RPC surface, and presents them as a block explorer covering blocks, transactions, addresses, alkanes and runes.

espo

raster
The espo mark
The espo mark

what it does

4

Modular indexer

During indexing espo assembles a per-block structure holding that block’s Alkanes traces and transactions, then passes it through modules, each of which reads it to build whatever indices that module defines. The repository ships a module for AMM data, covering OHLC series and swap trades, and one for balances, holder data, address outpoints and contract key/value stores.

RPC surface

The documentation catalogues espo’s JSON-RPC namespaces and HTTP routes with an example query and response for each. They cover Bitcoin reads and broadcast, alkane, address, outpoint, trace, holder and mempool data, AMM pools, candles and swap routing, runes and token data, and SUBFROST. Compatibility endpoints and the explorer’s own HTTP and websocket routes are documented alongside them.

Explorer interface

espo.sh presents a block explorer over the indexed data, with sections for blocks, alkanes and runes and a search field that accepts blocks, alkanes, transactions and addresses. The home page carries a block carousel and tables of alkanes and runes ranked by holder count. A network menu switches between the mainnet site and a regtest instance, and the interface is published in English and Chinese.

Running it yourself

The indexer is written in Rust and built with cargo, and it runs against a synced Electrs, a Bitcoin Core node with txindex enabled, and a synced metashrew. It reads block files from the configured Bitcoin blocks directory and falls back to the Bitcoin RPC, and is configured through a JSON file. A separate startup mode serves an existing database without indexing, keeping the RPC server reachable.

Facts

maker
mork1e
org
bitapeslabs
licence
BUSL-1.1
licensor
pizza.fun