66 lines
2.3 KiB
Markdown
66 lines
2.3 KiB
Markdown
# Explorer Monorepo – Documentation
|
||
|
||
Overview of documentation for the ChainID 138 Explorer (SolaceScan).
|
||
|
||
---
|
||
|
||
## Entry points
|
||
|
||
| Doc | Description |
|
||
|-----|-------------|
|
||
| **[INDEX.md](./INDEX.md)** | Full documentation index (bridge, setup, verification, operations) |
|
||
| **[EXPLORER_API_ACCESS.md](./EXPLORER_API_ACCESS.md)** | API access, 502 fix, CSP, frontend deploy for https://blockscout.defi-oracle.io |
|
||
| **[../README.md](../README.md)** | Project README: quick start, frontend, architecture, config |
|
||
|
||
---
|
||
|
||
## Frontend
|
||
|
||
| Doc | Description |
|
||
|-----|-------------|
|
||
| **[../frontend/FRONTEND_REVIEW.md](../frontend/FRONTEND_REVIEW.md)** | Frontend code review (Next app + legacy SPA) |
|
||
| **[../frontend/FRONTEND_TASKS_AND_REVIEW.md](../frontend/FRONTEND_TASKS_AND_REVIEW.md)** | Task list C1–L4 and detail review |
|
||
|
||
**Deploy the current Next standalone frontend (VMID 5000):**
|
||
|
||
```bash
|
||
./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](/home/intlc/projects/proxmox/explorer-monorepo/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):**
|
||
|
||
```bash
|
||
./scripts/complete-explorer-api-access.sh
|
||
```
|
||
|
||
---
|
||
|
||
## Deployment
|
||
|
||
| Doc | Description |
|
||
|-----|-------------|
|
||
| **[../README_DEPLOYMENT.md](../README_DEPLOYMENT.md)** | Deployment quick reference |
|
||
| **[../deployment/DEPLOYMENT_GUIDE.md](../deployment/DEPLOYMENT_GUIDE.md)** | Full LXC + Nginx + Cloudflare deployment guide |
|
||
| **[../QUICKSTART.md](../QUICKSTART.md)** | Quick start (deps, infra, dev services) |
|
||
|
||
---
|
||
|
||
## Other
|
||
|
||
- **Bridge / WETH:** See [INDEX.md](./INDEX.md) for bridge setup, verification, and operations.
|
||
- **Specs:** [specs/](./specs/) for infrastructure and multichain specs.
|
||
- **CCIP, Blockscout, etc.:** See files in this directory and the repo root.
|
||
|
||
---
|
||
|
||
*Last updated: 2026-04-11*
|