README.md

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. Advertised Cosmos networks load balances through current public RPC and LCD hosts (CryptoCrew, Lavender.Five, Polkachu, PublicNode, and official chain endpoints). Retired hosts such as QuickApi, Lava public RPC, Whispernode, and ping.pub for BeeZee were removed.

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

Bitcoin and Litecoin load balances through Esplora APIs (Blockstream, Mempool.space, Litecoin Space). Other Bitcoin-like networks still show addresses. Explorer links use current hosts (CipherScan, Ravencoin Explorer, Flux, BitcoinZ, NOSO). Retired sites such as zcha.in, ravencoin.network, and explorer.ritocoin.org were removed. Ritocoin no longer has a public explorer after the lull.

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

Advertised EVM networks load balances through current public RPCs (PublicNode, DRPC, Cloudflare, and official chain endpoints). Retired hosts such as MyCrypto, MaticVigil, and the old polygon-rpc.com gateway were removed.

SVM Chains (Solana-like)

Network	Network ID	Symbol	Address Format	Status
Solana	solana-mainnet	SOL	Base58	Enabled

Advertised Solana mainnet loads balances through current public RPCs (official Solana and PublicNode). Retired or key-gated hosts such as Ankr public RPC and Solana dRPC were removed.

Eclipse, Solana Devnet, and Solana Testnet are defined in config but disabled by default.

Features

• Multi-chain wallet from a single mnemonic
• Cosmos staking with validator APR display
• REStake compatibility detection
• BeeZee staking pools (Offers)
• IBC transfers and IBC token support
• Multi-chain swaps via Skip.go
• Solana (SVM) addresses and balances
• EVM and Bitcoin-like (UTXO) account views

Supported networks were last reviewed in September 2026. The same curated list appears in Settings.

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
• Adding an SVM Chain - Add Solana or SVM-compatible networks
• Adding a Network Type - Add a brand-new network family

Project Structure

src/
  lib/
    networks/           - Network configurations and curated catalog
      cosmos.ts         - Manual Cosmos overrides
      bitcoin.ts        - UTXO chain configs
      evm.ts            - Manual EVM overrides
      solana.ts         - SVM chain configs
      supported-catalog.ts - User-facing supported-network list
    cosmos/             - Cosmos-specific code
    evm/                - EVM client
    solana/             - Solana RPC client
    storage/            - Encrypted storage
  popup/
    pages/              - Extension and web UI pages
    components/         - Reusable components
  web/                  - Web app entry (vidulum.app)
  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

• Skip.go - Skip Go API is an end-to-end interoperability platform

License

See LICENSE file.