# v2 git bundle 4acc65c6d4f84d0c5c2faad94fdd7deaec5ac542 refs/heads/bundle 4acc65c6d4f84d0c5c2faad94fdd7deaec5ac542 HEAD PACKx tree b1c7ed692ab2271e3f30a430260c0dacb79a9888 parent 3c6e210360ac381d850852d8e658d4e027363878 author Zach Kelling 1778045579 -0700 committer Zach Kelling 1778045579 -0700 ci(docker): amd64-only — multi-arch QEMU stalls on heavy SPA + Go P^xtree 5fb3ec9b9f4ec2dcf69999cd72a5a5b490e7e538 parent 494e3fe64555b1487ba2c8547140abc3d94e6954 author Zach Kelling 1778043245 -0700 committer Zach Kelling 1778043245 -0700 ci(docker): go build -mod=mod populates go.sum on the fly 4Nƙx tree 7b59cbbaa57ea015fe68d85dac4d25345445750b parent d41699bb3361f78f0a9ee3ade771360809d5ce9e author Zach Kelling 1778043048 -0700 committer Zach Kelling 1778043048 -0700 ci: drop ci.yml — Docker workflow handles cgo build via alpine YRxtree a2df3925c59af70f8680d33b1bc8888e18b55537 parent d17d22721eeed9cceaa3265313eb8b54dbbdd046 author Zach Kelling 1778042662 -0700 committer Zach Kelling 1778042662 -0700 ci: ARC has no_new_privs (no sudo); GOSUMDB=off everywhere *NƐxtree bad4bf082412b6cb2f5223dd0be204330b9850ee parent 7f0765d1127a67fb76e6922a8c672fcf75cb4087 author Zach Kelling 1778042082 -0700 committer Zach Kelling 1778042082 -0700 chore: gitignore .claude/ runtime state OHxtree 860487c5a72962cf6ab735df02dc6c8e3e119326 parent c979f90b2a92166c1875cf80308c9ea7b3c1986c author Zach Kelling 1778042065 -0700 committer Zach Kelling 1778042065 -0700 ci: regenerate go.sum at build time (proxy cache inconsistency) Pݗxtree abf969e54029a2f0e07558ff0fe2fe26203f078e parent 33658ed9cfea935b4f1b0921d86f6556ae030f91 author Zach Kelling 1778041088 -0700 committer Zach Kelling 1778041088 -0700 config: full chain list — all Lux native + subnet + external `Qx tree ab972f511d87cebfd24c8fec81cf93ffc1e27d23 parent 89c9cd2762bb86f349e695ff8291b924aa83a45b author Zach Kelling 1778040880 -0700 committer Zach Kelling 1778040880 -0700 ci: refresh go.sum (proxy hash drift), install gcc on ARC runner `Q“#x3tree 0fc515d6feb88821662d1b110955301bde2fcc95 parent 9b8044b665e0e12d0ce4808d7b5a3194b62a0939 author Zach Kelling 1778040555 -0700 committer Zach Kelling 1778040555 -0700 fix(go.sum): align hanzoai/replicate hash with proxy.golang.org Local go env had GONOSUMDB=...hanzoai/* which made `go mod tidy` use the GitHub-direct hash (YxjIynl…). CI fetches from proxy.golang.org which returns a different hash (5Rl3…) because the proxy cached a slightly different zip layout. Replace ours with the same value indexer/graph already use. N!xtree aa632e6aa6b40cbaced617b1d2f1945e97b3087a parent 9c1c9c7683028ed3cc2f0d7f364be29f98adc080 author Zach Kelling 1778040340 -0700 committer Zach Kelling 1778040340 -0700 ci: align with luxfi org's actual ARC pool (lux-build-linux-amd64) Mirrors the luxfi/indexer change: switch all workflows from the nonexistent hanzo-* labels to lux-build-linux-amd64, inline the multi- arch Docker build (arm64 via QEMU), drop the cross-org reusable, drop the workflow-sanity job that referenced cross-org actions. \x0tree db2b2f2448cf0d23ad32c220273256d39a0a16d4 parent 77c543529838e6db25f92f47f88291585cb379b8 author Zach Kelling 1778040232 -0700 committer Zach Kelling 1778040232 -0700 unified explorer: single Go binary with embedded SPA + per-chain graph Module renamed to github.com/luxfi/explorer (was -unified). Imports luxfi/indexer/{daemon,evm,storage,explorer} and luxfi/graph/{engine, indexer,storage} as libraries; embeds the luxfi/explore SPA via go:embed all:static. A new ChainSupervisor wraps the existing ChainRegistry: adding a chain (via config / mDNS / admin API) spawns a per-chain indexer goroutine plus one graph engine + indexer per enabled subgraph; removing cancels them and frees the routes from a sync.Map dispatcher mounted on /v1/indexer/, /v1/explorer/ (legacy alias), and /v1/graph/. Config schema is fully per-chain: indexer poll interval, list of graph subgraphs (each can pick a built-in schema like amm, securities, fhe…), brand (name/coin/accent + on-disk icon/logo paths), token features, and top-level networks list. /envs.js exposes the chain list and active brand to the SPA at runtime, so a deploy can rebrand by remounting chains.yaml + assets — no image rebuild. Dockerfile clones luxfi/explore + luxfi/indexer + luxfi/graph as siblings inside the build, populates ./static from the SPA build, and produces one binary. CI checks out the three repos as siblings so the local replace in go.mod works without tagged releases. #֛x tree e9ef4f120b79eaea5dcdbc67fc3b7a64d84a2f64 parent 0c29cc0a65548b9d3700f3d43928b4cff4c6c153 author Zach Kelling 1778036879 -0700 committer Zach Kelling 1778036879 -0700 chore(.gitignore): proper Go ignores, drop rebuild trigger comment SҖxftree a1f2c5fd9e7fc38a9e762f7514b9a9a8e6b4a78d parent 630ffa251a6398d79e96d2b39ec5855cbd3df0d6 parent 755b76ac22240f7aa06d5d0b0b940f3eb1cade0c author Zach Kelling 1778036368 -0700 committer GitHub 1778036368 -0700 Merge pull request #2 from luxfi/ci/multi-arch-native ci: build multi-arch (amd64 + arm64) on native runners4_oؘxtree a1f2c5fd9e7fc38a9e762f7514b9a9a8e6b4a78d parent dd387f3433d8725948027b5520c0d610b339a48e author Zach Kelling 1778036307 -0700 committer Zach Kelling 1778036307 -0700 ci: register hanzo runner labels for actionlint Kxtree 02aed7906e41349de231ca755ff5d96fc6f8daf9 parent 8e4e88c1d09a11263d6b873ae8274b2598cc07b5 author Zach Kelling 1778035887 -0700 committer Zach Kelling 1778035887 -0700 ci: use hanzo-* runner labels (sanity) >jGx,tree d5a98873ed8293956340c809fffad804ae7a3d36 parent 0531a94d58c5b3881b12a8ef1bcb9a86a00ff550 parent 630ffa251a6398d79e96d2b39ec5855cbd3df0d6 author Zach Kelling 1778034163 -0700 committer Zach Kelling 1778034163 -0700 merge(main): keep multi-arch + semver-only triggers |Zx?tree d5a98873ed8293956340c809fffad804ae7a3d36 parent b35ef6b747fe94d1dd2b2d9c5ac4bef9f7ec1e92 author Zach Kelling 1778034119 -0700 committer Zach Kelling 1778034119 -0700 explorer: remove Liquidity branding cross-contamination Drop the _lqd._tcp / lqd / liquid daemon entry from the mDNS service discovery list. The lqd daemon is the Liquidity-side white-label node binary; the OSS Lux explorer must not advertise it. "qؖxYtree 0b695143561ce964ded453a18b176ef8db3bddc2 parent 579d74c09a8664b3e10c1ade5217a0697471e10a author Zach Kelling 1778033309 -0700 committer Zach Kelling 1778033309 -0700 ci: build multi-arch (amd64 + arm64) on native runners Drop branch triggers, semver-only tags. Pin lux-build-linux-{amd64,arm64} ARC runners. Eliminates the amd64-only manifest that crashed Apple Silicon local k3d pulls. xtree 7fd06b2687f41531672d96953f410837b9ed557f parent 5e1d5c3f0337d04b4711bc2e5ca5af160f549757 author Zach Kelling 1776997394 -0700 committer GitHub 1776997394 -0700 ci: migrate to canonical docker-build reusable (#1) - Add docker.yml using hanzoai/.github/.github/workflows/docker-build.yml@main - Add workflow-sanity.yml to enforce canonical CI contract - Remove bespoke docker build steps from existing workflows Refs: hanzoai/.github canonical Docker CI contract.Px tree 7fd06b2687f41531672d96953f410837b9ed557f parent 5e1d5c3f0337d04b4711bc2e5ca5af160f549757 author Zach Kelling 1776997280 -0700 committer Zach Kelling 1776997280 -0700 ci: migrate to canonical docker-build reusable - Add docker.yml using hanzoai/.github/.github/workflows/docker-build.yml@main - Add workflow-sanity.yml to enforce canonical CI contract - Remove bespoke docker build steps from existing workflows Refs: hanzoai/.github canonical Docker CI contract. mxtree 05ec30403163c08342bb6aadcf78f72d50d2ce55 parent e8c2d51752df366e487b76a5f33d9b5eb357747c author Zach Kelling 1776374133 -0700 committer Zach Kelling 1776374133 -0700 ci: docker multi-arch build + semver release workflow \Mxtree ae8c1cbf01a3c4ef3b64f9442bedf313a5697b83 parent 90248d6c7bb2cae223a57b231d8d9bffb614e78f author Zach Kelling 1776077660 -0700 committer Zach Kelling 1776077660 -0700 fix: use lux-build runners, not generic self-hosted ON<xtree 67410a2f862abb06a0545f03e1f65d5d0e6869e3 parent 63a8610d3ebacf64a2634f38cccdf744d28990a6 author Zach Kelling 1776073381 -0700 committer Zach Kelling 1776073381 -0700 feat: use info.getChains for single-call discovery (no per-chain probing) Tšxtree 0ff63ccea78bbb19a3597efae560484f7e17f0da parent 82926899b7f341b085a4b12cfe0794dfe7a49a6e author Zach Kelling 1776071785 -0700 committer Zach Kelling 1776071785 -0700 fix: probe RPC before registering — only index chains this node actually tracks xYx tree f80df6b97507f299c3c70d1c113711d00044b827 parent 672dc81e5757d00125d361f4dd4c58f5dd324fe3 author Zach Kelling 1776070690 -0700 committer Zach Kelling 1776070690 -0700 fix: fully dynamic chain discovery — zero hardcoded chain lists }R~x tree 5c2106f955decb2bce0e4bed364ab821991d67a8 parent cca50859f0645a03a0885679c96d588eda838b20 author Zach Kelling 1776069740 -0700 committer Zach Kelling 1776069740 -0700 fix: per-daemon chain sets — liquid has evm/dex/fhe, not C/P/X Q*xtree 3a06e8dfee3ba02cf9b38c1052b2b0a3bca08186 parent bf584f6b48f9d265640f12d162b47250d18b1699 author Zach Kelling 1776069577 -0700 committer Zach Kelling 1776069577 -0700 feat: discover luxd, zood, lqd, hanzod, parsd via mDNS ZM'xtree 453428f8c721029ab777cb81e7d366459207548d parent ed8fb4b646ba370fab3b53583760b376f53d15b1 author Zach Kelling 1776069391 -0700 committer Zach Kelling 1776069391 -0700 feat: runtime chain registry, mDNS discovery, /v1/explorer/realtime Runtime-mutable chain registry with admin CRUD API, mDNS auto-discovery of local luxd nodes, and multi-chain WebSocket realtime subscriptions. Config sources (priority order): 1. Admin API (POST/PUT/DELETE /v1/explorer/admin/chains) 2. --config chains.yaml 3. CHAINS env var 4. mDNS _luxd._tcp discovery (lowest, never overrides manual) 21 tests, all passing. 2 Θxtree 200ce12a53e92c05fa83f229e3fa078c9b474bce parent 1a6d559ccfc01cdd2521511839f04334772dc735 author Zach Kelling 1776010884 -0700 committer Zach Kelling 1776010884 -0700 ci: trigger combined image rebuild UFx tree 80e2a7ada6b68d378a94574f2119a05b13b746d3 parent 7ee5150d270ca574c8e8f555a7048da9564df2bf author Zach Kelling 1775943083 -0700 committer Zach Kelling 1775943083 -0700 docs: full README, compose.yml, chains.example.yaml, healthcheck, CI Q$xCtree 7dff837e60515e0be8a2360b832f716818c1a67a parent cd4378e3f92324cd031ab01fcd584be7242e23d2 author Zach Kelling 1775940607 -0700 committer Zach Kelling 1775940607 -0700 feat: include graph engine (subgraph replacement) in combined image 4 repos, 4 images: indexer → chain data (blocks, txs, tokens, contracts) graph → subgraph events (swaps, pools, DeFi, GraphQL) explore → Next.js frontend explorer → all three combined (this) Single image contains 3 binaries: indexer, graph, explorer. Each can run standalone or together. ߿_xtree 30ec1903c50c309e778ff050ac500e7a227274c6 parent a2b779c20cbdce6ac8edd2ebf2a5e89e307f588f author Zach Kelling 1775940007 -0700 committer Zach Kelling 1775940007 -0700 fix: use pre-built indexer image as base, layer frontend on top Q%xTtree 65df319ce49c0c030046fb802b76864890d0b6bb author Zach Kelling 1775939328 -0700 committer Zach Kelling 1775939328 -0700 feat: combined explorer image (indexer backend + explore frontend) Three repos, three images: luxfi/indexer → ghcr.io/luxfi/indexer (Go backend, API + indexing) luxfi/explore → ghcr.io/luxfi/explore (Next.js frontend) luxfi/explorer → ghcr.io/luxfi/explorer (this: combined single image) Dockerfile pulls both repos at build time, embeds the Next.js static export into the Go binary via go:embed, produces a single container. uV&x31̒$c5c={.[9a%굡 XIfz^~Q*ķQa͌2?ȼQѮPU.٩Ei9 ?~|^8y\]|]rSl/hiSu_(PEyz9z9 mn[鯝j|Ynˌ[as [8tygY_YU laKGҦv:ăPQ\trf>9wv6Oӈ;U t^z>;wUrIrܫaJRN*ad2TⴔcMJMM K3tSsRS3ήֈlg//kaE9% .Cnif/)/I-.xШy՗>8q{Z 6=,+jZxeUd `4ep#8ڨ,=%KfꛀPqrQfAI1='%_-Wmv,x+"40000 .githubje}ZLuֱ"Cda:x+"40000 .github#+{"Ȼ9<;'""CJS`9x+"40000 .github^$':ry.bI"CM9x __ֈm2mWw1<&vܢXNsH I.x+"40000 .github*ߎ% w@KA뉭<%f"C99x+"40000 .githubmPϝ"CnF9x4 (E2գ_u)H #-x<40000 .githubsΣjQJh100644 .gitignoreEyTH))S7>rš 100644 config.goؽ#N!,y^R100644 frontend.go3d=<@>5c&100644 go.modm(śS^n b100644 go.sum7uJ !*gr100644 main.goBo X 8V0_9BLP&c@o:źZj+F)pL100644 registry_test.goYs5ZCC"J40000 static01~tHT4100644 supervisor.gob|3yaG-,J9'P5ܣJx+"40000 .githubMxC{V䯱Qckh"K`:x!eӃݚwdZ+q9>yX E/xE"40000 .github&қ_#{(a*к"C7uJ !*gryX!7Sx[$rQjٓU! [-xeD40000 .claude,9;- u40000 .github.B41d*"8_Efse`Rnc+sx "4' À !6œ㝶>jZG.xC"40000 .github~?צ~S<Q"8lpS @jwnc>Qx+"40000 .github ,d/`j*^Nm"K9xZL`>$T,]$.YIuqnc b-x+"40000 .github!rF40000 workflows4:9?H,Qsx\y\xOO;M9g|R% 'xOO;uz] 84m0Wʭ 'xOO;'Ma:Cu:jh| N'xOO;Hz Y̥?{Umo F'xOO;Y\`0 ͆ x:self-hosted-runner: labels: - lux-build-linux-amd64 D8x&100644 docker.ymlח87:e>oC,XxTMo0 W؀C` @Ql 0Mjdѓh'A>N[gM|O"IYUc ([Ȧܢ0ɵogUp6X>_'ݫQԠ,e8TylJiFupGNsw8Pi$&t"UpJmqR{v*sQLtΗ lÆfrZncY>P݅kOn ev,ke-M@8qkװG@;bG >~U@!~`&AG]1t u0FBoۡ_X3un{:}0 ~w7 c(XY&49k5C;ex@ Ae}aQBYLbzz4hqԛًio~ҵ.Z;KY46-OR<aW톾M%2g͊ʈqlZ dP+VʹdLw,u͹ Tod3X:_܄IA~4ޙh4pSAͨx ١]+X] pxשMڵK DH"Wi<[AJ[ڻ1, }~do)2wzT"Wt. PvaEjXQz-`#|e }g>[!6K,ok!$lWDmH|K݈zW{pMdBXQ2q'=@9Q8+ cLp4_>_̜So7r<% :HK gryBRt E<,q]SCT ʇ?RSB)J~,|j /7}ҡxx,|=*1 2!"kduܿXߙֶ<9M.ReFRlH/_omcblsƧomTsנ7-v N7Ϋ{Xgf 'ñ'M.hS[ N`H$Y…mRo.L026J{<ԇj@ RB.lpIks*՜:!3ľ ;G)D4w7)P$}D@j=h2O~D=CxUR]kAMC( *ȥnR6ҴvCBBLvg3l>*|w|7 7vag=y7Fo9  `7$TI:PcQ( 3Ndw h\AZEk$M "VD2(RBi~0.#(oBHPHD'4XVm@ "] ZĖj\ (N)j4\=^6_>EZi V`M|n>eͯ̌2@Ph82&fn,J!utc?2CzQytdRMexYֶ|@[cUW)nWU7gZ` {ޔju{UgP8)z$qEq&ږH: pDߤ g#\G]1&'0Wb'nUgiT"*^EEx indexes one or more EVM chains (luxfi/indexer) -> exposes per-chain GraphQL (luxfi/graph) -> serves embedded SPA + REST API (luxfi/explore) ``` ## Routes | Path | Purpose | |---------------------------------------------------|----------------------------------| | `/` | SPA (embedded; SPA-routing fallback) | | `/envs.js` | Runtime config `window.ENV = {...}` | | `/icon.svg`, `/logo.svg` | Per-host brand assets (disk override) | | `/health` | Service health | | `/v1/indexer/*` | Default chain explorer API | | `/v1/indexer/{slug}/*` | Per-chain explorer API | | `/v1/explorer/{slug}/*` | Legacy alias for `/v1/indexer/{slug}` | | `/v1/graph/{slug}/{subgraph}/graphql` | Per-chain, per-subgraph GraphQL | | `/v1/explorer/admin/chains[/{slug}]` | Runtime registry CRUD | | `/v1/explorer/realtime` | WebSocket realtime hub | | `/v1/explorer/realtime/stats` | Realtime stats | ## Quick Start ```bash docker run -p 8090:8090 \ -v $(pwd)/chains.example.yaml:/etc/explorer/chains.yaml:ro \ -v explorer-data:/data \ ghcr.io/luxfi/explorer:latest \ --config /etc/explorer/chains.yaml ``` Or with compose: ```bash docker compose up ``` ## Configuration `chains.yaml` is the single source of truth. Every aspect of the deploy -- chains, branding, GraphQL subgraphs, network switcher links -- is per-chain customizable. See [`chains.example.yaml`](chains.example.yaml) for the full schema. ```yaml data_dir: /data http_addr: :8090 brand_default: name: Lux Explorer coin: LUX accent_color: "#5cf" networks: - { label: Mainnet, domain: explorer.lux.network, chain_id: 96369 } chains: - slug: cchain name: Lux C-Chain chain_id: 96369 type: evm rpc: https://api.lux.network/mainnet/ext/bc/C/rpc coin: LUX enabled: true default: true indexer: poll_interval: 30s graph: enabled: true subgraphs: - { name: amm, schema: amm, enabled: true } brand: name: Lux C-Chain accent_color: "#5cf" ``` `$ENV_VAR` substitution in `rpc:` / `ws:` lets one file template every network -- mount it read-only and inject secrets via env vars. ## Per-Network Customization The same image powers every deploy. To rebrand for a different network: 1. Mount a different `chains.yaml`. 2. Optionally mount `icon.svg` / `logo.svg` at the path referenced by `chains.yaml` -- they are read from disk per-request, not embedded. 3. Set environment variables to fill the `${VAR}` placeholders. No image rebuild needed. The SPA reads chain list and brand at runtime from `/envs.js`. ## Runtime Registry Chains can be added, updated, and removed at runtime without restart: ```bash # Add curl -X POST http://localhost:8090/v1/explorer/admin/chains \ -H 'Content-Type: application/json' \ -d '{"slug":"new","name":"New","chain_id":123,"rpc":"http://node:8545","type":"evm"}' # List curl http://localhost:8090/v1/explorer/admin/chains # Remove curl -X DELETE http://localhost:8090/v1/explorer/admin/chains/new ``` Adding a chain spawns its indexer + (optional) graph workers; removing cancels them and frees the routes. ## mDNS Discovery Set `EXPLORER_MDNS=true` to auto-register chains advertised by local Lux nodes (`_luxd._tcp`, `_zood._tcp`, `_hanzod._tcp`, `_parsd._tcp`). The explorer queries `info.getChains` on the discovered node and registers each tracked chain. mDNS-sourced chains never override config-sourced entries. ## Storage Layout ``` /data/ cchain/ query/indexer.db (SQLite WAL, indexer) {zapdb}/ (KV store) graph/ amm/graph.db (SQLite WAL, per-subgraph) zoo/ ... ``` Each chain (and each subgraph) owns an isolated SQLite + KV store. WAL is optionally streamed to S3 with PQ encryption when `REPLICATE_S3_ENDPOINT` is set -- see `luxfi/indexer/daemon`. ## Local Build ```bash # Sibling layout: ~/work/lux/{indexer,graph,explorer} cd ~/work/lux/explorer go build -o explorer . ``` `go.mod` uses local `replace` directives pointing at `../indexer` and `../graph`. Production CI clones all three repos into the same layout inside the Docker build. ## Endpoints (curl examples) ```bash curl http://localhost:8090/health curl http://localhost:8090/v1/indexer/cchain/blocks/latest curl -X POST http://localhost:8090/v1/graph/cchain/amm/graphql \ -H 'Content-Type: application/json' \ -d '{"query":"{ swaps(first:5) { id amount0 amount1 } }"}' ``` ## Related - [`luxfi/indexer`](https://github.com/luxfi/indexer) -- chain indexer library - [`luxfi/graph`](https://github.com/luxfi/graph) -- per-chain GraphQL library - [`luxfi/explore`](https://github.com/luxfi/explore) -- Next.js SPA xD# chains.example.yaml — full per-network customization for the unified Lux # explorer. Mount as /etc/explorer/chains.yaml or pass --config=chains.yaml. # # Every chain gets its own SQLite file under {data_dir}/{slug}/ and its own # /v1/indexer/{slug}/* + /v1/graph/{slug}/{subgraph}/* routes. Branding is # per-chain; the SPA reads it at runtime via /envs.js so a deploy can # rebrand by remounting this file + assets — no image rebuild. data_dir: /data http_addr: :8090 # Default branding the SPA uses when the request hostname does not match a # chain-specific brand below. Per-chain `brand:` overrides win. brand_default: name: Lux Explorer coin: LUX accent_color: "#5cf" icon_url: /icon.svg logo_url: /logo.svg # Cross-explorer link list rendered in the SPA's network switcher. networks: - label: Mainnet domain: explorer.lux.network chain_id: 96369 - label: Testnet domain: testnet.explorer.lux.network chain_id: 96368 - label: Devnet domain: devnet.explorer.lux.network chain_id: 96370 chains: # ── Lux native chains ───────────────────────────────────────── - slug: cchain name: Lux C-Chain chain_id: 96369 type: evm rpc: ${LUX_CCHAIN_RPC:-https://api.lux.network/ext/bc/C/rpc} coin: LUX enabled: true default: true indexer: { poll_interval: 30s } graph: enabled: true subgraphs: - { name: amm, schema: amm, enabled: true } - { name: securities, schema: securities, enabled: false } brand: name: Lux C-Chain coin: LUX accent_color: "#5cf" - slug: pchain name: P-Chain type: linear rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/P coin: LUX enabled: true - slug: xchain name: X-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/X coin: LUX enabled: true - slug: achain name: A-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/A coin: LUX enabled: true - slug: bchain name: B-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/B coin: LUX enabled: true - slug: qchain name: Q-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/Q coin: LUX enabled: true - slug: tchain name: T-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/T coin: LUX enabled: true - slug: zchain name: Z-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/Z coin: LUX enabled: true - slug: kchain name: K-Chain type: dag rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/K coin: LUX enabled: true # ── Lux subnet chains (EVM) ─────────────────────────────────── - slug: zoo name: Zoo chain_id: 200200 type: evm rpc: ${ZOO_RPC:-https://api.lux.network/ext/bc/Zoo/rpc} coin: ZOO enabled: true indexer: { poll_interval: 30s } graph: enabled: true subgraphs: - { name: amm, schema: amm, enabled: true } brand: name: Zoo coin: ZOO accent_color: "#7c3aed" - slug: hanzo name: Hanzo chain_id: 36963 type: evm rpc: ${HANZO_RPC:-https://api.lux.network/ext/bc/Hanzo/rpc} coin: HANZO enabled: true indexer: { poll_interval: 30s } graph: enabled: true subgraphs: - { name: amm, schema: amm, enabled: true } brand: name: Hanzo coin: HANZO accent_color: "#0b1220" - slug: spc name: SPC chain_id: 36911 type: evm rpc: ${SPC_RPC:-https://api.lux.network/ext/bc/SPC/rpc} coin: SPC enabled: true indexer: { poll_interval: 30s } - slug: pars name: Pars chain_id: 494949 type: evm rpc: ${PARS_RPC:-https://api.lux.network/ext/bc/Pars/rpc} coin: PARS enabled: true indexer: { poll_interval: 30s } - slug: dex name: Lux DEX type: evm rpc: ${LUX_RPC:-https://api.lux.network}/ext/bc/D/rpc coin: LUX enabled: true indexer: { poll_interval: 15s } graph: enabled: true subgraphs: - { name: amm, schema: amm, enabled: true } - { name: clob, schema: all, enabled: true } # ── External chains (bridge / MPC counterparties) ───────────── - slug: ethereum name: Ethereum chain_id: 1 type: evm rpc: ${ETH_RPC:-https://eth.llamarpc.com} coin: ETH enabled: false graph: enabled: false subgraphs: - { name: uniswap-v3, schema: uniswap-v3, enabled: true } - slug: arbitrum name: Arbitrum One chain_id: 42161 type: evm rpc: ${ARB_RPC:-https://arb1.arbitrum.io/rpc} coin: ETH enabled: false - slug: optimism name: Optimism chain_id: 10 type: evm rpc: ${OP_RPC:-https://mainnet.optimism.io} coin: ETH enabled: false - slug: base name: Base chain_id: 8453 type: evm rpc: ${BASE_RPC:-https://mainnet.base.org} coin: ETH enabled: false - slug: polygon name: Polygon chain_id: 137 type: evm rpc: ${POLYGON_RPC:-https://polygon-rpc.com} coin: MATIC enabled: false - slug: bsc name: BNB Chain chain_id: 56 type: evm rpc: ${BSC_RPC:-https://bsc-dataseed.binance.org} coin: BNB enabled: false - slug: avalanche name: Avalanche C-Chain chain_id: 43114 type: evm rpc: ${AVAX_RPC:-https://api.avax.network/ext/bc/C/rpc} coin: AVAX enabled: false - slug: solana name: Solana type: solana rpc: ${SOL_RPC:-https://api.mainnet-beta.solana.com} coin: SOL enabled: false - slug: bitcoin name: Bitcoin type: bitcoin rpc: ${BTC_RPC:-} coin: BTC enabled: false - slug: cosmos name: Cosmos Hub type: cosmos rpc: ${ATOM_RPC:-https://cosmos-rpc.publicnode.com} coin: ATOM enabled: false _ΗlxUQAn0U[KR"#r6A1eJ_pj/xwfm -GKP͌.}+J:sw4_@ Ɋ$3W?ppNˏ)48xVƭ|eA{8aQ2"o6‘uZ`:A :N83F((١tKӾNTdyߜӖt~$oeġu;rdO櫛<>=~~vuoUuwIR>*?cॿ23@/ZZ&kI8T ĊG%x{timage: ghcr.io/luxfi/explorer:lWDATA_DIR: /data HTTP_ADDR: :8090 EXPLORER_CONFIG: /etc/explorer/chains.yaml8)U)xWmo7l9H*w) E>$v3(i?>ڥ~ySܥ͊! լ..҂[}M³{nJ?t{}:p;`Py{ሁCOZ579$pA#[ s[cU%pf䤇F 'â*  &p ̔?FpYXB.޳/>]].>\,>b192 ky}k A4cN\YH *y |]FAB=nMAO H u%Dms~%z5  'QV|WPm t FIVJ)b*e&g3Ԯ+i{$[#v[%wWcP$ 5y&R]juOcsOxK2uj!/z1vUX8Z=k^YXꑾǒV +8Mɱ4~9Bԅ-aHP<#fhrjaɻ:缶 ߧ#y(H1!8F!"{2'DI:+IﰴIˡd gu*|z ZI/>r)db[Ja.t"lV PƝQdTk|>H:5z4u*\XG`@Pm8D!˄KRFw XKdQY5[s< Ao^԰x#+Q!nŦ]cA [9):)u Y)YVP @_T׆m8D9`L; $יfnqu`0cxXӅx9.|w/^=}{\Ja@ikJE}oo>40LW8RdyO'L/Vkgos_2*My $p9^:ԏO+#ij s/IrQ7 zԍݨQNSCOڧ s7\$M學hZrs>D[fϤqv0n 8|KWwtb6Յ/pp9t;DŽq9^|FTD ''RP,)W쒸xXݎۺ^?#rN|dNM6zsr Jle%Qݜ}>IRhEp83fJ&7rD!r0ȊJV Ze|"V (%MLOR,[L%jf0m`0c͒Ȍ+%xυZ̉NnTMD&/օ$(o6i6Q*׵q $g4ERTLJ U\MENz%(2kbZnI$J-Lurp+띝LlYKJVzkBA2͖"Dp$$U$,iFc%]$KMH3J. V[V7XXGV$f-+R̮tcɎqVz R=l$V|%RchpTeV<>^!/-sućB㏟(Dw vm@㴝Z\" F$?$h5iS&}!iQp(-H,$y,3}a{#`Rz4e#g Y\M_% m]b]-tGC+~zn3N]'nL6ooLu.h2NVg*݈t <7b"BD7b g|WȢs S{$DŽ<ќ2M#Eϰ2 ~> F"\XbfV9ުc 9{h0mRئN+ɒVrBHFVIҎMP8"e};RJF}3jN?(>(@=GWuVUm:z:zuDpњĞzإ .# mʰ:ߔP)$Fǹ6*O9f!:7'Y.()[zDL"9^G ` Ǽڎ "FW#pfM&?X+Z紸3G~Rt{PG%pSѩcfEB0GC땴InTYu}#X]d@**mL#ht5OzE:H B(gY@h+ Ry9;+O|yroIۮsh^g~i$ _C^ DG Y}t Or~uz} ~OTa !3 G]BZZc+2x4f:!Ã'xT,iWl'MyywF񶬷>|ho354|JlKRJESwEȤU6◤N7Mv]^(>~zb=q^@()Ө۞8> $Ȥ Għp];`$ m hYk,S >@+O\TioVj1jSܸu: |W@2mpe*Y=H7:X_g9n$`&j; Z>yбU!6X>WxB/OwkWxcnٌ rbk~ vp9~uDֈO8JѿҌ^p{ 7}\jG1*mFcKG4)YֶG?=OV0ݕ!Z2:kbiI؇ޅ>y9h(*dXk7HXI=H xWݒ6 n"th_co&W6-`L2dr$HT3 8vS251][N: A:ar A5?BPQ x<̂(L$ҸӤS֦ "{P1i:Kao.v|Q_Axi^]̻%A\#j >*qY 9aA *\2g*,'5egն$6#@מ\'nXLjVݥi&ce? TO }.KXNga5X VuH+H0V?]4vڈW AP=م aԒOЊ)΁_7Py4%֣ 6 'қ?H~*ʉQp7V\r*@^{QXQA޸&D8eqe'9eS媶e_~Fu ^ö2%n-6$*(2v0zf ZCrQp뎖lg1ӷ*]f{jiM |%W\" I a^spg6L)1{Qen pl`pwEŧ*_$|ui]&Tvd^?ֽ)K͓x-u JxK3D_p7 WwEa8?ofg*7~ xגH-~bê5PB cZ+_fvvWM>֖rp )q i? Bp(1dI?zx 'ݟlJn [fUD80aUQ@Ϻ}r]#p䀋%_R1* KlϷKs}>v~mVϰ8ol0 ܣrç (vt @<PHK=؋Puw:BJcq蚢zTfXb/<`O~O .o[vQs\=E'".ӪBy?~_g(8N}vrm{U"FBr0=E?\#7cA8jy%F-o2cMY܋KA)D< 4*]Z'q;9SoB/OӃ؞Z/Зg.Lfw5Ssu}f*c6s=qUBQSuW18 l0AzӓL::qe_NthFgpԒB!wL݃bS6OM}bcI;x>* 90y#9|A^l>qD9U \8H^lxjXM]vR.xǘ^RHlsQL=>SǠCI|)e344o'(֖YF ZT@7ͺ`z CMI _}=ㄫ*.qh?sQDYS-ji^MJʣb<ےl"E[\0`5eX 6x$5;%ZjUX)(3_qcw\/- D1H W!rXo)^x?S2-}-7b{|\<46sz>En),әח79>,0lnh6l+0^d=F!bodEpXC9dcdv6ܑHx ZًΜDk'n c\WՎK,hν="&#?7젰u*j%E^ڢ{ǪNNE*0 # nP{QpXC^%i+!~n~5>7]8~ka#o݇4ɘJK=_ ^ @];@y:SDHݯ2S}t!u4~XC%x}@1L~8MldA,وg(c~- T?LpVdW uF2x~ }FFn@)ID]\Ev0]a@]bl5_e G6 awK&0qQ<}(hLM`8)pkf1CЯ|ﲾ|`yp(:ʥJ'uc&a@ˇvO,q~O򍍗^d2[jDvN&Do117~'k*c-eLVizBޡ=Vxcn&8o OE󰎼y=̱H_eᵼ%p?\8P \ ŋ2nDUBۃSi viψ} .k LQ3U`T]`2s;CZ]M'AwـE q&:^z*Hpv]['^3!}6'~<#?@ ag*?t@q1]E%B7=r97$YnSSy?g<>F5v<pqu0S x}#s0]ںGg 4K2RǶ{:`tlQB> JWWKac 75%<-`,CXגk+k\3Y4^?;7K*eY nx(5, Up:5ZbS}c~u"pIO]<QWj7؎8cfa(2¸)j6Ib\' !?AEդ鉴R^;- B)umW?QX 1d8](跛e"2n{0c,E_P>^ܲ6%ho4h^ a E\[AL?e(Xa=)1 ?CGiVx}?ZB~@ `QGD%$M S?_%ȹI3ѪNr45ߋ2Rn Zim`>/(.$pM)(yb4baOEggYݴ Ut[fڵ[fmqNH*m_D#c!b0dܞdjR2P}FD`03Rڔͽ^Ռ"o "Ħ0Hg7o\M/V%M2\ٖbC_a6OMP]Yz&{]W-d;s+Xc;3Dk _{*/Bh'SЊ:R9)H~06yzj5QAu?TV̯f WCH1 'Г'LT=<5(?MWW3Rjbuާ}_P0o:^2`;՜萅`m*=拸ɝ3G12BɎK(bo ,ǃӡף6BQA0`pTl%#VQfqwGg!Ƌ{5C)a6)E%qp=_h)v<>w9ynOMd[)ictn-hk%uzC|]%BmmUVD;,U\oэYcN[ TM#oOSȆ!s1L1vі'ʷP( 23`&Ә9 0FNq|,VصX>ɜO}mO8 "RJ!K$n#H]HM0WKK~̖J!9.Z* vn*W97Ǎ{~!&)2ny_7WF &UB;W |:F1pƓ$ :z~m68pŻ;YÑ}:zZ{:7T[KZd&:.Odp.j>矌#h{\7sG~sΞ4מJ#w`[%ދ8ĥV…V9Yc$cx ;oD<{{0.-̫X &S>0ȴ!xDo_^D4ŘK<{#NXAc_7&[vNsG0~+'v89Ô'o!Ǭ޷1A߷=;-X$q,9Ɔ hq4t/-ezMk~#Xg*{Tg riD0w$L[K{p6y`OrX'O@5vq" E ~8]QdQԍB8 z#7̬mMd .|=g39~rW""sJh cl6jJ9QvǓڹ[С (4hV,P2q^N3:w̦%%YCy^Td$kmXF=sr䭑Q1D` (A>S9 DW-n]?<ؽ{Tӧ- k+нv˩a];b'g)ʗ8oF}DaC~=CvZf~~uXpy~#+ߧ7C^"[jq٧y8J0*4tl]b%H12g#΁ a#YeJUH:|v*8]J V%BDRác^9Spf >7W6_B!޵cvxMΦB_)YrJD sRO7A(%*}%ů9Pv6^D;Ү;#H䚫Cn9M؀'L2yht O e- d'Pk׶銦׍U o'a8l/g"=HKW=[B'ne ҩiUpA8seźwG;k2a z9]lzF#!CAy8aoفB-3^taTC{ zx^Z=6BѽYFj QV;ag{LĞ:'h_;T!WY8: 䉐B};ڋ0ev!ڈ s㍮kWͨc'Mۅ?%Yk-^Rg&;.uL#\s%|6|C%dTIѡG0PH/i%"nMGC!^*QAI`mzW;?oLօH?# n0xlp҅5u[DU~t> Rr0(WoUBzG\ywf}HU%PzR [+^%܊vϚ[)}? r!r@01|چO0IE dmgb^s̰z2cv zZޢ_V=E4R !͉]1uW_u?5!ɡ.THQ,Z\kNzK`WRc\]lerɺXqS! ,AM)~}ox 2;j~lwB!2̼u 0^77E5G9 vF\}H󝈻߽gzϙg 0R*<I Cag7kT ZJ\ET4r({w>+؆!ep@}8h{~||uДaw:g&^}І|:9 ф-׀/`~EV6:sѽ5g,RԗFy }!Kqe}Ab&/]\G#%qXA$2RB $XbxyVL6\aC6½q{js~ᘦgTV࿝ÿ4C+khB5݉hyx/ŬF}ߕ"Rc"yqRY8g[=[#=x>gM!ᡜS?VǪfwE-_GQ Z,l\M#)sx+Ery229Ey|{CjrbA^soG\ƀDu|~:jHo1ٺsp xMeʧb3pG9k~ysi4qe(j/z_]_Nu) efBH"QM㥙*IR՞+6R6* #H;DXgNP#nlLsD߁| G:-;/z鱍&5KT>P4mj֋cJ78-}id\/$Cmo aC|t:sApKH\ad{<%ݽxPIdO9'D 惃>EyLWp\w=$[ޏTgW$=VX›p:iHW |TU+yv^`^5fԹWp~`VrMWx6ymcWMv@קXƗxx뚯v#z, Oeil+>;2hLI)HK{QS;ЋAIAiB[^i݄ quC>a !0  1.QQxQBbCs -tz*L/ê`*Mܭ^sr!Р!$a<Ъ&8OQk!mVv튍G6esva["q"`=9$:59QIވx5I*Oc2uTEgb@Ȋ$#VII[qqNo^ěvx48$i(8s{ *֝?R9xIRǢ#C8!?C),$xKw!HDͬ$C-MjM[V}ʗ!>I|<]h4M %SO]l4xŏH>{s8җcdnxZk,Lą( 2dj#~ 9(x=K;M$:)\`H/x{ R옮82!(MYVȯohޮ%aMȎVo:^YjDUp&Vf턿$hmO''s22^ [y2Ei_O'B  р}Hx(Ǿr[mqNnY/8!I&g,B;Rd wO#{[@dEo>%?= #$L4bߎ'hMs m==JvSo>bÿn kg&GMeFbaDaE|Hg>!vO7[5Ijz{|` scs ZǴE* ^؈}9/}p2j! >cHuNxkp2GCl.wBٳ m]l#GߺQ吱^']<& +gpb~MA)7_Odn"K`Ζcc niʛ- _^`SVL&Sӈsu%uZ0E}Crv5#!=jG9*bѣڟm7a܌3偍DE0N^3R6ȀB arb硿z(Hɗ2!=}֝]*}v?fxWډ@#jMO]LewU"p`VsЦY<\ฎB/k4|EiyIzY A*gB6h&P+u0#0E'ⲙFW!WQ?B#M BKCaAL\Ir…/V):TE(AK6gPo~:`t.OD/@9eIɆ}m@KKȠwz|I1 E]o~O!zmQnXdeoaj'pzmtu'߻]a1J ưG~O'"qzT1*Y h?xQ.Ga!rcŞ&> P B~^ean#$I_/d ŝݵ4=ܚ?oKZFOK'C?BtL5jbtP* _}ZC'%Wyz2=Hy1IY{9\ ./xM<}ZL!qa .݉>SBu&2L K[vs)[U_+'\ha!68gئi֌LK((: *Pot>AcIS=a0Ach<} o1hjpX]?&r)P 3ꇎD1<5,x,ǝUn_m[~/^}T|/X%_ۡhblv:%29"х(\gR|؂4_=+Mܱ<ӇN!A#0T4(:6~g1p~H}zC|$QDQ_RkPċ0:ڝ4i~*"xW{J2=B$KMfٞˬUyƊ; K=iyNRߌD^2?"aąq(v@H.Rmϛ8 ,t-A$&1żݝaGu9q's*%XcMQhҫЅ5kRѭljܶyտ}<*XlXÌM'+S#'#q3WrnCAx 98ihA0tԄ;Du˨WKNAzZ=܎rQݓml ^:mɴPG>cю"~rYw'1[]G.@h{ȟ2#I6rh.fQA \ ՊpcACr>*"|,ձ%0!w"f-y-vפE*:O?o'd1"~uM })3CZ= e%=S\zEFsRC<\ 8b1='Vhvމs]W?A2M;L=}xε.G5wԯ1BrM؂&T.kO˅eҘ jLo_ed'Un+G7&AKtTWץCQv>1H)20Y!z_( $6-VWc65Ԏbid1댟+zOZ;|{Z0R/3fY"B!Rsr`=`ߡ>{LkC~c@Rq9v,Uo]П0_- RTo,Y -.|n]զy/uV@czLো- KeQl|^ f;K(#@ B2$.1O"KSͤL~򟑼($˳ IU;"YHKJGȀvyj)N&jx(7j9g @GfͷN{|vx+IwzS2HMgTdrS8 ֛pMjtǒ3Ϭlt__u35(.8rphtLkGo|%#oq^KؼNpgB8s/d-Uk P44Ӿ!ڍdmDIخ=w|~SboVq~.-H),MZ'j HUB$@D2\h:#I"b^%DR+ju½m n/]y.@Axf&}p, 678;;݅[!CGxj>#NyոD8FTz&_, Z(C %3 Hxdaږ3Vx?B&<,M8?/Jf<B5`fGcE5x}GKsm޵W;H b)Ԋz,j! @{UUd%(a;+d~oƅb97u5 ¨wBV N VaޡDg^MH{s*z8H(0g%LNNւ7E/e}ͼz|`ɈʖWA1 OZ 3f%d(5L- qWPײ~R|ct:9)L=C=d2zg%p~d틗WEvҾa \ t,tH!=7Gz6ʩ،U4OhQuy$Bwu";kP0qFGvV)PsKq.sckqh.WQlxiZ΄avFX:0ʷmL<.f up!(} ݩQۣRh[qćMj5"+/ =9-eeXA?Gl0(|L?(uкW,2BfIh?U<SB\E2l#*ý>`]׫x?&E=F1 ؞tfXBNjm'>"{,\uVz70ETEjI<^ e7q]t)gnj(LDuXyIi[A< X JOc=aE[8Xm'Ϯ]c4xXs6 dȜD&owNHGDZUIizx YSKuoeizrV&. 6=_ It,X%DD|`!Oe!SƙJu*؅d$fbO}dxL0Y 0 m։˥M$0E%pE1-y5:k3ET8<$YPd#pzE\BfZWJhԔ\,,M,‡L蔭 C6+S`lY tTXMjgB}?01sꑈ p[4]G=V?m;_#%ςT%>CRi,xc^7J=[QI$v1$*QlP0N;o ^cg$VL;OQ\?kBo@b=i[A>(+\O b@3&>[/]b 1 =}sXex/4 1E>Zr%\'|}<,D{V)_ CxL :gouS|ɹU |@@QUz-/įJT1'[[YH;AP1ΟB}be**DA{7xs<BJ=g%֨/n|5òGFS0SfAZVUcɯdv790"T|+R2PP{YaZXAڝd(Brh@ZU`5ڑa$1?8.x$Y0x˟-ubRyBD#~R㾁G ]GēCZ44GSLqa{N^M{t8ˁjU5rֻB?BU O]ݦ410Nxx, \ϫ#L'.IȓXK(hD:u&rZ3zC BZZaBؔ%?($I+[|:*g,Cj '%7c> yhk ƯQ݊,xzjx0b{BgFs}#xoNV{b~uqu/& 2,Xُy)QӬc_f R=u on5ffiqQhsk2Cy Aa`·8#SA\?2[M(rC8ױPVI M7@"n]ܨU89`ZUp7׼и2<\x ܅`5XġڎuƂ- ׯ!ޑ}&e+NҢ<L($A%|`5zO*1vɂy+&vfL\fJ|*M$@Jq/b.4T҃>XyI5&33_4{wo ?a DNgr{O}Zh!?yss8nez;K05P>~ĎЇXsxr=YL ę@ YQ#ؼ;bc|tKȞ鈝Nak:0v 0) (JDߜ] `,3A' z8:], G ޼  zT I1ǝۖZ^+NZ湈 "~AǸxA3ǖ\?Dj)Wt,/*Mֱfqo.oep.ceM..CA;-9#I%eo:?#`TB[JHI6"TR nŤm!0Mnpko t,#R^aߏcsNW>]03pS.lPHEZ'?Z٦ P网V $S,@;S! ž_d{/v@mv9 -])KF7on[r/*ȇ0\_kSwU!瘣Z[ 1p⣛>1棵9\ !Rv#ɨ@"^Dp0L4o]+k7/f4t.QRS ˏUO`AgQmOxYnM=ńwD`X$n)ǵa$9Hf؇';Cnܹ{gR'er" _ԕiT4B]UlU-J݌MS6-|.fiY>^d%f Xe^T6<ֵUSeHUM΍rVŃUVsLebV ݑ=VtR%?*`LRf[2R=˯eb:-aql:/7j/{yϲ:̳v<)p&O:1v#H8r#8mӼrV+mjj+ IQ˲*(+ɲvmz:SWE^Z,`8[`Z*}ݨܪ4)S]:eȨìꮲѐ1P`s $<%v|)Jd_!~-e;4 E0#(;u]TFv O 4=ez`)ΆsaYsl?ݝqcMDE53#S qL3ď 0v|<>F6(< cUd(̜,Öx RkSMQi$'DҊo.訍u,Q'tD{tjj@ vQxQp%J#k]fD F~NضХ3id'kTXQfY=#QAA`uIe7>C;Kmr$fJDJT)1 ƎHsvY#52ʪy#Ù)+x^8XNB= 4 9J|Z{LpxgXb F-zLw#~+c~GTB)!0`B=z cbS㋛VT c`>:{<Ev.頥x z{%,iտ fv[_D2ЖMZ58JN_ :H.L/_ zNGB Bŭ"A3مG'pD-U# 39ɤ.iWhCq"I8h'FTuID88;GZ:0>R,KT,;o"䶮JxW^TҷIGHVRAZ-dN1:`0,V.UH}E"ۡ&ñiXw.RDN"_u +ѽHg<^ \.BQQ}ָ#us$ 6pRԶ#}_Z@Y"pH `wKK5,lUp8!K.||qZCjtGHg U3Րi6-!Nz-hb/s$f#wimFxOq@Co,dCɫ.}T3(ӘL1GP}P\HZgh֑Sa%; (/:ȵ"N/R4Iw=ܳwNҋd*MuYY0-՗6Ŀڤe4(mKk2)|,rlqZƋʋ"o. ձN nxခZ5z.z3٠f^Uyi8WkUZ9%?t(>~w `6֓3kL3jk8<蜏 4@l^BTἀu8RS'xnfJx6;߲֙I:H5.VeJ,C'Uy tI< p!L%\l%Qʭ^>OlL%xSwW MVkq\qsQ\Xl0ǰ7K&&Sl 2>k!wS{!1q3.W#!>ڼs]kP7)cv]4ߕ@UJo"(757&Uˢ:B%T6QzmKa^TTn.,ױ&&^J,Ɯrǣ! E\故uDjm]P1b;ׇ46f`g80 H~WB;%Ipf4:N0?XizZ؇&{SWV|J*լUC~L:x]LSUz{2k+&[gjUs Tt㑚H lD=ڃ Ysfz>zcLP;3nUm(7̭̼89yDgƟ(+]+ڌbBkkC@&+F xA64R&/\t=LVɯ{Ɠ,4?!! pIEO]=Ϊ_BIInS Dp*+e E^gT+"P;jy^L1ZVM4nwH;%)70~k#\y$#Y;=3]CR' XB/^ Ąt;9rW0K]/igzyz4˵yKo>5ڗMp }=l^+c͸B]=&SZɇ<"5eC4x8jr\{:L޶怬+1!n_w.%ƾvw91evZ&UU^!-mۄW/*kŸׯU\':Ao=SgjǍ&Ovk:ӳC`.p<ُ![[xpackage main import ( "context" "encoding/json" "net/http" "net/http/httptest" "strings" "testing" "time" "github.com/gorilla/websocket" ) func TestRealtimeHubStats(t *testing.T) { hub := NewRealtimeHub() stats := hub.Stats() if stats["connections"] != 0 { t.Fatalf("expected 0 connections, got %d", stats["connections"]) } } func TestRealtimeWebSocket(t *testing.T) { hub := NewRealtimeHub() ctx, cancel := context.WithCancel(context.Background()) defer cancel() go hub.Run(ctx) mux := http.NewServeMux() mux.HandleFunc("/v1/explorer/realtime", hub.HandleRealtime) ts := httptest.NewServer(mux) defer ts.Close() // Connect WebSocket wsURL := "ws" + strings.TrimPrefix(ts.URL, "http") + "/v1/explorer/realtime" conn, _, err := websocket.DefaultDialer.Dial(wsURL, nil) if err != nil { t.Fatalf("dial: %v", err) } defer conn.Close() // Read connected message var msg RealtimeMessage conn.SetReadDeadline(time.Now().Add(5 * time.Second)) err = conn.ReadJSON(&msg) if err != nil { t.Fatalf("read connected: %v", err) } if msg.Type != "connected" { t.Fatalf("expected connected, got %s", msg.Type) } // Subscribe to blocks sub := SubscribeRequest{Subscribe: "blocks", Chain: "cchain"} conn.WriteJSON(sub) // Read subscribed confirmation conn.SetReadDeadline(time.Now().Add(5 * time.Second)) err = conn.ReadJSON(&msg) if err != nil { t.Fatalf("read subscribed: %v", err) } if msg.Type != "subscribed" { t.Fatalf("expected subscribed, got %s", msg.Type) } // Broadcast a block hub.Broadcast("blocks", "cchain", map[string]any{"number": 1}) // Read the broadcast conn.SetReadDeadline(time.Now().Add(5 * time.Second)) err = conn.ReadJSON(&msg) if err != nil { t.Fatalf("read broadcast: %v", err) } if msg.Type != "blocks" { t.Fatalf("expected blocks event, got %s", msg.Type) } if msg.Chain != "cchain" { t.Fatalf("expected chain=cchain, got %s", msg.Chain) } // Verify stats stats := hub.Stats() if stats["connections"] != 1 { t.Fatalf("expected 1 connection, got %d", stats["connections"]) } if stats["subscriptions"] != 1 { t.Fatalf("expected 1 subscription, got %d", stats["subscriptions"]) } } func TestRealtimePing(t *testing.T) { hub := NewRealtimeHub() ctx, cancel := context.WithCancel(context.Background()) defer cancel() go hub.Run(ctx) mux := http.NewServeMux() mux.HandleFunc("/v1/explorer/realtime", hub.HandleRealtime) ts := httptest.NewServer(mux) defer ts.Close() wsURL := "ws" + strings.TrimPrefix(ts.URL, "http") + "/v1/explorer/realtime" conn, _, err := websocket.DefaultDialer.Dial(wsURL, nil) if err != nil { t.Fatalf("dial: %v", err) } defer conn.Close() // Consume connected conn.SetReadDeadline(time.Now().Add(5 * time.Second)) conn.ReadJSON(&RealtimeMessage{}) // Send ping conn.WriteJSON(SubscribeRequest{Subscribe: "ping"}) var msg RealtimeMessage conn.SetReadDeadline(time.Now().Add(5 * time.Second)) err = conn.ReadJSON(&msg) if err != nil { t.Fatalf("read pong: %v", err) } if msg.Type != "pong" { t.Fatalf("expected pong, got %s", msg.Type) } } func TestRealtimeUnscopedSubscription(t *testing.T) { hub := NewRealtimeHub() ctx, cancel := context.WithCancel(context.Background()) defer cancel() go hub.Run(ctx) mux := http.NewServeMux() mux.HandleFunc("/v1/explorer/realtime", hub.HandleRealtime) ts := httptest.NewServer(mux) defer ts.Close() wsURL := "ws" + strings.TrimPrefix(ts.URL, "http") + "/v1/explorer/realtime" conn, _, err := websocket.DefaultDialer.Dial(wsURL, nil) if err != nil { t.Fatalf("dial: %v", err) } defer conn.Close() // Consume connected conn.SetReadDeadline(time.Now().Add(5 * time.Second)) conn.ReadJSON(&RealtimeMessage{}) // Subscribe to transactions without chain scope (gets all chains) conn.WriteJSON(SubscribeRequest{Subscribe: "transactions"}) conn.SetReadDeadline(time.Now().Add(5 * time.Second)) conn.ReadJSON(&RealtimeMessage{}) // subscribed // Broadcast from any chain should match hub.Broadcast("transactions", "zoo", map[string]any{"hash": "0xabc"}) var msg RealtimeMessage conn.SetReadDeadline(time.Now().Add(5 * time.Second)) err = conn.ReadJSON(&msg) if err != nil { t.Fatalf("read broadcast: %v", err) } if msg.Type != "transactions" { t.Fatalf("expected transactions, got %s", msg.Type) } if msg.Chain != "zoo" { t.Fatalf("expected chain=zoo, got %s", msg.Chain) } } func TestRealtimeStatsEndpoint(t *testing.T) { hub := NewRealtimeHub() mux := http.NewServeMux() mux.HandleFunc("GET /v1/explorer/realtime/stats", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(hub.Stats()) }) ts := httptest.NewServer(mux) defer ts.Close() resp, err := ts.Client().Get(ts.URL + "/v1/explorer/realtime/stats") if err != nil { t.Fatal(err) } defer resp.Body.Close() if resp.StatusCode != 200 { t.Fatalf("expected 200, got %d", resp.StatusCode) } var stats map[string]int json.NewDecoder(resp.Body).Decode(&stats) if stats["connections"] != 0 { t.Fatalf("expected 0 connections, got %d", stats["connections"]) } } }xxYmoF, qQ9E\zH|\q0|Z\I]Ҷ٥Df͇vwޞyff]鹚kUZ i^p8t1-?ՖE揬Ggs}%mmQ^e1 u^V8--Up- x,f=K mILӔHU<Iʹ/Q l:e'ۀX>To,])X) ?P{()Mիq~Tv1?b6:6](ϧBFL@>+= VW AD->_0R>>7:թDa,ĽD:8o<  0mH^},2R4AZǭ)'?/6upDPL9Ue4Λ퉒d JH/~ͣsE)xd GQƄ.REm`\ 9 yeTr*;A~(ISeEa>X% QgK>c(Ѹq)x9)[*{@mKl-"ZTlǗv=-}q=܏[9AKxKc;݊OkʕCX4/Zg!cGHKO7χ<콮3Y-i LDE+#PgK6ZCyYK]{Ntn9Ð-z(IMr9-Eoh~&֞][i&=nЎbߎچW')ecٶqzj`cM˚Hm+|W.kU ;S Q(pIIeRh;Fl?:\G=]EI m-yeU\3M8!+!ݹh)R%UUHB|J {im,ϸ4n5ǻ<  ylU0+Tktj2drd}%&3J ?lu6e,m3aTd;q{aB/AK,Hw7&m=&9&\ _F.G^kK2# :RЗ5ߦC0dIbS[}5.Wst(Z9onNnB 2rѡ|XKֵI=?utĝ1XߛAY焟"$m!t2AC ̇^8W4d@=2|+<-CLVCh?\ j,=hnGW*)]jJ4xU::JT1; legacy `chains: [...]` YAML shape used by tests and the // minimal config. The full Config struct in config.go is the canonical schemapE< sup *ChainSupervisor // nil = registry-only mode (tests)ZttachSupervisor wires a ChainSupervisor so admin/config/mdns adds also // spawn per-chain indexer + graph goroutines, and removes cancel them AttachSupervisor(s *ChainSupervisor) { r.sup = s } // Add registers a chain. mDNS-sourced chains never override higher-prioritLy // (config/env/admin) entries; admin/config/env duplicates return an error .B .mu.Unlock()Kd .mu.Unlock()K(0{!.mu.Unlock() return nil }1 r.mu.Unlock()?) if r.sup != nil { r.sup.start(cfg) }/ t % .mu.Unlock() , r.mu.Unlock() ) if r.sup != nil { r.sup.stop(slug) }5 " ) .mu.Unlock() " 8 $( updated := entry.Config r.mu.Unlock() u @ if r.sup != nil { r.sup.stop(slug) r.sup.start(updated) } ! ճ >d using the legacy `chains: [...]` // shape. Full Config (with brand, networks, etc.) loads via LoadCn OvK\c.WS = os.Expand(c.WSi/aI2&N[5B“س`pZ-xZO9+eYFc/GUQO93DZ'$Jp3gΜw?_I1ø '$ͅ8wNt5+ZU6*wCǃ㳓4L0[N/io2TdF"~3Y u/~;Ճ xu263 A.l 9+r0 bΥoYVk Z ! _Q-$^[^nDJNk(luð+!&U8d&@F䘼 Vo?JmL㛵$ay4$Y>Iw&-8In[+NFAȁ'r2=ST 1pQx'abZy1E̻'QyH<_&ri/9ydBP GOsGyw8* 4JRyieI 36o%i ٧S8+/쨡g:`ԆWfs2 !~F?vB'9菀i#=}FsUsQ;}Jsu)ԨXT(XLKȃ]s[SBuDE)m`.ſ%qAIo6j7 lབྷ>QTg(JOQ80Uc kV0J׬fmlmDZ% {6Zȴm!]A`߃:,P:WQ5>yVۛmM:@RɆ/w]d4~tkQ GJTc[o|{hD|ZQG8hWGzrb%jx68ZynRqIy8b\CזE esv.&,$Hf7J%4C~l}y(Ե[I!51fAlon$W±Lj|Yް 0)K;:Wr~! {fk8%Cn٧Jj=!%2kS!wF6Ry 8mnx|d}•Ҹr-&P8PFSP.z/#5+:r?xx]u7up]tX4A|#Wx@KF'Y{N[L{V3M,[Jv/I";]aֶQOJ` mRE&&[KLhR;Hz{U2R}'NeB j޴r g-5Joq嵰PlQ?P!X "dMT@j!ΖE5z943 A S3%6X,6<(s?e3HKȠҡ|fUA/L5$A( Q%q0q8iȅ 4R=hÂ#S[ۯITt<{FⓈzӆ2hPGLԡd;7 aK*l#9hfI*j^",M&k-o8C >w;~bD3hw/U+7zt;mSW_h^4=ĺ:1Ş ׌l1kWb,tQV/on;B+c9oLu2#jw-1 ^&c+7^sa[1C^Effͣs &T봩7O>0n{fQ0Cb LZ̹H渳d,s ( dnO;I]#O@CE z&f{J,h%!P}䣢} %lCx VUnX &Ex*100755 healthcheck.sh}Rh<,viO=<_x#!/bin/sh # healthcheck.sh -- Check explorer health and report per-chain block counts # # Usage: ./scripts/healthcheck.sh [base_url] # base_url defaults to http://localhost:8090 set -e BASE="${1:-http://localhost:8090}" printf "Checking %s ...\n\n" "$BASE" # Health endpoint printf "%-20s " "/health" status=$(curl -s -o /dev/null -w "%{http_code}" "$BASE/health" 2>/dev/null) || status="unreachable" if [ "$status" = "200" ]; then printf "OK (200)\n" else printf "FAIL (%s)\n" "$status" exit 1 fi # Stats endpoint printf "%-20s " "/v1/explorer/stats" stats=$(curl -sf "$BASE/v1/explorer/stats" 2>/dev/null) || stats="" if [ -z "$stats" ]; then printf "FAIL (no response)\n" exit 1 fi printf "OK\n\n" # Parse per-chain block counts from stats JSON # Expected format: {"chains":[{"name":"...","chain_id":...,"block_count":...},...]} printf "%-16s %-12s %s\n" "CHAIN" "CHAIN_ID" "BLOCKS" printf "%-16s %-12s %s\n" "-----" "--------" "------" echo "$stats" | \ sed 's/},{/}\n{/g' | \ sed -n 's/.*"name":"\([^"]*\)".*"chain_id":\([0-9]*\).*"block_count":\([0-9]*\).*/\1|\2|\3/p' | \ while IFS='|' read -r name chain_id blocks; do printf "%-16s %-12s %s\n" "$name" "$chain_id" "$blocks" done # If no chains parsed, show raw stats if ! echo "$stats" | grep -q '"name"'; then printf "(single chain mode)\n" block_count=$(echo "$stats" | sed -n 's/.*"block_count":\([0-9]*\).*/\1/p') printf "%-16s %-12s %s\n" "default" "-" "${block_count:-unknown}" fi printf "\nDone.\n" "!xn100644 icon.svg^p`98(=0100644 index.htmlO;@6w4L100644 logo.svgÞ6 ѕ_|n%ʸ,( xY 2.xc Explorer
Loading explorer…
P{p۳x Explorer iQL xZSYU$0rzU^%@6bR5,kFưY﯏]>G%`c4L JZh,nk$ }w T%Ja8qDqYi3bA̧> oMj}(dz?P43R:+Qgè3ʂtܑ(J}GndQfvUv,vV36:alLcGk ?;Z8izTfjhv 3S YTf9(C4hR3 0>9X>բMdzѢs($Vm&J~&u2PY&ÔXfAVZ k艥V,A3wE"~Dx +sMdeh4i=S?rI;򭵇=h3A?8{l<wwHz&7:1A*@lCyPfX9tg}ݠa0Fz4,Rmu(D "fr=zE5SiNU2@1Ua?fɠ7*D94WrT V4fJ2D!_1߭ML,]c-޵F']mg.̪.`/J`vxjB%G_ܲUb&bVxLMImܕSS4:ӸK"%js-0ZXQUC]=:.:U9mQE/վ]ylDB `T~1gLܓYh03c J #lRjK.jq t_KOȟ͐OĨXv$g,MCtB 9&--#@ gC]T5(sC4wNcxL4r",n-KQ_G0t_#%P.i#`#T"I!+]Vp "fd$8 zH|=BEdA]9g򌦡H'=MCFLbRzDkkkb:J,b1(%/hآ PE;A.ޗJo"y3vU&h)P2&Cb㬃kDb>VlY J \ؤ-jP6  8*#K~} =5j/wƶxL,^0z!'ߚ 9b}m T\*\ ^r6,^Lx-Amo5Ԩ kH F6Ӌ7@ҀVPM#eMŦ5(,'Z ֓SߖEfVڿQ&c8D@5,;1ř]8:p'ۖPJa$C6dyX^)&̦rl4XiTva8|k0ӲJ38̞c@}T3ucמ87?~ ?Ӵ`90B_Clz\Ig@ u7@w`@K +tay\ ,ߡ4q_!QæaapdZͲ]GꤴD6]AFDr.~etr8TnJ]]κ&r \'a HP/Pk<9U(26/ڌE5׀2@v!aX _j=7%l c92(NH8_}]( $0T  D a Q~VϏ64\RO)=IH(HyW^o:+~k1ZsiڹG-Di0+5w=**\O->S{7Md J_ە\*Ĺe誤D.n cxe%2iJke`f~}s{ S9b)LU(O2xF'K!+ݾ;X;8??]ݺxwR0@V7ONP@: ݓ+>s%Fq2p wa)Sx|)42M\+`AҲe<-k2W=5r^Q>RQ xv(Id׽&Gg[أ8:Y|;5a bbYX`>ʫ,qR y,S0.?YsΖJcG Æ;n] $23nf1[mkm{v yWlڮl`c-[%_~,p-1;gE{a_(ېƘLS>/G[g2)^P7RV'kh-_=6N!m>?ʹiN0Y4ѿPAv9 Lx~xJ[EY7~/5B\V Iw̝ BwtJ)sZNU j,)ߪI`Oo CL$o^~I&- 4А$?K Mh@~ۀ^|YOD$ Y,XMC$/nx!dѼnٜ돽[9 .-O|,"L2sJU| ^QQMWx-^Q`Z^&}3j?e!L;װ]rcm CqksE8,W՞}tmaU{SQՐ{\LBg p)O7>o7sqDw@(LpL:C{zi1wÈMZ%HF\UYjnYWfMcқ! q PIs|0GGHhd%x]Y%Hlc9 X/~' z^rV;)dFX2%8`@vH` j"mu8h/-e{-͘E٠7x&100644 docker.yml3+ 뫜ʳXiÊ]5 7x51 0FQBGAp@p7D'4 &%IQ'+rs{TCقW>PRV6dy)p,H|mP:2H8::_o= "LhD}4GP&uD,d42#'t ??alBeُ88&ߣy%n}D xH100644 ci.ymliVPy s100644 docker.yml3+ 뫜ʳXiÊWa LPxname: CI on: push: branches: [main] pull_request: branches: [main] permissions: contents: read # go.mod uses local replace directives to ../indexer and ../graph. CI checks # out all three repos as siblings so `go build ./...` resolves without any # network hop to a tagged version. jobs: test: runs-on: lux-build-linux-amd64 steps: - uses: actions/checkout@v4 with: { path: explorer } - uses: actions/checkout@v4 with: { repository: luxfi/indexer, ref: main, path: indexer } - uses: actions/checkout@v4 with: { repository: luxfi/graph, ref: main, path: graph } - name: Verify build deps run: | command -v gcc || { echo "gcc not installed on runner"; exit 1; } gcc --version | head -1 - uses: actions/setup-go@v5 with: { go-version-file: explorer/go.mod } - name: Refresh go.sum (proxy cache inconsistency) working-directory: explorer run: rm -f go.sum && GOSUMDB=off go mod download env: GOSUMDB: "off" - name: Build working-directory: explorer env: GOSUMDB: "off" run: go build ./... - name: Test working-directory: explorer env: CGO_ENABLED: "1" GOSUMDB: "off" run: go test -race -count=1 ./... CdxH100644 ci.ymlB񩑎7[2tw^"100644 docker.yml3+ 뫜ʳXiÊ! ixk uInstall build deps run: sudo apt-get update -qq && sudo apt-get install -y --no-install-recommends gcc libsqlite3-dev :]q"1kx $>x0100644 scheduled_tasks.lockSg իFit)xZ{"sessionId":"cf4e8ffa-52d2-4e07-b22c-dbf44cba2479","pid":5284,"acquiredAt":1778041169393}gx( 7xH100644 ci.yml5T[jx6100644 docker.yml3+ 뫜ʳXiÊPjKx No]x5$1fx/`zmainnet-A< indexer: poll_interval: 30s start_block: 0  ^7 a logo_url: /logo.svg tokens: featured: [] allow_list: [] block_list: []e mAmainnet/ext/bc/2Y625Kvdd4wZ5LKx9kLSf1jGALyARmXVN1YsTb4F3Hzv4bPDbp hAmainnet/ext/bc/2GiQb73CeJESjc4omFv2YtQHZrRgJf25NXPzAr5J6UNHRcDV2FP h@mainnet/ext/bc/rtjwvtE1tEvrokmpeYdTq7b2zqZgmybKwR5MLjKMGAR1W78dQAmainnet/ext/bc/2pUskxqaL5Bpx7uRUGG1fDjPckjxQ4UKX4sLKeaS1NdSVBJd3FK,xH100644 ci.yml$JqvT-x100644 docker.yml3+ 뫜ʳXiÊnQx oW*=}x90*5Rl34569IHJ5hXOvrkjbadfKNt/2rGZd83vhcSIRSP10NIxO100644 actionlint.yamlj@\/B|V540000 workflowsn9w~4YQ_3a! \xOO;_,t]A xyself-hosted-runner: labels: - hanzo-build-linux-amd64 - hanzo-build-linux-arm64 - hanzo-deploy-linux-amd64 c&xw100644 ci.yml05-FW, RoRG)100644 docker.ymlbU/>4qZXq/100644 workflow-sanity.yml~z2/V)(>o.xww4-0V7Y=,x]H/ +xNwwH100644 ci.ymlm̏Ұ1IeiVZ›100644 docker.ymlDž_am1}79%H/!n\x(ww"100644 ci.yml+_-‚ hu.@"US/x3EhanzoH | Irun: | i ܾ%x^name: Docker on: workflow_dispatch: push: tags: ['v*'] permissions: contents: read packages: write # Multi-arch (amd64 + arm64) on native hanzo ARC runners. # No QEMU emulation. No GitHub-hosted fallback. # Semver-only tags (v*); see hanzoai/.github docker-build.yml. jobs: docker: uses: hanzoai/.github/.github/workflows/docker-build.yml@main with: image: ghcr.io/luxfi/explorer platforms: linux/amd64,linux/arm64 runner-amd64: hanzo-build-linux-amd64 runner-arm64: hanzo-build-linux-arm64 runner-deploy: hanzo-deploy-linux-amd64 secrets: inherit +q xbname: Workflow Sanity on: pull_request: push: branches: [main] jobs: sanity: uses: hanzoai/.github/.github/workflows/workflow-sanity.yml@main 25)xhname: Release on: push: tags: ['v*'] jobs: release: runs-on: ubuntu-latest permissions: contents: read packages: write steps: - uses: actions/checkout@v4 - uses: docker/setup-buildx-action@v3 - uses: docker/login-action@v3 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - uses: docker/build-push-action@v5 with: push: true platforms: linux/amd64,linux/arm64 tags: | ghcr.io/${{ github.repository }}:${{ github.ref_name }} ghcr.io/${{ github.repository }}:latest a$x/[name: CI on: push: branches: [main] pull_request: branches: [main] jobs: test:!7 setup-go@v5go-version-file: go.mod - run: go mod download - run: go test ./... && go build ./... docker: needs: test $ if: github.ref == 'refs/heads/main';main.\M>x`" - main) - mainN#hanzo-build-linux-amd64 steps: $"with: $'HPx$# Explorer Combined block explorer: chain indexer + subgraph engine + frontend in a single image. ``` ghcr.io/luxfi/indexer -- chain data: blocks, txs, tokens, contracts (SQLite) ghcr.io/luxfi/graph -- subgraph events: swaps, pools, DeFi, GraphQL (SQLite) ghcr.io/luxfi/explore -- Next.js frontend ghcr.io/luxfi/explorer -- all three combined (this image) ``` Each component runs standalone for independent scaling, or together in one container. ## Architecture ``` +------------------+ | Load Balancer | | (hanzo/ingress) | +--------+---------+ | +--------v---------+ | explorer:8090 | | (single binary) | +--+-----+------+--+ | | | +-------------+ +--+--+ +-------------+ | | | | +------v------+ +-----v-+ +v-----------+ | | indexer | | graph | | explore | | | /v1/explorer | | /gql | | /* (static) | | +------+------+ +---+---+ +-------------+ | | | | +------v--------------v------+ +-------v-------+ | SQLite per-chain (WAL) | | ZapDB KV | | /data/{chain}/index.db | | fast lookups | +----------------------------+ +---------------+ | +------v-----------------------+ | Replicate -> S3 (optional) | | E2E PQ encrypted (ML-KEM) | +------------------------------+ RPC Sources (per network): +-----------------------------------------------+ | api.lux.network/{mainnet,testnet,devnet} | | /ext/bc/C/rpc C-Chain | | /ext/bc/{blockchain_id}/rpc Subnet chains | +-----------------------------------------------+ ``` ## Quick Start (Local Dev) ```bash # Clone git clone https://github.com/luxfi/explorer-combined.git cd explorer-combined # Run against testnet C-Chain docker compose up # Or run the image directly docker run -p 8090:8090 \ -e RPC_ENDPOINT=https://api.lux.network/testnet/ext/bc/C/rpc \ -v explorer-data:/data \ ghcr.io/luxfi/explorer ``` Open http://localhost:8090 to see the explorer frontend. ## Run Modes ```bash # Combined (default) -- indexes chain + subgraphs, serves API + frontend docker run -p 8090:8090 \ -e RPC_ENDPOINT=http://node:9650/ext/bc/C/rpc \ -v data:/data \ ghcr.io/luxfi/explorer # Indexer only (chain data API) docker run -p 8090:8090 \ -v data:/data \ ghcr.io/luxfi/explorer \ indexer --chain cchain --rpc http://node:9650/ext/bc/C/rpc # Graph only (subgraph GraphQL) docker run -p 4000:4000 \ -v data:/data \ ghcr.io/luxfi/explorer \ graph --rpc http://node:9650/ext/bc/C/rpc ``` ## Multi-Chain Configuration Use `chains.yaml` to index multiple chains in one instance. See `chains.example.yaml` for a complete template with all Lux networks. ```bash docker run -p 8090:8090 \ -v ./chains.yaml:/etc/explorer/chains.yaml \ -v data:/data \ ghcr.io/luxfi/explorer --config /etc/explorer/chains.yaml ``` ## Per-Network Deployment ### Mainnet ```bash docker run -p 8090:8090 \ -e RPC_ENDPOINT=https://api.lux.network/mainnet/ext/bc/C/rpc \ -e NETWORK=mainnet \ -e CHAIN_ID=96369 \ -v data:/data \ ghcr.io/luxfi/explorer:v0.1.0 ``` Mainnet chains and their RPC endpoints: | Chain | EVM Chain ID | RPC Endpoint | |---------|-------------|----------------------------------------------------------------------| | C-Chain | 96369 | `https://api.lux.network/mainnet/ext/bc/C/rpc` | | Zoo | 200200 | `https://api.lux.network/mainnet/ext/bc/2Y625Kvdd.../rpc` | | Hanzo | 36963 | `https://api.lux.network/mainnet/ext/bc/2GiQb73Ce.../rpc` | | SPC | 36911 | `https://api.lux.network/mainnet/ext/bc/rtjwvtE1t.../rpc` | | Pars | 494949 | `https://api.lux.network/mainnet/ext/bc/2pUskxqaL.../rpc` | ### Testnet ```bash docker run -p 8090:8090 \ -e RPC_ENDPOINT=https://api.lux.network/testnet/ext/bc/C/rpc \ -e NETWORK=testnet \ -e CHAIN_ID=96368 \ -v data:/data \ ghcr.io/luxfi/explorer:v0.1.0 ``` ### Devnet ```bash docker run -p 8090:8090 \ -e RPC_ENDPOINT=https://api.lux.network/devnet/ext/bc/C/rpc \ -e NETWORK=devnet \ -e CHAIN_ID=96370 \ -v data:/data \ ghcr.io/luxfi/explorer:v0.1.0 ``` ## White-Label Override branding via environment variables. No code changes needed. ```bash docker run -p 8090:8090 \ -e RPC_ENDPOINT=http://node:8545 \ -e CHAIN_NAME="My Chain" \ -e COIN_SYMBOL=MYC \ -e COIN_DECIMALS=18 \ -e LOGO_URL=https://example.com/logo.svg \ -e FAVICON_URL=https://example.com/favicon.ico \ -e BRAND_COLOR="#FF6600" \ ghcr.io/luxfi/explorer ``` | Variable | Default | Description | |---------------|---------------|----------------------------------| | CHAIN_NAME | Lux C-Chain | Display name in header/title | | COIN_SYMBOL | LUX | Native coin ticker | | COIN_DECIMALS | 18 | Native coin decimal places | | LOGO_URL | (Lux logo) | URL or path to header logo | | FAVICON_URL | (Lux favicon) | URL or path to favicon | | BRAND_COLOR | #1a1a2e | Primary brand color (hex) | White-label detection in production uses hostname-based routing. Each `*.lux.network` subdomain resolves to the correct chain branding automatically. ## PQ Encrypted Backup The explorer supports post-quantum encrypted backups to S3-compatible storage using ML-KEM-768. ```bash docker run -p 8090:8090 \ -e RPC_ENDPOINT=https://api.lux.network/mainnet/ext/bc/C/rpc \ -e BACKUP_ENABLED=true \ -e BACKUP_S3_ENDPOINT=https://s3.lux.network \ -e BACKUP_S3_BUCKET=explorer-backups \ -e BACKUP_S3_ACCESS_KEY= \ -e BACKUP_S3_SECRET_KEY= \ -e BACKUP_INTERVAL=6h \ -e BACKUP_PQ_ENCRYPT=true \ -e BACKUP_PQ_PUBLIC_KEY=/etc/explorer/backup.pub \ -v ./backup.pub:/etc/explorer/backup.pub:ro \ -v data:/data \ ghcr.io/luxfi/explorer ``` Backup flow: 1. SQLite checkpoint (WAL flush) 2. Snapshot all chain databases 3. Encrypt with ML-KEM-768 (post-quantum KEM + AES-256-GCM) 4. Upload to S3 with content-addressed naming 5. Prune old snapshots per retention policy Store secrets in KMS (kms.hanzo.ai), never in environment files committed to git. ## Performance (LP-104) Benchmarked against Blockscout (Elixir) on identical hardware (4 vCPU, 8 GB RAM). | Metric | Explorer (Go+SQLite) | Blockscout (Elixir+PG) | |--------------------------|---------------------|------------------------| | Block indexing (blocks/s) | 850 | 120 | | API latency p50 (ms) | 2.1 | 18 | | API latency p99 (ms) | 8.4 | 145 | | Memory at 1M blocks (MB) | 180 | 2400 | | Disk at 1M blocks (GB) | 1.2 | 28 | | Cold start to serving (s) | 0.8 | 45 | | Concurrent requests (rps) | 12,000 | 800 | ### Cost Comparison (monthly, per chain) | Setup | Explorer | Blockscout | |--------------------|-----------------|--------------------| | Compute | 1 vCPU / 512 MB | 4 vCPU / 8 GB | | Database | Embedded SQLite | PostgreSQL 2 vCPU | | Storage | 2 GB SSD | 30 GB SSD | | Estimated cost/mo | ~$5 | ~$80 | | 5 chains x 3 nets | ~$75/mo | ~$1,200/mo | ## Endpoints | Path | Description | |--------------------|------------------------------------| | `/health` | Health check (200 if indexing) | | `/v1/explorer/*` | Chain data REST API | | `/v1/explorer/stats` | Block count, tx count, sync status | | `/graphql` | Subgraph-compatible GraphQL | | `/*` | Embedded frontend (static) | ## Environment Variables | Variable | Default | Description | |-----------------|------------|------------------------------------------| | RPC_ENDPOINT | (required) | EVM JSON-RPC URL | | HTTP_ADDR | :8090 | Listen address | | DATA_DIR | /data | Database storage directory | | NETWORK | mainnet | Network name (mainnet/testnet/devnet) | | CHAIN_ID | (auto) | EVM chain ID override | | LOG_LEVEL | info | Log level (debug/info/warn/error) | ## Related - [`luxfi/indexer`](https://github.com/luxfi/indexer) -- Go chain indexer - [`luxfi/graph`](https://github.com/luxfi/graph) -- Subgraph engine, Graph Node replacement - [`luxfi/explore`](https://github.com/luxfi/explore) -- Next.js frontend - [`luxfi/explorer-v1`](https://github.com/luxfi/explorer-v1) -- Legacy Elixir stack (archived) 3x # chains.example.yaml -- All Lux chains across all networks # # Copy to chains.yaml and adjust as needed: # cp chains.example.yaml chains.yaml # Mainnet (network-id=1) mainnet: cchain: name: "Lux C-Chain" chain_id: 96369 rpc: "https://api.lux.network/mainnet/ext/bc/C/rpc" coin_symbol: "LUX" zoo: name: "Zoo" chain_id: 200200 rpc: "https://api.lux.network/mainnet/ext/bc/2Y625Kvdd4wZ5LKx9kLSf1jGALyARmXVN1YsTb4F3Hzv4bPDbp/rpc" coin_symbol: "ZOO" hanzo: name: "Hanzo" chain_id: 36963 rpc: "https://api.lux.network/mainnet/ext/bc/2GiQb73CeJESjc4omFv2YtQHZrRgJf25NXPzAr5J6UNHRcDV2F/rpc" coin_symbol: "HANZO" spc: name: "SPC" chain_id: 36911 rpc: "https://api.lux.network/mainnet/ext/bc/rtjwvtE1tEvrokmpeYdTq7b2zqZgmybKwR5MLjKMGAR1W78dQ/rpc" coin_symbol: "SPC" pars: name: "Pars" chain_id: 494949 rpc: "https://api.lux.network/mainnet/ext/bc/2pUskxqaL5Bpx7uRUGG1fDjPckjxQ4UKX4sLKeaS1NdSVBJd3F/rpc" coin_symbol: "PARS" # Testnet (network-id=2) testnet: cchain: name: "Lux C-Chain (Testnet)" chain_id: 96368 rpc: "https://api.lux.network/testnet/ext/bc/C/rpc" coin_symbol: "LUX" zoo: name: "Zoo (Testnet)" chain_id: 200201 rpc: "https://api.lux.network/testnet/ext/bc/2Uw1b5tf63vamHsWVeSW9uHcGBVbF5CYHS9JiLWttusY4Vvjsn/rpc" coin_symbol: "ZOO" hanzo: name: "Hanzo (Testnet)" chain_id: 36964 rpc: "https://api.lux.network/testnet/ext/bc/2wbYEFh7ELuovqXhyYeCLvweZrcEgNUoZVJUAtw145qTVAUJxE/rpc" coin_symbol: "HANZO" spc: name: "SPC (Testnet)" chain_id: 36910 rpc: "https://api.lux.network/testnet/ext/bc/u4pC2tT61o83pbQ8qwAyfXXGF6nyGFNSwCYHEFcUeESGiNKfu/rpc" coin_symbol: "SPC" pars: name: "Pars (Testnet)" chain_id: 7071 rpc: "https://api.lux.network/testnet/ext/bc/is5GUzsKHk3Z4Q5JXTjF4Ld9p4TnEs81tJFdaBiEBJVkaFrrs/rpc" coin_symbol: "PARS" # Devnet (network-id=3) devnet: cchain: name: "Lux C-Chain (Devnet)" chain_id: 96370 rpc: "https://api.lux.network/devnet/ext/bc/C/rpc" coin_symbol: "LUX" zoo: name: "Zoo (Devnet)" chain_id: 200202 rpc: "https://api.lux.network/devnet/ext/bc/2caKCdNop9C4oAPR1kYihN53HeSRDXD3JyMKS7ntfcpQYucmii/rpc" coin_symbol: "ZOO" hanzo: name: "Hanzo (Devnet)" chain_id: 36964 rpc: "https://api.lux.network/devnet/ext/bc/tecXMucYDxwN65mebPE6cvQ9GynG6Y5WEvwGFsY3xVDWHxiqT/rpc" coin_symbol: "HANZO" spc: name: "SPC (Devnet)" chain_id: 36912 rpc: "https://api.lux.network/devnet/ext/bc/213ZsFLRCBSmrii4huQqa6S3SxYPP8ec6dPEn6ad4CtLk3RdXp/rpc" coin_symbol: "SPC" pars: name: "Pars (Devnet)" chain_id: 494951 rpc: "https://api.lux.network/devnet/ext/bc/MEGAgimfcodi7QaqCruFpTkNM6fqu7ZduLmWJJjGQwUg8uDPJ/rpc" coin_symbol: "PARS" ׉jx(eni^fZfjD/&3N1(LfFJs(ZLNUa22Rŕy Q12dJs|=}}̢̼.M.5 $`5Rx];fq iԤ$Qn=;s b1`{9fے-S۹cөCU j~. Ub%N߳wOOr ^>\=zﾇo!/q8 GGvu po6i `!v8_P+$P?ĩ{P1b| ,`2EYJ)KʖTO 5snGhlh]\+ݯӊ}Bwz1{],xtI ډ^ĜT3zL/"odOΩ0DC{nNmk^֣kHI9lqʮ.bJRr>UȽ*Um./vO [m*gXLE%|] IKުG^@ ;a"v\_5ʽH歑}k~s0u ⣼* l:N*}֊,*4զ25ou2SwF =%U}CR 69"LXdy9(3F󈇿ϼilPI(bɆYp}naoJ- _|JNhi %#k\9]Vf:+ȥԬ(u^b(W`vJFvcq-6q/=clPƤ$ݵE`pM𫢂wʷA+xWn6}8RҢMǹ"h[L]G %R{[@ə3ù+\%O%K f2"a)ϔ i*&FQ)M{i&X@-iY͘%i=.v/c?"KX1A;+eL}vHx!~x)׃[C=AݎͲ j=8*`j=Q*=U h׭Q{U0p\8U)P!q]҉S\"C= oU)?HGtA$`K |,*1yFtǜͤ Gg9#Fx`&OX&QYyHW"wj;Ϥ5]}mk:s5H3ݍx$۫POL%sEx3ۈo p F =D3@@JD+ӌglֺ鳝Fxgk!H5ū6L_TP:oZpHvfhD8[k@b“ӊXE9a#VC(;_P.˧nx;,!xn,J\O.tAd4LayX5(-H95qS#ti/Eal>X@1` I7YZԢt^S8 bOxAù >ۋ.xVg,C&ӱ}`;=w}] xe#!/bin/sh # Patch Go embed directive to include _next prefixed files sed -i 's|//go:embed static/\*|//go:embed all:static|' /src/cmd/explorer/frontend.go 55x# rebuild 1776010884 B_x$40000 workflowsn9w~4YQ_3ax$40000 workflowsɿAnc t6k:xr ubuntu-latestn Wx,lux:lux'lux( lux-build<"vox$40000 workflows 9[zǗ>LBtrDx;2branches: [main, dev, test]-Dsecrets: inherit nmx$40000 workflows2A(ZLM`*Բ x340031QH*Iѫap|*co}t> /xN%n%I100644 ci.ymlt&_XU100644 release.yml0*Yٺ$4Azb'^GCxUMo0 WCCqHV$Zlɐ4A>RJ:mw/I|z(Ǖ3He VKN F87LRtƲ`dJh;R] `V:m$,I2\2QN0m ׭9$g&RԆv^-Ʋ@#f3Tv opF.6oRyBC,-hKU-@\2nM!|?fوV58;Q)R+ jP98"[#+E:#z+1-ST"uMZHgr["2дs=* 7:3֒ 08t1@;\CFy2 eF1צW kIYg15l_|?^}IN; t)jjԒ6ҐEhc^J!Lmh28;){a9tԅ|W5A?? # w y,\{p>gP6b^11)&i56b9)< ۦٿvڽ 搅LASr sW=Z :`!uaU(Čy>k=-Gœ9 #mTPT0J-6FS@&b=B Km:jߍXZ̈́^辽ݝrطxl=ϴ_oxxM<lux-build-amd64ulux-build-arm64lux-build-amd64+x$40000 workflowswr6'`/2q<0Dx{E3K2J"z_v]\vUu 7*20qI*qZʱ&o?Ax$40000 workflows[LdC2B_XNx%100644 build.ymlt͑Ӱ.W[lc5x{eC<[#[KjHHmSŌxxUJAEK (6 aMK"i-l0; ټMTqZƏv6+Q˻?_:ss!H@ᚧ ̐ʙɤJ`Y~1#zK4PC ^ӊڛmݺui%TI>g 2 )Tr¦Y2*%6,1`eL dXԑWOWSJOĊcRӎ]{6nt̟(;FB)bflɟxcaeџr>'lq=UUrӿxm|Uvx{eC<ӽ&{n,s+O+H;)hePhd30mRs뾪@!XS,ʜSi`:%CcCՔ/S .R \zEΧp Jp"A>d٬BAhsS88R8 xIkDF 6#2I%??@+z*j]m=¦EĠMFG'+t:zbJ#""+@$t AaBşR/VPdX4E 6%1` hG9 *<jow_(?yP5%38ah1pzm0N4=PhH L^ ܪ"IQĢ[nMOO hZfLb0ȢD¡LDN\~uh\_{^Gĉˣ>?d] ;biWQĥ+z)M2Tv"Dh`O 3B1oEx#4MC=jHpv 5GZ(A$7l~t2_Wi!f^I=G:W+JzޔZZs1̦`}YظA2&^ +0.2kw F ,'*ojt0c x _B+&p<s ix}Q=J@F2,RXKp-"2;31I$K9D."xkd7+f-f/X,i&dz,s%QκaRT #E*J=`JfGA6ȲE\ r-?؆Hg:sQMB9uI'knkωRD2`U\}]}@\ո仪xt[]8M]sM`dZ Sh7֡77C2Kkx _R;,V]_soKx]J@m3@u!XHpQ.(J 3Ӛ&a2J)|n|µϠ ssmb؋<N箃c&u#MQ?2l*zg\*uԲZ!ۆb7p}Fa@t]LܗjHSRddqsR+.*}bo2*lmĊ"asaA\860["x8~2L=3sʴP&k1){ l۞wb;g~S#|knGI,(3#ff' D~sT`ɕ|Cdc8( aU#Wq7Ԇ<x{4Aseꓝ;x)).gitignoreZcViZ72"^ xh40000 .github*M (Q7׫a100644 Dockerfile^&V-c100644 README.mdKVѤK9 *100755 patch-embed.sh6&ͫ(Y_u?wJ*Vx9 x$40000 workflowsb2oQ`fwXQd(j׋Vz إx%100644 build.yml/x%=A,: rx(sĉ 򓊭RS@,Ҽb<+ҤҼRݜĒoŊSKJ tJ3sR*tK2ʌ'Ma/P[SZZQ_Z46[*6wZ%'&gZ)Tڦg$mtI>BR'7?%67bZɦ~^Dc)x]RMkA&PXIҠֵnj>Bݷm73YIC[urg _x&ƥ<~<ǟ||~ק ۹J{IQeV>L寥wD"xr(.(8DhwQ,^)iGՅ"Ț}l'wL+Mn@[D5k8 |ƓLudUhQ= Z<}O',^kjH_e=Kf\gbVO|X@~qx9S0::#q(CΨ@g ʄ>k`șn3z 4ax&>?rƏKB|Ǝ Tӹa߳^u5B.L}hlk'MbR4Ǫ