WalletPress Architecture 🟢

 UI (Vue 3 / Nuxt) ──▶ WalletPress API (:8001)
                              │
             ┌────────────────┼─────────────────┐
             ▼                ▼                 ▼
      Chain Adapters    Postgres          Price Feeds
      (per family:      (wallets,         (CoinGecko,
      EVM / SVM /       labels,           DexScreener,
      UTXO / TVM)       cached balances)  0x — free tiers)

Adapter families

Family	Chains (examples)	Data source pattern
EVM	Ethereum, Base, Arbitrum, Optimism, +30 more	RPC eth_getBalance + token transfers via indexer API
Solana	Mainnet	RPC getBalance + SPL token accounts
UTXO	Bitcoin, Litecoin, Dogecoin	Public explorer APIs
TVM	TRON	Trongrid API

Adding a chain = implementing one adapter interface + chain registry entry. See Chains for the full list.

Caching strategy

Balances are cached with per-chain TTLs (fast chains 30 s, slow chains 120 s). Price feeds refresh on a 60 s sweep. Stale-while-revalidate keeps the UI instant.