Cyberyen Explorer

Block explorer for the Cyberyen blockchain — indexer, API, and static web UI.

Repository: cykuza/explorer.

Run locally

Prerequisites: uv (Python 3.14), pnpm 11+, Node.js 24 LTS, Docker Compose.

cp .env.example .env
docker compose -f deploy/compose.dev.yml up -d

Starts a Cyberyen Core regtest node and PostgreSQL 18. Regtest RPC credentials are throwaway dev / dev.

cd backend && uv sync && uv run pytest
cd ../web && pnpm install && pnpm next build

See .env.example for configuration.

Development

Start Postgres + regtest node, then the API (port 8080):

docker compose -f deploy/compose.dev.yml --profile api up -d

Run the web UI (dev server proxies /api/* and /healthz to 127.0.0.1:8080, and pretty entity URLs to shell pages):

cd web
pnpm install
pnpm dev

NEXT_PUBLIC_NETWORKS is a comma-separated list (first entry is the default network at root paths). When unset, it defaults to regtest.

Regenerate TypeScript types from the live OpenAPI document (API must be up):

cd web && pnpm gen:api

Typecheck / production static export:

cd web && pnpm typecheck && pnpm build

Deploy notes (nginx rewrite map for shell pages): deploy/README.md.

Documentation

Operator and developer notes: docs/.

Contributing

See CONTRIBUTING.md. Issues and pull requests are welcome.