Devin
40c9af678f
Before: 335 tracked .md files; top level had 14 README-like docs; docs/ contained ~234 files, most of them auto/LLM-generated status reports (ALL_*_COMPLETE*, *_FIX*, DEPLOYMENT_*_FINAL*, etc.). After: 132 tracked .md files. Repo now has exactly five top-level docs: README.md, QUICKSTART.md, RUNBOOK.md, CONTRIBUTING.md, CHANGELOG.md (moved up from docs/). Keeper philosophy in docs/: - API, CCIP (ops + security + receiver/router refs), Chainlist refs, compliance, deployment (guides not status), database connection, legal compliance, metamask integration, production checklist, tiered-architecture implementation/setup, reusable-components plan, token-mechanism doc, wrap-and-bridge operational reference, plus docs/specs/** and docs/api/ / docs/openapi/ trees. Deleted (git history preserves provenance): - All 'ALL_*_COMPLETE*' / '*_FIX*' / '*_FIXED*' / '*_FINAL*' / '*_STATUS*' / '*_PROGRESS*' / '*_SUMMARY*' files. - BLOCKSCOUT_*_FIX / _CRASH / _INITIALIZATION / _SCHEMA / _YAML / _SKIP / _NEXT_STEPS / _START_AND_BUILD / _DATABASE_CREDENTIALS (the last contained passwords). - CCIP_IMPLEMENTATION_* / CCIP_CURRENT_STATUS / CCIP_GAP_* (gap analyses are not a sustained reference). - NPMPLUS_CREDENTIALS_GUIDE.md (contained creds). - LETSENCRYPT_CONFIGURATION_GUIDE.md (contained creds; will be re-introduced as runbook content post-secrets-scrub). - docs/diagnostic-reports/, docs/feature-flags/ (run-time artifacts). README.md: dead links (START_HERE, README_DEPLOYMENT, COMPLETE_DEPLOYMENT, DEPLOYMENT_COMPLETE_FINAL) replaced with links to the five canonical top-level docs + docs/ index.
Explorer Monorepo – Documentation
Overview of documentation for the ChainID 138 Explorer (SolaceScan).
Entry points
| Doc | Description |
|---|---|
| INDEX.md | Full documentation index (bridge, setup, verification, operations) |
| EXPLORER_API_ACCESS.md | API access, 502 fix, CSP, frontend deploy for https://blockscout.defi-oracle.io |
| ../README.md | Project README: quick start, frontend, architecture, config |
Frontend
| Doc | Description |
|---|---|
| ../frontend/FRONTEND_REVIEW.md | Frontend code review (Next app + legacy SPA) |
| ../frontend/FRONTEND_TASKS_AND_REVIEW.md | Task list C1–L4 and detail review |
Deploy the current Next standalone frontend (VMID 5000):
./scripts/deploy-next-frontend-to-vmid5000.sh
Nginx should preserve /api, /api/config/*, /explorer-api/*, /token-aggregation/api/v1/*, /snap/, and /health, then proxy / and /_next/ using deployment/common/nginx-next-frontend-proxy.conf.
Legacy static SPA compatibility assets:
The historical static SPA (frontend/public/index.html +
frontend/public/explorer-spa.js) remains in-repo for compatibility and audit
reference only. The old static deploy scripts are deprecated shims and are not
supported deployment targets.
Full explorer/API fix (Blockscout + nginx + frontend):
./scripts/complete-explorer-api-access.sh
Deployment
| Doc | Description |
|---|---|
| ../README_DEPLOYMENT.md | Deployment quick reference |
| ../deployment/DEPLOYMENT_GUIDE.md | Full LXC + Nginx + Cloudflare deployment guide |
| ../QUICKSTART.md | Quick start (deps, infra, dev services) |
Other
- Bridge / WETH: See INDEX.md for bridge setup, verification, and operations.
- Specs: specs/ for infrastructure and multichain specs.
- CCIP, Blockscout, etc.: See files in this directory and the repo root.
Last updated: 2026-04-11