docs/REMAINING_TASKS.md

# Remaining Tasks — All Projects

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Master list of next steps:** For a single consolidated list (immediate, phases, containers, codebase, optional, maintenance), see **[00-meta/NEXT_STEPS_MASTER.md](00-meta/NEXT_STEPS_MASTER.md)**.

**Date:** 2026-01-30  
**Status:** ✅ **ALL TASKS COMPLETE** — See [ALL_TASKS_COMPLETE.md](archive/root-status-reports/ALL_TASKS_COMPLETE.md) for full report

---

## ✅ Recently Completed

### MetaMask Integration (2026-01-30)
- ✅ All 4 phases deployed to VMID 5000 (explorer.d-bis.org)
- ✅ Backend API serving `/api/config/networks` and `/api/config/token-list`
- ✅ Wallet page at `/wallet` for adding chains to MetaMask
- ✅ Integration tests passing (5 passed, 0 failed)

### SolaceScanScout Explorer (2026-01-30)
- ✅ Fixed RPC connectivity (updated from destroyed VMID 2500 to VMID 2201)
- ✅ Explorer now syncing in real-time (block 1,581,090+)
- ✅ Navigation bar reviewed and documented

---

## 🔄 Optional/Enhancement Tasks

### 1. MetaMask Integration Enhancements

| # | Task | Priority | Effort | Notes |
|---|------|----------|--------|-------|
| 12 | **Token-aggregation service deployment** | Medium | 2-3 hours | Deploy with DB for market data API (prices, volume, OHLCV) |
| 13 | **Chain 138 Snap - Market data/pricing** | Low | 4-6 hours | Integrate token-aggregation API into Snap UI |
| 14 | **Chain 138 Snap - Swap flow** | Low | 8-12 hours | Add quote API integration for swaps |
| 15 | **Chain 138 Snap - Bridge flow** | Low | 8-12 hours | Expose CCIP bridge routes in Snap |
| 16 | **Chain 138 Snap - Testing & distribution** | Low | 2-4 hours | Test in Flask, submit to Snap directory |
| 17 | **CoinGecko submission** | Low | 1-2 hours | Submit Chain 138 for native USD prices in MetaMask |
| 18 | **Consensys outreach** | Low | 1 hour | Request native Swaps/Bridge support |
| 19 | **Paymaster deployment** | Low | 2-3 hours | For Smart Accounts gas abstraction |

**Documentation:**
- [ALL_NEXT_STEPS.md](04-configuration/metamask/ALL_NEXT_STEPS.md)
- [SNAP_IMPLEMENTATION_ROADMAP.md](04-configuration/metamask/SNAP_IMPLEMENTATION_ROADMAP.md)
- [Token-aggregation REST_API_REFERENCE.md](../smom-dbis-138/services/token-aggregation/docs/REST_API_REFERENCE.md)

---

### 2. SolaceScanScout Explorer UI Enhancements

| # | Task | Priority | Effort | Notes |
|---|------|----------|--------|-------|
| 20 | **Add "Wallet" link to navbar** | Low | 15 min | Link to `/wallet` in live explorer HTML |
| 21 | **Add sync status indicator** | Low | 1 hour | Show "Synced" with latest block number |
| 22 | **Add network selector** | Low | 2-3 hours | Future: switch between Chain 138/Mainnet/ALL |
| 23 | **Add dark mode toggle** | Low | 2-3 hours | UX enhancement |

**Documentation:**
- [SOLACESCANSCOUT_REVIEW.md](04-configuration/SOLACESCANSCOUT_REVIEW.md)

---

### 3. Token-Aggregation Service

| # | Task | Priority | Effort | Notes |
|---|------|----------|--------|-------|
| 24 | **Deploy to production** | Medium | 2-3 hours | Requires PostgreSQL DB, env configuration |
| 25 | **Configure external API keys** | Medium | 30 min | CoinGecko, CMC, DexScreener for enrichment |
| 26 | **Set up monitoring** | Low | 1-2 hours | Health checks, error alerts |
| 27 | **Add authentication** | Low | 2-3 hours | JWT/API key auth for admin endpoints |

**Location:** `smom-dbis-138/services/token-aggregation/`  
**Status:** Built and tested locally, not deployed

---

### 4. Chain 138 Snap

