Skip to main content

Architecture

Altitude Wallet consists of three main components working together to provide a seamless Web3 experience.

Browser Extension​

A React-based browser extension built with the WXT framework.

Technology Stack​

  • React 19 — Modern UI library with TypeScript
  • MobX — Reactive state management
  • Vanilla Extract — Type-safe CSS-in-JS styling
  • React Query — Server state synchronization and caching
  • Viem & Ethers.js — Blockchain interaction libraries

Entry Points​

The extension provides multiple entry points:

  • Popup — Main wallet interface accessed via browser toolbar
  • Onboarding — First-time wallet setup and creation flow
  • Approvals — Transaction confirmation and signing interface
  • Background — Service worker for persistent operations

Backend Service​

An Express.js API that aggregates blockchain data from multiple sources.

Core Services​

  • Wallet Balance API — Real-time balance queries across all supported chains via /api/v1/wallet/balances endpoint
  • Transaction History — Complete transaction retrieval with filtering and pagination
  • Token Metadata — Rich token information including prices, logos, and contract details from CoinGecko
  • Network Configuration — Dynamic RPC endpoint management for reliable blockchain connections
  • Token Approvals — Track and manage ERC-20 token allowances for enhanced security

Data Sources​

The backend integrates with multiple providers for redundancy:

  • Moralis — Wallet data and token balances
  • GoldRush — Multi-chain indexing
  • CoinGecko — Price feeds and token metadata

Blockchain Service​

A dedicated service layer for on-chain operations.

Core Modules​

  • Wallet Operations — Key management, signing, and address derivation using Viem
  • Transaction Service — Gas estimation, nonce management, and transaction broadcasting
  • Token Service — ERC-20 token interactions including transfers, approvals, and balance checks
  • Contract Service — Smart contract interaction utilities and ABI encoding
  • Multi-Network Support — Seamless switching between EVM networks with automatic RPC fallback

Network Configuration​

Pre-configured support for major EVM networks with RPC fallback mechanisms for reliability.