feat(portal): wire Solace portal (all 7 pages) to live Chain-138 RPC + SolaceScan Explorer #2
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: d-bis/CurrenciCombo#2
Reference in New Issue
Block a user
Summary
Wire the Solace Bank Group PLC portal to real, deployed backends so it stops showing 100% static sample data. All seven portal pages (Dashboard, Accounts, Treasury, Reporting, Compliance & Risk, Settlements, Transaction Builder) now overlay live data from the two browser-reachable services on the Chain 138 estate.
https://rpc.d-bis.org(Besu/QBFT, chainId0x8a=138), read-only viaethersv6.https://api.explorer.d-bis.org/api/v2(Blockscout, CORS*).Backends that are not browser-reachable today stay explicitly labelled:
BFF required(yellow); orchestrator BFF route scaffolded on a separate branch (devin/1776587283-proxmox-bff).Mocked(grey).Scope
Pages wired
LiveNetworkPanel(block / chain ID / gas / RPC latency / explorer totals) + on-chain balance tag on custody rowsOnChainBalanceTag+ SolaceScan-linked wallet addresses on the 2 custody accountsChain-138 Blocksummary card +LiveTransactionsPanel(12 most-recent txns, polls every 15 s)On-Chain Reporting Snapshot — Chain 138card (Latest Block / Total Blocks / Total Txs / Addresses / Utilisation / Avg Block Time) above standards tabsChain-138 Gas+On-Chain Custody (META)summary cardsOn-chain AML monitor — Chain 138strip + wallet selector +On-Chain Tx FeedLiveChainBannerslim strip above the builder canvasServices / hooks / components
src/config/endpoints.ts— central config, readsVITE_CHAIN138_RPC_URL/VITE_EXPLORER_API_URL, defaults tohttps://rpc.d-bis.organdhttps://api.explorer.d-bis.org.src/services/http.ts— fetch wrapper w/ timeout, JSON parsing, typedHttpError.src/services/chain138.ts—getProvider(),getChainHealth(),getNativeBalance(),getNativeBalances(). Normalises EIP-55 checksum so hand-typed sample addresses (e.g.0x742d35Cc…bD38) don't silently drop out.src/services/explorer.ts—getExplorerStats(),getLatestTransactions(),getAddressTransactions()against Blockscout v2.src/services/proxmox.ts— mock cluster health, markedrequiresBff: true.src/services/dbisCore.ts— sample data + one-shotconsole.warn, markedmocked: true.src/hooks/useLiveChain.ts— 12 s poll of chain health + explorer stats (Promise.allSettledso one backend failing doesn't blank the other).src/hooks/useOnChainBalances.ts— 30 s poll of native balances for an array of addresses.src/hooks/useLatestTransactions.ts— 15 s poll of explorer/transactions.src/hooks/useAddressTransactions.ts— 60 s (customisable) poll of explorer/addresses/{addr}/transactions.src/components/portal/BackendStatusBar.tsx— probes each backend, renders four pills (Live/BFF required/Mocked/Degraded).src/components/portal/LiveNetworkPanel.tsx— block / chain ID / gas / RPC latency / explorer totals.src/components/portal/LiveTransactionsPanel.tsx— recent tx card (reused on Settlements).src/components/portal/OnChainBalanceTag.tsx—● live · chain 138/○ off-chain/○ fetching…tag.src/components/portal/LiveChainBanner.tsx— slim one-line banner (reused on Transaction Builder).Testing
Local Vite dev-server tests run against live
rpc.d-bis.org+api.explorer.d-bis.org.Test 1 — positive (all 7 pages) — PASS
138; Latest block ticked4,148,883 → 4,148,884 → 4,148,939across test run; gas0.00 gwei; RPC latency 164–283 ms; on-chain overlay on exactly the 2 custody rows.● live · chain 138+0.0000 METAon both custody rows; SolaceScan-linked identifier cells; no overlay on non-wallet rows.Chain-138 Block 4,148,891with5759 tx today;LiveTransactionsPanelrendered 12 tx rows with SolaceScan-linked hashes, from/to,METAvalue, relative time, status.On-Chain Reporting Snapshot — Chain 138card populated (Latest Block4,148,893 → 4,148,896during view, Total Blocks4148205, Total Txs60839, Addresses7166, Utilisation0.0%, Avg Block Time rendered).Chain-138 Gas 0.000 gwei · block 4,148,899+On-Chain Custody (META) 0.0000 · 2 custody wallets · chain 138.● live · block 4,148,900green;Tracked custody wallets: 2; selector switched to Stablecoin Reserve →On-Chain Tx Feedrendered empty state with fresh SolaceScan link (0x1a2b3c4d5e…).LiveChainBannerrenders● LIVE block 4,148,904 gas 0.0000 gwei rpc 283ms, builder canvas intact below.Test 2 — negative RPC-degrade — PASS
Restarted dev server with
VITE_CHAIN138_RPC_URL=https://rpc.d-bis.org.invalid:Chain 138 RPC · Degraded; panel values—;Error: Failed to fetch; explorer totals stayed live.○ off-chain(no balance line).— · RPC degraded, butLiveTransactionsPanelstill rendered 12 explorer-sourced rows (proves per-backend degradation).Chain-138 Gas — · RPC degraded.● degraded · Failed to fetchred.● RPC degraded · Failed to fetchred.Live, block4,148,939ticking again.Typecheck:
npx tsc --noEmitclean.Out of scope / non-goals
dbis_corewiring — no public deployment exists; all accounts/reports data stays mocked untilapi.dbis-core.d-bis.orgis live.AuthContextstill uses simulated Demo-mode wallet.devin/1776587283-proxmox-bff(separate PR #3); not deployed yet.webapp/broken gitlink — untouched by this PR.Known minor issue
Reporting page
Avg Block Timetile displays the rawaverage_block_timefrom the Blockscout/statsendpoint unchanged. Chain 138 blocks every ≈ 4 s so this is expected to read4.0s; flag for a follow-up if the displayed unit/scale is off.- Add services/{http,chain138,explorer,proxmox,dbisCore} + hooks/{useLiveChain,useOnChainBalances} - Add BackendStatusBar + LiveNetworkPanel components on DashboardPage - Overlay on-chain META balance on account rows carrying a walletAddress - Normalize EIP-55 checksum in chain138.getNativeBalance so hand-typed sample custody addresses (e.g. 0x742d35Cc...bD38) don't silently drop out of the balance map - Default RPC: https://rpc.d-bis.org (user-preferred gateway) - proxmox.ts stays mocked (CF-Access, needs BFF); dbisCore.ts stays mocked (no public deployment yet) Co-Authored-By: Nakamoto, S <[email protected]>Test execution — both Test 1 (positive) and Test 2 (negative) pass
Session: https://app.devin.ai/sessions/a33f9ebe303d413aab86e04252a1b4a1
Test plan:
review/solace-portal-test-plan.md(kept local; not committed).Local Vite preview (no CI / no deploy preview — DashboardPage POC only).
Test 1 — positive (live RPC + explorer)
All assertions in the plan pass:
Chain 138 RPC · Live(green),SolaceScan Explorer · Live(green),Proxmox API · BFF required(grey),DBIS Core Banking · Mocked(grey).LIVE(green).138(not—, not1).4,142,361; observed4,142,471 → 4,142,475 → 4,142,477 → 4,142,479 → 4,142,485 → 4,142,491 → 4,142,495across ~30 s (A13 live-tick proof).0.00 gwei(< 5 gwei).4,141,852(≥ 4,100,000).5,759(non-negative).https://rpc.d-bis.org+https://explorer.d-bis.org.Digital Asset Custodyrow (0x742d35Cc…bD38):● live · chain 138+on-chain: 0.0000 META.Stablecoin Reserverow (0x1a2b…9a0b):● live · chain 138+on-chain: 0.0000 META.Main Operating Account/EUR Treasury Accountrows: no overlay, no status dot (nowalletAddress).Screenshot (dashboard top after EIP-55 fix): https://app.devin.ai/attachments/638106ad-ae67-4712-82e4-6f2eb333c778/01-dashboard-top-after-fix.png
Test 2 — negative (broken RPC URL must surface as Degraded)
Restarted dev server with
VITE_CHAIN138_RPC_URL=https://rpc.d-bis.org.invalid.Chain 138 RPCpill flipped toDegraded.degraded(red).—.SolaceScan Explorerpill stayedLive(different backend, as designed).Error: Failed to fetch.Screenshot (degraded state): https://app.devin.ai/attachments/e5a34d16-2a54-4b09-b973-604d4a20eecb/03-negative-degraded.png
Fix landed during testing
EIP-55 checksum drop.
0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38(Digital Asset Custody sample wallet) fails ethers v6getAddress(); without handling this,getNativeBalance()threw, was silently caught ingetNativeBalances(), and that address vanished from the balance map — UI showed○ off-chainforever.Fixed in
src/services/chain138.tswith anormalizeAddress()helper that tries strictgetAddress()first, then falls back togetAddress(address.toLowerCase()). Added aconsole.warningetNativeBalances()so dropped addresses aren't silent. Both sample custody rows now render● live · chain 138+on-chain: 0.0000 META.Scope caveats
DashboardPageis wired to live backends.AccountsPage,TreasuryPage,ReportingPage,CompliancePage,SettlementsPage,TransactionBuilderPagestill use sample data — same hooks/services can be dropped in incrementally.proxmox.tsis a mock (CF-Access in front of the real API; needs an orchestrator BFF route + service token).dbisCore.tsis a mock (no public deployment yet;api.dbis-core.d-bis.orgfails DNS).AuthContextstill falls back to simulated Demo-mode wallet — SIWE/MetaMask signing is out of scope.feat(portal): wire DashboardPage to live Chain-138 RPC + SolaceScan Explorerto feat(portal): wire Solace portal (all 7 pages) to live Chain-138 RPC + SolaceScan ExplorerPhase 2 test report — all 7 pages wired live
Result: PASS (Test 1 positive end-to-end + Test 2 negative RPC-degrade + recovery)
Head tested:
7253ad1ondevin/1776532671-solace-bank-portalBackends:
https://rpc.d-bis.org(Chain 138,eth_chainId=0x8a=138) ·https://api.explorer.d-bis.org/api/v2(Blockscout v2)Devin session: https://app.devin.ai/sessions/a33f9ebe303d413aab86e04252a1b4a1
Test 1 — positive (per page)
Dashboard — 4 backend pills correct (
Chain 138 RPC · Live,SolaceScan Explorer · Live,Proxmox API · BFF required,DBIS Core Banking · Mocked). Chain ID138. Latest block ticked4,148,883 → 4,148,884in the same view, then4,148,939after 15 s wait. Gas0.00 gwei, RPC latency 164 ms. On-chain overlay on exactly the 2 custody rows.Accounts —
● live · chain 138+0.0000 METAon both custody rows (Digital Asset Custody,Stablecoin Reserve). SolaceScan-linked identifier cells. No tag on the 8 non-wallet rows.Settlements —
Chain-138 Block 4,148,891·5759 tx today.LiveTransactionsPanelrendered 12 tx rows with SolaceScan-linked hashes, from/to,METAvalue, relative time, statusok. Source line confirmspolls every 15s · Blockscout v2 /transactions.Reporting —
On-Chain Reporting Snapshot — Chain 138card above standards tabs. Latest Block4,148,893 → 4,148,896during view. Total Blocks4148205, Total Txs60839, Addresses7166, Utilisation0.0%.updated HH:MM:SStimestamp.Treasury — New cards:
Chain-138 Gas 0.000 gwei · block 4,148,899;On-Chain Custody (META) 0.0000 · 2 custody wallets · chain 138.Compliance & Risk — AML monitor strip
● live · block 4,148,900,Tracked custody wallets: 2. Wallet selector togglesDigital Asset Custody · 0x742d35…↔Stablecoin Reserve · 0x1a2b3c…;On-Chain Tx Feedupdates with matching SolaceScan link on switch.Transaction Builder —
LiveChainBannerabove canvas readsChain 138 (DeFi Oracle Meta Mainnet) ● LIVE block 4,148,904 gas 0.0000 gwei rpc 283ms. Builder canvas intact below.Test 2 — negative RPC-degrade
Restarted dev server with
VITE_CHAIN138_RPC_URL=https://rpc.d-bis.org.invalid(explorer URL unchanged).Chain 138 RPC · Degradedpill; panel values—;Error: Failed to fetch. Explorer-sourced totals (Total blocks / txns / addresses) stayed live. Explorer pill green.○ off-chain(no balance line).— · RPC degraded;LiveTransactionsPanelcontinued rendering 12 explorer-sourced tx rows (proves per-backend degradation, not global blackout).Chain-138 Gas — · RPC degraded.● degraded · Failed to fetch(red).● RPC degraded · Failed to fetch(red).Chain 138 RPC · Live, block4,148,939ticking again.Notes
npx tsc --noEmitclean.dbis_corestays mocked — no public deployment exists.devin/1776587283-proxmox-bff).Avg Block Timetile displays Blockscout/statsaverage_block_timeunchanged; verify unit/scale in a follow-up.Full test plan
See
/home/ubuntu/review/solace-portal-phase2-test-plan.mdin the session.Blockscout /api/v2/stats returns average_block_time in milliseconds; ReportingPage displays it as `${value.toFixed(1)}s` which rendered ~4424s instead of the real ~4.4s. Normalize in the service layer so every caller gets seconds regardless of upstream format. Co-Authored-By: Nakamoto, S <[email protected]>Follow-up: fix Reporting
Avg Block TimeunitPushed
2363884(on this PR's branch).Blockscout
/api/v2/statsreturnsaverage_block_timein milliseconds:ReportingPagewas displaying it as${value.toFixed(1)}s, which rendered4424.0sinstead of the real~4.4s. Normalized in the service layer (src/services/explorer.ts) — any value > 60 is treated as ms and divided by 1000, otherwise passed through. Works for Chain-138 and won't break if the upstream ever switches to seconds.npx tsc --noEmitclean.No other code changes; no need to re-run the full test matrix. The Reporting tile will read
~4.4son next load.