oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
aitbc/docs/explorer_web.md
oib cdaf1122c3 ``` 
chore: update genesis timestamp, fix import paths, clean compiled JS files, and adjust mock path

- Update devnet genesis timestamp to 1766400877
- Add Receipt model for zk-proof generation with receiptId, miner, coordinator fields
- Fix import paths from settings to config across service modules (access_control, audit_logging, encryption, hsm_key_manager, key_management, zk_proofs)
- Remove compiled JavaScript files from explorer-web components and lib directories
- Update mock data base path
2025-12-22 15:51:19 +01:00

2.7 KiB
Raw Blame History

Explorer Web – Task Breakdown

Status (2025-12-22)

  • Stage 1: ✅ DEPLOYED - Explorer Web successfully deployed in production at https://aitbc.bubuit.net/explorer/
    • All pages implemented with mock data integration, responsive design, and live data toggle
    • Genesis block (height 0) properly displayed
    • Mock/live data toggle functional
    • nginx proxy configured at /explorer/ route
  • Stage 2: ✅ Completed - Live mode validated against coordinator endpoints with Playwright e2e tests.

Stage 1 (MVP) - COMPLETED

  • Structure & Assets

    • ✅ Populate apps/explorer-web/public/ with index.html and all page scaffolds.
    • ✅ Add base stylesheets (public/css/base.css, public/css/layout.css, public/css/theme.css).
    • ✅ Include logo and icon assets under public/assets/.

  • TypeScript Modules

    • ✅ Provide configuration and data helpers (src/config.ts, src/lib/mockData.ts, src/lib/models.ts).
    • ✅ Add shared store/utilities module for cross-page state.
    • ✅ Implement core page controllers and components under src/pages/ and src/components/ (overview, blocks, transactions, addresses, receipts, header/footer, data mode toggle).

  • Mock Data

    • ✅ Provide mock JSON fixtures under public/mock/.
    • ✅ Enable mock/live mode toggle via getDataMode() and <data-mode-toggle> components.

  • Interaction & UX

    • ✅ Implement search box detection for block numbers, hashes, and addresses.
    • ✅ Add pagination or infinite scroll for block and transaction tables.
    • ✅ Expand responsive polish beyond overview cards (tablet/mobile grid, table hover states).

  • Live Mode Integration

    • ✅ Hit live coordinator endpoints (/v1/blocks, /v1/transactions, /v1/addresses, /v1/receipts) via getDataMode() === "live".
    • ✅ Add fallbacks + error surfacing for partial/failed live responses.
    • ✅ Implement Playwright e2e tests for live mode functionality.

  • Documentation

    • ✅ Update apps/explorer-web/README.md with build/run instructions and API assumptions.
    • ✅ Capture coordinator API + CORS considerations in README deployment notes.

Production Deployment Details

  • Container: Incus container 'aitbc' at /var/www/aitbc.bubuit.net/explorer/
  • Build: Vite + TypeScript build process
  • Port: Static files served by nginx
  • Access: https://aitbc.bubuit.net/explorer/
  • Features: Genesis block display, mock/live toggle, responsive design
  • Mock Data: Blocks.json with proper {items: [...]} structure

Stage 2+ - IN PROGRESS

  • 🔄 Integrate WebSocket streams for live head and mempool updates.
  • 🔄 Add token balances and ABI decoding when supported by blockchain node.
  • 🔄 Provide export-to-CSV functionality and light/dark theme toggle.