Aime Block Explorer

Forked from moneroexamples/onion-monero-blockchain-explorer Patched to build against Aime daemon (Monero v0.18.4.6 base).

Maintained by: Kiwoong Eom (eric.eom@gmail.com) — GitHub @kiwoongeom Companion project: aime-core (the daemon)

A web-based block explorer for the Aime blockchain.

---

🚀 New here? Start with the Aime Getting Started Guide — step-by-step instructions for the whole project (mining, node, wallet, all 4 components).

Features

• View blocks by height
• Inspect transactions (with privacy-aware decoding)
• Mempool monitor
• Search by block height, block hash, or transaction hash
• Optional JSON REST API
• No JavaScript / no cookies / no trackers (privacy-preserving)
• RingCT details, key image checking, output key checking

Build

Prerequisites

You need a working Aime daemon source tree first.

sudo apt-get install -y libasio-dev   # In addition to Aime's build deps

Compile

git clone <aime-explorer-repo> aime-explorer
cd aime-explorer
mkdir build && cd build
cmake -DMONERO_DIR=/path/to/aime \
      -DMONERO_BUILD_DIR=/path/to/aime/build/Linux/aime-main/release/ ..
make -j$(nproc)

Output: ./xmrblocks (~26 MB)

Run

Quick start

# In the build/ directory (so templates/ is found)
cd build
./xmrblocks --port 8081 \
            --bindaddr 127.0.0.1 \
            --daemon-url 127.0.0.1:17081 \
            --bc-path ~/.aime/lmdb

Open in browser: http://127.0.0.1:8081/

Public deployment

./xmrblocks --port 8081 \
            --bindaddr 0.0.0.0 \
            --daemon-url 127.0.0.1:17081 \
            --bc-path /home/aime/.aime/lmdb \
            --enable-json-api \
            --enable-emission-monitor \
            --enable-autorefresh-option

For TLS/HTTPS, run behind a reverse proxy (Caddy/nginx).

Aime-Specific Patches

The fork includes these patches against upstream xmrblocks:

1. get_pruned_transaction_hash API fix — Monero v0.18 changed this signature; fixed in src/page.h
2. miniupnpc dependency removed — Aime daemon doesn't link miniupnpc
3. Title rebrand — "Onion Monero Blockchain Explorer" → "Aime Blockchain Explorer"

Reverse Proxy Example (Caddy)

Caddyfile:

explorer.aime.network {
    reverse_proxy 127.0.0.1:8081
}

Caddy auto-provisions TLS via Let's Encrypt.

API (when --enable-json-api)

Endpoints under /api/:

Endpoint	Returns
/api/networkinfo	Daemon network status
/api/block/{height-or-hash}	Block details
/api/tx/{hash}	Transaction details
/api/transactions	Recent transactions
/api/mempool	Current mempool
/api/search/{query}	Search by hash or height

Example:

curl http://127.0.0.1:8081/api/networkinfo | jq

Troubleshooting

"Given path is not a folder"

The --bc-path doesn't exist or daemon hasn't created it yet. Run aimed first.

Empty pages (HTTP 200 but 0 bytes)

Templates not found. Make sure you cd to the build directory before running.

"404 not found" on /api/...

Add --enable-json-api flag.

Slow page loads

• Database access can be slow on rotating disks. Use SSD.
• Disable templates compression: handled automatically.

License

GPL v3 (inherited from upstream xmrblocks).