feat: explorer API, wallet, CCIP scripts, and config refresh
- Backend REST/gateway/track routes, analytics, Blockscout proxy paths. - Frontend wallet and liquidity surfaces; MetaMask token list alignment. - Deployment docs, verification scripts, address inventory updates. Check: go build ./... under backend/ (pass). Made-with: Cursor
This commit is contained in:
@@ -26,9 +26,9 @@ cd backend
|
||||
|
||||
### Required
|
||||
- `DB_HOST` - PostgreSQL host (default: localhost)
|
||||
- `DB_USER` - Database user (default: explorer)
|
||||
- `DB_USER` - Database user (default: explorer; use `blockscout` for the shared Blockscout DB mode)
|
||||
- `DB_PASSWORD` - Database password (default: changeme)
|
||||
- `DB_NAME` - Database name (default: explorer)
|
||||
- `DB_NAME` - Database name (default: explorer; use `blockscout` for the shared Blockscout DB mode)
|
||||
|
||||
### Recommended (Production)
|
||||
- `JWT_SECRET` - Strong random secret for JWT signing (required for production)
|
||||
@@ -38,17 +38,18 @@ cd backend
|
||||
|
||||
## Database Migration
|
||||
|
||||
Run the Track 2-4 schema migration:
|
||||
Run the migration helper:
|
||||
|
||||
```bash
|
||||
bash scripts/run-migration-0010.sh
|
||||
```
|
||||
|
||||
This creates:
|
||||
- Track 2 tables: `addresses`, `token_transfers`, `token_balances`, `internal_transactions`
|
||||
- Track 3 tables: `analytics_flows`, `analytics_bridge_history`, `token_distribution` (materialized view)
|
||||
- Track 4 tables: `operator_events`, `operator_ip_whitelist`, `operator_roles`
|
||||
- Auth table: `wallet_nonces`
|
||||
The helper auto-detects the database layout:
|
||||
|
||||
- **Standalone explorer DB**: creates the full Track 2-4 schema
|
||||
- **Shared Blockscout DB**: creates only `operator_events`, `operator_ip_whitelist`, `operator_roles`, and `wallet_nonces`
|
||||
|
||||
Do **not** apply `backend/database/migrations/0010_track_schema.up.sql` directly to the shared Blockscout DB.
|
||||
|
||||
## User Management
|
||||
|
||||
@@ -152,11 +153,13 @@ The indexers will:
|
||||
### Migration Fails
|
||||
- Check database connection: `psql -h $DB_HOST -U $DB_USER -d $DB_NAME -c "SELECT 1"`
|
||||
- Verify user has CREATE TABLE permissions
|
||||
- If you are using the shared Blockscout DB, keep `DB_USER` and `DB_NAME` aligned to `blockscout`
|
||||
|
||||
### Authentication Fails
|
||||
- Check JWT_SECRET is set
|
||||
- Verify wallet_nonces table exists
|
||||
- Check database connection in auth handlers
|
||||
- If the wallet popup shows `Nonce: undefined`, the nonce request failed before signing. Run `bash scripts/run-migration-0010.sh`, restart the backend, and retry.
|
||||
|
||||
### Track Routes Not Working
|
||||
- Verify user is approved: Check `operator_roles` table
|
||||
@@ -179,4 +182,3 @@ The indexers will:
|
||||
7. ✅ Verify feature gating
|
||||
|
||||
For detailed API documentation, see: `docs/api/track-api-contracts.md`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user