# v2 git bundle 6d9764e6ea1e2f689eb9a47ec743655f8d766555 refs/heads/bundle 6d9764e6ea1e2f689eb9a47ec743655f8d766555 HEAD PACK$-x"tree 533a223a4a6a05fc74cb6c11ab0d3684a0272400 parent a3477f6bfa40f7f4b1ffdf445de792f2422d756f author Zach Kelling 1781115662 -0700 committer Zach Kelling 1781115662 -0700 fix(spa): brand merging + env-tag canonicalisation - BRAND is now a merge of SERVER_BRAND (chains.yaml-supplied) and INFERRED_BRAND (host parser table). Server wins on name/coin/accent when it's non-default; inferred fills in iconUrl/logoUrl when the chain config doesn't carry per-brand SVG paths. Stops Zoo rendering with the default Lux favicon when chains.yaml omits icon_url. - networkFromHost now canonicalises "test"→"testnet", "dev"→"devnet" so the dropdown label matches the server-side VITE_CURRENT_NETWORK. Ν8xrtree c961de9403495557c9b2fdb3af810c6ae6457625 parent b65e5ce9c6064e82b14e734ef028d2165d1916e0 author Zach Kelling 1781114859 -0700 committer Zach Kelling 1781114859 -0700 fix(spa): client-side network derivation fallback for older images The Go-side networksForHost was added in v1.2.20 but the deployed image is still v1.2.18 (CI pool gap — lux-build AutoscalingRunnerSet is missing from arc-system). The SPA now also parses location.host client-side so the network switcher works when /envs.js doesn't ship VITE_CURRENT_NETWORK / VITE_NETWORK_HOSTS. Same shape rules as the Go side: explore.{brand}.{tld} (mainnet, preserve tld), explorer.{brand}-test.network (testnet, .network is canonical). Numeric and *.local hosts skip the dropdown. This lets us ship the cross-network switcher via an EXPLORER_STATIC_DIR overlay (ConfigMap-mounted SPA) without rebuilding the image. 3^xtree c80d86484e1d9fae913ea8a910bfaf7c79fbd98a parent d7baefc3b8b37e83376aaf50c4d0aec1db4efd9e author Zach Kelling 1781114715 -0700 committer Zach Kelling 1781114715 -0700 feat(frontend): cross-network switcher (mainnet ↔ testnet) in SPA handleEnvs now returns VITE_CURRENT_NETWORK + VITE_NETWORK_HOSTS so the SPA can render a Network dropdown next to the Chain picker. When the user picks "testnet" from explore.zoo.network the SPA redirects to explorer.zoo-test.network (and vice-versa). Sibling host derivation lives entirely in Go: - parseBrandEnv extracts (brand, env, dotted, ok) from any of our deployed host shapes — explore.{brand}.tld, explorer.{brand}-test.network, explore-{brand}.lux.network, explore-{brand}-test.lux.network. - networksForHost composes the sibling map. Mainnet TLD is preserved when the user is on a brand-owned host (explore.hanzo.ai stays .ai); testnet is always {brand}-test.network because that's the canonical shape. - isValidBrand rejects numeric stems so an IP host (10.0.0.1) doesn't fall through to "explore.10.0.0.1" / "explorer.10-test.network". SPA renders the dropdown above the chain picker; hidden when the host yields fewer than two siblings (local dev, admin tooling). Tests cover all four canonical surfaces (lux+zoo × mainnet+testnet), hanzo's TLD asymmetry (.ai mainnet → .network testnet), the explore-{slug}.lux.network prefix shape, and the unparseable-host guards (IPs, in-cluster service names, localhost). >xtree c08b7d0a8bbefd9faf6dd8fe59ba3379c6698e95 parent 8f103933932a783da0a8f82bd117d473e0f0dd47 author Zach Kelling 1781113587 -0700 committer Zach Kelling 1781113587 -0700 fix(brand): per-host whitelabel + default-chain — covers *-test.network - host matcher now accepts explorer.* (alias of explore.*) and {prefix}.{slug}-{env}.tld shapes — so explorer.zoo-test.network resolves to the Zoo brand (was falling through to Lux default). - new chainSlugForHost helper drives a default-chain promotion in handleEnvs: when the host pins a chain, the SPA opens on that chain instead of the config-default cchain. explore.zoo.network now defaults to Zoo, not C-Chain. - factored host matching into pure hostMatchesSlug predicate so brand and slug paths share one ground truth. - tests cover both regressions (explorer.zoo-test.network → Zoo, explore.zoo.network → slug=zoo) plus the existing cross-contamination guards (zoofoo must not match zoo). Z&x tree ea82f477bc4ab46c6f59af4e9fe06a4e51ffc64e parent e5156b7cb5efc829ca0f0c92443a2a825b175ed5 author Zach Kelling 1780808721 -0700 committer Zach Kelling 1780808721 -0700 go: 1.26.3 → 1.26.4 (security: crypto/x509, mime, net/textproto) ?Q xtree c0d884c572efe675e44d5dd11a3e6f6dad153f95 parent 9631f27f4b2dd58a73b8c35792482be85fb9d880 author Zach Kelling 1780700385 -0700 committer Zach Kelling 1780700385 -0700 docs: document the unified explorer bundle deployment luxfi/explorer + luxfi/graph + luxfi/explore now ship as ONE Deployment per env on lux-k8s. CLAUDE.md describes the 2-container sidecar layout (explorer Go + explore Next.js), image versions, manifests, and verified public URLs across mainnet / testnet / devnet. 3ݫcx4tree f8d20596c9169308b7ce9ea28fd7c64ba70b8c7e parent b76299d500648b717a45ab35d024af21173ec3db author Zach Kelling 1780697122 -0700 committer Zach Kelling 1780697122 -0700 fix(frontend): match per-chain Brand for explore-{slug} / api-explore-{slug} hosts brandStruct only matched bare "{slug}" and "{slug}.tld" host shapes — but the unified explorer ships behind IngressRoutes whose Host() patterns are exclusively `explore-{slug}.lux.network` and `api-explore-{slug}.lux.network` plus brand-owned roots like `explore.hanzo.ai`, `explore.zoo.ngo`, `explore.pars.network`. With the old matcher every per-chain host fell through to BrandDefault ("Lux Explorer"), so per-chain theming silently no-op'd in prod (verified 2026-06-05: explore-hanzo.lux.network /envs.js returned "VITE_BRAND":{"name":"Lux Explorer"} instead of Hanzo). New matcher recognises the four prefix shapes the IngressRoutes produce, both with and without an env suffix (-test / -dev): - explore-{slug}.tld... UI host on lux.network - api-explore-{slug}.tld... API host on lux.network - explore-{slug}-{env}.tld... UI host for testnet / devnet variants - api-explore-{slug}-{env}... API host for testnet / devnet variants - explore.{slug}.tld... UI on brand-owned domain - api-explore.{slug}.tld... API on brand-owned domain Plus the prior bare-{slug} and {slug}-prefix shapes for backward compat. Test coverage: TestBrandStructHostMatching, 18 cases incl. the explore-spcfoo cross-contamination guard ensuring partial-slug- suffix matches don't bleed. ӭ% txJtree 5ec2f38deccfc4f8f9b7f7dfeceab992e4d43f15 parent 0acc759fe9f1788964f87ca4718250d19f036709 author Zach Kelling 1780682753 -0700 committer Zach Kelling 1780682753 -0700 feat(frontend): runtime static-dir overlay + substantive SPA shell Two related changes that get the explorer SPA rendering real chain data without waiting for upstream luxfi/explore to ship a Next.js static export. 1. Runtime SPA overlay (config.go, frontend.go) New cfg.StaticDir (also EXPLORER_STATIC_DIR env var). When set, the frontend prefers the on-disk copy of any static asset over the embedded FS — so a ConfigMap-mounted SPA shell replaces the embedded 60-byte placeholder without rebuilding the binary. The embedded FS remains the source of truth at build time and the fallback when no overlay is configured. handleSPA + serveBrandFile both check overlay > embedded. Tests cover overlay-present, overlay-missing-file fallback, no-overlay, and env-var-only configuration. 2. Substantive SPA shell (static/index.html) Replaced the 60-byte stub (
) with a vanilla JS SPA — ~7KB, zero dependencies, no React/Next.js. Reads window.ENV from /envs.js, fetches /v1/indexer/{slug}/{stats,blocks, transactions}, renders KPIs + Latest Blocks + Latest Transactions with per-chain switching and brand color/title overrides. Polls every 15s. Stores selected chain in URL hash + localStorage. This is the explorer's default UI until upstream luxfi/explore ships output: 'export' and the Dockerfile's optional pnpm-build overlay activates. Dockerfile: drop the leftover merge-conflict markers around the SPA build stage, keep the explanatory comment. Tests: 4 new in frontend_test.go covering overlay precedence + env-var fallback. All existing tests (registry, realtime) still pass. Tx1tree e28c6b94f71317e534e00002089e579f8952751c parent a1094dbac24bdbedc528ca2c48103a3fdfc9b2c4 author Zach Kelling 1780423898 -0700 committer Zach Kelling 1780423898 -0700 chore(deps): go get -u ./... Updated dependencies to latest minor versions via go get -u + go mod tidy. 0]Wxtree 203ccfdb424dfcebde8e5c8c3a0f5c3f6aca776e parent 7f3f1b64a235cd1e8af879aae47eef154f5981d1 author zooqueen 1780289380 -0700 committer zooqueen 1780289881 -0700 Add Claude Code project docs (CLAUDE.md, LLM.md) Co-authored-by: Hanzo Dev V xtree 840eafe94434197f464f52e254277f7f558dea7d parent ef2c3f454e18b8daaf495c8361c4c090855ff35c author Zach Kelling 1779747200 -0700 committer Zach Kelling 1779747203 -0700 chore: brand-neutral cleanup — remove cross-tenant references aSxKj0>EC6ńǖEDddY&s Y=( *VOc3l)2%8Qӥnj@ΎEq6%Cbkd >k;n\J&494hq8i-趿u>|)g^(w˵) 'c? wUx]N 9$>W(ݲc6 F P^V735zJjeFXgC-)V8N 4:+1TM zN16_HLQS4PJZWVZh)O`y):ʷ{йLMkh3aAH;!NpHjZ y;8ވ T~{gږr, s30@Z3[kF[ˎ}2x/tree 68a63bc88e9feb5fbd10abd209fe87bf4f419ded parent 3372680a90d8599a2193f2d564a7b06c06bf5233 author Darkhorse7stars 1779620243 -0700 committer Darkhorse7stars 1779620243 -0700 deps: bump indexer to 0.20260524105612-65220f1104cd Pulls luxfi/indexer#9 — formatAddress + addrCounters now read both the legacy `transactions_count` / `contract_code` and the SQLite-backed `tx_count` / `code` column names, and coerce nil counters to int64(0) so the Blockscout-derived SPA can call .toLocaleString() without crashing. Repros against rpc.dev.redacted.com: GET /v1/indexer/evm/addresses/0x58a86aafb6cdd0989c799353c891e420fb530e0a returned transactions_count: null + is_contract: false for a real deployed AMM pool → now returns the actual tx count + is_contract: true. -OW/x tree b32d9907be943012c2b933d9f5964669730e2a6f parent 18e50c5b7af2fbea4f3c0579ff6fe96704ff8229 author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779617218 -0700 committer GitHub 1779617218 -0700 ci: drop arm64 QEMU build (2h -> ~5 min) (#11) The previous matrix did linux/amd64,linux/arm64 with arm64 via docker/setup-qemu-action. QEMU-emulated builds of this image (Next.js SPA + Go cgo-sqlite) ran for ~2 hours per tag — fast enough to bottleneck every hotfix tag. Drop arm64. Cluster runners are amd64; Mac devs already run native arm64 under OrbStack with its own arm64 base story. If we ever need an arm64 multi-arch index, the right path is a second matrix entry on a native arm64 runner — not QEMU.8]x)tree 2d465242887e048e5300993fd4cb9bdebd7d736f parent b851be4241a812d3b94ad7bd53cdb1f5bf36e762 author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779608652 -0700 committer GitHub 1779608652 -0700 indexer: wire chains[].indexer.start_block + default devnet chainId (#10) Two related fixes for running the explorer against a mainnet-fork devnet: 1. Honor the per-chain `indexer.start_block` field from chains.yaml when the indexer DB is fresh. Without this the indexer always backfills from block 0, which on a mainnet fork is 25M+ blocks of irrelevant pre-fork history. Now an operator can set: chains: - slug: evm rpc: http://anvil:8545 indexer: start_block: 25162000 and the indexer skips to that block on first run. Once any rows exist in evm_blocks, start_block is ignored and indexing resumes from MAX(number)+1 as before — backward-compatible for fresh-genesis chains. 2. Default the bundled SPA's NETWORK_ID to 8675312 (the Liquid devnet chain ID). The Dockerfile previously inherited luxfi/explore's default of 8675311 — a stale leftover from before the devnet chainId migration. Adds NETWORK_ID / NETWORK_NAME / CURRENCY_SYMBOL as build-args so the same Dockerfile produces correct images for devnet/testnet/mainnet. Requires luxfi/indexer #8 (StartBlock field on evm.Config) — bumped via `go mod edit` to the post-merge commit d5e65d4b50c1.jGx|tree abfe5dc2b9cd0a7a48fa5dd67a21a5394276ab87 parent a1fcc8fd445de5a2cf5e5aa90fb91db0c47ee21e author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779420692 -0700 committer GitHub 1779420692 -0700 fix(sse): minimal HEAD response to avoid GCP/Traefik 502 on streaming content-type (#9) GCP HTTP/2 load balancers (and Traefik in some configs) return 502 to clients when a HEAD response carries `Connection: keep-alive` plus a streaming content-type — because they expect HEAD to be a closed-body response, not an opened SSE stream. Symptom: external `curl -I https://.../v1/base/realtime` → 502 even though in-cluster `curl -I http://localhost:8090/v1/base/realtime` → 200 OK with full SSE headers. SPA's `fetch(..., {method:'HEAD'}).then(r => r.ok)` gets false → live channel `disabled=true` → no live updates ever fire. Fix: HEAD pre-flight returns ONLY `Content-Type: text/event-stream` + 200, without the streaming-only headers. The full SSE header set still ships on the actual GET stream. Applies to both the per-channel HandleSSE() and the multiplexed HandleMultiplexedSSE() handlers. `fxatree de3bf981ef4194c6bd1abf733996872270b27eef parent 5e985266ac87102df8f9be4181088dddcdeacfda author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779420479 -0700 committer GitHub 1779420479 -0700 feat(realtime): add /v1/base/realtime multiplexed SSE channel (#8) The bundled SPA opens a single EventSource at /v1/base/realtime and routes incoming frames via msg.event off a handler map — see realtime_sse.go for the wire shape. Per-channel /blocks /transactions etc. stay for external consumers; the SPA only uses this one path. client.es.onmessage = o => { const c = JSON.parse(o.data); const d = this.handlers.get(c.event); if (d) for (const m of d) m(c.data); }; Wire: - HandleMultiplexedSSE() attaches a wildcard sseClient (channel=`*`) - Broadcast() now builds two SSE payloads per event: perChannel: existing `event:\ndata:\n\n` framing for /blocks /transactions /etc. wildcard: `data:{"event":,"chain":,"data":<...>}\n\n` for /v1/base/realtime — no `event:` line so SPA's onmessage gets the JSON envelope and dispatches. - sseRegistry.fanout dispatches both payloads to matching clients based on channel ("*" → wildcard, "blocks" → perChannel) - main.go mounts GET + HEAD /v1/base/realtime (HEAD is the SPA's pre-flight to decide whether to disable the live channel). Without this path the SPA's HEAD pre-flight got a 404 (the explorer SSE-HEAD-silencer from #4) and the client set `disabled=true`, so no live updates ever reached the home page.x#Gxtree fdc48f3ac2b455d3f4ae846fa534011dbaa212b7 parent b8e7e84bec3e5e7274b75464b59d2c46bcc9ce9e author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779419718 -0700 committer GitHub 1779419718 -0700 fix(supervisor): preserve unrecognized first-segment when default-routing /v1/indexer (#7) dispatchIndexer's splitSlug peels off the first segment as a "slug" if it matches the slug regex ([a-z0-9][a-z0-9-]{0,63}). When that segment turns out NOT to be a registered chain, the previous code forwarded only the REMAINDER to the default chain — so `/v1/indexer/main-page/blocks` silently became `/v1/indexer/evm/blocks` server-side, a completely different endpoint that returns a paginated envelope instead of the raw array the SPA expects. The SPA's home page widget does `data.slice(0, 8).map(...)` on the result and threw "o.slice is not a function" against the envelope shape. Fix: when the parsed slug isn't a registered chain, re-join it with the rest before delegating so the original path is preserved under the default chain (`/v1/indexer/main-page/blocks` → `/v1/indexer/evm/main-page/blocks`).yčB>xtree da4ba9c87520199170911fa37074680541f61043 parent 3c14ffa4375073f712712ed026925b3c31dbf4b5 author Darkhorse7stars <92065535+Darkhorse7stars@users.noreply.github.com> 1779415778 -0700 committer GitHub 1779415778 -0700 feat(realtime): bridge per-chain block events into the realtime hub (#6) When ChainSupervisor.AttachRealtime is called (from main), each chain's indexer.Subscriber.OnBroadcast is wired to push block events into the RealtimeHub on the chain's slug. The hub then fans out to WebSocket clients (existing path) and SSE subscribers (new in #5). Requires luxfi/indexer v1.4.4 — pulls in the exported Subscriber() accessor. End-to-end chain: evm.Indexer.indexBlock → Subscriber.BroadcastBlock → OnBroadcast → RealtimeHub.Broadcast → ws.send + SSE fanout → SPA EventSource Now /blocks, /transactions, /token-transfers, etc. on the explorer host actually stream live events as blocks land instead of just returning HEAD 200 with no payload.`TxWrSQ.H$DPe׍Rqf#I/2S.!@w$3d }0?I v2Svwg$K2.NfI/|f"N,j|.B\'fd&t&,D+ak:a,XN/fٳ'o>k46ֵMWmuNlzzN|:RIC_(MEwy-ʥpC#ET%GW$i&i!%ݐYS+,Vg5 ?S07v8Cs5~$etMp'FjK7]ݚTGn5{k:QY9K*iAc"\ӏDQ+ϣ顡?$kpDW)+=piQVK*'$%at>4⴩UA&3*Z,NSzdkAjLJYˡb/TUL '-6@"BlKwޗcҵ&R-SoI*H,M m2n#X};1]sJ״FSjG_,yv 0Z_g9:jZ1#ʄCbVv|o+w @s"[_0zT*E]EJ*zW-*YƮ2ѩ$J]S=`MD;ъKD4Mr Q-֡S(-`PH9+˜*Q/}qscTKΊ*tC$N/$%|͙w*v:deDzrjm&w,X ,c% Yf؁Ϟ5'<\屧t{Ná`G^@\yf>:R> [kO[PЖ?-<1vxF$BYLooO .-v*#waoAykp\EX>0[ +SR N,,7U0 o R)-w=Nq+WiKZ3`;܁ڒ^hF kvvP H n߼  5qgjɍ/E%M$C #sܷeaHl[(3uCcўTyEb|CqI @$ SLƴEip55&d+#[FW^+4rώb\"ƃ-Ӎ ՙ^M_J{+;yn9 xw1ӕѧYAE _۳5lpc1\{ƪS%R?aGf̳~_À_`<GG8z0 "y7gdP7F^6vB[~l d nZH߳h07[T Pp'dXKfJ^:A؞q7a|`g/܀0-tP/{|0׬m8oGC8AY6EM)8p쒆'hZTt 8ńfmoކּyY\;*3C4<;9%J uHq41NK~Vz }E>mH|qu 텄¤F"k6OQMA헄j1:\6l+Ph$dSxTێ6}W ۀ-KkymiA.hѧP"L.IZ # |Ium_$9<猢G/y*\X^_X[YUi֪aFzqQ_rݮE,%6 !WFTjjԢc윇?9};= AZ5uXV5eY2^LjjEULXyg#Z9Yys#(b}}3Sܘ=x'vJ2w@`sGܺv3qkф;2z!`΢ۣ=>g]`ɽ]&t(ћ)TW0J"vh{p{>zi<+:䚱ߨ, `GzN X!`ԒN{wuh+Tt7Sd<ƣ'-.>e$;(CM~v<2(5hDtOqN0=HJx>P:ۅQ ,!t|@d hBxL `Q7q^BQ;[0_)t`8!LIL fOq~΢6(avJ@x/tree 4a3520bf2f2184bb8c1c19162cfdba7471d8af38 parent 9f018edb60cfc9aae09ffaf5ef87483d7b2837fa author Zach Kelling 1779222063 -0700 committer Zach Kelling 1779222063 -0700 ci: switch workflows to lux-build (luxfi-scoped ARC pool) Cross-org runs-on dispatch failure: hanzo-build-linux-amd64 scale set is registered to github.com/hanzoai and silently rejects luxfi/* jobs. Switch to lux-build (githubConfigUrl=github.com/luxfi, max 20). ix tree 2f2a5c66dc9a24f0e4d8b934ddcf08160dfbdf2f parent c5227405f31443affb57c898a31069635e9a659c author Zach Kelling 1779205220 -0700 committer Zach Kelling 1779205220 -0700 ci: rip orphan replace block (graph + indexer sibling-dir shims) ;Q`xtree fe946c3655d13d622306adf8142fa975c2226355 parent 1d853ed3289a0d44dc82c28eb1a9710af612e18b author Zach Kelling 1779204815 -0700 committer Zach Kelling 1779204815 -0700 ci: rip ../graph + ../indexer replace shims; bump to graph v1.2.0 + indexer v1.4.1 Sx|tree bb7107d16c636d6f9d677cd8ef75176724440b5a parent 34b016037668f9eaff4cc89ea5be3886c6c3d868 author Zach Kelling 1779202927 -0700 committer Zach Kelling 1779203016 -0700 ci: fix runner label (hanzo-build pool) Imaginary runner label `lux-build-linux-amd64` does not exist. The live amd64 pool is `hanzo-build-linux-amd64`. - docker.yml: docker job KUxxvtree 1b601c107e5b2b5127157e64b2b0a7da33b69766 parent b043993d03df852a3fcaab07308bcdd43877b6b1 author Zach Kelling 1778953747 -0700 committer GitHub 1778953747 -0700 chore: add LICENSE (BSD 3-Clause License) + LICENSING.md pointer (#3) * chore: add BSD 3-Clause License * docs: add LICENSING.md pointer to canonical IP/licensing strategy(qzxtree 840c342b50cfd524a73f5fcd9413e28594e3e367 parent a858082e3bfaf4e0ddb3bc690719f420130614fe author Zach Kelling 1778698780 -0700 committer Zach Kelling 1778698780 -0700 deps: luxfi/crypto v1.19.0 HBڐxtree 0397891d3eeabb15b99bfad03a75e845514d49b6 parent f5cfd03bd4478d758cc45733b691d77016f46643 author Zach Kelling 1778646558 -0700 committer Zach Kelling 1778646558 -0700 go.mod: bump go directive to 1.26.3 (security advisory) >Lxtree a84952a30b356e5c7a51e88fcc1b6daf11828d32 parent 4acc65c6d4f84d0c5c2faad94fdd7deaec5ac542 author Zach Kelling 1778089515 -0700 committer Zach Kelling 1778089515 -0700 ci: build multi-arch (amd64+arm64) — Mac devs run native arm64, no Rosetta Matches lux/graph + lux/indexer docker.yml. The unified explorer binary bundles SPA + indexer + graph in one image, so this is the canonical multi-arch artifact for the Liquidity local stack and devnet. ꞉x 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̒$V?LiYx[k7N f&&`%yE k橿~مCsfU⪗ W>awnjT=+S"TK~rvjQZfN*CK6ג) }?tT_+?5V,;|n[tl%~ bh_nusG44{"CX/~ԛ+^BM rut;Y:I(;o.oUWZ[W z)Z(ce7'UF40000 workflows4:9?H,Qsx\y\xOO;M9g|R% 'xOO;uz] 84m0Wʭ 'xOO;'Ma:Cu:jh| N'xOO;Hz Y̥?{Umo F'xOO;Y\`0 ͆ 'xOO;bU_`,vܿF 'xOO;Ԥv߫4ko* 'xOO;K"0pj;(d 8 8'xOO;vh&:UQ ^x:self-hosted-runner: labels: - lux-build-linux-amd64 D8x&100644 docker.yml&bceJ`x name: Docker on: workflow_dispatch: push: tags: ['v*'] permissions: contents: read packages: write id-token: write # amd64-only on luxfi's native ARC pool — the SPA build (Next.js + 8GB # heap) + Go cgo-sqlite Docker build under QEMU arm64 emulation pushes # build time from ~5 min to ~2 hours. Cluster runners are amd64; Mac # devs use OrbStack which has its own arm64 base image story. arm64 # rebuilds can come back via a separate matrix entry on a native # arm64 runner — not via QEMU. jobs: docker: runs-on: lux-build steps: - uses: actions/checkout@v4 - uses: docker/setup-buildx-action@v3 with: driver: docker-container driver-opts: network=host - uses: docker/login-action@v3 with: registry: ghcr.io username: ${{ github.repository_owner }} password: ${{ secrets.GITHUB_TOKEN }} - id: meta uses: docker/metadata-action@v5 with: images: ghcr.io/luxfi/explorer flavor: latest=auto tags: | type=semver,pattern={{version}} type=semver,pattern={{major}}.{{minor}} type=sha,prefix=sha- - uses: docker/build-push-action@v6 with: context: . platforms: linux/amd64 labels: ${{ steps.meta.outputs.labels }} tags: ${{ steps.meta.outputs.tags }} cache-from: type=gha,scope=explorer cache-to: type=gha,scope=explorer,mode=max provenance: false push: true Mx8# Binaries bin/ explorer explorer-unified *.exe *.test # Coverage coverage.out coverage.html # Go workspace go.work go.work.sum # Editor .idea/ .vscode/ *.swp *.swo # OS .DS_Store # Local .env .env.local *.local # AI assistant context (not committed) AGENTS.md CLAUDE.md GEMINI.md QWEN.md # Runtime logs/ 8TcEx,# Binaries bin/ /explorer) .claude/ = ۷x X# explorer **Org:** luxfi · **Ecosystem:** lux · **Path:** `/Users/a/work/lux/luxfi/explorer` **Origin:** https://github.com/luxfi/explorer.git ## Discovery This file (`CLAUDE.md`) is the canonical agent-facing readme; `LLM.md` is a symlink to it. Update either name and both stay in sync. ## Where to look first - `README.md` — human-facing overview (if present) - `package.json` / `Cargo.toml` / `pyproject.toml` / `go.mod` — language & deps - `.github/workflows/` — CI surface - `docs/` — extended docs (if present) ## Sibling repos See the org-level `LLM.md` at `/Users/a/work/lux/luxfi/LLM.md` for the full inventory of sibling repos and inter-repo dependencies. ## Unified explorer bundle (2026-06-05) luxfi/explorer + luxfi/graph + luxfi/explore are rolled into ONE Deployment per env. Architecture: - **luxfi/explorer (this repo)** — the Go binary `cmd: explorer`. Imports `github.com/luxfi/indexer` and `github.com/luxfi/graph` as libraries. Serves on `:8090`: /v1/indexer/{slug}/* — Blockscout-compatible JSON API /v1/graph/{slug}/{subgraph}/ — GraphQL per-chain per-subgraph /v1/explorer/admin/* — Runtime chain registry CRUD /v1/explorer/realtime — WebSocket + SSE live feed / — Embedded SPA shim (fallback only) Image: `ghcr.io/luxfi/explorer:1.2.18` - **luxfi/explore** — the Next.js SSR app (Blockscout fork). Serves the rich SPA at `:3000`. Runs as a **sidecar container in the same Pod**; shares the network namespace with the explorer Go binary so it can hit `http://localhost:8090` for data if needed (currently it uses the public `api-explore..network` host). Image: `ghcr.io/luxfi/explore@sha256:ddb15bc28ff38c7619bc08df9337e02b32ef886c33b9993a9b9cb3c475ad75de` - **luxfi/graph (formerly graphd)** — NOT a separate Deployment. Linked into the explorer binary as a library. Per-chain GraphQL engines are spawned by the supervisor when `chains[].graph.enabled: true` in the chains.yaml ConfigMap. The legacy `lux-indexer` Deployment (same Go `indexerd` binary, only indexed EVM) has been **deleted**. Its routes are served by the unified explorer Deployment. Per env: 1 Pod, 2 containers, 1 Service exposing `:80 / :8090 / :3000`. Manifests: ~/work/lux/universe/k8s/lux-mainnet/explorer.yaml ~/work/lux/universe/k8s/lux-mainnet/explore-ingress.yaml ~/work/lux/universe/k8s/lux-testnet/explorer.yaml ~/work/lux/universe/k8s/lux-testnet/explore-ingress.yaml ~/work/lux/universe/k8s/lux-devnet/explorer.yaml ~/work/lux/universe/k8s/lux-devnet/explore-ingress.yaml Public URLs (all 200 OK, verified 2026-06-05): https://explore.lux.network (Next.js SPA) https://api-explore.lux.network/v1/indexer/cchain/blocks https://api-explore.lux.network/v1/graph/cchain/amm/graphql https://explore.lux-test.network (Next.js SPA) https://api-explore.lux-test.network/v1/indexer/cchain/blocks https://api-explore.lux-test.network/v1/graph/cchain/amm/graphql https://explore.lux-dev.network (Next.js SPA) https://api-explore.lux-dev.network/v1/indexer/cchain/blocks https://api-explore.lux-dev.network/v1/graph/cchain/amm/graphql *Lrxb# Unified Lux explorer image. Single Go binary, embedded SPA, indexer + # graph as libraries. Deploy with a chains.yaml (or env vars) and persist # /data; brand swap by remounting chains.yaml + assets, no rebuild needed. ARG GO_VERSION=1.26 ARG NODE_VERSION=22 ARG EXPLORE_REPO=https://github.com/luxfi/explore.git ARG EXPLORE_REF=main ARG INDEXER_REPO=https://github.com/luxfi/indexer.git ARG INDEXER_REF=main ARG GRAPH_REPO=https://github.com/luxfi/graph.git ARG GRAPH_REF=main # ---- Stage 1: build the SPA ---- # <<<<<<< Updated upstream # Frontend chain knobs are build-time, not runtime: the Blockscout-fork # SPA reads NEXT_PUBLIC_* at `pnpm build` and bakes them into the # emitted JS. Default to the Liquid devnet shape; downstream rebuilds # override via --build-arg NETWORK_ID=… (etc.) for testnet/mainnet. ======= # luxfi/explore is a Next.js `output: 'standalone'` SSR app, not a static # export — so `pnpm build` does NOT produce /app/out/. The unified # explorer needs static assets to embed via go:embed; until upstream # explore ships `output: 'export'`, we ship a substantive runtime SPA # shell from explorer/static/. The shell wires /envs.js (window.ENV) # to render the chain list client-side. When upstream explore lands # static-export support, this stage gains `pnpm build && cp .next/static # /app/out/_next/static` and the shell can hydrate. >>>>>>> Stashed changes FROM node:${NODE_VERSION}-alpine AS frontend ARG EXPLORE_REPO ARG EXPLORE_REF ARG NETWORK_ID=8675312 ARG NETWORK_NAME="regulated EVM L1" ARG NETWORK_CURRENCY_SYMBOL=LQDTY RUN apk add --no-cache git WORKDIR /app # Best-effort: clone explore and try to produce a static export. If # anything fails (missing pnpm-lockfile entry, missing env vars, SSR-only # Next config), don't fail the image — explorer/static/ still ships. RUN git clone --depth=1 --branch=${EXPLORE_REF} ${EXPLORE_REPO} . || true ENV NEXT_PUBLIC_API_BASE_PATH=/v1/explorer ENV NEXT_PUBLIC_NETWORK_ID=${NETWORK_ID} ENV NEXT_PUBLIC_NETWORK_NAME=${NETWORK_NAME} ENV NEXT_PUBLIC_NETWORK_CURRENCY_NAME=${NETWORK_CURRENCY_SYMBOL} ENV NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL=${NETWORK_CURRENCY_SYMBOL} ENV NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS=18 ENV NODE_OPTIONS=--max-old-space-size=8192 RUN if [ -f package.json ]; then \ corepack enable && pnpm install --frozen-lockfile --ignore-scripts && pnpm build || true; \ fi # /app/out is created only if static export succeeded. The builder stage # below COPYs it over explorer/static/ — but only if non-empty. The # fallback path is the local explorer/static/index.html (substantive # 372-byte SPA shell with id="root" + /envs.js bootstrap). RUN mkdir -p /app/out # ---- Stage 2: clone indexer + graph siblings, build the unified binary ---- FROM golang:${GO_VERSION}-alpine AS builder ARG INDEXER_REPO ARG INDEXER_REF ARG GRAPH_REPO ARG GRAPH_REF ARG VERSION=dev RUN apk add --no-cache gcc musl-dev sqlite-dev git WORKDIR /src RUN git clone --depth=1 --branch=${INDEXER_REF} ${INDEXER_REPO} indexer && \ git clone --depth=1 --branch=${GRAPH_REF} ${GRAPH_REPO} graph WORKDIR /src/explorer COPY . . # explorer/static/ already contains the substantive SPA shell. Only # overlay frontend /app/out/ if it has the static-exported assets (an # index.html that's NOT the 60-byte stub). When upstream explore ships # static-export, the cp succeeds and overlays the real assets. RUN --mount=type=bind,from=frontend,source=/app/out,target=/tmp/frontend-out \ sh -eu -c '\ if [ -s /tmp/frontend-out/index.html ] && [ "$(wc -c  h# # Build-arg defaults shape the optional Next.js static export attempt # (only used if explore.git land  upstream). Real # branding comes from the runtime chains.yaml + brand assets mount on # the explorer Deployment — no rebuild needed to swap.u `_xBSD 3-Clause License Copyright (c) 2024-2026 Lux Industries Inc. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.%x_# Licensing This repository is licensed under the **BSD 3-Clause License** (see [LICENSE](LICENSE)). It belongs to the **public** tier of the Lux three-tier IP strategy: anyone may use, fork, or redistribute it, including for commercial purposes, subject to the BSD 3-Clause License terms. For the canonical Lux IP and licensing strategy, see: For commercial inquiries that go beyond the public tier (e.g. private moat acceleration kernels, Eco-tier patent-protected primitives outside Authorized Networks), contact `licensing@lux.network`. Ր9xsq uqM xe# Explorer Single-binary Lux explorer: chain indexer, GraphQL engine, and SPA frontend in one Go process. Imports [`luxfi/indexer`](https://github.com/luxfi/indexer) and [`luxfi/graph`](https://github.com/luxfi/graph) as libraries; embeds the [`luxfi/explore`](https://github.com/luxfi/explore) Next.js build via `go:embed`. ``` ghcr.io/luxfi/explorer -> 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)x2package main import ( "fmt" "os" "regexp" "gopkg.in/yaml.v3" ) // Config is the top-level explorer configuration loaded from chains.yaml. type Config struct { DataDir string `yaml:"data_dir"` HTTPAddr string `yaml:"http_addr"` StaticDir string `yaml:"static_dir"` // overlay dir for SPA; empty = embedded only BrandDefault Brand `yaml:"brand_default"` Networks []Network `yaml:"networks"` Chains []ChainConfig `yaml:"chains"` } // ChainConfig defines a single chain plus per-chain customization. The // admin/registry/mdns layer also uses this shape; fields beyond Slug/Name/ // ChainID/RPC/Type/Default are optional and apply when the chain is loaded // from a config file. type ChainConfig struct { Slug string `json:"slug" yaml:"slug"` Name string `json:"name" yaml:"name"` ChainID int64 `json:"chain_id" yaml:"chain_id"` Type string `json:"type" yaml:"type"` // evm, dag, linear, solana, bitcoin, cosmos RPC string `json:"rpc" yaml:"rpc"` WS string `json:"ws" yaml:"ws"` CoinSymbol string `json:"coin" yaml:"coin"` Enabled bool `json:"enabled" yaml:"enabled"` Default bool `json:"default" yaml:"default"` Source string `json:"source" yaml:"-"` // config, env, mdns, admin Indexer IndexerSettings `json:"indexer,omitempty" yaml:"indexer,omitempty"` Graph GraphSettings `json:"graph,omitempty" yaml:"graph,omitempty"` Brand *Brand `json:"brand,omitempty" yaml:"brand,omitempty"` Tokens TokensFeatures `json:"tokens,omitempty" yaml:"tokens,omitempty"` } // IndexerSettings overrides indexer behaviour for a single chain. type IndexerSettings struct { PollInterval string `yaml:"poll_interval" json:"poll_interval,omitempty"` // e.g. "30s" StartBlock uint64 `yaml:"start_block" json:"start_block,omitempty"` } // GraphSettings configures per-chain GraphQL subgraphs. type GraphSettings struct { Enabled bool `yaml:"enabled" json:"enabled"` Subgraphs []Subgraph `yaml:"subgraphs" json:"subgraphs,omitempty"` } // Subgraph mounts a single named GraphQL schema under // /v1/graph/{chain-slug}/{subgraph-name}/. Schema is either a built-in name // understood by github.com/luxfi/graph/engine.LoadBuiltin (amm, uniswap-v2, // uniswap-v3, uniswap-v4, securities, fhe, etc.) or a path to a .graphql file. type Subgraph struct { Name string `yaml:"name" json:"name"` Schema string `yaml:"schema" json:"schema"` Enabled bool `yaml:"enabled" json:"enabled"` } // Brand is the per-chain (or default) UI branding shown by the SPA. Icon/Logo // files are read from disk on every request so a deploy can swap them without // rebuilding the binary. type Brand struct { Name string `yaml:"name" json:"name,omitempty"` Coin string `yaml:"coin" json:"coin,omitempty"` AccentColor string `yaml:"accent_color" json:"accentColor,omitempty"` IconFile string `yaml:"icon_file" json:"-"` LogoFile string `yaml:"logo_file" json:"-"` IconURL string `yaml:"icon_url" json:"iconUrl,omitempty"` LogoURL string `yaml:"logo_url" json:"logoUrl,omitempty"` } // TokensFeatures controls which tokens the SPA highlights or hides. type TokensFeatures struct { Featured []string `yaml:"featured" json:"featured,omitempty"` AllowList []string `yaml:"allow_list" json:"allowList,omitempty"` BlockList []string `yaml:"block_list" json:"blockList,omitempty"` } // Network is a peer explorer the SPA can link to in its network switcher. type Network struct { Label string `yaml:"label" json:"label"` Domain string `yaml:"domain" json:"domain"` ChainID int64 `yaml:"chain_id" json:"chainId"` } // slugPattern restricts chain slugs to lowercase alphanumeric + hyphen so they // remain safe in URL routes (/v1/indexer/{slug}/) and filesystem paths. var slugPattern = regexp.MustCompile(`^[a-z0-9][a-z0-9-]{0,63}$`) // LoadConfig reads chains.yaml, expands $ENV_VAR in RPC/WS, and validates slugs. func LoadConfig(path string) (Config, error) { data, err := os.ReadFile(path) if err != nil { return Config{}, fmt.Errorf("read %s: %w", path, err) } var cfg Config if err := yaml.Unmarshal(data, &cfg); err != nil { return Config{}, fmt.Errorf("parse %s: %w", path, err) } for i := range cfg.Chains { cfg.Chains[i].RPC = os.Expand(cfg.Chains[i].RPC, os.Getenv) cfg.Chains[i].WS = os.Expand(cfg.Chains[i].WS, os.Getenv) if !slugPattern.MatchString(cfg.Chains[i].Slug) { return Config{}, fmt.Errorf("chain[%d]: invalid slug %q", i, cfg.Chains[i].Slug) } } return cfg, nil } = 湌x06package main import ( "bytes" "embed" "encoding/json" "fmt" "io/fs" "net/http" "os" "path/filepath" "strings" "sync" ) // staticFS is the embedded SPA. The Dockerfile populates static/ from a // luxfi/explore build before the Go build runs; for local dev a placeholder // index.html is committed so go:embed always succeeds. // //go:embed all:static var staticFS embed.FS // Frontend serves the embedded SPA, runtime config (/envs.js), and per-host // brand assets (/icon.svg, /logo.svg). Brand assets read from disk on every // request so a deploy can swap them without rebuilding the binary. // // SPA override: if cfg.StaticDir (or $EXPLORER_STATIC_DIR) points at an // existing directory, file lookups prefer the on-disk copy over the // embedded FS. This lets a ConfigMap-mounted SPA replace the embedded // 60-byte placeholder without a binary rebuild — useful when the // upstream `explore` Next.js app hasn't shipped a static export yet but // we want a richer in-cluster default than `
`. type Frontend struct { cfg Config registry *ChainRegistry root fs.FS // embedded SPA (always present) overlay fs.FS // disk overlay (nil if cfg.StaticDir not set) index []byte // resolved index.html (overlay > embedded > builtin) } // NewFrontend returns a frontend handler bound to a config and chain registry. func NewFrontend(cfg Config, r *ChainRegistry) (*Frontend, error) { root, err := fs.Sub(staticFS, "static") if err != nil { return nil, err } f := &Frontend{cfg: cfg, registry: r, root: root} dir := cfg.StaticDir if dir == "" { dir = os.Getenv("EXPLORER_STATIC_DIR") } if dir != "" { if st, err := os.Stat(dir); err == nil && st.IsDir() { f.overlay = os.DirFS(dir) } } if data := f.readStatic("index.html"); data != nil { f.index = data } else { f.index = []byte("Explorer") } return f, nil } // readStatic returns the bytes for `name` from the overlay if present, // otherwise from the embedded FS. Returns nil if neither has the file. func (f *Frontend) readStatic(name string) []byte { if f.overlay != nil { if data, err := fs.ReadFile(f.overlay, name); err == nil { return data } } if data, err := fs.ReadFile(f.root, name); err == nil { return data } return nil } // Mount installs / (SPA), /envs.js, /icon.svg, /logo.svg on mux. func (f *Frontend) Mount(mux *http.ServeMux) { mux.HandleFunc("GET /envs.js", f.handleEnvs) mux.HandleFunc("GET /icon.svg", f.handleIcon) mux.HandleFunc("GET /logo.svg", f.handleLogo) mux.HandleFunc("/", f.handleSPA) } // handleSPA serves embedded static assets and falls back to index.html for // any path the SPA owns (client-side routing). // // HEAD-method note: the bundled SPA opens EventSource (Server-Sent Events) // channels for live block / token / tx streams and pre-flights each URL // with a HEAD request: // // fetch(url, {method: 'HEAD'}).then(r => r.ok ? openEventSource() : disable()); // // If we serve a 200 (because of the SPA fallback to index.html), the SPA // proceeds to open the EventSource — which then immediately aborts because // the response body is text/html, not text/event-stream. Browser logs // "EventSource's response has a MIME type ('text/html') that is not // 'text/event-stream'" for every channel on every page load — noisy and // disables the channel anyway. // // Fix: return 404 for HEAD requests on the SPA-fallback path. Real assets // (anything in `f.root`) still serve normally on HEAD; only the index.html // fallback gets the 404 so the SSE pre-flight cleanly fails and the SPA // disables that channel on its own. Visible browser load is unchanged // because the SPA only HEAD-probes its SSE endpoints, never the SPA URL // itself. func (f *Frontend) handleSPA(w http.ResponseWriter, r *http.Request) { p := strings.TrimPrefix(r.URL.Path, "/") if p == "" { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } // Overlay wins if it has the file (any non-directory entry); falls // back to embedded; falls back to index.html (SPA-routing). if f.overlay != nil { if file, err := f.overlay.Open(p); err == nil { st, statErr := file.Stat() file.Close() if statErr == nil && !st.IsDir() { http.ServeFileFS(w, r, f.overlay, p) return } } } file, err := f.root.Open(p) if err != nil { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } defer file.Close() stat, err := file.Stat() if err != nil || stat.IsDir() { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } http.ServeFileFS(w, r, f.root, p) } func (f *Frontend) writeIndex(w http.ResponseWriter) { w.Header().Set("Content-Type", "text/html; charset=utf-8") w.Header().Set("Cache-Control", "no-cache") w.Write(f.index) } // handleEnvs returns runtime config the SPA reads instead of build-time env // vars. This is what makes per-network customization possible without a // rebuild: deploy the same image, mount a different chains.yaml, get a // different brand + chain list. func (f *Frontend) handleEnvs(w http.ResponseWriter, r *http.Request) { hostBrand := f.brandForHost(r.Host) hostSlug := f.chainSlugForHost(r.Host) chains := f.chainListJSON() // When the host pins a specific chain (e.g. explore.zoo.network → // zoo, explorer.zoo-test.network → zoo), promote that chain to // default and demote any other config-level default. The SPA's chain // switcher honours the "default" flag. if hostSlug != "" { for i := range chains { if chains[i]["slug"] == hostSlug { chains[i]["default"] = true } else { chains[i]["default"] = false } } } env := map[string]any{ "VITE_CHAINS": chains, "VITE_NETWORKS": f.cfg.Networks, "VITE_BRAND": hostBrand, } body, _ := json.Marshal(env) var buf bytes.Buffer buf.WriteString("window.ENV = ") buf.Write(body) buf.WriteString(";\n") w.Header().Set("Content-Type", "application/javascript") w.Header().Set("Cache-Control", "no-cache") w.Write(buf.Bytes()) } // handleIcon serves the per-host or default icon.svg from disk. func (f *Frontend) handleIcon(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.IconFile }, "icon.svg") } // handleLogo serves the per-host or default logo.svg from disk. func (f *Frontend) handleLogo(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.LogoFile }, "logo.svg") } // serveBrandFile resolves the file path from the matched brand (per-chain or // default) and sends it. Falls back to the on-disk overlay (if configured) // then the embedded SPA's named asset. func (f *Frontend) serveBrandFile(w http.ResponseWriter, r *http.Request, pick func(Brand) string, fallback string) { brand := f.brandStruct(r.Host) if path := pick(brand); path != "" { if data, err := os.ReadFile(path); err == nil { w.Header().Set("Content-Type", contentTypeFor(path)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data) return } } if data := f.readStatic(fallback); data != nil { w.Header().Set("Content-Type", contentTypeFor(fallback)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data) return } http.NotFound(w, r) } // brandForHost returns a JSON-shaped brand for /envs.js. It strips file paths. func (f *Frontend) brandForHost(host string) map[string]any { b := f.brandStruct(host) return map[string]any{ "name": b.Name, "coin": b.Coin, "accentColor": b.AccentColor, "iconUrl": b.IconURL, "logoUrl": b.LogoURL, } } // brandStruct returns the Brand for a request host: a chain whose name or // slug matches the hostname wins; otherwise the global default. // // See hostMatchesSlug for the list of supported hostname shapes. func (f *Frontend) brandStruct(host string) Brand { if c, ok := f.matchChain(host); ok && c.Brand != nil { return *c.Brand } return f.cfg.BrandDefault } // chainSlugForHost returns the slug of the chain pinned by the request host, // or "" if the host does not name a chain. Used by handleEnvs to promote a // per-host chain to the SPA's default selection. func (f *Frontend) chainSlugForHost(host string) string { if c, ok := f.matchChain(host); ok { return c.Slug } return "" } // matchChain finds the first configured chain whose slug appears in the // request host. Matches these hostname shapes, in order of specificity: // - "{slug}" — bare slug (curl localhost) // - "{slug}.tld..." — {slug}.lux.network, {slug}.hanzo.ai // - "explore-{slug}.tld..." — explore-hanzo.lux.network // - "explorer-{slug}.tld..." — explorer-hanzo.lux.network // - "api-explore-{slug}.tld..." — api-explore-hanzo.lux.network // - "explore.{slug}.tld..." — explore.hanzo.ai, explore.zoo.ngo // - "explorer.{slug}.tld..." — explorer.hanzo.ai, explorer.zoo.network // - "api-explore.{slug}.tld..." — api-explore.hanzo.ai // - "explore-{slug}-{env}.tld..." — explore-hanzo-test.lux.network // - "explorer-{slug}-{env}.tld..." — explorer-hanzo-test.lux.network // - "api-explore-{slug}-{env}.tld..." — api-explore-hanzo-dev.lux.network // - "explore.{slug}-{env}.tld..." — explore.zoo-test.network // - "explorer.{slug}-{env}.tld..." — explorer.zoo-test.network // - "api-explore.{slug}-{env}.tld..." — api-explore.zoo-test.network // // First chain match wins on ambiguous hosts. func (f *Frontend) matchChain(host string) (ChainConfig, bool) { host = strings.ToLower(strings.SplitN(host, ":", 2)[0]) for _, c := range f.cfg.Chains { if hostMatchesSlug(host, c.Slug) { return c, true } } return ChainConfig{}, false } // hostMatchesSlug is the pure string predicate for chain↔host matching. // Kept separate from matchChain so unit tests can cover it directly. func hostMatchesSlug(host, slug string) bool { if slug == "" { return false } if host == slug { return true } // Direct slug-as-subdomain: zoo.lux.network, hanzo.ai. if strings.HasPrefix(host, slug+".") || strings.HasPrefix(host, slug+"-") { return true } // Brand-owned domains: explore.zoo.network, explorer.zoo-test.network, // api-explore.zoo.ngo, etc. Each "explore"/"explorer" prefix combines // with "." or "-" as the slug separator. prefixes := []string{ "explore-", "explorer-", "api-explore-", "api-explorer-", "explore.", "explorer.", "api-explore.", "api-explorer.", } for _, p := range prefixes { // {prefix}{slug}.tld — e.g. explore.zoo.network, explore-zoo.lux.network if strings.HasPrefix(host, p+slug+".") { return true } // {prefix}{slug}-{env}.tld — e.g. explore-zoo-test.lux.network, // explorer.zoo-test.network if strings.HasPrefix(host, p+slug+"-") { return true } } return false } // chainListJSON returns a SPA-friendly chain list from the live registry, // not the static config — chains added via mDNS/admin show up immediately. var chainListMu sync.Mutex func (f *Frontend) chainListJSON() []map[string]any { chainListMu.Lock() defer chainListMu.Unlock() out := []map[string]any{} if f.registry == nil { return out } for _, c := range f.registry.List() { out = append(out, map[string]any{ "slug": c.Slug, "name": c.Name, "chainId": c.ChainID, "rpc": c.RPC, "coin": c.CoinSymbol, "type": c.Type, "default": c.Default, }) } return out } // contentTypeFor maps a file extension to a Content-Type, defaulting to // application/octet-stream. func contentTypeFor(path string) string { switch strings.ToLower(filepath.Ext(path)) { case ".svg": return "image/svg+xml" case ".png": return "image/png" case ".jpg", ".jpeg": return "image/jpeg" case ".webp": return "image/webp" case ".ico": return "image/x-icon" default: return "application/octet-stream" } } // fingerprint returns a short, stable identifier for the embedded asset // bundle, useful for cache-busting log lines at startup. func fingerprint() string { root, err := fs.Sub(staticFS, "static") if err != nil { return "0" } count := 0 _ = fs.WalkDir(root, ".", func(_ string, _ fs.DirEntry, _ error) error { count++ return nil }) return fmt.Sprintf("assets=%d", count) } Wx?a<net/http" "net/http/httptestT&testing" ) // TestFrontendStaticOverlay verifies that NewFrontend prefers the on-disk // static dir over the embedded FS when cfg.StaticDir points at a real // directory. The overlay use-case: ConfigMap-mounting a richer SPA shell // into an existing image without rebuilding. func TestFrontendStaticOverlay(t *testing.T) { dir := t.TempDir() want := "OVERLAY" if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte(want), 0644); err != nil { t.Fatal(err) } cfmg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html, got %q", got) } } // TestFrontendNoOverlay verifies that with no StaticDir, the embedded // index.html is served (current behaviour — pre-overlay). func TestFrontendNoOverlay(t *testing.T) { cfg := Config{BrandDefault: Brand{Name: "Tes3t"}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } if f.overlay != nil { t.Fatal("expected nil overlay when StaticDir empty") } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "doctype html") { t.Fatalf("expected fallback index.html, got %q", got) } } // TestFrontendOverlayMissingFileFallsBack covers the case where the // overlay dir exists but a particular file is missing — the request // falls through to the embedded FS (and ultimately to index.html for // SPA-routing). func TestFrontendOverlayMissingFileFallsBack(t *testing.T) { dir := t.TempDir() // Only index.html in overlay; no other assets. if err := os.WriteFile(filepath.Join(dir, "index.html"),?OVERLAY"), 0644); err != nil { t.Fatal(err) } cfg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := #NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) // Request a path the overlay doesn't have. With SPA-routing, the // handler returns index.html — which IS in the overlay. req := httptest.NewRequest("GET", "/some/spa/route", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html (SPA fallback), got %q", got) } } // TestFrontendEnvStaticDir verifies $EXPLORER_STATIC_DIR is the env-var // equivalent of cfg.StaticDir. Empty cfg + env-var-set overlay should // still pick up the overlay. func TestFrontendEnvStaticDir(t *testing.T) { dir := t.TempDir() if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte("ENV-OVERLAY"), 0644); err != nil { t.Fatal(err) } t.Setenv("EXPLORER_STATIC_DIR", dir) cfg := Config{BrandDefault: Brand{Name: "Test"1}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } if f.overlay == nil { t.Fatal("expected overlay populated from env var") } if !strings.Contains(string(f.index), "ENV-OVERLAY") { t.Fatalf("expected env-overlay index, got %q", string(f.index)) } } // TestBrandStructHostMatching covers every hostname shape the unified // explorer's IngressRoutes hand it: the per-chain brand must win over // BrandDefault for both UI hosts (explore-{slug}, explore.{slug}.tld) // and API hosts (api-explore-{slug}). The matcher must NOT bleed across // chains — a hanzo host must not pick zoo's brand or vice versa. func TestBrandStructHostMatching(t *testing.T) { hanzoBrand := Brand{Name: "Hanzo", Coin: "AI", AccentColor: "#0b1220"} zooBrand := Brand{Name: "Zoo", Coin: "ZOO", AccentColor: "#7c3aed"} cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain", Brand: &Brand{Name: "Lux C-Chain", Coin: "LUX"}}, {Slug: "hanzo", Brand: &hanzoBrand}, {Slug: "zoo", Brand: &zooBrand}, }, } f, err :%= NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } cases := []struct { host string want string }{ // Bare slug + slug-prefix shape. {"hanzo", "Hanzo"},` {"hanzo.lux.network", "Hanzo"}, // explore-{slug} prefix shape (lux.network UI hosts). {"="", "Hanzo"}, {"$?", "Hanzo"}, {"explore-hanzo-dev.lux.network", "Hanzo"}, {" *Q", "Zoo"}, // api-explore-{slug} prefix shape (lux.network API hosts). {"api-="", "Hanzo"}, {"api-$", "Hanzo"}, {"api- *", "Zoo"}, // explore.{slug}.tld shape (brand-owned domains). {"explore.hanzo.ai", "Hanzo"}, {"explore.hanzo.network", "Hanzo"}, {"explore.zoo.network", "Zoo"}, {"explore.zoo.ngo", "Zoo"}, {"api-explore.hanzo.ai", "Hanzo"}, {"api-explore.zoo.ngo", "Zoo"}, // explorer.{slug}.tld shape (alias of explore.* for brand-owned domains). {"explorer.zoo.network", "Zoo"},f {"explorer.hanzo.ai", "Hanzo"}, // {slug}-{env}.tld shape — brand-owned testnet/devnet domains.*% is the primary case this fixes. {"*", "Zoo"}, {"%?", "Zoo"}, {"explorer.hanzo-test.network", "Hanzo"}, {"api-%", "Zoo"}, // Mismatched hosts fall back to BrandDefault. {"explore.lux.network", "Lux Explorer"}, {"unknown.example.com", "Lux Explorer"}, // Cross-contamination guard: explore-spcfoo must NOT match spc. {"explore-spcfoo.lux.network", "Lux Explorer"}, // Cross-contamination guard: zoofoo must NOT match zoo. {"explore.zoofoo.network", "Lux Explorer"}, {"explorer.zoofoo.network", "Lux Explorer"}, } for _, tc := range cases { t.Run(tc.host, func(t *testing.T) { got := f.brandStruct(tc.host).Name if got != tc.want { t.Fatalf("host=%q: got brand=%q, want %q", tc.host, got, tc.want) } }) } } // TestChainSlugForHost covers the host→default-chain promotion that // handleEnvs uses to set the SPA's initial chain selection. Hosts that // pin a chain ( *() must // return the slug; generic hosts (explore.lux.network) must return "". func TestChainSlugForHost(t *testing.T) { zooBrand := Brand{Name: "Zoo"} hanzoBrand := Brand{Name: "Hanzo"} cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain", Brand: &Brand{Name: "Lux C-Chain"}}, {Slug: "hanzo", Brand: &hanzoBrand}, {Slug:Q "zoo", Brand: &zooBrand}, }, } f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } cases := []struct { host string want string }{ {"explore.zoo.network", "zoo"}, {"explore.zoo.ngo", "z-oo"}, {"explorer.zoo.network", "zoo"}, {"*", "zoo"}, {"%", "zoo"}, {" *", "zoo"}, {"*", "zoo"}, {"explore.hanzo.ai", "hanzo"}, {"explorer.hanzo-test.network", "hanzo"}, // Generic / mismatched hosts: no slug. {"explore.lux.network", ""}, {"unknown.example.com", ""}, {"explore.zoofoo.network", ""}, } for _, tc := range cases/ { t.Run(tc.host, func(t *testing.T) { gotttc.host) if got != tc.want { t.Fatalf("host=%q: got slug=%q, want %q", tc.host, got, tc.want) } }) } } ,g5OxG<;bytes" "embed" "encoding/json" "fmt" "io/fs" "net/http6&sync" ) // staticFS is the embedded SPA. The Dockerfile populates static/ from a // luxfi/explore build before the Go build runs; for local dev a placeholder // index.html is committed so go:embed always succeeds. // //go:embed all:static var staticFS embed.FS // Frontend serves the embedded SPA, runtime config (/envs.js), and per-host // brand assets (/icon.svg, /logo.svg). Brand assets read from disk on every // request so a deploy can swap them without rebuilding the binary. // // SPA override: if cfg.StaticDir (or $EXPLORER_STATIC_DIR) points at an // existing directory, file lookups prefer the on-disk copy over the // embedded FS. This lets a ConfigMap-mounted SPA replace the embedded // 60-byte placeholder without a binary rebuild — useful when the // upstream `explore` Next.js app hasn't shipped a static export yet but // we want a richer in-cluster default than ``. type Frontend struct { cfg Config registry *ChainRegistry root fs.FS // embedded SPA (always present) overlay fs.FS // disk overlay (nil if cfg.StaticDir not set) index []byte // resolved index.html (overlay > embedded > builtin) } // NewFrontend returns a frontend handler bound to a config and chain registry. func NewFrontend(cfg Config, r *ChainRegistry) (*Frontend, error) { root, err := fs.Sub(staticFS, "static") if err != nil { return nil, err } f f := &Frontend{cfg: cfg, registry: r, root: root} dir := cfg.StaticDir if dir == "" { dir = os.G) ) } if dir != "" { if st, err := os.Stat(dir); err == nil && st.IsDir() { f.overlay = os.DirFS(dir) } } if data := Xf.readStatic("index.html"); data != nil { f.index = data } else { f.index = []byte(Explorer") } return f, nil } // readStatic returns the bytes for `name` from the overlay if present, // otherwise from the embedded FS. Returns nil if neither has the file. func (f *Frontend) readStatic(name string) []byte { if f.overlay != n@if data, err := fs.ReadFile(f.overlay, name); err == nil { return data } } if data, err := fs.ReadFile(f.root, name); err == nil { return data } return nil } // Mount installs / (SPA), /envs.js, /icon.svg, /logo.svg on mux. func (f *Frontend) Mount(mux *http.ServeMux) { mux.HandleFunc("GET /envs.js", f.handleEnvs) mux.HandleFunc("GET /icon.svg", f.handleIcon) mux.HandleFunc("GET /logo.svg", f.handleLogo) mux.HandleFunc("/", f.handleSPA) } // handleSPA serves embedded static assets and falls back to index.html for // any path the SPA owns (client-side routing). // // HEAD-method note: the bundled SPA opens EventSource (Server-Sent Events) // channels for live block / token / tx streams and pre-flights each URL // with a HEAD request: // // fetch(url, {method: 'HEAD'}).then(r => r.ok ? openEventSource() : disable()); // // If we serve a 200 (because of the SPA fallback to index.html), the SPA // proceeds to open the EventSource — which then immediately aborts because // the response body is text/html, not text/event-stream. Browser logs // "EventSource's response has a MIME type ('text/html') that is not // 'text/event-stream'" for every channel on every page load — noisy and // disables the channel anyway. // // Fix: return 404 for HEAD requests on the SPA-fallback path. Real assets // (anything in `f.root`) still serve normally on HEAD; only the index.html // fallback gets the 404 so the SSE pre-flight cleanly fails and the SPA // disables that channel on its own. Visible browser load is unchanged // because the SPA only HEAD-probes its SSE endpoints, never the SPA URL // itself. func (f *Frontend) handleSPA(w http.ResponseWriter, r *http.Request) { p := strings.TrimPrefix(r.URL.Path, "/") if p == "" { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } // Overlay wins if it has the file (any non-dirRectory entry); falls // back to embedded; falls back to index.html (SPA-routing).-if file, err := f.overlay.Open(p); err == nil { st, statErr := file.Stat() file.Close() if statErr == nil && !st.IsDir() { http.ServeFileFS(w, r, f.overlay, p) return } } } file, err := f.root.Open(p) if err != nil { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } defer file.Close() stat, err := file.Stat() if err != nil || stat.IsDir() { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } http.ServeFileFS(w, r, f.root, p) } func (f *Frontend) writeIndex(w http.ResponseWriter) { w.Header().Set("Content-Type", "text/html; charset=utf-8") w.Header().Set("Cache-Control", "no-cache") w.Write(f.index) } // handleEnvs returns runtime config the SPA reads instead of build-time env // vars. This is what makes per-network customization possible without a // rebuild: deploy the same image, mount a different chains.yaml, get a // different brand + chain list. func (f *Frontend) handleEnvs(w http.ResponseWriter, r *http.Request) { hostBrand := f.brandForHost(r.Host) hostSlug := f.chainSlugForHost(r.Hoost) chains := f.chainListJSON() // When the host pins a specific chain (e.g. explore.zoo.network → // zoo! → zoo), promote that chain to // default and demote any other config-level default. The SPA's chain // switcher honours the "default" flag. if hostSlug != "" { for i := range chains { if chains[i]["slug"] == hostSlug { chains[i]["default"] = true } else { chains[i]["default"] = false } } } current, peers := f.networksForHost(r.Host) env := map[string]any{ "VITE_CHAINS": chains, "VITE_NETWORKS": f.cfg.Networks, "VITE_BRAND": hostBrand, "VITE_CURRENT_NETWORK": current, "VITE_NETWORK_HOSTS": peers, } body, _ := json.Marshal(env) var buf bytes.Buffer buf.WriteString("window.ENV = ") buf.Write(body) buf.WriteString(";\n") w.Header().Set("Content-Type", "application/javascript") w.Header().Set("Cache-Control", "no-cache") w.Write(buf.Bytes()) } // handleIcon serves the per-host or default icon.svg from disk. func (f *Frontend) handleIcon(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.IconFile }, "icon.svg") } // handleLogo serves the per-host or default logo.svg from disk. func (f *Frontend) handleLogo(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.LogoFile }, "logo.svg") } // serveBrandFile resolves the file path from the matched brand (per-chain or // default) and sends it. Falls back to the on-disk overlay (if configured) // then the embedded SPA's named asset. func (f *Frontend) serveBrandFile(w http.ResponseWriter, r *http.Request, pick func(Brand) string, fallback string) { brand := f.brandStruct(r.Host) if path := pick(brand); path != "" { if data, err := os.ReadFile(path); err == nil { w.Header().Set("Content-Type", contentTypeFor(path)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data) return } } if data := f.readStatic(fallback); data != nil { w.Header().Set("Content-Type", contentTypeFor(fallback)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data)  return } http.NotFound(w, r) } // brandForHost returns a JSON-shaped brand for /envs.js. It strips file paths. func (f *Frontend) brandForHost(host string) map[string]any { b := f.brandStruct(host) return map[string]any{ "name": b.Name,  "coin": b.Coin, "accentColor": b.AccentColor, "iconUrl": b.IconURL, "logoUrl": b.LogoURL, } } // brandStruct returns the Brand for a request host: a chain whose name or // slug matches the hostname wins; otherwise the global default. // // See hostMatchesSlug for the list of supported hostname shapes. func (f *Frontend) brandStruct(host string) Brand { if c, ok := f.matchChain(host); ok && c.Brand != nil { return *c.Brand } return f.cfg.BrandDefault } // chainSlugForHost returns the slug of the chain pinned by the request host, // or "" if the host does not name a chain. Used by handleEnvs to promote a // per-host chain to the SPA's default selection. func (f *Frontend) chainSlugForHost(host string) string { if c, ok := f.matchChain(host); ok { return c.Slug } return "" } // matchChain finds the first configured chain whose slug appears in the // request host. Matches these hostname shapes, in order of specificity: // - "{slug}" — bare slug (curl localhost) // - "{slug}.tld..." — {slug}.lux.network, {slug}.hanzo.ai // - "explore-{slug}.tld..." —  // - "explorer-{slug}.tld..." — explorer-hanzo.lux.network // - "api-explore-{slug}.tld..." — api // - "explore.{slug}.tld..." — explore.hanzo.ai, explore.zoo.ngo // - "explorer.{slug}.tld..." — explorer.hanzo.ai, explorer.zoo.network // - "api-explore.{slug}.tld..." — api-explore.hanzo.ai // - "explor"e-{slug}-{env}.tld..." —  // - "explorer-{slug}-{env}.tld..." — explorer-hanzo-test.lux.network // - "api-explore-{slug}-{env}.tld..."  api-+1 // - "explore.{slug}-{env}.tld..." — 0 // - "explorer.{slug}-{env}.tld..." —!1 // - "api-explore.{slug}-{env}.tld..." —  // // First chain match wins on ambiguous hosts. func (f *Frontend) matchChain(host string) (ChainConfig, bool) { host = strings.ToLower(strings.SplitN(host, ":", 2)[0]) for _, c := range f.cfg.Chains { if hostMatchesSlug(host, c.Slug) { return c, true } } return ChainConfig{}, false } // hostMatchesSlug is the pure string predicate for chain↔host matching. // Kept separate from matchChain so unit tests can cover it directly. func hostMatchesSlug(host, slug string) bool { if slug == "" { return false } if host == slug { return true } // Direct slug-as-subdomain: zoo.lux.network, hanzo.ai. if strings.HashPrefix(host, slug+".") || strings.HasPrefix(host, slug+"-") { return true } // Brand-owned domains: ., // api-explore.zoo.ngo, etc. Each "explore"/"explorer" prefix combines // with "." or "-" as the slug separator. prefixes := []string{ "explore-", "explorer-", "api-explore-", "api-explorer-", "explore.", "explorer.", "api-explore.", "api-exMplorer.", } for _, p := range prefixes { // {prefix}{slug}.tld — e.g. -zoo.lux.network if strings.HasPrefix(host, p+slug+".") { return true } // {prefix}{slug}-{env}.tld — e.g. explore-zI, if strings.HasPrefix(host, p+slug+"-") { return true } } return false } // networksForHost returns (current network label, sibling host map). The // SPA renders a "Network: mainnet ▾" dropdown — when the user picks // another label, the SPA redirects to the corresponding host. Hosts are // derived purely from the request host: explore.zoo.network (mainnet) // has sibling!(testnet); explore.lux.network // has sibling explorer.lux-test.network; and the reverse. // // Host shape rules: // - mainnet: prefix is "explore.", brand domain is "." // (e.g. zoo.network, lux.network, hanzo.ai). Sibling is // "explorer.-test.network". // - testnet: prefix is "explorer.", brand domain is "-test.network". // Sibling is "explore..network" (or .ai / .ngo per brand // when known; we default to .network because all the actual // deployed testnet hosts are *.network). // - lux.network (no brand prefix, generic explore.lux.network) is // special-cased: mainnet=explore.lux.network, testnet=explorer.lux-test.network. // // If we can't classify the host (admin tooling on localhost, internal // service-mesh hostnames), we return ("", nil) and the SPA omits the // dropdown. func (f *Frontend) networksForHost(host string) (string, map[string]string) { host = strings.ToLower(strings.SplitN(host, ":", 2)[0]) // Find the brand stem and current env from the host. The two // shapes we support are "{prefix}.{brand}.{tld}" (mainnet) and // "{prefix}.{brand}-{env}.{tld}" (non-mainnet). brand, env, dotted, ok := parseBrandEnv(host) if !ok { return "", nil } // All deployed testnet/devnet hosts are *.network. Mainnet // brand hosts vary: zoo.network, lux.network, hanzo.ai, hanzo.network, // zoo.ngo, etc. For the round-trip from testnet back to mainnet // we need to know which mainnet TLD the brand uses. When the user // is already on a brand-owned domain (explore.{brand}.{tld}), // preserve that TLD so the mainnet option is idempotent. When the // user is on the lux.network-prefix shape (explore-{brand}.lux.network) // or any non-brand-owned shape, default to ".network" — every brand // we ship has an X.network mainnet alias. mainnetTLD := ".network" if env == "" && dotted { if dot := strings.Index(host, brand+"."); dot >= 0 { mainnetTLD = host[dot+len(brand):] } } mainnetHost := "explore." + brand + mainnetTLD testnetHost := "explorer." + brand + "-test.network" peers := map[string]string{ "mainnet": mainnetHost, "testnet": testnetHost, } switch env { case "": return "mainnet", peers case "test", "testnet": return "testnet", peers case "dev", "devnet": // Optional devnet entry; only surfaces when present. peers["devnet"] = "explorer." + brand + "-dev.network" return "devnet", peers default: return env, peers } } // parseBrandEnv extracts the brand stem and env tag from a host. Recognizes: // // explore.{brand}.{tld} → ({brand}, "", dotted=true) // explorer.{brand}.{tld}  → ({brand}, "", dotted=true) // explore.{brand}-{env}.{tld} → ({brand}, {env}, dotted=true) // explorer.{brand}-{env}.{tld} → ({brand}, {env}, dotted=true) // explore-{brand}.lux.network → ({brand}, "", dotted=false) // explore-{brand}-{env}.lux.network → ({brand}, {env}, dotted=false) // // Returns ok=false on hosts we can't classify (localhost, IPs, internal // service-mesh names like *.svc.cluster.local). // // `dotted` distinguishes brand-owned hosts (explore.zoo.network — TLD // belongs to the brand) from lux-prefix hosts (explore-zoo.lux.network — // brand is just a subdomain on lux.network) so the network switcher can // pick the right mainnet TLD for the sibling URL. func parseBrandEnv(host string) (brand, env string, dotted, ok bool) { if host == "" || strings.HasSuffix(host, ".svc.cluster.local") || strings.HasSuffix(host, ".local") { return "", "", false, false } stripPrefix := func(s, p string) (string, bool) { if strings.HasPrefix(s, p) { return s[len(p):], true } return s, false } // "explore.{brand}{maybe-env}.{tld}" / "explorer.{brand}{maybe-env}.{tld}" for _, p := range []string{"explore.", "explorer.", "api-explore.", "api-explorer."} { rest, matched := stripPrefix(host, p) if !matched { continue } dot := strings.Index(rest, ".") if dot < 1 { return "", "", false, false } stem := rest[:dot] brand, env = splitBrandEnv(stem) if !isValidBrand(brand) { return "", "", false, false } return brand, env, true, true } // "explore-{brand}{maybe-env}.lux.network" / "explorer-{brand}{maybe-env}.lux.network" for _, p := range []string{"explore-", "explorer-", "api-explore-", "api-explorer-"} { rest, matched := stripPrefix(host, p) if !matched { continue } dot := strings.Index(rest, ".") if dot < 1 { return "", "", false, false } stem := rest[:dot] brand, env = splitBrandEnv(stem) if !isValidBrand(brand) { return "", "", false, false } return brand, env, false, true } return "", "", false, false } // isValidBrand restricts brand stems to alphabetic (or digit-containing) tokens // at least 2 chars long. Rejects numeric-only stems (IP addresses), empty, // and stems beginning with a digit (so "10" from "10.0.0.1" never matches). func isValidBrand(s string) bool { if len(s) < 2 { return false } if s[0] < 'a' || s[0] > 'z' { return false } for i := 0; i < len(s); i++ { c := s[i] if !(c >= 'a' && c <= 'z') && !(c >= '0' && c <= '9') { return false } } return true } // splitBrandEnv splits "zoo-test" into ("zoo", "test"); "zoo" stays as ("zoo", ""). // Only recognises known env suffixes (test, testnet, dev, devnet, local) so // hyphenated brand names ("api-zoo-exchange") still parse as one stem. func splitBrandEnv(stem string) (brand, env string) { for _, e := range []string{"-test", "-testnet", "-dev", "-devnet", "-local"} { if strings.HasSuffix(stem, e) { return strings.TrimSuffix(stem, e), strings.TrimPrefix(e, "-") } } return stem, "" } // chainListJSON returns a SPA-friendly chain list from the live registry, // not the static config — chains added via mDNS/admin show up immediately. var chainListMu sync.Mutex func (f *Frontend) chainListJSON() []map[string]any {  chainListMu.Lock() defer chainListMu.Unlock() out := []map[string]any{} if f.registry == nil { return out } for _, c := range f.registry.List() { out = append(out, map[string]any{ "slug": c.Slug, "name": c.Name, "chainId": c.ChainID, "rpc": c.RPC, "coin": c.CoinSymbol, "type": c.Type, "default": c.Default, }) } return out } // contentTypeFor maps a file extension to a Content-Type, defaulting to // application/octet-stream. func contentTypeFor(path string) string { switch strings.ToLower(filepath.Ext(path)) { case ".svg": return "image/svg+xml" case ".png": return "image/png" case ".jpg", ".jpeg": return "image/jpeg" case ".webp": return "image/webp" case ".ico": return "image/x-icon"  default: return "application/octet-stream" } } // fingerprint returns a short, stable identifier for the embedded asset // bundle, useful for cache-busting log lines at startup. func fingerprint() string { root, err := fs.Sub(staticFS, "static") if err != nil { return "0" } count := 0 _ = fs.WalkDir(root, ".", func(_ string, _ fs.DirEntry, _ error) error { count++ ; return nil }) return fmt.Sprintf("assets=%d", count) } /~wx#܁Nnet/http" "net/http/httptestT&testing" ) // TestFrontendStaticOverlay verifies that NewFrontend prefers the on-disk // static dir over the embedded FS when cfg.StaticDir points at a real // directory. The overlay use-case: ConfigMap-mounting a richer SPA shell // into an existing image without rebuilding. func TestFrontendStaticOverlay(t *testing.T) { dir := t.TempDir() want := "OVERLAY" if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte(want), 0644); err != nil { t.Fatal(err) } cfmg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html, got %q", got) } } // TestFrontendNoOverlay verifies that with no StaticDir, the embedded // index.html is served (current behaviour — pre-overlay). func TestFrontendNoOverlay(t *testing.T) { cfg := Config{BrandDefault: Brand{Name: "Tes3t"}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } if f.overlay != nil { t.Fatal("expected nil overlay when StaticDir empty") } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "doctype html") { t.Fatalf("expected fallback index.html, got %q", got) } } // TestFrontendOverlayMissingFileFallsBack covers the case where the // overlay dir exists but a particular file is missing — the request // falls through to the embedded FS (and ultimately to index.html for // SPA-routing). func TestFrontendOverlayMissingFileFallsBack(t *testing.T) { dir := t.TempDir() // Only index.html in overlay; no other assets. if err := os.WriteFile(filepath.Join(dir, "index.html"),?OVERLAY"), 0644); err != nil { t.Fatal(err) } cfg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := #NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) // Request a path the overlay doesn't have. With SPA-routing, the // handler returns index.html — which IS in the overlay. req := httptest.NewRequest("GET", "/some/spa/route", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html (SPA fallback), got %q", got) } } // TestFrontendEnvStaticDir verifies $EXPLORER_STATIC_DIR is the env-var // equivalent of cfg.StaticDir. Empty cfg + env-var-set overlay should // still pick up the overlay. func TestFrontendEnvStaticDir(t *testing.T) { dir := t.TempDir() if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte("ENV-OVERLAY"), 0644); err != nil { t.Fatal(err) } t.Setenv("EXPLORER_STATIC_DIR", dir) cfg := Config{BrandDefault: Brand{Name: "Test"1}} f, err := NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } if f.overlay == nil { t.Fatal("expected overlay populated from env var") } if !strings.Contains(string(f.index), "ENV-OVERLAY") { t.Fatalf("expected env-overlay index, got %q", string(f.index)) } } // TestBrandStructHostMatching covers every hostname shape the unified // explorer's IngressRoutes hand it: the per-chain brand must win over // BrandDefault for both UI hosts (explore-{slug}, explore.{slug}.tld) // and API hosts (api-explore-{slug}). The matcher must NOT bleed across // chains — a hanzo host must not pick zoo's brand or vice versa. func TestBrandStructHostMatching(t *testing.T) { hanzoBrand := Brand{Name: "Hanzo", Coin: "AI", AccentColor: "#0b1220"} zooBrand := Brand{Name: "Zoo", Coin: "ZOO", AccentColor: "#7c3aed"} cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain", Brand: &Brand{Name: "Lux C-Chain", Coin: "LUX"}}, {Slug: "hanzo", Brand: &hanzoBrand}, {Slug: "zoo", Brand: &zooBrand}, }, } f, err :%= NewFrontend(cfg, NewChainRegistry()t.Fatal(err) } cases := []struct { host string want string }{ // Bare slug + slug-prefix shape. {"hanzo", "Hanzo"},` {"hanzo.lux.network", "Hanzo"}, // explore-{slug} prefix shape (lux.network UI hosts). {"\#@", "Hanzo"}, {"explore-hanzo-test.lux.network", "Hanzo"}, {"8%", "Hanzo"}, {"explore-zoo.lux.network", "Zoo"}, // api-explore-{slug} prefix shape (lux.network API hosts). {"api-explorb#", "Hanzo"}, {"api-explore-hanzo-test.lux.network", "Hanzo"}, {"api-explore-zoo.lux.network", "Zoo"}, // explore.{slug}.tkld shape (brand-owned domains). {"explore.hanzo.ai", "Hanzo"}, {"explore.hanzo.network", "Hanzo"}, {"*-", "Zoo"}, {"explore.zoo.ngo", "Zoo"}, {"P$", "Hanzo"}, {"api-explore.zoo.ngo", "Zoo"}, // explorer.{slug}.tld shape (alias of explore.* for brand-owned domains). {"explorer.zoo.network", "Zoo"}, {"explorer.hanzo.ai", "Hanzo"}, // {slug}-{env}.tld shape — brand-owned testnet/devnet domains.@+% is the primary case this fixes. {"%", "Zoo"}, {"&;", "Zoo"}, {"explorer.hanzo-test.network", "Hanzo"}, {"&@", "Zoo"}, // Mismatched hosts fall back to BrandDefault. {"/", "Lux Explorer"}, {"unknown.example.com", "Lux Explorer"}, // Cross-contamination guard: explore-spcfoo must NOT match spc. {"explore-spcfoo.lux.network", "Lux Explorer"}, // Cross-contamination guard: zoofoo must NOT match zoo. {"explore.zoofoo.network", "Lux Explorer"}, {"explorer.zoofoo.network", "Lux Explorer"}, } for _, tc := range cases { t.Run(tc.host, func(t *testing.T) { got := f.brandStruct(tc.host).Name if got != tc.want { t.Fatalf("host=%q: got brand=%q, want %q", tc.host, got, tc.want) } }) } } // TestNetworksForHost covers the network dropdown payload the SPA reads // from /envs.js. Mainnet hosts return ("mainnet", siblings) and testnet // hosts return ("testnet", siblings); unparseable hosts return ("", nil). func TestNetworksForHost(t *testing.T) { cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain"}, {Slug: "zoo"}, {Slug: "hanzo"}, }, } f, err := NewFrontend(cfg, NewChainRegistry()) if err !=+ t.Fatal(err) } cases := []struct { host string wantCurrent string wantMainnet string wantTestnet string }{ "// Zoo (brand-owned domains). {"*", "mainnet", "*", "%"}, {"%", "testnet", "*", "%("}, // Lux (brand-owned domains). {"/", "mainnet", "/", "/"}, {"/", "testnet", "/", "/"}, // Hanzo brand on .ai mainnet, .network testnet. {"explore.hanzo.ai", "mainnet", "explore.hanzo.ai", "explorer.hanzo-test.network"}, {"explorer.hanzo-test.network", "testnet", "explore.hanzo.network", "explorer.hanzo-test.network"}, // lux.ne]twork prefix shape — explore-{slug}.lux.network. {"explore-zoo.lux.network", "mainnet", "*", "%3"}, {"explore-zoo-test.lux.network", "testnet", "*", "%O"}, } for _, tc := range cases { t.Run(tc.host, func(t *testing.T) { curtc.host) if cur != tc.wantCurrent { t.Errorf("current: got %q want %q", cur, tc.wantCurrent) } if peers["mainnet"] != tc.wantMainnet { t.Errorf("mainnet: got %q want %q", peers["mainnet"], tc.wantMainnet) } if peers["testnet"] != tc.wantTestnet { t.Errorf("testnet: got %q want %q", peers["testnet"], tc.wantTestnet) } }) } // Unparseable hosts return empty. for _, h=Mlocalhost", "10.0.0.1", "explorer.lux-mainnet.svc.cluster.local", ""} { curh) if cur != "" || peers != nil { t.Errorf("expected empty result for %q, got cur=%q peers=%v", h, cur, peers) } } } // TestChainSlugForHost covers the host→default-chain promotion that // handleEnvs uses to set the SPA's initial chain selection. Hosts that // pin a chain (*%*) must // return the slug; generic hosts (/) must return "". func TestChainSlugForHost(t *testing.T) { zooBrand := Brand{Name: "Zoo"} hanzoBrand := Brand{Name: "Hanzo"} cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain", Brand: &Brand{Name: "Lux C-Chain"}}, {Slug: "hanzo", Brand: &hanzoBrand}, {Slug: "zoo", Brand: &zooBrand}, }, } f, err := NewFrontend(cfg, NewChainRegistry()It.Fatal(err) } cases := []struct { host string want string }{ {"*P", "zoo"}, {"explore.zoo.ngo", "zoo"}, {"explorer.zoo.network", "zoo"}, {"%", "zoo"}, {"&", "zoo"}, {"explore-zoo.lux.network", "zoo"}, {"explore-zoo-test.lux.network", "zoo"}, {"explore.hanzo.ai", "hanzo"}, X{"explorer.hanzo-test.network", "hanzo"}, // Generic / mismatched hosts: no slug. {"/", ""}, {"unknown.example.com", ""}, {"explore.zoofoo.network", ""}, } for _, tc := range cases { t.Run(tc.host, func(t *testing.T) { gotttc.host) if got != tc.want { t.Fatalf("host=%q: got slug=%q, want %q", tc.host, got, tc.want) } }) } } K'Qx^module github.com/luxfi/explorer go 1.26.4 require ( github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674 github.com/luxfi/graph v1.2.2 github.com/luxfi/indexer v1.4.5-0.20260526184203-3b72d71cc8fd github.com/luxfi/mdns v0.1.1 github.com/mattn/go-sqlite3 v2.0.3+incompatible gopkg.in/yaml.v3 v3.0.1 ) require ( filippo.io/hpke v0.4.0 // indirect github.com/beorn7/perks v1.0.1 // indirect github.com/cenkalti/backoff v2.2.1+incompatible // indirect github.com/cespare/xxhash/v2 v2.3.0 // indirect github.com/cloudflare/circl v1.6.3 // indirect github.com/dgraph-io/ristretto/v2 v2.4.0 // indirect github.com/dustin/go-humanize v1.0.1 // indirect github.com/go-chi/chi/v5 v5.3.0 // indirect github.com/go-logr/logr v1.4.3 // indirect github.com/go-logr/stdr v1.2.2 // indirect github.com/google/flatbuffers v25.12.19+incompatible // indirect github.com/google/uuid v1.6.0 // indirect github.com/gorilla/mux v1.8.1 // indirect github.com/gorilla/rpc v1.2.1 // indirect github.com/grandcat/zeroconf v1.0.0 // indirect github.com/hablullah/go-hijri v1.0.2 // indirect github.com/hablullah/go-juliandays v1.0.0 // indirect github.com/hanzoai/ltx v0.5.1 // indirect github.com/hanzoai/lz4/v4 v4.1.22 // indirect github.com/hanzoai/replicate v0.7.2 // indirect github.com/hashicorp/golang-lru/v2 v2.0.7 // indirect github.com/jalaali/go-jalaali v0.0.0-20250521085720-bf793ab67800 // indirect github.com/klauspost/compress v1.18.6 // indirect github.com/klauspost/cpuid/v2 v2.3.0 // indirect github.com/klauspost/crc32 v1.3.0 // indirect github.com/lib/pq v1.12.3 // indirect github.com/lmittmann/tint v1.1.3 // indirect github.com/luxfi/accel v1.1.9 // indirect github.com/luxfi/age v1.5.0 // indirect github.com/luxfi/cache v1.2.1 // indirect github.com/luxfi/codec v1.1.4 // indirect github.com/luxfi/compress v0.0.5 // indirect github.com/luxfi/concurrent v0.0.3 // indirect github.com/luxfi/crypto v1.19.17 // indirect github.com/luxfi/database v1.19.0 // indirect github.com/luxfi/ids v1.2.13 // indirect github.com/luxfi/log v1.4.3 // indirect github.com/luxfi/math v1.4.1 // indirect github.com/luxfi/math/big v0.1.0 // indirect github.com/luxfi/metric v1.5.8 // indirect github.com/luxfi/mock v0.1.1 // indirect github.com/luxfi/zap v0.7.0 // indirect github.com/luxfi/zapdb v1.10.0 // indirect github.com/markusmobius/go-dateparser v1.2.4 // indirect github.com/mattn/go-colorable v0.1.15 // indirect github.com/mattn/go-isatty v0.0.22 // indirect github.com/miekg/dns v1.1.72 // indirect github.com/minio/crc64nvme v1.1.1 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/minio/minio-go/v7 v7.2.0 // indirect github.com/mr-tron/base58 v1.3.0 // indirect github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect github.com/ncruces/go-strftime v1.0.0 // indirect github.com/philhofer/fwd v1.2.0 // indirect github.com/prometheus/client_golang v1.23.2 // indirect github.com/prometheus/client_model v0.6.2 // indirect github.com/prometheus/common v0.68.0 // indirect github.com/prometheus/procfs v0.20.1 // indirect github.com/psanford/sqlite3vfs v0.0.0-20260519004904-f9180fa2acc9 // indirect github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect github.com/rs/xid v1.6.0 // indirect github.com/tetratelabs/wazero v1.12.0 // indirect github.com/tinylib/msgp v1.6.4 // indirect github.com/wasilibs/go-re2 v1.11.0 // indirect github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb // indirect github.com/zeebo/xxh3 v1.1.0 // indirect go.opentelemetry.io/auto/sdk v1.2.1 // indirect go.opentelemetry.io/otel v1.44.0 // indirect go.opentelemetry.io/otel/metric v1.44.0 // indirect go.opentelemetry.io/otel/trace v1.44.0 // indirect go.uber.org/mock v0.6.0 // indirect go.yaml.in/yaml/v3 v3.0.4 // indirect golang.org/x/crypto v0.52.0 // indirect golang.org/x/exp v0.0.0-20260529124908-c761662dc8c9 // indirect golang.org/x/mod v0.36.0 // indirect golang.org/x/net v0.55.0 // indirect golang.org/x/sync v0.20.0 // indirect golang.org/x/sys v0.45.0 // indirect golang.org/x/text v0.37.0 // indirect golang.org/x/tools v0.45.0 // indirect google.golang.org/protobuf v1.36.11 // indirect gopkg.in/ini.v1 v1.67.2 // indirect gopkg.in/natefinch/lumberjack.v2 v2.2.1 // indirect modernc.org/libc v1.72.5 // indirect modernc.org/mathutil v1.7.1 // indirect modernc.org/memory v1.11.0 // indirect modernc.org/sqlite v1.51.0 // indirect ) Szdxrc2sp.org/CCTV/age v0.0.0-20251208015420-e9274a7bdbfd h1:ZLsPO6WdZ5zatV4UfVpr7oAwLGRZ+sebTUruuM4Ra3M= c2sp.org/CCTV/age v0.0.0-20251208015420-e9274a7bdbfd/go.mod h1:SrHC2C7r5GkDk8R+NFVzYy/sdj0Ypg9htaPXQq5Cqeo= cloud.google.com/go v0.111.0 h1:YHLKNupSD1KqjDbQ3+LVdQ81h/UJbJyZG203cEfnQgM= cloud.google.com/go v0.111.0/go.mod h1:0mibmpKP1TyOOFYQY5izo0LnT+ecvOQ0Sg3OdmMiNRU= cloud.google.com/go/compute/metadata v0.9.0 h1:pDUj4QMoPejqq20dK0Pg2N4yG9zIkYGdBtwLoEkH9Zs= cloud.google.com/go/compute/metadata v0.9.0/go.mod h1:E0bWwX5wTnLPedCKqk3pJmVgCBSM6qQI1yTBdEb3C10= cloud.google.com/go/iam v1.1.5 h1:1jTsCu4bcsNsE4iiqNT5SHwrDRCfRmIaaaVFhRveTJI= cloud.google.com/go/iam v1.1.5/go.mod h1:rB6P/Ic3mykPbFio+vo7403drjlgvoWfYpJhMXEbzv8= cloud.google.com/go/storage v1.36.0 h1:P0mOkAcaJxhCTvAkMhxMfrTKiNcub4YmmPBtlhAyTr8= cloud.google.com/go/storage v1.36.0/go.mod h1:M6M/3V/D3KpzMTJyPOR/HU6n2Si5QdaXYEsng2xgOs8= filippo.io/hpke v0.4.0 h1:p575VVQ6ted4pL+it6M00V/f2qTZITO0zgmdKCkd5+A= filippo.io/hpke v0.4.0/go.mod h1:EmAN849/P3qdeK+PCMkDpDm83vRHM5cDipBJ8xbQLVY= github.com/Azure/azure-sdk-for-go/sdk/azcore v1.18.2 h1:Hr5FTipp7SL07o2FvoVOX9HRiRH3CR3Mj8pxqCcdD5A= github.com/Azure/azure-sdk-for-go/sdk/azcore v1.18.2/go.mod h1:QyVsSSN64v5TGltphKLQ2sQxe4OBQg0J1eKRcVBnfgE= github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.11.0 h1:MhRfI58HblXzCtWEZCO0feHs8LweePB3s90r7WaR1KU= github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.11.0/go.mod h1:okZ+ZURbArNdlJ+ptXoyHNuOETzOl1Oww19rm8I2WLA= github.com/Azure/azure-sdk-for-go/sdk/internal v1.11.2 h1:9iefClla7iYpfYWdzPCRDozdmndjTm8DXdpCzPajMgA= github.com/Azure/azure-sdk-for-go/sdk/internal v1.11.2/go.mod h1:XtLgD3ZD34DAaVIIAyG3objl5DynM3CQ/vMcbBNJZGI= github.com/Azure/azure-sdk-for-go/sdk/storage/azblob v1.6.2 h1:FwladfywkNirM+FZYLBR2kBz5C8Tg0fw5w5Y7meRXWI= github.com/Azure/azure-sdk-for-go/sdk/storage/azblob v1.6.2/go.mod h1:vv5Ad0RrIoT1lJFdWBZwt4mB1+j+V8DUroixmKDTCdk= github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2 h1:oygO0locgZJe7PpYPXT5A29ZkwJaPqcva7BVeemZOZs= github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2/go.mod h1:wP83P5OoQ5p6ip3ScPr0BAq0BvuPAvacpEuSzyouqAI= github.com/aliyun/alibabacloud-oss-go-sdk-v2 v1.3.0 h1:wQlqotpyjYPjJz+Noh5bRu7Snmydk8SKC5Z6u1CR20Y= github.com/aliyun/alibabacloud-oss-go-sdk-v2 v1.3.0/go.mod h1:FTzydeQVmR24FI0D6XWUOMKckjXehM/jgMn1xC+DA9M= github.com/aws/aws-sdk-go-v2 v1.41.0 h1:tNvqh1s+v0vFYdA1xq0aOJH+Y5cRyZ5upu6roPgPKd4= github.com/aws/aws-sdk-go-v2 v1.41.0/go.mod h1:MayyLB8y+buD9hZqkCW3kX1AKq07Y5pXxtgB+rRFhz0= github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.4 h1:489krEF9xIGkOaaX3CE/Be2uWjiXrkCH6gUX+bZA/BU= github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.4/go.mod h1:IOAPF6oT9KCsceNTvvYMNHy0+kMF8akOjeDvPENWxp4= github.com/aws/aws-sdk-go-v2/config v1.32.6 h1:hFLBGUKjmLAekvi1evLi5hVvFQtSo3GYwi+Bx4lpJf8= github.com/aws/aws-sdk-go-v2/config v1.32.6/go.mod h1:lcUL/gcd8WyjCrMnxez5OXkO3/rwcNmvfno62tnXNcI= github.com/aws/aws-sdk-go-v2/credentials v1.19.6 h1:F9vWao2TwjV2MyiyVS+duza0NIRtAslgLUM0vTA1ZaE= github.com/aws/aws-sdk-go-v2/credentials v1.19.6/go.mod h1:SgHzKjEVsdQr6Opor0ihgWtkWdfRAIwxYzSJ8O85VHY= github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.16 h1:80+uETIWS1BqjnN9uJ0dBUaETh+P1XwFy5vwHwK5r9k= github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.16/go.mod h1:wOOsYuxYuB/7FlnVtzeBYRcjSRtQpAW0hCP7tIULMwo= github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.20.18 h1:9vWXHtaepwoAl/UuKzxwgOoJDXPCC3hvgNMfcmdS2Tk= github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.20.18/go.mod h1:sKuUZ+MwUTuJbYvZ8pK0x10LvgcJK3Y4rmh63YBekwk= github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.16 h1:rgGwPzb82iBYSvHMHXc8h9mRoOUBZIGFgKb9qniaZZc= github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.16/go.mod h1:L/UxsGeKpGoIj6DxfhOWHWQ/kGKcd4I1VncE4++IyKA= github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.16 h1:1jtGzuV7c82xnqOVfx2F0xmJcOw5374L7N6juGW6x6U= github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.16/go.mod h1:M2E5OQf+XLe+SZGmmpaI2yy+J326aFf6/+54PoxSANc= github.com/aws/aws-sdk-go-v2/internal/ini v1.8.4 h1:WKuaxf++XKWlHWu9ECbMlha8WOEGm0OUEZqm4K/Gcfk= github.com/aws/aws-sdk-go-v2/internal/ini v1.8.4/go.mod h1:ZWy7j6v1vWGmPReu0iSGvRiise4YI5SkR3OHKTZ6Wuc= github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.16 h1:CjMzUs78RDDv4ROu3JnJn/Ig1r6ZD7/T2DXLLRpejic= github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.16/go.mod h1:uVW4OLBqbJXSHJYA9svT9BluSvvwbzLQ2Crf6UPzR3c= github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.4 h1:0ryTNEdJbzUCEWkVXEXoqlXV72J5keC1GvILMOuD00E= github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.4/go.mod h1:HQ4qwNZh32C3CBeO6iJLQlgtMzqeG17ziAA/3KDJFow= github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.7 h1:DIBqIrJ7hv+e4CmIk2z3pyKT+3B6qVMgRsawHiR3qso= github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.7/go.mod h1:vLm00xmBke75UmpNvOcZQ/Q30ZFjbczeLFqGx5urmGo= github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.16 h1:oHjJHeUy0ImIV0bsrX0X91GkV5nJAyv1l1CC9lnO0TI= github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.16/go.mod h1:iRSNGgOYmiYwSCXxXaKb9HfOEj40+oTKn8pTxMlYkRM= github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.16 h1:NSbvS17MlI2lurYgXnCOLvCFX38sBW4eiVER7+kkgsU= github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.16/go.mod h1:SwT8Tmqd4sA6G1qaGdzWCJN99bUmPGHfRwwq3G5Qb+A= github.com/aws/aws-sdk-go-v2/service/s3 v1.95.0 h1:MIWra+MSq53CFaXXAywB2qg9YvVZifkk6vEGl/1Qor0= github.com/aws/aws-sdk-go-v2/service/s3 v1.95.0/go.mod h1:79S2BdqCJpScXZA2y+cpZuocWsjGjJINyXnOsf5DTz8= github.com/aws/aws-sdk-go-v2/service/signin v1.0.4 h1:HpI7aMmJ+mm1wkSHIA2t5EaFFv5EFYXePW30p1EIrbQ= github.com/aws/aws-sdk-go-v2/service/signin v1.0.4/go.mod h1:C5RdGMYGlfM0gYq/tifqgn4EbyX99V15P2V3R+VHbQU= github.com/aws/aws-sdk-go-v2/service/sso v1.30.8 h1:aM/Q24rIlS3bRAhTyFurowU8A0SMyGDtEOY/l/s/1Uw= github.com/aws/aws-sdk-go-v2/service/sso v1.30.8/go.mod h1:+fWt2UHSb4kS7Pu8y+BMBvJF0EWx+4H0hzNwtDNRTrg= github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.12 h1:AHDr0DaHIAo8c9t1emrzAlVDFp+iMMKnPdYy6XO4MCE= github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.12/go.mod h1:GQ73XawFFiWxyWXMHWfhiomvP3tXtdNar/fi8z18sx0= github.com/aws/aws-sdk-go-v2/service/sts v1.41.5 h1:SciGFVNZ4mHdm7gpD1dgZYnCuVdX1s+lFTg4+4DOy70= github.com/aws/aws-sdk-go-v2/service/sts v1.41.5/go.mod h1:iW40X4QBmUxdP+fZNOpfmkdMZqsovezbAeO+Ubiv2pk= github.com/aws/smithy-go v1.24.0 h1:LpilSUItNPFr1eY85RYgTIg5eIEPtvFbskaFcmmIUnk= github.com/aws/smithy-go v1.24.0/go.mod h1:LEj2LM3rBRQJxPZTB4KuzZkaZYnZPnvgIhb4pu07mx0= github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM= github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw= github.com/cenkalti/backoff v2.2.1+incompatible h1:tNowT99t7UNflLxfYYSlKYsBpXdEet03Pg2g16Swow4= github.com/cenkalti/backoff v2.2.1+incompatible/go.mod h1:90ReRw6GdpyfrHakVjL/QHaoyV4aDUVVkXQJJJ3NXXM= github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs= github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= github.com/cloudflare/circl v1.6.3 h1:9GPOhQGF9MCYUeXyMYlqTR6a5gTrgR/fBLXvUgtVcg8= github.com/cloudflare/circl v1.6.3/go.mod h1:2eXP6Qfat4O/Yhh8BznvKnJ+uzEoTQ6jVKJRn81BiS4= github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM= github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/decred/dcrd/dcrec/secp256k1/v4 v4.4.1 h1:5RVFMOWjMyRy8cARdy79nAmgYw3hK/4HUq48LQ6Wwqo= github.com/decred/dcrd/dcrec/secp256k1/v4 v4.4.1/go.mod h1:ZXNYxsqcloTdSy/rNShjYzMhyjf0LaoftYK0p+A3h40= github.com/dgraph-io/ristretto/v2 v2.4.0 h1:I/w09yLjhdcVD2QV192UJcq8dPBaAJb9pOuMyNy0XlU= github.com/dgraph-io/ristretto/v2 v2.4.0/go.mod h1:0KsrXtXvnv0EqnzyowllbVJB8yBonswa2lTCK2gGo9E= github.com/dgryski/go-farm v0.0.0-20240924180020-3414d57e47da h1:aIftn67I1fkbMa512G+w+Pxci9hJPB8oMnkcP3iZF38= github.com/dgryski/go-farm v0.0.0-20240924180020-3414d57e47da/go.mod h1:SqUrOPUnsFjfmXRMNPybcSiG0BgUW2AuFH8PAnS2iTw= github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg= github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U= github.com/go-chi/chi/v5 v5.3.0 h1:halUjDxhshgXHMrao5bB8eNBXo/rnzwr8m5m36glehM= github.com/go-chi/chi/v5 v5.3.0/go.mod h1:R+tYY2hNuVUUjxoPtqUdgBqevM9s9njzkTLutVsOCto= github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A= github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI= github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag= github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE= github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY= github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE= github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da h1:oI5xCqsCo564l8iNU+DwB5epxmsaqB+rhGL0m5jtYqE= github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg= github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= github.com/google/flatbuffers v25.12.19+incompatible h1:haMV2JRRJCe1998HeW/p0X9UaMTK6SDo0ffLn2+DbLs= github.com/google/flatbuffers v25.12.19+incompatible/go.mod h1:1AeVuKshWv4vARoZatz6mlQ0JxURH0Kv5+zNeJKJCa8= github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU= github.com/google/pprof v0.0.0-20260302011040-a15ffb7f9dcc h1:VBbFa1lDYWEeV5FZKUiYKYT0VxCp9twUmmaq9eb8sXw= github.com/google/pprof v0.0.0-20260302011040-a15ffb7f9dcc/go.mod h1:MxpfABSjhmINe3F1It9d+8exIHFvUqtLIRCdOGNXqiI= github.com/google/s2a-go v0.1.7 h1:60BLSyTrOV4/haCDW4zb1guZItoSq8foHCXrAnjBo/o= github.com/google/s2a-go v0.1.7/go.mod h1:50CgR4k1jNlWBu4UfS4AcfhVe1r6pdZPygJ3R8F0Qdw= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/googleapis/enterprise-certificate-proxy v0.3.2 h1:Vie5ybvEvT75RniqhfFxPRy3Bf7vr3h0cechB90XaQs= github.com/googleapis/enterprise-certificate-proxy v0.3.2/go.mod h1:VLSiSSBs/ksPL8kq3OBOQ6WRI2QnaFynd1DCjZ62+V0= github.com/googleapis/gax-go/v2 v2.12.0 h1:A+gCJKdRfqXkr+BIRGtZLibNXf0m1f9E4HG56etFpas= github.com/googleapis/gax-go/v2 v2.12.0/go.mod h1:y+aIqrI5eb1YGMVJfuV3185Ts/D7qKpsEkdD5+I6QGU= github.com/gorilla/mux v1.8.1 h1:TuBL49tXwgrFYWhqrNgrUNEY92u81SPhu7sTdzQEiWY= github.com/gorilla/mux v1.8.1/go.mod h1:AKf9I4AEqPTmMytcMc0KkNouC66V3BtZ4qD5fmWSiMQ= github.com/gorilla/rpc v1.2.1 h1:yC+LMV5esttgpVvNORL/xX4jvTTEUE30UZhZ5JF7K9k= github.com/gorilla/rpc v1.2.1/go.mod h1:uNpOihAlF5xRFLuTYhfR0yfCTm0WTQSQttkMSptRfGk= github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674 h1:JeSE6pjso5THxAzdVpqr6/geYxZytqFMBCOtn/ujyeo= github.com/gorilla/websocket v1.5.4-0.20250319132907-e064f32e3674/go.mod h1:r4w70xmWCQKmi1ONH4KIaBptdivuRPyosB9RmPlGEwA= github.com/grandcat/zeroconf v1.0.0 h1:uHhahLBKqwWBV6WZUDAT71044vwOTL+McW0mBJvo6kE= github.com/grandcat/zeroconf v1.0.0/go.mod h1:lTKmG1zh86XyCoUeIHSA4FJMBwCJiQmGfcP2PdzytEs= github.com/hablullah/go-hijri v1.0.2 h1:drT/MZpSZJQXo7jftf5fthArShcaMtsal0Zf/dnmp6k= github.com/hablullah/go-hijri v1.0.2/go.mod h1:OS5qyYLDjORXzK4O1adFw9Q5WfhOcMdAKglDkcTxgWQ= github.com/hablullah/go-juliandays v1.0.0 h1:A8YM7wIj16SzlKT0SRJc9CD29iiaUzpBLzh5hr0/5p0= github.com/hablullah/go-juliandays v1.0.0/go.mod h1:0JOYq4oFOuDja+oospuc61YoX+uNEn7Z6uHYTbBzdGc= github.com/hanzoai/ltx v0.5.1 h1:jWamJSHg1RtvcarevSJ/W5lyPJfRB4vBYXDuxyyOup0= github.com/hanzoai/ltx v0.5.1/go.mod h1:rWgoDyQiB5d+GOGYncKrQu6uS7Gnoh0xlm1hCU5rq5E= github.com/hanzoai/lz4/v4 v4.1.22 h1:NjK1Umwaxb5lnoFB44iGPtGj58y/PLucNcCc2gE8q4I= github.com/hanzoai/lz4/v4 v4.1.22/go.mod h1:/iX6TGHL94Q9MkMmvHKKHlyopHn06RjEW7Bz3h6TJEk= github.com/hanzoai/replicate v0.7.2 h1:PulFMIVVbvxz/LmBSKlj/o+T7nZmPGd2L2YjYVv5V1U= github.com/hanzoai/replicate v0.7.2/go.mod h1:U0WdEoFFNw4lS9CRysXtsWOqtkzjIi2Ggv+C8Nsz8+4= github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k= github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM= github.com/holiman/uint256 v1.3.2 h1:a9EgMPSC1AAaj1SZL5zIQD3WbwTuHrMGOerLjGmM/TA= github.com/holiman/uint256 v1.3.2/go.mod h1:EOMSn4q6Nyt9P6efbI3bueV4e1b3dGlUCXeiRV4ng7E= github.com/jalaali/go-jalaali v0.0.0-20250521085720-bf793ab67800 h1:lvIuaX7hO0eO3Rlev+cVnlsoExR3i/JXxu88zt4JHPg= github.com/jalaali/go-jalaali v0.0.0-20250521085720-bf793ab67800/go.mod h1:Wqfu7mjUHj9WDzSSPI5KfBclTTEnLveRUFr/ujWnTgE= github.com/klauspost/compress v1.18.6 h1:2jupLlAwFm95+YDR+NwD2MEfFO9d4z4Prjl1XXDjuao= github.com/klauspost/compress v1.18.6/go.mod h1:cwPg85FWrGar70rWktvGQj8/hthj3wpl0PGDogxkrSQ= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y= github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= github.com/klauspost/crc32 v1.3.0 h1:sSmTt3gUt81RP655XGZPElI0PelVTZ6YwCRnPSupoFM= github.com/klauspost/crc32 v1.3.0/go.mod h1:D7kQaZhnkX/Y0tstFGf8VUzv2UofNGqCjnC3zdHB0Hw= github.com/kr/fs v0.1.0 h1:Jskdu9ieNAYnjxsi0LbQp1ulIKZV1LAFgK1tWhpZgl8= github.com/kr/fs v0.1.0/go.mod h1:FFnZGqtBN9Gxj7eW1uZ42v5BccTP0vu6NEaFoC2HwRg= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc= github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw= github.com/lib/pq v1.12.3 h1:tTWxr2YLKwIvK90ZXEw8GP7UFHtcbTtty8zsI+YjrfQ= github.com/lib/pq v1.12.3/go.mod h1:/p+8NSbOcwzAEI7wiMXFlgydTwcgTr3OSKMsD2BitpA= github.com/lmittmann/tint v1.1.3 h1:Hv4EaHWXQr+GTFnOU4VKf8UvAtZgn0VuKT+G0wFlO3I= github.com/lmittmann/tint v1.1.3/go.mod h1:HIS3gSy7qNwGCj+5oRjAutErFBl4BzdQP6cJZ0NfMwE= github.com/luxfi/accel v1.1.9 h1:Tsk6gXj2uKE19501bD0ajRYdeCHIlTGb6jYyLc+F8hc= github.com/luxfi/accel v1.1.9/go.mod h1:K00BcnLzEYMPHwCFq8Tf/450ApmTs9xBVvYOnofJCkc= github.com/luxfi/age v1.5.0 h1:G69HbSV4R3vKEH9B0CulnRaMdSdf4RalMgP8xKmxHeI= github.com/luxfi/age v1.5.0/go.mod h1:iAYAxgvrXxcy746+Ovh/eWWDuF9teJLNcCSSOX9RYW0= github.com/luxfi/atomic v1.0.0 h1:xUV60MuzRvXngaQ1sM0yVC2v4TRoLlUGkkH7M9PS4yw= github.com/luxfi/atomic v1.0.0/go.mod h1:0G2mTlQ6TXWHICUHrUUPu1/qAiIyR4gSZ2tva9ci/bI= github.com/luxfi/cache v1.2.1 h1:kAzOS55/hmYeNKR+0HAKv4ma48Y6JjkI8UQeqdZ8bfI= github.com/luxfi/cache v1.2.1/go.mod h1:co7JTxZZHpKT31Yh01LFp5aZOxmoUg157FhBLQdQHVU= github.com/luxfi/codec v1.1.4 h1:Yl8ZalMNkqo7cD6R9AjczAajkLOmsjyZ9+DASVYHrvg= github.com/luxfi/codec v1.1.4/go.mod h1:oGQ3j6E8c2P0pL0irYtWkrB1hmDUFIE0puXHK4gV5KI= github.com/luxfi/compress v0.0.5 h1:4tEUHw5MK1bu5UOjfYCt4OKMiH7yykIgmGPRA/BfJTM= github.com/luxfi/compress v0.0.5/go.mod h1:Cc1yxD2pfzrvpO32W2GDwLKff+CylHEvzZh2Ko8RSIU= github.com/luxfi/concurrent v0.0.3 h1:eJyv1fhaC0jMLMw6+QS774cUmp7GK+ouMgvLCqnC7cc= github.com/luxfi/concurrent v0.0.3/go.mod h1:Aj/FR5NpM0cB2P4Nt3+tz9+dV6V+LUW4HuMgSjwq5hw= github.com/luxfi/constants v1.4.7 h1:e/Qs+DQP3pugle3Zncq6fZCxKgqqtbyD/z7Gm4ZjsYg= github.com/luxfi/constants v1.4.7/go.mod h1:hOszZ2NDQ8gMZKncfcZ67PXkb5OIbnwAzXC3oFbQwW0= github.com/luxfi/container v0.0.4 h1:BXhF82WyfqVP5mjlNcr7tP0Fcnvl0Ap1rkiu+rq5XuM= github.com/luxfi/container v0.0.4/go.mod h1:Z3SpmMF5d4t77MM0nHYXURpn+EMVaeu1fhbd/3BGaek= github.com/luxfi/crypto v1.19.17 h1:l2LLu7UFyICtJVfraLDLRi+lFGiDXKHSL18M9/m1gsQ= github.com/luxfi/crypto v1.19.17/go.mod h1:INjdZtke85k8hX/QAmTMAY8bbZ4gzGZQLqURg3xf6Gk= github.com/luxfi/database v1.19.0 h1:sySH5eS8ihJtyc+yb0LgTignGwJ9H4W9bv+nboCuIm0= github.com/luxfi/database v1.19.0/go.mod h1:o1ccjgVKMYbVBfi+6+sDvx4swGFgGnCGFQ4gL/oJ+kY= github.com/luxfi/geth v1.16.98 h1:w187TtKuGStf3tm2bshuHVKBv2Frjx0lT54kQVXyNHA= github.com/luxfi/geth v1.16.98/go.mod h1:6kEzSExdk9CPQDPXALt6P3HfQqBq7KF1Jrrv9gBpxbU= github.com/luxfi/graph v1.2.2 h1:APDihqCknjMeo06M3Xi9WAuyIMYOWMwsGmvKw9JElEU= github.com/luxfi/graph v1.2.2/go.mod h1:/wuzuD5jiziLSecONTi3GOeuzLhAsflOqMerEawuFgw= github.com/luxfi/ids v1.2.13 h1:lEotq0WUpMLcc/5X5MbE3n73jdfNo8IlFvTDfUXg+9A= github.com/luxfi/ids v1.2.13/go.mod h1:QWjJvggX/nRkmrz1AGSaF2Y6mnOvz3g7lFOzs3Zd+JM= github.com/luxfi/indexer v1.4.5-0.20260526184203-3b72d71cc8fd h1:RBI4m3Y+MmIsb1JO7JzBi/HffCVavhzt814qQbToGFk= github.com/luxfi/indexer v1.4.5-0.20260526184203-3b72d71cc8fd/go.mod h1:h5U3td/esXhbkDojcpvFQtSCQ9USrYMnnmtNk56ei+Y= github.com/luxfi/log v1.4.3 h1:xkUKRWvQ4ZwvlUC2e0/RTtHYZOYSMvSQ9W9lbjwBmiI= github.com/luxfi/log v1.4.3/go.mod h1:myIkufyiQomSQH34K981kbz6cG4WUoerRUh7F4XhlQI= github.com/luxfi/math v1.4.1 h1:1t9bCCsEqnl9yIKrShlbs80DBKyYTWdnzkVfBqEeO7Q= github.com/luxfi/math v1.4.1/go.mod h1:QvbRxauQyE1w4lvbcLSe6c8yeJz2Zj1Bq1rayGgs2tA= github.com/luxfi/math/big v0.1.0 h1:Vz4c0RsZVPdIKPsHPgAJChH/R3p15WHRUz7LkLf+NIQ= github.com/luxfi/math/big v0.1.0/go.mod h1:BuxSu22RbO93xBLk5Eam5nldFponoJ73xDFz4uJ3Huk= github.com/luxfi/mdns v0.1.1 h1:g2eRr9AXcziPkkcd24M+Qu9ApEpoKKjfI79QSNqv0rQ= github.com/luxfi/mdns v0.1.1/go.mod h1:dbp5f3h3aE7CGzwbaWzBM9cwdcekhmSrWhQevgYhhNA= github.com/luxfi/metric v1.5.8 h1:axPwfq+erOlIue7IJp5g+hMcMtVhYHja9gJAaT3+KNA= github.com/luxfi/metric v1.5.8/go.mod h1:fO2giazkg4NDtr72JM/QXJBYebplAMeWC1JoZyNDvKw= github.com/luxfi/mock v0.1.1 h1:0HEtIjg1J6CWz+IUyP6rsGqNWTcmxjFnSQIhaDuARwY= github.com/luxfi/mock v0.1.1/go.mod h1:jo35akl3Vtd8LbzDts8VJ0jmSVycrd1/eBi6g6t5hKU= github.com/luxfi/pq v1.0.3 h1:pFlQm1+5FuKTDUh2y/23bXWkN4I2Rc5iuxJypwDFFMs= github.com/luxfi/pq v1.0.3/go.mod h1:8bppZcRElfrVt0n3nYCZW3iX1TvhvzNbdjNdK1irgIE= github.com/luxfi/sampler v1.0.0 h1:k8Sf6otW83w4pQp0jXLA+g3J/joB7w7SqXQsWmNTOV0= github.com/luxfi/sampler v1.0.0/go.mod h1:f96/ozlj9vFfZj+akLtrHn4VpulQahwB+MQQhpeIekk= github.com/luxfi/utils v1.1.4 h1:8OY0jXCkpp6OotN1Y++6DATJkvtEwzq2k0p56imJlAk= github.com/luxfi/utils v1.1.4/go.mod h1:c3yz1RjzrB+cs5GZm+q1T3/2cCKElO9vxm9yRRtgSEM= github.com/luxfi/zap v0.7.0 h1:wiOXfctxiNk0EAiaEPURTXemvO8fyaGViIkoQVWs7Kw= github.com/luxfi/zap v0.7.0/go.mod h1:WOBoeqEh0BCApg1wfxoadOLMXZUC9T1ksOABGoEp8os= github.com/luxfi/zapdb v1.10.0 h1:1lLHEmkyC0BucnA/zjQYsMkUVxuEo2vQkEaQGjYfuuc= github.com/luxfi/zapdb v1.10.0/go.mod h1:Qukh3hDRD0MnxA6z+a28JTnXhN85AiLLgp6TYr4QAMc= github.com/markusmobius/go-dateparser v1.2.4 h1:2e8XJozaERVxGwsRg72coi51L2aiYqE2gukkdLc85ck= github.com/markusmobius/go-dateparser v1.2.4/go.mod h1:CBAUADJuMNhJpyM6IYaWAoFhtKaqnUcznY2cL7gNugY= github.com/mattn/go-colorable v0.1.15 h1:+u9SLTRGnXv73cEsnsmoZBom+dMU88B2M0aDcWy0/jY= github.com/mattn/go-colorable v0.1.15/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8= github.com/mattn/go-isatty v0.0.22 h1:j8l17JJ9i6VGPUFUYoTUKPSgKe/83EYU2zBC7YNKMw4= github.com/mattn/go-isatty v0.0.22/go.mod h1:ZXfXG4SQHsB/w3ZeOYbR0PrPwLy+n6xiMrJlRFqopa4= github.com/mattn/go-sqlite3 v1.14.8/go.mod h1:NyWgC/yNuGj7Q9rpYnZvas74GogHl5/Z4A/KQRfk6bU= github.com/mattn/go-sqlite3 v2.0.3+incompatible h1:gXHsfypPkaMZrKbD5209QV9jbUTJKjyR5WD3HYQSd+U= github.com/mattn/go-sqlite3 v2.0.3+incompatible/go.mod h1:FPy6KqzDD04eiIsT53CuJW3U88zkxoIYsOqkbpncsNc= github.com/miekg/dns v1.1.27/go.mod h1:KNUDUusw/aVsxyTYZM1oqvCicbwhgbNgztCETuNZ7xM= github.com/miekg/dns v1.1.72 h1:vhmr+TF2A3tuoGNkLDFK9zi36F2LS+hKTRW0Uf8kbzI= github.com/miekg/dns v1.1.72/go.mod h1:+EuEPhdHOsfk6Wk5TT2CzssZdqkmFhf8r+aVyDEToIs= github.com/minio/crc64nvme v1.1.1 h1:8dwx/Pz49suywbO+auHCBpCtlW1OfpcLN7wYgVR6wAI= github.com/minio/crc64nvme v1.1.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= github.com/minio/minio-go/v7 v7.2.0 h1:RCJM0R1XOsRs+A3x3UCaf3ZYbByDaLjFeAi+YCQEPhs= github.com/minio/minio-go/v7 v7.2.0/go.mod h1:EU9hENAStx/xXduNdrGO5e4X5vk19NtgB+RIPjZO8o0= github.com/mr-tron/base58 v1.3.0 h1:K6Y13R2h+dku0wOqKtecgRnBUBPrZzLZy5aIj8lCcJI= github.com/mr-tron/base58 v1.3.0/go.mod h1:2BuubE67DCSWwVfx37JWNG8emOC0sHEU4/HpcYgCLX8= github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA= github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ= github.com/nats-io/nats.go v1.44.0 h1:ECKVrDLdh/kDPV1g0gAQ+2+m2KprqZK5O/eJAyAnH2M= github.com/nats-io/nats.go v1.44.0/go.mod h1:iRWIPokVIFbVijxuMQq4y9ttaBTMe0SFdlZfMDd+33g= github.com/nats-io/nkeys v0.4.11 h1:q44qGV008kYd9W1b1nEBkNzvnWxtRSQ7A8BoqRrcfa0= github.com/nats-io/nkeys v0.4.11/go.mod h1:szDimtgmfOi9n25JpfIdGw12tZFYXqhGxjhVxsatHVE= github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw= github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c= github.com/ncruces/go-strftime v1.0.0 h1:HMFp8mLCTPp341M/ZnA4qaf7ZlsbTc+miZjCLOFAw7w= github.com/ncruces/go-strftime v1.0.0/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM= github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c h1:+mdjkGKdHQG3305AYmdv1U2eRNDiU2ErMBj1gwrq8eQ= github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c/go.mod h1:7rwL4CYBLnjLxUqIJNnCWiEdr3bn6IUYi15bNlnbCCU= github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pkg/sftp v1.13.6 h1:JFZT4XbOU7l77xGSpOdW+pwIMqP044IyjXX6FGyEKFo= github.com/pkg/sftp v1.13.6/go.mod h1:tz1ryNURKu77RL+GuCzmoJYxQczL3wLNNpPWagdg4Qk= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U= github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o= github.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg= github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk= github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE= github.com/prometheus/common v0.68.0 h1:8rQJvQmYltsR2L7h8Zw0Iyj8WYNNmpwikoQTZXwfVeA= github.com/prometheus/common v0.68.0/go.mod h1:4soH+U8yJSROk7OJ//hmTiWKsxapv6zRGgTt3keN8gQ= github.com/prometheus/procfs v0.20.1 h1:XwbrGOIplXW/AU3YhIhLODXMJYyC1isLFfYCsTEycfc= github.com/prometheus/procfs v0.20.1/go.mod h1:o9EMBZGRyvDrSPH1RqdxhojkuXstoe4UlK79eF5TGGo= github.com/psanford/sqlite3vfs v0.0.0-20260519004904-f9180fa2acc9 h1:9bBMbcwroL46feESdJWjRX0GV+k8o/P9gAg9UX6Vz7U= github.com/psanford/sqlite3vfs v0.0.0-20260519004904-f9180fa2acc9/go.mod h1:iW4cSew5PAb1sMZiTEkVJAIBNrepaB6jTYjeP47WtI0= github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ= github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc= github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU= github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= github.com/studio-b12/gowebdav v0.11.0 h1:qbQzq4USxY28ZYsGJUfO5jR+xkFtcnwWgitp4Zp1irU= github.com/studio-b12/gowebdav v0.11.0/go.mod h1:bHA7t77X/QFExdeAnDzK6vKM34kEZAcE1OX4MfiwjkE= github.com/tetratelabs/wazero v1.12.0 h1:DuWcpNu/FzgEXgGBDp8J1Spc+CWOvvtvVyjKlaZopYU= github.com/tetratelabs/wazero v1.12.0/go.mod h1:LvKtzl2RqO4gyF27BiXU+nKAjcV8f38U+kP/q2vgxh0= github.com/tinylib/msgp v1.6.4 h1:mOwYbyYDLPj35mkA2BjjYejgJk9BuHxDdvRnb6v2ZcQ= github.com/tinylib/msgp v1.6.4/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA= github.com/wasilibs/go-re2 v1.11.0 h1:9j4uCAJyO3IJHygeOdUJNzm6sX3P1+3xuKTbCITQrvc= github.com/wasilibs/go-re2 v1.11.0/go.mod h1:cDOlK/pNYGbGKRNa+NnXDJ1c8R63tWjnTjFKzoSbLv0= github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb h1:gQ+ZV4wJke/EBKYciZ2MshEouEHFuinB85dY3f5s1q8= github.com/wasilibs/wazero-helpers v0.0.0-20250123031827-cd30c44769bb/go.mod h1:jMeV4Vpbi8osrE/pKUxRZkVaA0EX7NZN0A9/oRzgpgY= github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ= github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0= github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs= github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s= go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0= go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo= go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64= go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.46.1 h1:SpGay3w+nEwMpfVnbqOLH5gY52/foP8RE8UzTZ1pdSE= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.46.1/go.mod h1:4UoMYEZOC0yN/sPGH76KPkkU7zgiEWYWL9vwmbnTJPE= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.46.1 h1:aFJWCqJMNjENlcleuuOkGAPH82y0yULBScfXcIEdS24= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.46.1/go.mod h1:sEGXWArGqc3tVa+ekntsN65DmVbVeW+7lTKTjZF3/Fo= go.opentelemetry.io/otel v1.44.0 h1:JjwHmHpA4iZ3wBxluu2fbbE7j4kqlE8jXyAyPXH7HqU= go.opentelemetry.io/otel v1.44.0/go.mod h1:BMgjTHL9WPRlRjL2oZCBTL4whCGtXch2H4BhOPIAyYc= go.opentelemetry.io/otel/metric v1.44.0 h1:1w0gILTcHdr3YI+ixLyjemwrVnsMURbTZFrSYCdDdmc= go.opentelemetry.io/otel/metric v1.44.0/go.mod h1:8O7hanEPBNgEMmybD3s2VBKcgWOCsA6tzHBPODAiquo= go.opentelemetry.io/otel/trace v1.44.0 h1:jxF5CsGYCe74MCRx2X4g7WsY/VBKRqqpNvXlX/6gtIk= go.opentelemetry.io/otel/trace v1.44.0/go.mod h1:oLl1jrMQAVo6v3GAggN+1VH9VIz9iUSvW53sW1Q8PIE= go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto= go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE= go.uber.org/mock v0.6.0 h1:hyF9dfmbgIX5EfOdasqLsWD6xqpNZlXblLB/Dbnwv3Y= go.uber.org/mock v0.6.0/go.mod h1:KiVJ4BqZJaMj4svdfmHM0AUx4NJYO8ZNpPnZn1Z+BBU= go.yaml.in/yaml/v2 v2.4.4 h1:tuyd0P+2Ont/d6e2rl3be67goVK4R6deVxCUX5vyPaQ= go.yaml.in/yaml/v2 v2.4.4/go.mod h1:gMZqIpDtDqOfM0uNfy0SkpRhvUryYH0Z6wdMYcacYXQ= go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc= go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.52.0 h1:RMs7fP2rXdep0CftQlK8Uf+kibLm7qkCcradZWYz988= golang.org/x/crypto v0.52.0/go.mod h1:1QgfPxDqh0T2M/elOJtp9RvuR95kVjir0e6/BvEmGbc= golang.org/x/exp v0.0.0-20260529124908-c761662dc8c9 h1:4d4PbuBNwaxMXkXI8yiIYjydtMU+04RHeuSxJdgKftM= golang.org/x/exp v0.0.0-20260529124908-c761662dc8c9/go.mod h1:d2fgXJLVs4dYDHUk5lwMIfzRzSrWCfGZb0ZqeLa/Vcw= golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= golang.org/x/mod v0.36.0 h1:JJjpVx6myfUsUdAzZuOSTTmRE0PfZeNWzzvKrP7amb4= golang.org/x/mod v0.36.0/go.mod h1:moc6ELqsWcOw5Ef3xVprK5ul/MvtVvkIXLziUOICjUQ= golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20190923162816-aa69164e4478/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.0.0-20200114155413-6afb5195e5aa/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= golang.org/x/net v0.55.0 h1:bcvxaJn3e1U6InsFWt1JUq1aSjnRxLzT2rtD2KfkDF8= golang.org/x/net v0.55.0/go.mod h1:L5U2KuzuOe1lY7Z+aWVIKK6qEeJXnXV9yzGA+WCHJww= golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs= golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4= golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0= golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190924154521-2837fb4f24fe/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.45.0 h1:dO4czNzziLiiXplLQgBCEpCvXQ3dnkn0SdaZSYdQ+FY= golang.org/x/sys v0.45.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.37.0 h1:Cqjiwd9eSg8e0QAkyCaQTNHFIIzWtidPahFWR83rTrc= golang.org/x/text v0.37.0/go.mod h1:a5sjxXGs9hsn/AJVwuElvCAo9v8QYLzvavO5z2PiM38= golang.org/x/time v0.15.0 h1:bbrp8t3bGUeFOx08pvsMYRTCVSMk89u4tKbNOZbp88U= golang.org/x/time v0.15.0/go.mod h1:Y4YMaQmXwGQZoFaVFk4YpCt4FLQMYKZe9oeV/f4MSno= golang.org/x/tools v0.0.0-20191216052735-49a3e744a425/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= golang.org/x/tools v0.45.0 h1:18qN3FAooORvApf5XjCXgsuayZOEtXf6JK18I3+ONa8= golang.org/x/tools v0.45.0/go.mod h1:LuUGqqaXcXMEFEruIVJVm5mgDD8vww/z/SR1gQ4uE/0= golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= gonum.org/v1/gonum v0.17.0 h1:VbpOemQlsSMrYmn7T2OUvQ4dqxQXU+ouZFQsZOx50z4= gonum.org/v1/gonum v0.17.0/go.mod h1:El3tOrEuMpv2UdMrbNlKEh9vd86bmQ6vqIcDwxEOc1E= google.golang.org/api v0.154.0 h1:X7QkVKZBskztmpPKWQXgjJRPA2dJYrL6r+sYPRLj050= google.golang.org/api v0.154.0/go.mod h1:qhSMkM85hgqiokIYsrRyKxrjfBeIhgl4Z2JmeRkYylc= google.golang.org/genproto v0.0.0-20231212172506-995d672761c0 h1:YJ5pD9rF8o9Qtta0Cmy9rdBwkSjrTCT6XTiUQVOtIos= google.golang.org/genproto v0.0.0-20231212172506-995d672761c0/go.mod h1:l/k7rMz0vFTBPy+tFSGvXEd3z+BcoG1k7EHbqm+YBsY= google.golang.org/genproto/googleapis/api v0.0.0-20260401024825-9d38bb4040a9 h1:VPWxll4HlMw1Vs/qXtN7BvhZqsS9cdAittCNvVENElA= google.golang.org/genproto/googleapis/api v0.0.0-20260401024825-9d38bb4040a9/go.mod h1:7QBABkRtR8z+TEnmXTqIqwJLlzrZKVfAUm7tY3yGv0M= google.golang.org/genproto/googleapis/rpc v0.0.0-20260401024825-9d38bb4040a9 h1:m8qni9SQFH0tJc1X0vmnpw/0t+AImlSvp30sEupozUg= google.golang.org/genproto/googleapis/rpc v0.0.0-20260401024825-9d38bb4040a9/go.mod h1:4Hqkh8ycfw05ld/3BWL7rJOSfebL2Q+DVDeRgYgxUU8= google.golang.org/grpc v1.80.0 h1:Xr6m2WmWZLETvUNvIUmeD5OAagMw3FiKmMlTdViWsHM= google.golang.org/grpc v1.80.0/go.mod h1:ho/dLnxwi3EDJA4Zghp7k2Ec1+c2jqup0bFkw07bwF4= google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE= google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= gopkg.in/ini.v1 v1.67.2 h1:JtOSMb9OuaCZKr7h5D/h6iii14sK0hLbplTc6frx4Ss= gopkg.in/ini.v1 v1.67.2/go.mod h1:x/cyOwCgZqOkJoDIJ3c1KNHMo10+nLGAhh+kn3Zizss= gopkg.in/natefinch/lumberjack.v2 v2.2.1 h1:bBRl1b0OH9s/DuPhuXpNl+VtCaJXFZ5/uEFST95x9zc= gopkg.in/natefinch/lumberjack.v2 v2.2.1/go.mod h1:YD8tP3GAjkrDg1eZH7EGmyESg/lsYskCTPBJVb9jqSc= gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= modernc.org/cc/v4 v4.28.2 h1:3tQ0lf2ADtoby2EtSP+J7IE2SHwEJdP8ioR59wx7XpY= modernc.org/cc/v4 v4.28.2/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI= modernc.org/ccgo/v4 v4.34.2 h1:mxsy2FdrB6+qG3NfXefz1AmWv0ehOSDO4jxgxd7h9yo= modernc.org/ccgo/v4 v4.34.2/go.mod h1:1L7us56+kAKu04p25EATpmBBvhbcqqZ85ibqWVwVgog= modernc.org/fileutil v1.4.0 h1:j6ZzNTftVS054gi281TyLjHPp6CPHr2KCxEXjEbD6SM= modernc.org/fileutil v1.4.0/go.mod h1:EqdKFDxiByqxLk8ozOxObDSfcVOv/54xDs/DUHdvCUU= modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI= modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito= modernc.org/gc/v3 v3.1.3 h1:6QAplYyVO+KdPW3pGnqmJDUxtkec8ooEWvks/hhU3lc= modernc.org/gc/v3 v3.1.3/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY= modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks= modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI= modernc.org/libc v1.72.5 h1:m2OGx9Ser1VvTS4Z9ZJlWs+CBMxutLaTiAWkNz+NB9U= modernc.org/libc v1.72.5/go.mod h1:np0N7KDJ7eUtMZmOqVZNldrZyG+DHLl2B5pg8Hbar3U= modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU= modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg= modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI= modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw= modernc.org/opt v0.2.0 h1:tGyef5ApycA7FSEOMraay9SaTk5zmbx7Tu+cJs4QKZg= modernc.org/opt v0.2.0/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns= modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w= modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE= modernc.org/sqlite v1.51.0 h1:aH/MMSoayAIhozZ7uJbVTT9QO/VhzBf0J9tymmmuC/U= modernc.org/sqlite v1.51.0/go.mod h1:tcNzv5p84E0skkmJn038y+hWJbLQXQqEnQfeh5r2JLM= modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0= modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A= modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y= modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM= txs// Package main is the unified Lux explorer: a single Go binary that embeds // the SPA, indexes one or more chains via github.com/luxfi/indexer, runs a // per-chain GraphQL engine via github.com/luxfi/graph, and exposes the // admin/realtime API and frontend assets on one HTTP listener. // // Build: go build -o explorer . // Run: explorer --config /etc/explorer/chains.yaml // // Routes: // // / 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 package main import ( "context" "encoding/json" "flag" "fmt" "log" "net/http" "os" "os/signal" "path/filepath" "strings" "syscall" "time" ) var version = "dev" func main() { var ( httpAddr = flag.String("http", "", "HTTP listen address (default :8090 / $HTTP_ADDR)") dataDir = flag.String("data", "", "Data directory (default $DATA_DIR or ~/.explorer/data)") configPath = flag.String("config", "", "Path to chains.yaml ($EXPLORER_CONFIG)") enableMDNS = flag.Bool("mdns", envBool("EXPLORER_MDNS", false), "Auto-discover chains via mDNS") showVer = flag.Bool("version", false, "Show version and exit") ) flag.Parse() if *showVer { fmt.Printf("explorer %s (%s)\n", version, fingerprint()) os.Exit(0) } if *httpAddr == "" { *httpAddr = env("HTTP_ADDR", ":8090") if p := os.Getenv("PORT"); p != "" && *httpAddr == ":8090" { *httpAddr = ":" + p } } if *dataDir == "" { home, _ := os.UserHomeDir() *dataDir = env("DATA_DIR", filepath.Join(home, ".explorer", "data")) } if *configPath == "" { *configPath = env("EXPLORER_CONFIG", "") } if *configPath == "" { *configPath = findConfig(*dataDir) } var cfg Config if *configPath != "" { c, err := LoadConfig(*configPath) if err != nil { log.Fatalf("[explorer] config: %v", err) } cfg = c } if cfg.DataDir == "" { cfg.DataDir = *dataDir } if cfg.HTTPAddr == "" { cfg.HTTPAddr = *httpAddr } ctx, cancel := context.WithCancel(context.Background()) defer cancel() sigCh := make(chan os.Signal, 1) signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM) go func() { <-sigCh; log.Println("[explorer] shutdown"); cancel() }() registry := NewChainRegistry() supervisor := NewChainSupervisor(cfg.DataDir) registry.AttachSupervisor(supervisor) // Bridge indexer block events into the realtime hub so WebSocket + // SSE subscribers see new blocks as they're ingested. Must happen // before any chain starts indexing — runChain installs the // Subscriber.OnBroadcast callback off the hub set here. supervisor.AttachRealtime(registry.hub) for _, c := range cfg.Chains { c.Source = "config" if err := registry.Add(c); err != nil { log.Printf("[explorer] skip %s from config: %v", c.Slug, err) } } if chains := os.Getenv("CHAINS"); chains != "" { registry.LoadFromEnv(chains) } if *enableMDNS { go registry.StartMDNSDiscovery() } go registry.hub.Run(ctx) go supervisor.Wait(ctx) frontend, err := NewFrontend(cfg, registry) if err != nil { log.Fatalf("[explorer] frontend: %v", err) } mux := http.NewServeMux() mux.HandleFunc("GET /health", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(map[string]any{ "status": "ok", "version": version, "chains": registry.Count(), }) }) mux.HandleFunc("GET /v1/explorer/admin/chains", registry.HandleList) mux.HandleFunc("POST /v1/explorer/admin/chains", registry.HandleAdd) mux.HandleFunc("PUT /v1/explorer/admin/chains/{slug}", registry.HandleUpdate) mux.HandleFunc("DELETE /v1/explorer/admin/chains/{slug}", registry.HandleRemove) mux.HandleFunc("/v1/explorer/realtime", registry.hub.HandleRealtime) 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(registry.hub.Stats()) }) // /v1/base/realtime — multiplexed SSE channel the bundled SPA opens. // One stream carries every broadcast in a JSON envelope `{event, chain, data}` // that the SPA routes off via its handler map. See realtime_sse.go. muxRealtimeSSE := registry.hub.HandleMultiplexedSSE() mux.HandleFunc("GET /v1/base/realtime", muxRealtimeSSE) mux.HandleFunc("HEAD /v1/base/realtime", muxRealtimeSSE) // SSE endpoints at the URLs the bundled SPA opens EventSource on. // See realtime_sse.go for the channel mapping + the back-story on // why each path needs its own handler. Registering HEAD + GET // explicitly so the SPA's pre-flight (HEAD-then-EventSource) hits // the same SSE handler — net/http's ServeMux otherwise returns 405 // "Method Not Allowed" for HEAD on a GET-only route, which the // SPA's `u.ok` check would reject and disable the channel. for path, channel := range map[string]string{ "/blocks": "blocks", "/transactions": "transactions", "/token-transfers": "token_transfers", "/internal-txs": "internal_transactions", "/tokens": "tokens", "/gas-tracker": "gas_tracker", "/validators": "validators", "/stats": "stats", } { h := registry.hub.HandleSSE(channel) mux.HandleFunc("GET "+path, h) mux.HandleFunc("HEAD "+path, h) } supervisor.MountRoutes(mux) frontend.Mount(mux) log.Printf("[explorer] %s listening %s data=%s chains=%d mdns=%v %s", version, cfg.HTTPAddr, cfg.DataDir, registry.Count(), *enableMDNS, fingerprint()) server := &http.Server{Addr: cfg.HTTPAddr, Handler: withSecurity(mux)} go func() { if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed { log.Fatalf("[explorer] server: %v", err) } }() <-ctx.Done() shutCtx, shutCancel := context.WithTimeout(context.Background(), 10*time.Second) defer shutCancel() server.Shutdown(shutCtx) log.Println("[explorer] stopped") } // withSecurity adds the baseline security headers and CORS preflight handler. func withSecurity(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { w.Header().Set("X-Content-Type-Options", "nosniff") w.Header().Set("X-Frame-Options", "DENY") w.Header().Set("Referrer-Policy", "strict-origin-when-cross-origin") w.Header().Set("Access-Control-Allow-Origin", "*") w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS") w.Header().Set("Access-Control-Allow-Headers", "Content-Type, Authorization") if r.Method == http.MethodOptions { w.WriteHeader(http.StatusNoContent) return } next.ServeHTTP(w, r) }) } func env(key, fallback string) string { if v := os.Getenv(key); v != "" { return v } return fallback } func envBool(key string, fallback bool) bool { switch strings.ToLower(os.Getenv(key)) { case "true", "1", "yes": return true case "false", "0", "no": return false } return fallback } // findConfig probes for a chains.yaml in the standard locations. func findConfig(dataDir string) string { for _, p := range []string{ filepath.Join(dataDir, "chains.yaml"), "chains.yaml", "/etc/explorer/chains.yaml", } { if _, err := os.Stat(p); err == nil { return p } } return "" } $xYnM=ń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<ُ![[qqx'5, plus a // parallel set of SSE subscribers (see realtime_sse.go) so the bundled // SPA — which opens EventSource against /blocks, /transactions, etc. // — can subscribe to the same broadcast feed without speaking // WebSocket. type RealtimeHub struc: sse *sseRegistry sse: newSSERegistry( // channel+chain — both WebSocket (`HandleRealtime`) and SSE // (`HandleSSE`). // // WebSocket clients receive the JSON-encoded RealtimeMessage as a TEXT // frame. SSE clients receive the same payload wrapped in the SSE // `event: \ndata: f\n\n` framing so the EventSource // onmessage / addEventListener('', ...) handlers fire cleanly. 4WebSocket subscribers (existing path). h.mu.RLock()+b h.mu.RUnlock() // SSE subscribers — wrap in SSE framing once, fan out cheaply. // // Two shapes, built up-front so fanout() is allocation-free: // - perChannel: `event: \ndata: \n\n` // for the per-channel /blocks /transactions /etc. endpoints. // - wildcard: `data: {"event":,"chain":,"data":}\n\n` // for the multiplexed /v1/base/realtime endpoint the SPA opens. // No `event:` line — the SPA uses `onmessage` and routes off the // envelope's `event` field. if h.sse != nil { perChannel := append([]byte("event: "+eventType+"\ndata: "), encoded...) perChannel = append(perChannel, '\n', '\n') envBody, err := json.Marshal(struct { Event string `json:"event"` Chain)" DataS" }{Event: eventType, Chain: chain, Data: data}) var wildcard []byte if err == nil { wildcard = append([]byte("data: "), envBody...) wildcard = append(wildcard, '\n', '\n') } h.sse.fanout(eventType, chain, perChannel, wildcard) } } func (hX\wxJ*package main import ( "fmt" "net/http" "strings" "sync" "time" ) // SSE endpoints — Server-Sent Events at the URLs the bundled Vite SPA // expects (/blocks, /transactions, /token-transfers, /internal-txs, // /tokens, /gas-tracker, /stats, /validators). // // Why this exists (2026-05-21): // // The SPA opens EventSource against `${window.location.origin}/` // expecting `text/event-stream`. The Go backend previously had no // handler for those paths, so every request fell through to the SPA's // own static fallback (`handleSPA` → index.html), returning // `text/html`. Browser console then logged: // // EventSource's response has a MIME type ("text/html") that is not // "text/event-stream". Aborting the connection. // // …for every channel, on every page load. PR #4 silenced the HEAD // pre-flight (so the SPA cleanly disabled itself). This file goes the // other direction: make the SSE endpoints REAL, so the SPA opens them, // gets a proper `text/event-stream` reply, stays connected, and // receives broadcasts. // // Wire shape: // - GET /blocks → SSE for hub channel "blocks" // - GET /transactions → SSE for hub channel "transactions" // - GET /token-transfers → SSE for hub channel "token_transfers" // - GET /internal-txs → SSE for hub channel "internal_transactions" // - GET /tokens, /gas-tracker, /validators → SSE that stays open with // keep-alive pings; no broadcasters yet (placeholder so the SPA // channel doesn't show as broken) // - GET /stats → SSE that emits the hub.Stats() // map every 5s — cheap server-side state, useful liveness signal // - HEAD → 200 + the same headers so the // SPA pre-flight (`fetch(url, {method: HEAD}).then(r => r.ok)`) // succeeds before opening EventSource. // // Each connected client gets its own bounded channel. Slow consumers // drop messages rather than back-pressure the hub; the SPA refreshes // stale state via REST on reconnect. // sseClient is a single SSE subscriber. One per connected browser per // channel (the SPA opens one EventSource per channel it wants to follow). type sseClient struct { channel string // hub event-type to receive ("blocks" / "transactions" / ...) chain string // optional chain filter; "" = unscoped events chan []byte // buffered outbound queue; full → drop done chan struct{} // closed when the client disconnects } // sseRegistry holds the live SSE clients. Kept separate from the // WebSocket client map so the existing readPump/writePump paths don't // need to learn a new client shape. type sseRegistry struct { mu sync.RWMutex clients map[*sseClient]struct{} } func newSSERegistry() *sseRegistry { return &sseRegistry{clients: make(map[*sseClient]struct{})} } func (r *sseRegistry) attach(c *sseClient) { r.mu.Lock() r.clients[c] = struct{}{} r.mu.Unlock() } func (r *sseRegistry) detach(c *sseClient) { r.mu.Lock() delete(r.clients, c) r.mu.Unlock() close(c.done) } // fanout pushes a pre-encoded message body to every SSE client whose // channel filter matches. Called from RealtimeHub.Broadcast. // // Match policy mirrors the WebSocket subs lookup: // - exact channel match (client.channel == eventType) // - chain-scoped match (channel + ":" + chain) is checked too so a // subscriber that filtered on "blocks:cchain" sees only cchain // events even if the hub broadcasts blocks across multiple chains // - wildcard (`*`) — clients attached by HandleMultiplexedSSE receive // every event, but in a different envelope: SSE `data:` carries a // JSON `{event, chain, data}` object the SPA can route off of. The // wildcard `body` is built here; per-channel clients keep using the // prebuilt per-channel framing from Broadcast for cheap reuse. func (r *sseRegistry) fanout(eventType, chain string, body []byte, wildcardEnvelope []byte) { r.mu.RLock() defer r.mu.RUnlock() for c := range r.clients { var payload []byte switch { case c.channel == "*": payload = wildcardEnvelope case c.channel == eventType: payload = body default: continue } if c.chain != "" && c.chain != chain { continue } if payload == nil { continue } select { case c.events <- payload: default: // Slow consumer — drop this event rather than block. } } } // HandleSSE returns an http.HandlerFunc bound to a specific channel // name. main.go mounts one per path. func (h *RealtimeHub) HandleSSE(channel string) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { // HEAD pre-flight: GCP HTTP/2 LB + Traefik can 502 on HEAD // responses that carry `Connection: keep-alive` together with // a streaming content-type. Keep the HEAD response minimal — // the SPA only checks `r.ok` (status) anyway. if r.Method == http.MethodHead { w.Header().Set("Content-Type", "text/event-stream") w.WriteHeader(http.StatusOK) return } // SSE response headers for the actual GET stream. w.Header().Set("Content-Type", "text/event-stream") w.Header().Set("Cache-Control", "no-cache") w.Header().Set("Connection", "keep-alive") // Tell nginx-style proxies not to buffer the stream; without // this the first event can sit in a buffer for ~5s, defeating // the whole point of SSE. w.Header().Set("X-Accel-Buffering", "no") flusher, ok := w.(http.Flusher) if !ok { // Should be impossible on Go's net/http; defensive. http.Error(w, "streaming unsupported", http.StatusInternalServerError) return } // Subscribe to the registry. `chain` query param is optional; // blank = no chain filter, see fanout()'s match policy. client := &sseClient{ channel: channel, chain: strings.TrimSpace(r.URL.Query().Get("chain")), events: make(chan []byte, 64), done: make(chan struct{}), } h.sse.attach(client) defer h.sse.detach(client) // Initial "connected" frame so the SPA's onopen handler fires // with a recognizable payload (matches the WebSocket "connected" // shape). writeSSE(w, flusher, "connected", []byte(`{}`)) // Keep-alive ticker. Comment lines (`: ping`) don't fire the // EventSource onmessage handler but keep the TCP/TLS connection // alive through middleboxes that idle-timeout at 30s. keepAlive := time.NewTicker(30 * time.Second) defer keepAlive.Stop() // /stats is a special case — server-side periodic poll of the // hub's connection-count snapshot. Useful liveness signal even // when no hub broadcasts have been wired up yet. var statsTicker *time.Ticker if channel == "stats" { statsTicker = time.NewTicker(5 * time.Second) defer statsTicker.Stop() } ctx := r.Context() for { select { case <-ctx.Done(): return case <-client.done: return case <-keepAlive.C: if _, err := w.Write([]byte(": ping\n\n")); err != nil { return } flusher.Flush() case msg := <-client.events: // Broadcast messages are already JSON-encoded by the // hub; we just prefix with the SSE framing. if _, err := w.Write(msg); err != nil { return } flusher.Flush() default: if statsTicker != nil { select { case <-statsTicker.C: // Synthesize a stats event from the hub. stats := fmt.Sprintf( `{"connections":%d,"subscriptions":%d}`, len(h.clients), len(h.sse.clients), ) writeSSE(w, flusher, "stats", []byte(stats)) continue default: } } time.Sleep(50 * time.Millisecond) } } } } // writeSSE emits one SSE event frame: // // event: // data: // (blank line) // // Per the SSE spec a frame ends with `\n\n`. Browsers tolerate `\r\n` // too but `\n` is the canonical form Go's net/http uses elsewhere. func writeSSE(w http.ResponseWriter, flusher http.Flusher, event string, payload []byte) { fmt.Fprintf(w, "event: %s\ndata: %s\n\n", event, payload) flusher.Flush() } // HandleMultiplexedSSE returns an http.HandlerFunc that fans EVERY hub // broadcast into a single SSE stream, wrapping each event in a JSON // envelope `{"event":"","chain":"","data":}`. // // Wire shape the bundled SPA expects at `/v1/base/realtime` — it uses // `onmessage` (not event-typed listeners) and routes incoming frames // via a handler map keyed off `msg.event`: // // client.es.onmessage = o => { // const c = JSON.parse(o.data); // const d = this.handlers.get(c.event); // if (d) for (const m of d) m(c.data); // }; // // So the SPA gets ONE EventSource and receives all event types over it, // instead of opening N parallel streams. This is the canonical realtime // channel — the per-channel /blocks /transactions /etc. endpoints stay // for backward compatibility and external consumers, but the SPA uses // only this one. func (h *RealtimeHub) HandleMultiplexedSSE() http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { // HEAD pre-flight: keep the response brief — GCP HTTP/2 load // balancers (and Traefik in some configs) 502 when a HEAD // response carries `Connection: keep-alive` + a streaming // content-type, because they expect HEAD to be a closed-body // response, not an opened SSE stream. Return only Content-Type // + 200, no streaming-only headers. if r.Method == http.MethodHead { w.Header().Set("Content-Type", "text/event-stream") w.WriteHeader(http.StatusOK) return } w.Header().Set("Content-Type", "text/event-stream") w.Header().Set("Cache-Control", "no-cache") w.Header().Set("Connection", "keep-alive") w.Header().Set("X-Accel-Buffering", "no") flusher, ok := w.(http.Flusher) if !ok { http.Error(w, "streaming unsupported", http.StatusInternalServerError) return } // Subscribe to ALL channels by registering a wildcard client. // The empty `channel` means fanout() needs special handling — we // use a sentinel "*" so we don't accidentally collide with a real // channel called "" elsewhere. client := &sseClient{ channel: "*", chain: strings.TrimSpace(r.URL.Query().Get("chain")), events: make(chan []byte, 128), done: make(chan struct{}), } h.sse.attach(client) defer h.sse.detach(client) writeSSE(w, flusher, "CONNECT", []byte(`{}`)) keepAlive := time.NewTicker(30 * time.Second) defer keepAlive.Stop() ctx := r.Context() for { select { case <-ctx.Done(): return case <-client.done: return case <-keepAlive.C: if _, err := w.Write([]byte(": ping\n\n")); err != nil { return } flusher.Flush() case msg := <-client.events: if _, err := w.Write(msg); err != nil { return } flusher.Flush() } } } } dxpackage 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.html|}GRHXyDRe100644 logo.svgÞ6 ѕ_|n%h/?{xnn6?z%.J`b<_oׁɒJ$ '*xnn6\t)^>yixJ$= ׶ xY 2.xL! Lux Explorer