| # | Task | Priority | Effort | Notes |
|---|------|----------|--------|-------|
| 28 | **Test in MetaMask Flask** | Low | 1 hour | Manual E2E testing |
| 29 | **Add UI for market data** | Low | 4-6 hours | Display prices, charts in Snap |
| 30 | **Implement swap quotes** | Low | 8-12 hours | Integrate DEX aggregator |
| 31 | **Implement bridge routes** | Low | 8-12 hours | CCIP + custom bridge integration |
| 32 | **Submit to Snap directory** | Low | 2-3 hours | MetaMask Snap marketplace listing |

**Location:** `metamask-integration/chain138-snap/`  
**Status:** Scaffolded and built, not published

---

## 📋 Maintenance Tasks

### Ongoing Monitoring

| # | Task | Frequency | Notes |
|---|------|-----------|-------|
| 33 | **Monitor explorer sync status** | Daily | Ensure Blockscout stays synced |
| 34 | **Monitor RPC node health** | Daily | Check VMID 2201 (192.168.11.221) uptime |
| 35 | **Check config API uptime** | Weekly | Verify `/api/config/*` endpoints |
| 36 | **Review explorer logs** | Weekly | Check for errors in Blockscout |
| 37 | **Update token list** | As needed | Add new tokens to `DUAL_CHAIN_TOKEN_LIST.tokenlist.json` |

---

## 🎯 Quick Wins (< 1 hour)

1. **Add Wallet link to explorer navbar** (15 min)
   - **Runbook:** [EXPLORER_WALLET_LINK_QUICK_WIN.md](04-configuration/EXPLORER_WALLET_LINK_QUICK_WIN.md) — options for Blockscout frontend, static HTML, and one-liner.
   - SSH to explorer VM (e.g. VMID 5000). Edit the main page or Blockscout nav template; add `<a href="/wallet">Wallet</a>` in the nav. Save and reload https://explorer.d-bis.org.

2. **CoinGecko submission** (1 hour)
   - Follow guide: `docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md`
   - Submit Chain 138 and major tokens

3. **Consensys outreach** (1 hour)
   - Use package: `metamask-integration/docs/CONSENSYS_OUTREACH_PACKAGE.md`
   - Email Consensys BD team

4. **Test Snap in Flask** (1 hour)
   - Run `cd metamask-integration/chain138-snap && pnpm run start`
   - Install in MetaMask Flask
   - Test RPC methods

---

## 📊 Priority Matrix

### High Priority (Do First)
- None currently (all critical items completed)

### Medium Priority (Next Sprint)
- Token-aggregation service deployment
- Configure external API keys for enrichment

### Low Priority (Backlog)
- Snap enhancements (market data, swaps, bridge)
- Explorer UI improvements (dark mode, network selector)
- CoinGecko/Consensys submissions

---

## 🔗 Key Documentation

- **MetaMask Integration:** [PHASES_1-4_COMPLETE.md](04-configuration/metamask/PHASES_1-4_COMPLETE.md)
- **Deployment Details:** [DEPLOYMENT_COMPLETE_VMID5000.md](04-configuration/metamask/DEPLOYMENT_COMPLETE_VMID5000.md)
- **Explorer Review:** [SOLACESCANSCOUT_REVIEW.md](04-configuration/SOLACESCANSCOUT_REVIEW.md)
- **All Next Steps:** [ALL_NEXT_STEPS.md](04-configuration/metamask/ALL_NEXT_STEPS.md)

---

## 📝 Notes

- **Package manager:** All projects use `pnpm` as default
- **Explorer:** Now syncing in real-time at https://explorer.d-bis.org
- **Wallet page:** Live at https://explorer.d-bis.org/wallet
- **Config APIs:** Live at https://explorer.d-bis.org/api/config/*

**Last updated:** 2026-01-30
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates - ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com> 2026-02-12 15:46:57 -08:00			`# Remaining Tasks — All Projects`

			`Last Updated: 2026-01-31`
			`Document Version: 1.0`
			`Status: Active Documentation`

			`---`

			`Master list of next steps: For a single consolidated list (immediate, phases, containers, codebase, optional, maintenance), see [00-meta/NEXT_STEPS_MASTER.md](00-meta/NEXT_STEPS_MASTER.md).`

			`Date: 2026-01-30`
