Vidulum App

Free Open-Source multi-chain wallet built by the people, for the people.

Available as:

• Browser Extension - Chrome, Firefox, Edge

• Web App - vidulum.app

• Purpose - Project mission and core principles

• Privacy Policy - No data collection, all storage is local

• Terms of Use - Non-custodial wallet, user responsibilities

Supported Networks

Cosmos SDK Chains

Cosmos networks are sourced from the Cosmos Chain Registry.

Network	Chain ID	Symbol	Status
BeeZee	beezee-1	BZE	Enabled
Osmosis	osmosis-1	OSMO	Enabled
AtomOne	atomone-1	ATONE	Enabled
Cosmos Hub	cosmoshub-4	ATOM	Enabled

View full list of Cosmos chains

UTXO Chains (Bitcoin-like)

Network	Network ID	Symbol	Address Format	Status
Bitcoin	bitcoin-mainnet	BTC	bc1... (SegWit)	Enabled
Litecoin	litecoin-mainnet	LTC	ltc1... (SegWit)	Enabled
Dogecoin	dogecoin-mainnet	DOGE	D... (P2PKH)	Enabled
Zcash	zcash-mainnet	ZEC	t1... (Transparent)	Enabled
Flux	flux-mainnet	FLUX	t1... (Transparent)	Enabled
Ravencoin	ravencoin-mainnet	RVN	R... (P2PKH)	Enabled
Ritocoin	ritocoin-mainnet	RITO	R... (P2PKH)	Enabled
BitcoinZ	bitcoinz-mainnet	BTCZ	t1... (Transparent)	Enabled
NOSO	noso-mainnet	NOSO	X... (P2PKH)	Enabled

EVM Chains

Network	Network ID	Symbol	Chain ID	Status
Ethereum	eth-mainnet	ETH	1	Enabled
OP Mainnet	oeth-mainnet	ETH	10	Enabled
BNB Chain	bnb-mainnet	BNB	56	Enabled
Polygon	pol-mainnet	POL	137	Enabled
Base	base-mainnet	ETH	8453	Enabled
Arbitrum One	arb1-mainnet	ETH	42161	Enabled

Features

• Multi-chain wallet from a single mnemonic
• Cosmos staking with validator APR display
• REStake compatibility detection
• MoonPay integration for fiat on/off ramp
• BeeZee staking pools (Offers)
• IBC token support

Installation

Web App

Visit vidulum.app - no installation required.

Browser Extension

From Source

# Clone the repository
git clone https://github.com/corey-code/vidulum-app.git
cd vidulum-app

# Install dependencies
npm install

# Build the extension
npm run build

Load in Chrome

1. Navigate to chrome://extensions
2. Enable "Developer mode"
3. Click "Load unpacked"
4. Select the dist folder

Development

# Development build with watch (extension)
npm run dev

# Development server (web app)
npm run dev:web

# Production build (extension)
npm run build

# Production build (web app)
npm run build:web

# Run tests
npm test

Documentation

Detailed documentation is available in the docs/ folder:

• Data Storage - How wallet data is stored and encrypted
• Adding a Cosmos Chain - Add new Cosmos SDK networks
• Adding a UTXO Chain - Add new Bitcoin-like networks
• Adding an EVM Chain - Add new EVM networks

Project Structure

src/
  lib/
    networks/           - Network configurations
      cosmos.ts         - Cosmos chain configs
      bitcoin.ts        - UTXO chain configs
      evm.ts            - EVM chain configs
    crypto/             - Cryptographic operations
      keyring.ts        - Key management
      bitcoin.ts        - UTXO address derivation
      evm.ts            - EVM address derivation
    cosmos/             - Cosmos-specific code
      chainRegistry.ts  - Asset definitions
      client.ts         - Cosmos client
    storage/            - Encrypted storage
  popup/
    pages/              - Extension UI pages
    components/         - Reusable components
  background/           - Service worker
docs/                   - Documentation

Security

• Mnemonic encrypted with AES-256-GCM
• PBKDF2 key derivation (100,000 iterations)
• Session-based unlock with auto-lock
• No plaintext secrets stored

See Data Storage for details.

Acknowledgements

This project is built with the following open-source libraries:

Core Framework

• React - UI framework
• Vite - Build tool and dev server
• TypeScript - Type-safe JavaScript
• Zustand - State management

UI Components

• Chakra UI - Component library
• Framer Motion - Animation library
• Emotion - CSS-in-JS styling

Blockchain & Cryptography

• CosmJS - Cosmos SDK client libraries
• Noble Hashes - Cryptographic hash functions
• Noble Secp256k1 - Elliptic curve cryptography
• BIP32 - HD wallet key derivation
• BIP39 - Mnemonic phrase generation

Browser Extension

• webextension-polyfill - Cross-browser extension API
• CRXJS - Vite plugin for Chrome extensions

Integrations

• MoonPay - Fiat on/off ramp integration

License

See LICENSE file.