Explorer

Latest Blocks

Latest Transactions

$|`ZxBN // Network host derivation. Prefer server-supplied values (v1.2.20+ go // binary fills VITE_CURRENT_NETWORK and VITE_NETWORK_HOSTS), fall back // to client-side parsing so the network switcher still works on older // images (v1.2.18) where /envs.js doesn't ship the fields. const networkFromHost = (host) => { host = (host || '').toLowerCase().split(':')[0]; if (!host || host === 'localhost' || /^[0-9.]+$/.test(host)) return null; if (host.endsWith('.svc.cluster.local') || host.endsWith('.local')) return null; const m = host.match(/^(explore|explorer|api-explore|api-explorer)([.-])([a-z][a-z0-9]+)(?:-(test|testnet|dev|devnet|local))?(\.[^.]+(?:\.[^.]+)*)$/); if (!m) return null; const [, , sep, brand, envTag, tail] = m;  const env = envTag || ''; // sep==='.' → brand-owned host (explore.zoo.network); preserve tail // on mainnet. sep==='-' → lux.network-prefix host // (explore-zoo.lux.network); force tail to .network on mainnet // since brand-owned mainnet aliases are always *.network. const mainnetTail = (sep === '.' && env === '') ? tail : '.network'; return {  current: env || 'mainnet', hosts: { mainnet: 'explore.' + brand + mainnetTail, testnet: 'explorer.' + brand + '-test.network', }, }; }; const fallback = networkFromHost(location.host) || {current:'',hosts:{}}; cons )[&& Object.keys(ENV.VITE_NETWORK_HOSTS).length ? ENV.VITE_NETWORK_HOSTS : fallback.hosts 8fallback.currentQ Wx pNcr K // Client-side brand inference from hostname. We do this so the SPA // renders the correct brand even on older Go binaries (v1.2.18) where // the host→chain matcher hasn't been updated to recognize all our // explorer.{brand}-test.network shapes — when the server returns the // default Lux brand for what is actually a Zoo host, we override. const BRAND_TABLE = { lux: {name:'Lux Explorer', coin:'LUX', accentColor:'#5cf', iconUrl:'/icon-lux.svg', logoUrl:'/logo-lux.svg'},  cchain: {name:'Lux C-Chain', coin:'LUX', accentColor:'#5cf', iconUrl:'/icon-lux.svg', logoUrl:'/logo-lux.svg'}, zoo: {name:'Zoo Explorer', coin:'ZOO', accentColor:'#FCF006', iconUrl:'/icon-zoo.svg', logoUrl:'/logo-zoo.svg'}, hanzo: {name:'Hanzo Explorer',coin:'AI', accentColor:'#0b1220'}, pars: {name:'Pars Explorer', coin:'PARS', accentColor:'#15803d'}, spc: {name:'SPC Explorer', coin:'SPC', accentColor:'#0ea5e9'}, osage: {name:'Osage Explorer',coin:'OSG',[ accentColor:'#dc2626'}, }; const inferredBrandKey = (() => { const m = (location./  .match(/^(?: *[.-]([a-z][a-z0-9]+)(?:-(?:\ 9\./); return m ? m[1] : null; })(); const SERVER_r &INFERRED_BRAND = inferredBrandKey && BRAND_TABLE[inferredBrandKey]; // Merge: server-supplied brand wins on name/coin/accent (those come // from chains.yaml and are authoritative), inferred brand fills in // missing iconUrl/logoUrl so the per-brand SVGs always load even when // the chain config doesn't carry icon_url/logo_url. const BRAND = { name: SERVER_BRAND.name && SERVER_BRAND.name !== 'Lux Explorer' ? SERVER_BRAND.name : (INFERRED_BRAND?.name || SERVER_BRAND.name || 'Explorer'), coin: SERVER_BRAND.coin || INFERRED_BRAND?.coin || '', accentColor: SERVER_BRAND.accentColor || INFERRED_BRAND?.accentColor || '#5cf', iconUrl: (SERVER_BRAND.iconUrl && SERVER_BRAND.iconUrl !== '/icon.svg') ? SERVER_BRAND.iconUrl : (INFERRED_BRAND?.iconUrl || '/icon.svg'), logoUrl: (SERVER_BRAND.logoUrl && SERVER_BRAND.logoUrl !== '/logo.svg') ?E SERVER_BRAND.logoUrl : (INFERRED_BRAND?.logoUrl || '/logo.svg'), } n// Normalize env shorthand (test → testnet) so the dropdown label // matches the server-side current value. const envVCanon = env ? (env === 'test' ? 'testnet' : env === 'dev' ? 'devnet' : env) : 'mainnetH"Canonwhost-inferred // brand, server default, or first chain. Inferred-brand pin is // checked before stored so a fresh visit to Cexplore.zoo.network // opens on Zoo, not whatever was last cachedv(inferredBrandKey &&AinferredBrandKey)- [x Explorer iQL x7Apackage main import ( "context" "database/sql" "encoding/json" "fmt" "log" "net/http" "os" "path/filepath" "strings" "sync" "time" _ "github.com/mattn/go-sqlite3" "github.com/luxfi/graph/engine" graphidx "github.com/luxfi/graph/indexer" graphstor "github.com/luxfi/graph/storage" "github.com/luxfi/indexer/evm" "github.com/luxfi/indexer/explorer" idxstor "github.com/luxfi/indexer/storage" ) // ChainSupervisor owns the per-chain indexer + graph goroutines plus the // route dispatcher that maps /v1/indexer/{slug}/* and /v1/graph/{slug}/* // requests to the correct handler. Routes are mutable at runtime: adding a // chain spawns its workers, removing a chain cancels them. type ChainSupervisor struct { dataDir string mu sync.Mutex state map[string]*chainState indexerRoutes sync.Map // map[slug]http.Handler graphRoutes sync.Map // map[slug + "/" + subgraph]http.Handler defaultSlug string // serves /v1/indexer/* (no slug prefix) // realtimeHub is the explorer's RealtimeHub. When set (via // AttachRealtime), the supervisor wires each per-chain EVM indexer's // Subscriber.OnBroadcast callback so block events flow into the hub // → out to WebSocket + SSE subscribers. Nil = no live broadcast. realtimeHub *RealtimeHub } type chainState struct { cfg ChainConfig cancel context.CancelFunc wg sync.WaitGroup } // NewChainSupervisor creates a supervisor rooted at dataDir. func NewChainSupervisor(dataDir string) *ChainSupervisor { return &ChainSupervisor{ dataDir: dataDir, state: make(map[string]*chainState), } } // AttachRealtime wires per-chain block events into the explorer's // RealtimeHub. Called once from main.go after both the supervisor and // the registry's hub exist. Subsequent chain spawns (runChain below) // install the Subscriber.OnBroadcast callback automatically. func (s *ChainSupervisor) AttachRealtime(h *RealtimeHub) { s.realtimeHub = h } // MountRoutes installs the /v1/indexer and /v1/graph dispatchers on mux. The // dispatchers look up per-chain handlers from the supervisor's route maps so // chains added at runtime become reachable without re-mounting. func (s *ChainSupervisor) MountRoutes(mux *http.ServeMux) { mux.Handle("/v1/indexer/", http.HandlerFunc(s.dispatchIndexer)) mux.Handle("/v1/explorer/", http.HandlerFunc(s.dispatchExplorerLegacy)) mux.Handle("/v1/graph/", http.HandlerFunc(s.dispatchGraph)) } // SetDefaultSlug picks which chain serves the unprefixed /v1/indexer/* route. func (s *ChainSupervisor) SetDefaultSlug(slug string) { s.mu.Lock() s.defaultSlug = slug s.mu.Unlock() } // start spawns workers for cfg. Idempotent: starting an already-running slug // is a no-op. func (s *ChainSupervisor) start(cfg ChainConfig) { s.mu.Lock() if _, ok := s.state[cfg.Slug]; ok { s.mu.Unlock() return } ctx, cancel := context.WithCancel(context.Background()) st := &chainState{cfg: cfg, cancel: cancel} s.state[cfg.Slug] = st if cfg.Default && s.defaultSlug == "" { s.defaultSlug = cfg.Slug } s.mu.Unlock() st.wg.Add(1) go func() { defer st.wg.Done() s.runChain(ctx, cfg) }() if cfg.Graph.Enabled { for _, sg := range cfg.Graph.Subgraphs { if !sg.Enabled { continue } sg := sg st.wg.Add(1) go func() { defer st.wg.Done() s.runSubgraph(ctx, cfg, sg) }() } } } // stop cancels and waits for all workers belonging to slug. func (s *ChainSupervisor) stop(slug string) { s.mu.Lock() st, ok := s.state[slug] if !ok { s.mu.Unlock() return } delete(s.state, slug) if s.defaultSlug == slug { s.defaultSlug = "" } s.mu.Unlock() st.cancel() st.wg.Wait() s.indexerRoutes.Delete(slug) s.graphRoutes.Range(func(k, _ any) bool { if key, ok := k.(string); ok && strings.HasPrefix(key, slug+"/") { s.graphRoutes.Delete(k) } return true }) log.Printf("[supervisor] stopped %s", slug) } // Wait blocks until ctx is done, then cancels every chain and waits for // goroutines to drain. func (s *ChainSupervisor) Wait(ctx context.Context) { <-ctx.Done() s.mu.Lock() slugs := make([]string, 0, len(s.state)) for k := range s.state { slugs = append(slugs, k) } s.mu.Unlock() for _, slug := range slugs { s.stop(slug) } } // runChain runs one chain's indexer to completion or context cancel and then // mounts the standalone explorer API once the SQLite schema is ready. func (s *ChainSupervisor) runChain(ctx context.Context, cfg ChainConfig) { chainDir := filepath.Join(s.dataDir, cfg.Slug) if err := os.MkdirAll(chainDir, 0755); err != nil { log.Printf("[%s] mkdir: %v", cfg.Slug, err) return } store, err := idxstor.NewUnified(idxstor.DefaultUnifiedConfig(chainDir)) if err != nil { log.Printf("[%s] storage: %v", cfg.Slug, err) return } defer store.Close() if err := store.Init(ctx); err != nil { log.Printf("[%s] storage init: %v", cfg.Slug, err) return } dbPath := filepath.Join(chainDir, "query", "indexer.db") log.Printf("[%s] indexing %s (%s) -> %s", cfg.Slug, cfg.Name, cfg.CoinSymbol, dbPath) go s.mountIndexerAPI(ctx, cfg, dbPath) switch cfg.Type { case "", "evm": poll := 30 * time.Second if cfg.Indexer.PollInterval != "" { if d, err := time.ParseDuration(cfg.Indexer.PollInterval); err == nil { poll = d } } idx, err := evm.NewIndexer(evm.Config{ ChainName: cfg.Name, ChainID: cfg.ChainID, RPCEndpoint: cfg.RPC, HTTPPort: 0, PollInterval: poll, StartBlock: cfg.Indexer.StartBlock, }, store) if err != nil { log.Printf("[%s] evm indexer: %v", cfg.Slug, err) return } // Live broadcast bridge — when the supervisor has been given a // RealtimeHub (see AttachRealtime), every block the indexer // commits is re-published into the hub on the chain's slug. The // hub then fans out to WebSocket and SSE subscribers (see // realtime.go + realtime_sse.go). slug captured by value so the // closure doesn't see a mutated `cfg` if the supervisor loops. if s.realtimeHub != nil && idx.Subscriber() != nil { slug := cfg.Slug hub := s.realtimeHub idx.Subscriber().OnBroadcast = func(eventType string, data any) { hub.Broadcast(eventType, slug, data) } } if err := idx.Init(ctx); err != nil { log.Printf("[%s] evm init: %v", cfg.Slug, err) return } if err := idx.Run(ctx); err != nil && ctx.Err() == nil { log.Printf("[%s] evm run: %v", cfg.Slug, err) } default: log.Printf("[%s] %s indexer: passive (no chain-specific implementation)", cfg.Slug, cfg.Type) <-ctx.Done() } } // mountIndexerAPI waits for the per-chain SQLite schema to settle, then // publishes the standalone explorer API in the indexer/explorer route maps. func (s *ChainSupervisor) mountIndexerAPI(ctx context.Context, cfg ChainConfig, dbPath string) { apiPrefix := "/v1/indexer/" + cfg.Slug deadline := time.Now().Add(5 * time.Minute) for { select { case <-ctx.Done(): return case <-time.After(time.Second): } if _, err := os.Stat(dbPath); err != nil { if time.Now().After(deadline) { log.Printf("[%s] api waiting for %s: %v", cfg.Slug, dbPath, err) deadline = time.Now().Add(5 * time.Minute) } continue } if cfg.Type == "" || cfg.Type == "evm" { db, err := sql.Open("sqlite3", "file:"+dbPath+"?mode=ro") if err == nil { var n int _ = db.QueryRow("SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name='evm_blocks'").Scan(&n) db.Close() if n == 0 { if time.Now().After(deadline) { log.Printf("[%s] api waiting for evm_blocks", cfg.Slug) deadline = time.Now().Add(5 * time.Minute) } continue } } } srv, err := explorer.NewStandaloneServer(explorer.Config{ IndexerDBPath: dbPath, ChainID: cfg.ChainID, ChainName: cfg.Name, CoinSymbol: cfg.CoinSymbol, APIPrefix: apiPrefix, }) if err != nil { if time.Now().After(deadline) { log.Printf("[%s] api: %v", cfg.Slug, err) deadline = time.Now().Add(5 * time.Minute) } continue } s.indexerRoutes.Store(cfg.Slug, srv.Handler()) log.Printf("[%s] api mounted at %s/*", cfg.Slug, apiPrefix) return } } // runSubgraph spawns a graph indexer + engine for a single subgraph and // publishes its handler at /v1/graph/{chain-slug}/{subgraph-name}/. func (s *ChainSupervisor) runSubgraph(ctx context.Context, cfg ChainConfig, sg Subgraph) { dir := filepath.Join(s.dataDir, cfg.Slug, "graph", sg.Name) if err := os.MkdirAll(dir, 0755); err != nil { log.Printf("[%s/%s] mkdir: %v", cfg.Slug, sg.Name, err) return } store, err := graphstor.New(dir) if err != nil { log.Printf("[%s/%s] storage: %v", cfg.Slug, sg.Name, err) return } defer store.Close() if err := store.Init(ctx); err != nil { log.Printf("[%s/%s] storage init: %v", cfg.Slug, sg.Name, err) return } idx := graphidx.New(cfg.RPC, store) go func() { if err := idx.Run(ctx); err != nil && ctx.Err() == nil { log.Printf("[%s/%s] indexer: %v", cfg.Slug, sg.Name, err) } }() eng := engine.New(store, &engine.Config{ MaxQueryDepth: 10, MaxResultSize: 1 << 20, QueryTimeoutMs: 30000, }) schema := sg.Schema if schema == "" { schema = "amm" } if err := eng.LoadBuiltin(schema); err != nil { log.Printf("[%s/%s] schema %q: %v", cfg.Slug, sg.Name, schema, err) return } prefix := fmt.Sprintf("/v1/graph/%s/%s", cfg.Slug, sg.Name) mux := http.NewServeMux() gqlHandler := func(w http.ResponseWriter, r *http.Request) { r.Body = http.MaxBytesReader(w, r.Body, 10<<20) var req engine.Request if err := json.NewDecoder(r.Body).Decode(&req); err != nil { http.Error(w, `{"errors":[{"message":"invalid JSON"}]}`, http.StatusBadRequest) return } resp := eng.Execute(r.Context(), &req) w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(resp) } statusHandler := func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") st := idx.Status() fmt.Fprintf(w, `{"status":"ok","block":%d,"indexed":%d}`, st.LatestBlock, st.IndexedEvents) } mux.HandleFunc("POST "+prefix+"/graphql", gqlHandler) mux.HandleFunc("GET "+prefix+"/graphql", eng.HandleGraphiQL) mux.HandleFunc("POST "+prefix+"/ql", gqlHandler) mux.HandleFunc("GET "+prefix+"/ql", eng.HandleGraphiQL) mux.HandleFunc("GET "+prefix+"/health", statusHandler) s.graphRoutes.Store(cfg.Slug+"/"+sg.Name, http.Handler(mux)) log.Printf("[%s/%s] graph mounted at %s/{graphql,ql,health} (schema=%s)", cfg.Slug, sg.Name, prefix, schema) <-ctx.Done() } // dispatchIndexer routes /v1/indexer/{slug}/* and /v1/indexer/* (default // chain) to the per-chain handler installed by mountIndexerAPI. // // Edge case the older code got wrong: when the first path segment matches // the slug regex but is NOT a registered chain (e.g. `main-page` in // `/v1/indexer/main-page/blocks`), splitSlug peels it off as a "slug" and // the dispatcher then forwarded only the REMAINING segments to the // default chain. That turned `/v1/indexer/main-page/blocks` into // `/v1/indexer/evm/blocks` server-side — a completely different endpoint // with a different response shape (paginated envelope vs. raw array). The // SPA's `?.slice(0,8)` on the home page's Latest Blocks widget tripped // over the envelope and threw "o.slice is not a function". // // Fix: when the parsed slug isn't a real chain, re-join it with the rest // before delegating, so the unrecognized segment is preserved as part of // the path under the default chain. func (s *ChainSupervisor) dispatchIndexer(w http.ResponseWriter, r *http.Request) { slug, rest, ok := splitSlug(r.URL.Path, "/v1/indexer/") if !ok { s.serveDefault(w, r, "") return } if h, found := s.indexerRoutes.Load(slug); found { h.(http.Handler).ServeHTTP(w, r) return } fullTail := slug if rest != "" { fullTail = slug + "/" + rest } s.serveDefault(w, r, fullTail) } // serveDefault forwards an unprefixed /v1/indexer/* request to the default // chain. The standalone server is mounted under its slug, so we rewrite the // URL to include the slug before delegating. func (s *ChainSupervisor) serveDefault(w http.ResponseWriter, r *http.Request, rest string) { s.mu.Lock() def := s.defaultSlug s.mu.Unlock() if def == "" { http.Error(w, `{"error":"no default chain"}`, http.StatusNotFound) return } h, ok := s.indexerRoutes.Load(def) if !ok { http.Error(w, `{"error":"chain not ready"}`, http.StatusServiceUnavailable) return } r2 := r.Clone(r.Context()) r2.URL.Path = "/v1/indexer/" + def + "/" + strings.TrimPrefix(rest, "/") h.(http.Handler).ServeHTTP(w, r2) } // dispatchExplorerLegacy preserves the older /v1/explorer/{slug}/* prefix // for clients that haven't migrated to /v1/indexer/. func (s *ChainSupervisor) dispatchExplorerLegacy(w http.ResponseWriter, r *http.Request) { slug, rest, ok := splitSlug(r.URL.Path, "/v1/explorer/") if !ok { http.NotFound(w, r) return } h, found := s.indexerRoutes.Load(slug) if !found { http.NotFound(w, r) return } r2 := r.Clone(r.Context()) r2.URL.Path = "/v1/indexer/" + slug + "/" + strings.TrimPrefix(rest, "/") h.(http.Handler).ServeHTTP(w, r2) } // dispatchGraph routes /v1/graph/{slug}/{subgraph}/* to the matching engine. func (s *ChainSupervisor) dispatchGraph(w http.ResponseWriter, r *http.Request) { rest := strings.TrimPrefix(r.URL.Path, "/v1/graph/") if rest == r.URL.Path { http.NotFound(w, r) return } parts := strings.SplitN(rest, "/", 3) if len(parts) < 2 { http.NotFound(w, r) return } key := parts[0] + "/" + parts[1] h, ok := s.graphRoutes.Load(key) if !ok { http.NotFound(w, r) return } h.(http.Handler).ServeHTTP(w, r) } // splitSlug returns the chain slug and the remainder of the path after a // known prefix (e.g. "/v1/indexer/"). Returns ok=false if the path does not // match the prefix or contains no slug. func splitSlug(path, prefix string) (slug, rest string, ok bool) { if !strings.HasPrefix(path, prefix) { return "", "", false } tail := strings.TrimPrefix(path, prefix) if tail == "" { return "", "", false } parts := strings.SplitN(tail, "/", 2) if !slugPattern.MatchString(parts[0]) { return "", "", false } if len(parts) == 1 { return parts[0], "", true } return parts[0], parts[1], true } x }x&/Ii-+#) Fxf@lDx <100644 frontend_test.goOXޓs>[%q2إ==I).xn100644 icon.svg^p`98(=0100644 index.html!"Ѓ'Xa100644 logo.svgÞ6 ѕ_|n%<.mx. Lux Explorer

Explorer

Latest Blocks

Latest Transactions

W48xq40000 .github;:5̄, 48100644 .gitignore' À !6œ㝶>100644 CLAUDE.mdh2q!8]~&oQ100644 Dockerfilei0]pZpZ100644 LICENSE<:MdPR100644 LICENSING.md__"]+Ұ?Y120000 LLM.mdhSsW{100644 README.mdo&;bkܛVv4100644 chains.example.yaml[$rQjٓU!100644 compose.yml>)S7>rš 100644 config.goؽ#N!,y^R100644 frontend.goX( q-Ɗ ]100644 go.modA֕3h́(qm100644 go.sum|S)B(2(ڂI100644 main.go G/נs܁100644 mdns.go_ֈm2mWw1<&vܢXN100644 realtime.gozYW/rb4gӌ100644 realtime_sse.goZ*ڶ%e&100644 realtime_test.go2-CGM"100644 registry.goo:źZj+F)pL100644 registry_test.goYs5ZC40000 scriptsB:N~=w$=^+E40000 static01~tHT4100644 supervisor.goO[>LbgX) i}b k xCu*tRzYn5%M w8-H100644 frontend.gobgP6 oJ)iPZb100644 frontend_test.goߤ[ ͧr`!Ge}100644 go.modA֕3h̳r2إ==Ie),M}KxM@>)Hnڕ`, 100644 frontend_test.go>< )>ݡyͥ8u+8"\xY`(z52v#cmMj-x!E5ug)BLF9,q޳; x'package main import ( "bytes" "embed" "encoding/json" "fmt" "io/fs" "net/http" "os" "path/filepath" "strings" "sync" ) // staticFS is the embedded SPA. The Dockerfile populates static/ from a // luxfi/explore build before the Go build runs; for local dev a placeholder // index.html is committed so go:embed always succeeds. // //go:embed all:static var staticFS embed.FS // Frontend serves the embedded SPA, runtime config (/envs.js), and per-host // brand assets (/icon.svg, /logo.svg). Brand assets read from disk on every // request so a deploy can swap them without rebuilding the binary. // // SPA override: if cfg.StaticDir (or $EXPLORER_STATIC_DIR) points at an // existing directory, file lookups prefer the on-disk copy over the // embedded FS. This lets a ConfigMap-mounted SPA replace the embedded // 60-byte placeholder without a binary rebuild — useful when the // upstream `explore` Next.js app hasn't shipped a static export yet but // we want a richer in-cluster default than `
`. type Frontend struct { cfg Config registry *ChainRegistry root fs.FS // embedded SPA (always present) overlay fs.FS // disk overlay (nil if cfg.StaticDir not set) index []byte // resolved index.html (overlay > embedded > builtin) } // NewFrontend returns a frontend handler bound to a config and chain registry. func NewFrontend(cfg Config, r *ChainRegistry) (*Frontend, error) { root, err := fs.Sub(staticFS, "static") if err != nil { return nil, err } f := &Frontend{cfg: cfg, registry: r, root: root} dir := cfg.StaticDir if dir == "" { dir = os.Getenv("EXPLORER_STATIC_DIR") } if dir != "" { if st, err := os.Stat(dir); err == nil && st.IsDir() { f.overlay = os.DirFS(dir) } } if data := f.readStatic("index.html"); data != nil { f.index = data } else { f.index = []byte("Explorer") } return f, nil } // readStatic returns the bytes for `name` from the overlay if present, // otherwise from the embedded FS. Returns nil if neither has the file. func (f *Frontend) readStatic(name string) []byte { if f.overlay != nil { if data, err := fs.ReadFile(f.overlay, name); err == nil { return data } } if data, err := fs.ReadFile(f.root, name); err == nil { return data } return nil } // Mount installs / (SPA), /envs.js, /icon.svg, /logo.svg on mux. func (f *Frontend) Mount(mux *http.ServeMux) { mux.HandleFunc("GET /envs.js", f.handleEnvs) mux.HandleFunc("GET /icon.svg", f.handleIcon) mux.HandleFunc("GET /logo.svg", f.handleLogo) mux.HandleFunc("/", f.handleSPA) } // handleSPA serves embedded static assets and falls back to index.html for // any path the SPA owns (client-side routing). // // HEAD-method note: the bundled SPA opens EventSource (Server-Sent Events) // channels for live block / token / tx streams and pre-flights each URL // with a HEAD request: // // fetch(url, {method: 'HEAD'}).then(r => r.ok ? openEventSource() : disable()); // // If we serve a 200 (because of the SPA fallback to index.html), the SPA // proceeds to open the EventSource — which then immediately aborts because // the response body is text/html, not text/event-stream. Browser logs // "EventSource's response has a MIME type ('text/html') that is not // 'text/event-stream'" for every channel on every page load — noisy and // disables the channel anyway. // // Fix: return 404 for HEAD requests on the SPA-fallback path. Real assets // (anything in `f.root`) still serve normally on HEAD; only the index.html // fallback gets the 404 so the SSE pre-flight cleanly fails and the SPA // disables that channel on its own. Visible browser load is unchanged // because the SPA only HEAD-probes its SSE endpoints, never the SPA URL // itself. func (f *Frontend) handleSPA(w http.ResponseWriter, r *http.Request) { p := strings.TrimPrefix(r.URL.Path, "/") if p == "" { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } // Overlay wins if it has the file (any non-directory entry); falls // back to embedded; falls back to index.html (SPA-routing). if f.overlay != nil { if file, err := f.overlay.Open(p); err == nil { st, statErr := file.Stat() file.Close() if statErr == nil && !st.IsDir() { http.ServeFileFS(w, r, f.overlay, p) return } } } file, err := f.root.Open(p) if err != nil { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } defer file.Close() stat, err := file.Stat() if err != nil || stat.IsDir() { if r.Method == http.MethodHead { http.NotFound(w, r) return } f.writeIndex(w) return } http.ServeFileFS(w, r, f.root, p) } func (f *Frontend) writeIndex(w http.ResponseWriter) { w.Header().Set("Content-Type", "text/html; charset=utf-8") w.Header().Set("Cache-Control", "no-cache") w.Write(f.index) } // handleEnvs returns runtime config the SPA reads instead of build-time env // vars. This is what makes per-network customization possible without a // rebuild: deploy the same image, mount a different chains.yaml, get a // different brand + chain list. func (f *Frontend) handleEnvs(w http.ResponseWriter, r *http.Request) { hostBrand := f.brandForHost(r.Host) chains := f.chainListJSON() env := map[string]any{ "VITE_CHAINS": chains, "VITE_NETWORKS": f.cfg.Networks, "VITE_BRAND": hostBrand, } body, _ := json.Marshal(env) var buf bytes.Buffer buf.WriteString("window.ENV = ") buf.Write(body) buf.WriteString(";\n") w.Header().Set("Content-Type", "application/javascript") w.Header().Set("Cache-Control", "no-cache") w.Write(buf.Bytes()) } // handleIcon serves the per-host or default icon.svg from disk. func (f *Frontend) handleIcon(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.IconFile }, "icon.svg") } // handleLogo serves the per-host or default logo.svg from disk. func (f *Frontend) handleLogo(w http.ResponseWriter, r *http.Request) { f.serveBrandFile(w, r, func(b Brand) string { return b.LogoFile }, "logo.svg") } // serveBrandFile resolves the file path from the matched brand (per-chain or // default) and sends it. Falls back to the on-disk overlay (if configured) // then the embedded SPA's named asset. func (f *Frontend) serveBrandFile(w http.ResponseWriter, r *http.Request, pick func(Brand) string, fallback string) { brand := f.brandStruct(r.Host) if path := pick(brand); path != "" { if data, err := os.ReadFile(path); err == nil { w.Header().Set("Content-Type", contentTypeFor(path)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data) return } } if data := f.readStatic(fallback); data != nil { w.Header().Set("Content-Type", contentTypeFor(fallback)) w.Header().Set("Cache-Control", "public, max-age=300") w.Write(data) return } http.NotFound(w, r) } // brandForHost returns a JSON-shaped brand for /envs.js. It strips file paths. func (f *Frontend) brandForHost(host string) map[string]any { b := f.brandStruct(host) return map[string]any{ "name": b.Name, "coin": b.Coin, "accentColor": b.AccentColor, "iconUrl": b.IconURL, "logoUrl": b.LogoURL, } } // brandStruct returns the Brand for a request host: a chain whose name or // slug matches the hostname wins; otherwise the global default. // // Matches any of these hostname shapes, in order of specificity: // - "{slug}" — bare slug (curl localhost) // - "{slug}.tld..." — {slug}.lux.network, {slug}.hanzo.ai // - "explore-{slug}.tld..." — explore-hanzo.lux.network // - "api-explore-{slug}.tld..." — api-explore-hanzo.lux.network // - "explore.{slug}.tld..." — explore.hanzo.ai, explore.zoo.ngo // - "api-explore.{slug}.tld..." — api-explore.hanzo.ai // - "explore-{slug}-{env}.tld..." — explore-hanzo-test.lux.network // - "api-explore-{slug}-{env}.tld..." — api-explore-hanzo-dev.lux.network // // Per-chain Brand wins over BrandDefault; first match wins on ambiguous // hosts. func (f *Frontend) brandStruct(host string) Brand { host = strings.ToLower(strings.SplitN(host, ":", 2)[0]) for _, c := range f.cfg.Chains { if c.Brand == nil { continue } slug := c.Slug if host == slug || strings.HasPrefix(host, slug+".") || strings.HasPrefix(host, "explore-"+slug+".") || strings.HasPrefix(host, "explore-"+slug+"-") || strings.HasPrefix(host, "api-explore-"+slug+".") || strings.HasPrefix(host, "api-explore-"+slug+"-") || strings.HasPrefix(host, "explore."+slug+".") || strings.HasPrefix(host, "api-explore."+slug+".") { return *c.Brand } } return f.cfg.BrandDefault } // chainListJSON returns a SPA-friendly chain list from the live registry, // not the static config — chains added via mDNS/admin show up immediately. var chainListMu sync.Mutex func (f *Frontend) chainListJSON() []map[string]any { chainListMu.Lock() defer chainListMu.Unlock() out := []map[string]any{} if f.registry == nil { return out } for _, c := range f.registry.List() { out = append(out, map[string]any{ "slug": c.Slug, "name": c.Name, "chainId": c.ChainID, "rpc": c.RPC, "coin": c.CoinSymbol, "type": c.Type, "default": c.Default, }) } return out } // contentTypeFor maps a file extension to a Content-Type, defaulting to // application/octet-stream. func contentTypeFor(path string) string { switch strings.ToLower(filepath.Ext(path)) { case ".svg": return "image/svg+xml" case ".png": return "image/png" case ".jpg", ".jpeg": return "image/jpeg" case ".webp": return "image/webp" case ".ico": return "image/x-icon" default: return "application/octet-stream" } } // fingerprint returns a short, stable identifier for the embedded asset // bundle, useful for cache-busting log lines at startup. func fingerprint() string { root, err := fs.Sub(staticFS, "static") if err != nil { return "0" } count := 0 _ = fs.WalkDir(root, ".", func(_ string, _ fs.DirEntry, _ error) error { count++ return nil }) return fmt.Sprintf("assets=%d", count) } axpackage main import ( "net/http" "net/http/httptest" "os" "path/filepath" "strings" "testing" ) // TestFrontendStaticOverlay verifies that NewFrontend prefers the on-disk // static dir over the embedded FS when cfg.StaticDir points at a real // directory. The overlay use-case: ConfigMap-mounting a richer SPA shell // into an existing image without rebuilding. func TestFrontendStaticOverlay(t *testing.T) { dir := t.TempDir() want := "OVERLAY" if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte(want), 0644); err != nil { t.Fatal(err) } cfg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()) if err != nil { t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html, got %q", got) } } // TestFrontendNoOverlay verifies that with no StaticDir, the embedded // index.html is served (current behaviour — pre-overlay). func TestFrontendNoOverlay(t *testing.T) { cfg := Config{BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()) if err != nil { t.Fatal(err) } if f.overlay != nil { t.Fatal("expected nil overlay when StaticDir empty") } mux := http.NewServeMux() f.Mount(mux) req := httptest.NewRequest("GET", "/", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "doctype html") { t.Fatalf("expected fallback index.html, got %q", got) } } // TestFrontendOverlayMissingFileFallsBack covers the case where the // overlay dir exists but a particular file is missing — the request // falls through to the embedded FS (and ultimately to index.html for // SPA-routing). func TestFrontendOverlayMissingFileFallsBack(t *testing.T) { dir := t.TempDir() // Only index.html in overlay; no other assets. if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte("OVERLAY"), 0644); err != nil { t.Fatal(err) } cfg := Config{StaticDir: dir, BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()) if err != nil { t.Fatal(err) } mux := http.NewServeMux() f.Mount(mux) // Request a path the overlay doesn't have. With SPA-routing, the // handler returns index.html — which IS in the overlay. req := httptest.NewRequest("GET", "/some/spa/route", nil) rec := httptest.NewRecorder() mux.ServeHTTP(rec, req) got := rec.Body.String() if !strings.Contains(got, "OVERLAY") { t.Fatalf("expected overlay index.html (SPA fallback), got %q", got) } } // TestFrontendEnvStaticDir verifies $EXPLORER_STATIC_DIR is the env-var // equivalent of cfg.StaticDir. Empty cfg + env-var-set overlay should // still pick up the overlay. func TestFrontendEnvStaticDir(t *testing.T) { dir := t.TempDir() if err := os.WriteFile(filepath.Join(dir, "index.html"), []byte("ENV-OVERLAY"), 0644); err != nil { t.Fatal(err) } t.Setenv("EXPLORER_STATIC_DIR", dir) cfg := Config{BrandDefault: Brand{Name: "Test"}} f, err := NewFrontend(cfg, NewChainRegistry()) if err != nil { t.Fatal(err) } if f.overlay == nil { t.Fatal("expected overlay populated from env var") } if !strings.Contains(string(f.index), "ENV-OVERLAY") { t.Fatalf("expected env-overlay index, got %q", string(f.index)) } } // TestBrandStructHostMatching covers every hostname shape the unified // explorer's IngressRoutes hand it: the per-chain brand must win over // BrandDefault for both UI hosts (explore-{slug}, explore.{slug}.tld) // and API hosts (api-explore-{slug}). The matcher must NOT bleed across // chains — a hanzo host must not pick zoo's brand or vice versa. func TestBrandStructHostMatching(t *testing.T) { hanzoBrand := Brand{Name: "Hanzo", Coin: "AI", AccentColor: "#0b1220"} zooBrand := Brand{Name: "Zoo", Coin: "ZOO", AccentColor: "#7c3aed"} cfg := Config{ BrandDefault: Brand{Name: "Lux Explorer"}, Chains: []ChainConfig{ {Slug: "cchain", Brand: &Brand{Name: "Lux C-Chain", Coin: "LUX"}}, {Slug: "hanzo", Brand: &hanzoBrand}, {Slug: "zoo", Brand: &zooBrand}, }, } f, err := NewFrontend(cfg, NewChainRegistry()) if err != nil { t.Fatal(err) } cases := []struct { host string want string }{ // Bare slug + slug-prefix shape. {"hanzo", "Hanzo"}, {"hanzo.lux.network", "Hanzo"}, // explore-{slug} prefix shape (lux.network UI hosts). {"explore-hanzo.lux.network", "Hanzo"}, {"explore-hanzo-test.lux.network", "Hanzo"}, {"explore-hanzo-dev.lux.network", "Hanzo"}, {"explore-zoo.lux.network", "Zoo"}, // api-explore-{slug} prefix shape (lux.network API hosts). {"api-explore-hanzo.lux.network", "Hanzo"}, {"api-explore-hanzo-test.lux.network", "Hanzo"}, {"api-explore-zoo.lux.network", "Zoo"}, // explore.{slug}.tld shape (brand-owned domains). {"explore.hanzo.ai", "Hanzo"}, {"explore.hanzo.network", "Hanzo"}, {"explore.zoo.network", "Zoo"}, {"explore.zoo.ngo", "Zoo"}, {"api-explore.hanzo.ai", "Hanzo"}, {"api-explore.zoo.ngo", "Zoo"}, // Mismatched hosts fall back to BrandDefault. {"explore.lux.network", "Lux Explorer"}, {"unknown.example.com", "Lux Explorer"}, // Cross-contamination guard: explore-spcfoo must NOT match spc. {"explore-spcfoo.lux.network", "Lux Explorer"}, } for _, tc := range cases { t.Run(tc.host, func(t *testing.T) { got := f.brandStruct(tc.host).Name if got != tc.want { t.Fatalf("host=%q: got brand=%q, want %q", tc.host, got, tc.want) } }) } } H Explorer
Loading explorer…
P{pExIOtk67i^ˤ,͌A100644 go.sum1)7|?.2sş ji=Yx;>_1U/7!p4E u>0ѣH|||_|ϫN)YƝ}Ld!6/xo#!*3+h0.1.0 !0.0.0-00010101000000-000000000000 0QProjectZKM/Ziren/crates/go-runtime/zkvm_runtime v0.0.0-20260215031811-a0ab0b218a8! }!decred/dcrd/dcrec/secp256k1/v4 v4`Hx2.5Areplicate v0.6T10801064154-80525e88d958A5q ib/pq v1.12Q]<0.7q ge v1`-<]ontainer v0.0.4q  database v1.17.44q ids v1.2.9q R$_ r:R!02Q! /v4 v4.9Amagefile/mage v1.1aE S4    * 2 ierrec(  t7.5A procfs v0.19I 51127171934-4e34e03a991aA Qsuperfly/ltx v0.5 2n 3^2$otel/metric v1.42$2F2 v2.4.3 crypto v0.49Z312153236-7ab1446f8b90#4 net v0.52-2 text v0.35[ 3fJA0h3[48.0 // indirect ) replace (graph => ../graphindexer => ../indexer ) "Y6x,!{xrypto v1.17.45 =;x,1.2.01.4.1Ջ9` =V03 h1:bcqUO8twMOhHWCgN/RbjfWulVPbvUQcxDkssaRrCx4g!=/? 73/go.mod h1:ENkJ121cmDEkwQPDiKK4QhnTnW9u37PGpepbrdVcAmc!=,@?00 h1:VtH6kvZrCEjCnkHPkhExDU+GJ0ZulYX4rnA+lXJdJHw@ 70/go.mod h1:ee525i8Recbpb0jVTDZYZBr1MmvJ27OITJHZ/nlNMBw!=~A 37.44 h1:hfiTls7sqbweW+o4iaZqB8P997paC+vpgWmhN6v5MJ0!=~A :7.44/go.mod h1:6Ey5y3I0WNLHbxIlIdFqUuKfBg+b0fAgTA8FgRgQ8zg!=;geth v1.16.69 h1:CHO6xTZ+A+3itk94ts4uyVRJajNVP3RxWTjJp5qGOlIBgeth v1.16.69/go.mod h1:8eEO1hW5sa6OH2VeCMaCPnRz28JBxFvCPBCWPLsU2cI|B 00 h1:jwOXnlDGfx2TjqE5GhP5T3Rv9cGh7jHSfV6DceggmAc!=|B 70/go.mod h1:bf35zaU3Nm5tiJj1d5SoZP8DYYJl4aCVp32rOY5vj2w!=C 09 h1:+yjdhXW99drnd2Zlp1u/p8k3G23W3/1btJQ4ogHawUI!=C 79/go.mod h1:khJOEdOPxd22yn0jcVrnbX1ADa0GHn5Y74gvCzN5BYc!=C 04 h1:r/c47r6WEK+EfkTeYCj3tWKTH5dUWQauuLUmK/jDvBw!=C 4ZDICC4105612-65220f1104cd h1:s34y2+uPyyqsXuJKWQu5bL2Y1sWevkBJr2xF7eRkrFc!=C4105612-65220f1104cYDJCC4130605-aade4dd9fd4c h1:OCaB/KxgU8hrKtIBMwSoA8mt2Pf8B+23UhKQf0EbRDo!=C4130605-aade4dd9fd4cZDICC4134132-0c0ba56e32d7 h1:vgt+Q5m+lJzLLIuErWkjg2lbbKE3wtoZD9X41MoRokg!=C4134132-0c0ba56e32d7ZDR01 h1:rIfFRodb9jrD/w7KayaUk0Oc+37PaQQdKEEMJCjR8gw!=D 61/go.mod h1:64IE3xRMJcpkQwnPUfJw3pDj7wU0kRS7BZ9wM7R72jIE12.4 h1:iVz7s0gToCNUU/2cLT8gUa8MLzc0YRp4jBmeXBeKdXIE92.4/go.mod h1:i+Am9YvFsqDE75ZW8MPE62XCXGukXNiN/7mD9SKxxZY!F"E/0 h1:VB3mQcETc9j5SY1S6lAgFtuGr/rjWuDgPYnxS+OKWM FF 60/go.mod h1:/3dheKVjUk2yiS/ocH1IDzeLXOIe+kpVsErIGDOZdi F.G 01 h1:6tVarXMnNR3Xzud8FYUHjtXabTll3HI/OEqG0tgLAcI!F.G 71/go.mod h1:PkD4D4JoGuyKtfUkqPNYkrg9xKrJeNVZFdW/5XvAe/A!F H GI03 h1:yDEuuJ6bm9H8DzOzzveXI1AZlu/AeSpHNRrY1akbyc0!=@utils v1.1.3/go.mod h1:lskchZiYYRBFsSyYg3NWLPw211uRyxIs3/wAzrfSII9zap v0.2.1 h1:5uU3Z47Nu/FNcLqYeKZ4B0f+0ZDF79/2M/9FRN/1/Hw!=@zap v0.2.1/go.mod h1:CobyEg6MNO6qZ5wn3kVEw6QCxFVZvvGMnEKsC5sJZtI!=>zapdb/v4 v4.9.3 h1:KV1DrbZqtZsZvrWyPw5D8WHR0DxzqW2jHjqx6obxgoM!=zapdb/v4 v4.9.3/go.mod h1:BrpLaDeYy+smON4ASDPCFKWrQ58CXhy3WNEPGna7vuU= github.com/magefile/mage v1.14.0 h1:6QDX3g6z1YvJ4olPhT1wksUcSa/V0a1B+pJb73fBjyo= github.com/magefile/mage v1.14.0/go.mod h1:z5UZb/iS3GoOSn0JgWuiw7dxlurVYTu+/jHXqQg881A= github.com/marK04 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIELL4LY/0 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWELhM 60/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3LN M%R22.0 h1:T/HDJBh4ZCPbU39/+c3rRvE0uKBQlU27+QI8LJ4t64oR92.0/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwcoRierrec0cKFw6uJDK+/gfw5BcDL0JL5aBsAFdsIT18eRtLj7VIU= github.com/pierrec/lz4/v4 v4.1.22/go.mod h1:gZWDp/Ze/IJXGXf23ltt2EXimqmTUXEy0GFuRQyBid4V@YfYF17.5 h1:pIgK94WWlQt1WLwAC5j2ynLaBRDiinoAb86HZHTUGIZCommon v0.67.5/go.mod h1:SjE/0MzDEEAyrdr5Gqc6G+sXI67maCxzaT3A2+HqjUw\"319.2 h1:zUMhqEW66Ex7OXIiDkll3tl9a1ZdilUOd/F6ZXw4Vws\":19.2/go.mod h1:M0aotyiemPhBCM0z5w87kL22CxfcH05ZpYlu+b4J7mw]]+G51127171934-4e34e03a991a h1:r4YWl0uVObCbBFvj1VsIlyHzgZwZOHvY1KdRaQjzzUc]]+51127171934-4e34e03a991a]~abPsuperfly/ltx v0.5.1 h1:vGUeBhKvBKZ2s2TsTrOSahz+m0PswfqOWDAD+ICiiYY= github.com/superfly/ltx v0.5.1/go.mod h1:Nf50QAIXU/ET4ua3AuQ2fh31MbgNQZA7r/DYx6Os77s9d#22.1 h1:J4X2hrGzJvt+wqltuvcSjHQ7ujQxA9gb6PeMs4qlUWs9d#92.1/go.mod h1:wYx2gNRg8/WihJfSDxA1TIL8H+GkfLYm+bIfbblu9VQe 23.0 h1:LFhBNzoStM3wMie6rN2slD1cuYH2CGiHpvNL3UtcsMwe 93.0/go.mod h1:AafrCXVvGRJJOImMajgJ2M7rVmWyisVK7sFshbxnVrge?nottinygc v0.4.0 h1:h1TJMihMC4neN6Zq+WKpLxgd9xCFMw7O9ETLwY2exJQeFnottinygc v0.4.0/go.mod h1:oDcIotskuYNMpqMF23l7Z8uzD4TC0WXHK8jetlB3HIo!hi22.0 h1:lSQGzTgVR3+sgJDAU/7/ZMjN9Z+vUip7leaqBKy4shoiBotel v1.42.0/go.mod h1:lJNsdRMxCUIWuMlVJWzecSMuNjE7dOYyWlqOXWkdqCci*l12.0 h1:2jXG+3oZLNXEPfNmnpxKDeZsFI5o4J+nz6xUlaFdF/ i*l92.0/go.mod h1:RlUN/7vTU7Ao/diDkEpQpnz3/92J9ko05BIwxYa2SSIi8m22.0 h1:OUCgIPt+mzOnaUTpOQcBiM/PLQ/Op7oq6g4LenLmOYYi8m92.0/go.mod h1:f3K9S+IFqnumBkKhRJMeaZeNk9epyhnCmQh/EysQCdcmL03 h1:6gvOSjQoTB3vt1l+CU+tSyi/HOjfOjRLJ4YwYZGwRO0n63/go.mod h1:zSxWcmIDjOzPXpjlTTbAsKokqkDNAVtZO0WOMiT90sqop p349.0 h1:+Ng2ULVvLHnJ/ZFEq4KdcDd/cfjrrjjNSXNzxg0Y4U4q:49.0/go.mod h1:ErX4dUh2UM+CFYiXZRTcMpEcN8b/1gxEuv3nODoYtCAqE312153236-7ab1446f8b90 h1:jiDhWWeC7jfWqR9c/uplMOqJ0sbNlNWv0UkzE0vX1MAqL312153236-7ab1446f8b90/go.mod h1:xE1HEv6b+1SCZ5/uscMRjUBKtIxworgEcEi+/n9NQDQrHrn24.0 h1:xIHgNUUnW6sYkcM5Jleh05DvLOtwc6RitGHbDk4akRIr94.0/go.mod h1:ykgH52iCZe79kzLLMhyCUzhMci+nQj+0XkbXpNYtVjYtWs22.0 h1:He/TN1l0e4mmR3QqHMT2Xab3Aj3L9qjbhRm78/6jrW0t952.0/go.mod h1:R1MAz7uMZxVMualyPXb+VaqGSa3LIaUqk0eEt3w36S|u96.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITgw342.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeow42x25.0 h1:JOVx6vVDFokkpaq1AEptVzLTpDe9KGpj5tR4/X+ybL8x95.0/go.mod h1:khi/HExzZJ2pGnjenulevKNX1W67CUy0AsXcNubPGCAy!23.0 h1:12BdW9CeB3Z+J/I/wj34VMl8X+fEXBxVR90JeMX5E7sz83.0/go.mod h1:uHkMso649BX2cZK6+RpuIPXS3ho2hZo4FVwfoy1vIk{26.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfkk|96.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E}Ńē27.1 h1:9W30zRlYrefrDV2JE2O8VDtJ1yPGownxciz5rrbQZis97.1/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL022.0 h1:hjG66bI/kqIPX1b2yT6fr/jt+QedtP2fqojG2VrFuVw92.0/go.mod h1:6F08EBCx5uQc38kMGl+0Nm0oWczoo1c7cgpzEry7Uc0Q02 h1:ZtDCnhonXSZexk/AYsegNRV1lJGgaNZJuKjJSWKyEqo.2H0.0 h1:U58NawXqXbgpZ/dcdS9kMshu08aiA6b7gusEusqzNkw= modernc.org/libc v1.70.0/go.mod h1:OVmxFGP1CI/Z4L3E0Q3Mf1PDE0BucwMkcXjjLntvHJoω4J1.4 h1:2kNGMRiUjrp4LcaPuLY2PzUfqM/w9N23quVwhKt5Qm8= modernc.org/opt v0.1.4M348.0 h1:ElZyLop3Q2mHYk5IFPPXADejZrlHu7APbpB0sF78bq4m:48.0/go.mod h1:hWjRO6Tj/5Ik8ieqxQybiEOUXy0NJFNp2tpvVpKlvig87٥&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!rLbgX) i}b qu \x+"40000 .github;:5̄, 48"%Z9xC6#j 100644 go.sumzNv 3ս4w͍|QxC6 dɉ/ w"$100644 go.sumq ;t`S@O,1׳LQxC67i^ˤ,͌A100644 go.sum1)7|?.2sş'x$ vw Liquid EVML #Agb21 _  && [ -f /app/out/index.html ] || \ echo 'Explorer
' > /app/out/index.htmlu © --from=frontend /app/out ./staticOL x 0605-aade4dd9fd4cqO DxͅAB B"AOX\x!05612-65220f1104cdqOH HTx@B B"AR$gx3(d5e65d4b50c127ce8982ef94f448dd17822448f7bncx?@,A3Scx&100644 docker.ymlCbj{!_Gj`Gq~x* Multi-arch on luxfi org's native amd64 ARC runner pool; arm64 via QEMU # (matches lux/graph + lux/indexer docker.yml). Mac devsP run native arm64 # under OrbStack — zero Rosetta is allowed. Semver tags onlyhanzo-build-linux-amd64$Iqemu#platforms: linux/arm6P ,linux/armi:x s lux-buildKbs xNc:Fslyx 4b$5#lkx ooClR"%yxOTQ_SSE response headers — set BEFORE the HEAD short-circuit so // the pre-flight sees them and the SPA's `u.ok` check passes 4 // (200 + text/event-stream → open EventSource). p8%[// HEAD pre-flight from EventSource open. Standard HTTP requires // HEAD to return the same headers as GET would, with no bodAy. // We've already set them above; just acknowledge and returnJ*,&. r6%N&,&5ql#x =:w "r&xU5.qframedA#framed = append(framed, '\n', '\n')O" framed) } } @B@x@Q: t+Fif c.channel != eventType {Lbody#y/'.*x!oh)s3,".rest?.V Q gmx ;? 1u@uAc x=7 Aw A1=xh^> ns Xx=0 > >wyx$;1Q/ n.  /.  P. v hx&100644 docker.yml{92j؉8b8 dxn<37.45 h1:uGK0y4+aLipE/M0YIQ5hcsWv0ZG0E4cPv03a94K/eLE!?; 97.45/go.mod h1:GnAkhQ7HNs3X0Tzx5nOONS3kl0yRmWHbDcRO5ffILs:;>@,Ak0n x<oC,4x` LARC runner pool. arm64 via QEMU until a # native arm64 runner joins the poolB1luxx]C oxz amd64-only.Ywill be added back # once a native arm64 scale-set is provisioned (CLAUDE.md: no QEMU). #"*ʦx&100644 docker.yml3+ 뫜ʳXiÊ]5 xBNchas inconsistent cachingxM^Regenerate go.sum from the # proxy state we actually see at build time and skip sum.golang.orgA  GOSUMDB=off go mod download RUNV W FBxH100644 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"1k-x $>x0100644 scheduled_tasks.lockSg իFit)xZ{"sessionId":"cf4e8ffa-52d2-4e07-b22c-dbf44cba2479","pid":5284,"acquiredAt":1778041169393}g x( 7xH100644 ci.yml5T[jx6100644 docker.yml3+ 뫜ʳXiÊPjKx Nomx5$1f5x/`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: $'HPxVQs8~أһ@N˄0 S9CzFb,זMf~aɭd;i2h%}vowAmWb8 K_B_l݅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~Dx$# 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" ׉j x(eni^fZfjD/&3N1(LfFJs(ZLNUa22Rŕy Q12dJs|=}}̢̼.M.5 $`5x];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+}BxmUoDVZii6ն^ui mTMV{XuxGn#qp]\s&˲/hŜrL !Y )a۩ ͈"!NODaCтA0.opB;$Ra仰sxrxz cĹ HkYY(\K-NffG k5Gml$2bfRhzNf!?)F﫴(\cbp)O۬mfvC(d}v#+%DǭT)}CK+O~onNNU1 Ǧf 720~QS/ՐAQ[սjG560@i5b#=KtExr+ȥrrjV5!?[`/D$ۅE՟셼 ѷ-";JrnzJJE'QƆswdBNq*N숎 Ij8`DxN~7@d׃ 7;ᡠhy[^@I/х.,?]<Ԅ gWB{[^޸^z oogp;/#EuvS+ G .^>S-̩H9&fnRkAW<>1jL}i A_ 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 Xx,lux:lux'lux( lux-build<"vox$40000 workflows 9[zǗ>LBtrEx;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<0ex{E3K2J"z_v]\vUu 7*20qI*qZʱ&o?Ax$40000 workflows[LdC2B_XNx%100644 build.ymlt͑Ӱ.W[lc5x{eC<[#[KjHHmSŌxnxUJAEK (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)Ox]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Ǫ