Sync all local changes: docs, config, scripts, submodule refs, verification evidence Co-authored-by: Cursor <cursoragent@cursor.com> 2026-02-21 15:46:06 -08:00			`Status: ✅ ALL TASKS COMPLETE — See [ALL_TASKS_COMPLETE.md](archive/root-status-reports/ALL_TASKS_COMPLETE.md) for full report`
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates - ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com> 2026-02-12 15:46:57 -08:00
			`---`

			`## ✅ Recently Completed`

			`### MetaMask Integration (2026-01-30)`
			`- ✅ All 4 phases deployed to VMID 5000 (explorer.d-bis.org)`
			- ✅ Backend API serving `/api/config/networks` and `/api/config/token-list`
			- ✅ Wallet page at `/wallet` for adding chains to MetaMask
			`- ✅ Integration tests passing (5 passed, 0 failed)`

			`### SolaceScanScout Explorer (2026-01-30)`
			`- ✅ Fixed RPC connectivity (updated from destroyed VMID 2500 to VMID 2201)`
			`- ✅ Explorer now syncing in real-time (block 1,581,090+)`
			`- ✅ Navigation bar reviewed and documented`

			`---`

			`## 🔄 Optional/Enhancement Tasks`

			`### 1. MetaMask Integration Enhancements`

			`\| # \| Task \| Priority \| Effort \| Notes \|`
			`\|---\|------\|----------\|--------\|-------\|`
			`\| 12 \| Token-aggregation service deployment \| Medium \| 2-3 hours \| Deploy with DB for market data API (prices, volume, OHLCV) \|`
			`\| 13 \| Chain 138 Snap - Market data/pricing \| Low \| 4-6 hours \| Integrate token-aggregation API into Snap UI \|`
			`\| 14 \| Chain 138 Snap - Swap flow \| Low \| 8-12 hours \| Add quote API integration for swaps \|`
			`\| 15 \| Chain 138 Snap - Bridge flow \| Low \| 8-12 hours \| Expose CCIP bridge routes in Snap \|`
			`\| 16 \| Chain 138 Snap - Testing & distribution \| Low \| 2-4 hours \| Test in Flask, submit to Snap directory \|`
			`\| 17 \| CoinGecko submission \| Low \| 1-2 hours \| Submit Chain 138 for native USD prices in MetaMask \|`
			`\| 18 \| Consensys outreach \| Low \| 1 hour \| Request native Swaps/Bridge support \|`
			`\| 19 \| Paymaster deployment \| Low \| 2-3 hours \| For Smart Accounts gas abstraction \|`

			`Documentation:`
			`- [ALL_NEXT_STEPS.md](04-configuration/metamask/ALL_NEXT_STEPS.md)`
			`- [SNAP_IMPLEMENTATION_ROADMAP.md](04-configuration/metamask/SNAP_IMPLEMENTATION_ROADMAP.md)`
			`- [Token-aggregation REST_API_REFERENCE.md](../smom-dbis-138/services/token-aggregation/docs/REST_API_REFERENCE.md)`

			`---`

			`### 2. SolaceScanScout Explorer UI Enhancements`

			`\| # \| Task \| Priority \| Effort \| Notes \|`
			`\|---\|------\|----------\|--------\|-------\|`
			\| 20 \| Add "Wallet" link to navbar \| Low \| 15 min \| Link to `/wallet` in live explorer HTML \|
			`\| 21 \| Add sync status indicator \| Low \| 1 hour \| Show "Synced" with latest block number \|`
			`\| 22 \| Add network selector \| Low \| 2-3 hours \| Future: switch between Chain 138/Mainnet/ALL \|`
			`\| 23 \| Add dark mode toggle \| Low \| 2-3 hours \| UX enhancement \|`

			`Documentation:`
			`- [SOLACESCANSCOUT_REVIEW.md](04-configuration/SOLACESCANSCOUT_REVIEW.md)`

			`---`

			`### 3. Token-Aggregation Service`

			`\| # \| Task \| Priority \| Effort \| Notes \|`
			`\|---\|------\|----------\|--------\|-------\|`
			`\| 24 \| Deploy to production \| Medium \| 2-3 hours \| Requires PostgreSQL DB, env configuration \|`
			`\| 25 \| Configure external API keys \| Medium \| 30 min \| CoinGecko, CMC, DexScreener for enrichment \|`
			`\| 26 \| Set up monitoring \| Low \| 1-2 hours \| Health checks, error alerts \|`
			`\| 27 \| Add authentication \| Low \| 2-3 hours \| JWT/API key auth for admin endpoints \|`

			Location: `smom-dbis-138/services/token-aggregation/`
			`Status: Built and tested locally, not deployed`

			`---`

			`### 4. Chain 138 Snap`

			`\| # \| Task \| Priority \| Effort \| Notes \|`
			`\|---\|------\|----------\|--------\|-------\|`
			`\| 28 \| Test in MetaMask Flask \| Low \| 1 hour \| Manual E2E testing \|`
			`\| 29 \| Add UI for market data \| Low \| 4-6 hours \| Display prices, charts in Snap \|`
			`\| 30 \| Implement swap quotes \| Low \| 8-12 hours \| Integrate DEX aggregator \|`
			`\| 31 \| Implement bridge routes \| Low \| 8-12 hours \| CCIP + custom bridge integration \|`
			`\| 32 \| Submit to Snap directory \| Low \| 2-3 hours \| MetaMask Snap marketplace listing \|`

			Location: `metamask-integration/chain138-snap/`
			`Status: Scaffolded and built, not published`

			`---`

			`## 📋 Maintenance Tasks`

			`### Ongoing Monitoring`

			`\| # \| Task \| Frequency \| Notes \|`
			`\|---\|------\|-----------\|-------\|`
			`\| 33 \| Monitor explorer sync status \| Daily \| Ensure Blockscout stays synced \|`
			`\| 34 \| Monitor RPC node health \| Daily \| Check VMID 2201 (192.168.11.221) uptime \|`
			\| 35 \| Check config API uptime \| Weekly \| Verify `/api/config/*` endpoints \|
			`\| 36 \| Review explorer logs \| Weekly \| Check for errors in Blockscout \|`
			\| 37 \| Update token list \| As needed \| Add new tokens to `DUAL_CHAIN_TOKEN_LIST.tokenlist.json` \|

			`---`

			`## 🎯 Quick Wins (< 1 hour)`

			`1. Add Wallet link to explorer navbar (15 min)`
