Skip to content

Commit aff75d6

Browse files
JOYclaude
andcommitted
docs: Add DOScan architecture, changelog, and features documentation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 1983dc1 commit aff75d6

3 files changed

Lines changed: 834 additions & 0 deletions

File tree

docs/CHANGELOG.md

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# DOScan Changelog
2+
3+
All notable changes to DOScan (DOS Chain Block Explorer) are documented in this file.
4+
5+
---
6+
7+
## [2026-02-01] - Testnet Feature Expansion
8+
9+
### Added
10+
11+
#### Frontend Features
12+
- **User Operations Page** (`/ops`) - ERC-4337 Account Abstraction support
13+
- Integrated with `user-ops-indexer` microservice
14+
- API endpoint: `https://test-ops.doscan.io`
15+
16+
- **Homepage Stats Widget** - Display key blockchain metrics on homepage
17+
- `total_blocks`, `average_block_time`, `total_txs`, `wallet_addresses`, `gas_tracker`
18+
19+
- **Get Gas Button** - Link to DOS Faucet for testnet tokens
20+
- URL: `https://faucet.doschain.com?address={address}`
21+
22+
#### Backend Features
23+
- **Account Abstraction Microservice** - Backend support for ERC-4337
24+
- `MICROSERVICE_ACCOUNT_ABSTRACTION_ENABLED=true`
25+
- URL: `http://host.docker.internal:8090/`
26+
27+
- **Admin Panel** - Backend administration interface
28+
- `ADMIN_PANEL_ENABLED=true`
29+
30+
- **GraphQL API** - GraphQL endpoint for queries
31+
- `API_GRAPHQL_ENABLED=true`
32+
33+
- **Sourcify Integration** - Alternative contract verification
34+
- `SOURCIFY_INTEGRATION_ENABLED=true`
35+
- Server: `https://sourcify.dev/server`
36+
37+
#### Infrastructure
38+
- **test-stats.doscan.io** - Dedicated stats API for testnet
39+
- Port: 8052
40+
- Container: `test-stats`
41+
- Database: testnet blockscout DB (port 7432)
42+
43+
- **test-ops.doscan.io** - User Ops API endpoint
44+
- Port: 8090
45+
- Container: `user-ops-indexer`
46+
47+
### Changed
48+
- Updated `NEXT_PUBLIC_STATS_API_HOST` from `stats-beta.doscan.io` to `test-stats.doscan.io`
49+
- Added `ops` route to nginx frontend regex for proper routing
50+
51+
### Fixed
52+
- Fixed User Ops page 404 error by adding route to nginx config
53+
- Fixed frontend env syntax error for `NEXT_PUBLIC_HOMEPAGE_STATS`
54+
55+
---
56+
57+
## [2026-01-31] - User Ops Indexer Deployment
58+
59+
### Added
60+
- Deployed `user-ops-indexer` container for ERC-4337 support
61+
- Created nginx config for `test-ops.doscan.io`
62+
- Added CORS headers for cross-origin API access
63+
64+
### Configuration
65+
```yaml
66+
USER_OPS_INDEXER__INDEXER__RPC_URL: http://10.0.0.4:9650/ext/bc/.../rpc
67+
USER_OPS_INDEXER__INDEXER__ENTRYPOINTS__V08: "true"
68+
USER_OPS_INDEXER__INDEXER__ENTRYPOINTS__V08_ENTRY_POINT: "0x433709009B8330FDa32311DF1C2AFA402eD8D009"
69+
USER_OPS_INDEXER__DATABASE__CONNECT__URL: postgresql://postgres:@host.docker.internal:7432/blockscout
70+
```
71+
72+
---
73+
74+
## [2026-01-30] - Testnet Explorer Launch
75+
76+
### Added
77+
- Full Blockscout deployment for DOS Chain Testnet
78+
- Frontend v2.6.0 (latest)
79+
- Backend v9.0.2
80+
81+
### Services Deployed
82+
- Frontend (`ghcr.io/blockscout/frontend:latest`)
83+
- Backend (`blockscout/blockscout:latest`)
84+
- PostgreSQL 15
85+
- Redis
86+
- Smart Contract Verifier
87+
- Visualizer (Sol2UML)
88+
- Sig Provider
89+
90+
### Domains Configured
91+
- `test.doscan.io` - Main explorer
92+
- `test-api.doscan.io` - API endpoint
93+
- `viz-beta.doscan.io` - Visualizer
94+
- `stats-beta.doscan.io` - Stats (legacy)
95+
96+
---
97+
98+
## [2026-01-23] - Initial Setup
99+
100+
### Added
101+
- Initial DOScan project structure
102+
- Docker Compose configuration for testnet
103+
- Environment variable templates
104+
105+
### Network Configuration
106+
- Chain ID: 3939
107+
- RPC: `https://test.doschain.com`
108+
- Blockchain ID: `e4PHth8utBAPorg4sFRTaWmDfUWf9X8nAECczGx1BJVmYBv3A`
109+
110+
---
111+
112+
## Pending / Roadmap
113+
114+
### Mainnet Deployment
115+
- [ ] Deploy to mainnet (Chain ID: 7979)
116+
- [ ] Configure `doscan.io` domain
117+
- [ ] Set up production database
118+
119+
### Features to Enable
120+
- [ ] Validators List (requires custom implementation for Avalanche L1)
121+
- [ ] My Account full integration with Auth0
122+
- [ ] Export to CSV feature
123+
- [ ] Public tag submission
124+
125+
### Infrastructure
126+
- [ ] Set up monitoring (Prometheus/Grafana)
127+
- [ ] Configure automated backups
128+
- [ ] Set up CI/CD pipeline
129+
130+
---
131+
132+
## Version History
133+
134+
| Date | Frontend | Backend | Notes |
135+
|------|----------|---------|-------|
136+
| 2026-02-01 | latest | latest | Feature expansion |
137+
| 2026-01-30 | v2.6.0 | v9.0.2 | Initial testnet launch |

0 commit comments

Comments
 (0)