Files
skills/public/hanzo-explorer.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

303 lines
20 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-explorer</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hanzo-explorer.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-explorer">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-explorer.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-explorer</h1><p class="lede">Hanzo Explorer is an EVM blockchain explorer for inspecting and analyzing transactions, accounts, smart contracts, and tokens on Lux Network and other EVM-compatible chains.</p><h1>Hanzo Explorer - EVM Blockchain Explorer for Lux Network</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-evm.md</code>, <code>hanzo/hanzo-network.md</code>, <code>hanzo/hanzo-web3.md</code></p>
<h2>Overview</h2>
<p>Hanzo Explorer is an <strong>EVM blockchain explorer</strong> for inspecting and analyzing transactions, accounts, smart contracts, and tokens on Lux Network and other EVM-compatible chains. It is a fork of Blockscout (v8.1.1), an open-source alternative to Etherscan. Built with Elixir/Phoenix (backend) and a separate frontend, it provides full blockchain indexing, smart contract verification, and a REST/GraphQL API. Includes Lux-specific Docker configurations for mainnet deployment.</p>
<h3>Why Hanzo Explorer?</h3>
<ul><li><strong>Full EVM support</strong>: Transactions, accounts, balances, tokens (ERC-20/721/1155), internal transactions</li><li><strong>Smart contract verification</strong>: Solidity source verification and interaction UI</li><li><strong>GraphQL + REST API</strong>: Programmatic access to all indexed blockchain data</li><li><strong>NFT media handling</strong>: Dedicated media handler for NFT assets</li><li><strong>Lux-native</strong>: Pre-built Docker configs for Lux mainnet/testnet</li><li><strong>Microservices</strong>: Stats, visualizer (Sol2UML), sig-provider, user-ops-indexer</li></ul>
<h3>Tech Stack</h3>
<ul><li><strong>Backend</strong>: Elixir 1.17.3 + OTP 27 (Phoenix framework)</li><li><strong>Database</strong>: PostgreSQL 14+</li><li><strong>Cache</strong>: Redis</li><li><strong>Frontend</strong>: Node.js 20.17 (separate Blockscout frontend)</li><li><strong>Indexer</strong>: Custom blockchain indexer (Elixir)</li><li><strong>JSON-RPC</strong>: ethereum_jsonrpc client for EVM nodes</li><li><strong>Deployment</strong>: Docker Compose, Kubernetes, Ansible</li><li><strong>Microservices</strong>: Rust-based (stats, visualizer, sig-provider, user-ops-indexer)</li><li><strong>CI</strong>: CircleCI</li></ul>
<h3>OSS Base</h3>
<p>Repo: <code>hanzoai/explorer</code> (fork of <code>blockscout/blockscout</code>). GPL v3.0 License.</p>
<h2>When to use</h2>
<ul><li>Deploying a block explorer for Lux Network or any EVM chain</li><li>Indexing and querying blockchain data (transactions, tokens, contracts)</li><li>Verifying and interacting with smart contracts</li><li>Building analytics dashboards on top of blockchain data</li><li>Running a self-hosted alternative to Etherscan</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>Elixir 1.17+</strong> with OTP 27</li><li><strong>PostgreSQL 14+</strong> for blockchain data storage</li><li><strong>Redis</strong> for caching</li><li><strong>Running EVM JSON-RPC node</strong> (Lux, Geth, Erigon, etc.)</li><li><strong>Node.js 20+</strong> for frontend build</li></ol>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Repo | <code>github.com/hanzoai/explorer</code> | | Branch | <code>master</code> | | Version | 8.1.1 | | Backend | Elixir 1.17 + Phoenix | | Database | PostgreSQL 14+ | | License | GPL v3.0 | | Upstream | <code>blockscout/blockscout</code> |</p>
<h2>One-file quickstart</h2>
<h3>Docker Compose (quickest)</h3>
<pre><code class="lang-bash"># Standard EVM chain
cd docker-compose
docker-compose up --build
# Lux mainnet specific
cd docker-luxnet
docker-compose -f explorer.yml up -d</code></pre>
<h3>Manual development</h3>
<pre><code class="lang-bash"># Install Elixir dependencies
mix deps.get
# Create and migrate database
mix ecto.create &amp;&amp; mix ecto.migrate
# Start the server
mix phx.server</code></pre>
<h2>Core Concepts</h2>
<h3>Architecture</h3>
<pre><code>hanzoai/explorer/
apps/ Umbrella Elixir apps
block_scout_web/ Phoenix web app (API + UI)
ethereum_jsonrpc/ JSON-RPC client for EVM nodes
explorer/ Core data models + indexing logic
indexer/ Blockchain indexer (blocks, txs, tokens)
nft_media_handler/ NFT media processing
utils/ Shared utilities
config/ Elixir configuration
docker-compose/ Generic Docker configs
docker-compose.yml Standard setup (Postgres, Redis, backend, frontend, nginx)
erigon.yml Erigon JSON-RPC client config
geth.yml Geth JSON-RPC client config
hardhat-network.yml HardHat dev network config
microservices.yml Stats, visualizer, sig-provider
envs/ Environment variable files
docker-luxnet/ Lux Network specific configs
explorer.yml Lux mainnet explorer compose
microservices.yml Lux microservices compose
services/ Service definitions
docker-testnet/ Testnet configurations
docker/ Dockerfile and build configs
rel/ Elixir release configuration
bin/ Helper scripts
mix.exs Umbrella project definition</code></pre>
<h3>Umbrella Apps</h3>
<p>| App | Purpose | |-----|---------| | <code>block_scout_web</code> | Phoenix web application, REST API, GraphQL API | | <code>ethereum_jsonrpc</code> | JSON-RPC client for communicating with EVM nodes | | <code>explorer</code> | Core domain logic, Ecto schemas, chain data models | | <code>indexer</code> | Real-time blockchain indexer (blocks, transactions, tokens, logs) | | <code>nft_media_handler</code> | NFT image/media fetching and processing | | <code>utils</code> | Shared utility functions |</p>
<h3>Microservices (Rust)</h3>
<p>| Service | Purpose | |---------|---------| | Stats | Chain statistics and analytics | | Sol2UML Visualizer | Solidity contract visualization | | Sig-provider | Function signature decoding | | User-ops-indexer | ERC-4337 account abstraction indexing |</p>
<h3>Docker Compose Configs</h3>
<p>| Config | Use Case | |--------|----------| | <code>docker-compose.yml</code> | Standard full setup with all services | | <code>erigon.yml</code> | Erigon JSON-RPC backend | | <code>geth.yml</code> | Geth/Reth JSON-RPC backend | | <code>geth-clique-consensus.yml</code> | Geth with Clique PoA | | <code>hardhat-network.yml</code> | HardHat local dev network | | <code>external-db.yml</code> | Explorer with external PostgreSQL | | <code>external-backend.yml</code> | Frontend with external API | | <code>external-frontend.yml</code> | Backend with external frontend | | <code>microservices.yml</code> | All Rust microservices | | <code>no-services.yml</code> | Explorer only, no microservices |</p>
<h3>Environment Variables</h3>
<pre><code class="lang-bash"># Backend (in docker-compose/envs/common-blockscout.env)
DATABASE_URL=postgresql://user:pass@postgres:5432/blockscout
ETHEREUM_JSONRPC_VARIANT=geth
ETHEREUM_JSONRPC_HTTP_URL=http://host.docker.internal:8545
ETHEREUM_JSONRPC_WS_URL=ws://host.docker.internal:8546
# Frontend (in docker-compose/envs/common-frontend.env)
NEXT_PUBLIC_API_HOST=localhost
NEXT_PUBLIC_API_PORT=80</code></pre>
<h2>Lux Network Integration</h2>
<p>The <code>docker-luxnet/</code> directory contains Lux-specific configurations for connecting to Lux Network&#x27;s EVM-compatible C-Chain. These configs are pre-tuned for Lux&#x27;s block times, gas model, and RPC endpoints.</p>
<h2>Troubleshooting</h2>
<p>| Issue | Cause | Solution | |-------|-------|----------| | Indexer not syncing | Wrong JSON-RPC URL | Verify <code>ETHEREUM_JSONRPC_HTTP_URL</code> points to running node | | DB connection error | PostgreSQL not ready | Wait for DB startup or check <code>DATABASE_URL</code> | | Frontend blank | API URL mismatch | Check <code>NEXT_PUBLIC_API_HOST</code> matches backend | | Linux localhost issue | Docker networking | Use <code>http://0.0.0.0/</code> instead of <code>http://127.0.0.1/</code> |</p>
<h2>Related Skills</h2>
<ul><li><code>hanzo/hanzo-evm.md</code> - Hanzo EVM execution engine (Rust, reth fork)</li><li><code>hanzo/hanzo-network.md</code> - Lux/Hanzo network infrastructure</li><li><code>hanzo/hanzo-web3.md</code> - Web3 services and gateway</li><li><code>hanzo/hanzo-contracts.md</code> - Smart contract development</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: blockchain, explorer, evm, elixir, blockscout, lux-network <strong>Prerequisites</strong>: Elixir, PostgreSQL, Redis, EVM node</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-explorer.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>