chore: update submodule references and documentation - Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes. - Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions. - Enhanced the README and various index files to provide clearer navigation and task completion guidance. Made-with: Cursor 2026-03-04 02:03:08 -08:00			`- Runbook: [EXPLORER_WALLET_LINK_QUICK_WIN.md](04-configuration/EXPLORER_WALLET_LINK_QUICK_WIN.md) — options for Blockscout frontend, static HTML, and one-liner.`
			- SSH to explorer VM (e.g. VMID 5000). Edit the main page or Blockscout nav template; add `<a href="/wallet">Wallet</a>` in the nav. Save and reload https://explorer.d-bis.org.
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates - ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com> 2026-02-12 15:46:57 -08:00
			`2. CoinGecko submission (1 hour)`
			- Follow guide: `docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md`
			`- Submit Chain 138 and major tokens`

			`3. Consensys outreach (1 hour)`
			- Use package: `metamask-integration/docs/CONSENSYS_OUTREACH_PACKAGE.md`
			`- Email Consensys BD team`

			`4. Test Snap in Flask (1 hour)`
			- Run `cd metamask-integration/chain138-snap && pnpm run start`
			`- Install in MetaMask Flask`
			`- Test RPC methods`

			`---`

			`## 📊 Priority Matrix`

			`### High Priority (Do First)`
			`- None currently (all critical items completed)`

			`### Medium Priority (Next Sprint)`
			`- Token-aggregation service deployment`
			`- Configure external API keys for enrichment`

			`### Low Priority (Backlog)`
			`- Snap enhancements (market data, swaps, bridge)`
			`- Explorer UI improvements (dark mode, network selector)`
			`- CoinGecko/Consensys submissions`

			`---`

			`## 🔗 Key Documentation`

			`- MetaMask Integration: [PHASES_1-4_COMPLETE.md](04-configuration/metamask/PHASES_1-4_COMPLETE.md)`
			`- Deployment Details: [DEPLOYMENT_COMPLETE_VMID5000.md](04-configuration/metamask/DEPLOYMENT_COMPLETE_VMID5000.md)`
			`- Explorer Review: [SOLACESCANSCOUT_REVIEW.md](04-configuration/SOLACESCANSCOUT_REVIEW.md)`
			`- All Next Steps: [ALL_NEXT_STEPS.md](04-configuration/metamask/ALL_NEXT_STEPS.md)`

			`---`

			`## 📝 Notes`

			- Package manager: All projects use `pnpm` as default
			`- Explorer: Now syncing in real-time at https://explorer.d-bis.org`
			`- Wallet page: Live at https://explorer.d-bis.org/wallet`
			`- Config APIs: Live at https://explorer.d-bis.org/api/config/*`

			`Last updated: 2026-01-30`