Gero Wallet
A multi-chain, non-custodial wallet browser extension (Chrome Manifest V3) for Cardano, Bitcoin, Midnight, and Apex Fusion.
Features • Quick Start • Documentation • Contributing
Overview
Gero Wallet is a feature-rich, non-custodial multi-chain wallet browser extension. It supports Cardano, Bitcoin, Midnight, and Apex Fusion (Prime and Vector), and ships two interfaces: a full dashboard and Mini-Gero, a compact side-panel wallet.
Cardano data and DeFi routing primarily use Nexus, through the Gero
backend. Bitcoin also uses Esplora directly, and the SPO client calls Koios.
Midnight data uses Nexus/Gero Sync, while proof generation can use direct
Foundation/Arkhia services. See architecture
for these boundaries. Feature availability depends on chain and feature flags.
The development package is 2.8.0; that version is not evidence of a published
release. The Vue 3 migration is merged. See maintenance for
current checks and remaining release work.
Two interfaces
Gero ships two surfaces over the same wallet core:
- Full dashboard — the complete extension: portfolio, swaps, perpetuals, staking, governance, dApp connections, rewards, and settings.
- Mini-Gero — a compact wallet in the browser side panel, for working without leaving the page you're on. It covers the common flows: balances, send, receive, swap, buy and sell, staking and DRep delegation, market prices, perpetuals, vaults, activity, and dApp approvals.
Mini-Gero is a focused subset of the dashboard. Anything not in the side panel is available in the full interface.
Key Features
💼 Wallet Management
- Create and import wallets with BIP39 mnemonic phrases
- Hardware wallet support (Ledger, Trezor, Keystone)
- PassKey (WebAuthn PRF) wallets with hardware-backed key encryption
- Multiple wallets; broader account-index support is tracked in #1307
- Versioned authenticated encryption for stored software-wallet secrets
⛓️ Multi-Chain Support
- Cardano — staking, CIP-1694 governance, native assets, NFTs, dApp connector
- Midnight — shielded transfers, NIGHT/DUST management, proof server, and a shielded proving consent flow
- Apex Fusion — Prime and Vector chains
- Bitcoin — wallet and transaction flows behind the Bitcoin feature flag
⛓️ Cardano Native Features
- Staking: delegate to stake pools and earn rewards
- Governance: CIP-1694 DRep voting and delegation
- NFTs: view, manage, and trade Cardano NFTs
- Native Tokens: full support for Cardano native assets
- CIP-113 programmable tokens: shown in the portfolio and badged; Stage 1 is display only, transfers of these tokens are not supported yet
🔄 DeFi and Trading
- DEX aggregation for best swap rates (routed via Nexus)
- Token swaps across multiple Cardano DEXs
- Perpetuals trading via Strike Finance: order book, market and limit orders, TWAP orders, positions and order history
- Vaults via Strike Finance: view vault data; transfers remain unavailable pending #1292
- Portfolio tracking, analytics, and real-time price feeds
- Fiat on-ramp via MoonPay
🎁 Rewards
- Cashback via the Bring portal (on supported networks)
🔐 Security First
- Non-custodial (you control your keys)
- Configurable lock methods: password, PIN, or pattern
- Two-factor authentication
- Auto-lock with configurable timeout
- Transaction risk assessment
- DApp connection approval system
- Hardware wallet integration
🌐 Web3 Connectivity
- CIP-30 dApp connector API (
window.cardano)
- WalletConnect session support
- Real-time blockchain updates via Gero Sync (WebSocket push)
Tech Stack
- Frontend: Vue.js 3.5 + TypeScript + Vuetify 4.2 (Material Design)
- Build System: Vite 7.3 with 4 separate configurations
- State Management: Custom Vue reactive stores (lightweight, performant)
- Database: Dexie (see the lockfile for the installed version) (IndexedDB wrapper with versioned schemas)
- Cardano SDK:
@cardano-sdk/core (see the lockfile) (modern, preferred for new features)
- Data Layer: Nexus (Gero backend) for blockchain data, prices, and DeFi routing
- Real-time: Gero Sync — WebSocket push for instant blockchain updates
- Cryptography: Local WASM from chain SDK dependencies, plus versioned secret encryption
- Hardware Wallets: Native support for Ledger, Trezor, and Keystone
For complete technical details, see ARCHITECTURE.md.
Quick Start
Prerequisites
Before you begin, ensure you have the following installed:
- Node.js 24.19+ (24.x) and npm 11.1.0, matching CI (Download)
- A configured Gero backend for live data; optional for offline checks
- Chrome or any Chromium-based browser (Edge, Brave, etc.)
- Git for version control
1. Clone and Install
# Clone the repository
git clone https://github.com/Gero-Labs/gerowallet.git
cd gerowallet
git switch development
# Match the CI package manager
npm install --global [email protected]
# Install dependencies
npm ci
# Create .env.development in your editor using the settings below.
2. Configure Environment
For local development, create .env.development with these backend settings.
They allow the base application to boot; live integrations and feature flags
may need additional public configuration. Never put backend secrets in
VITE_* variables, which are exposed to the client:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
