Blockchain Wallet Validator

A comprehensive TypeScript library for validating blockchain wallet addresses across multiple networks.

Features

• 🚀 Lightweight: < 10KB minified + gzipped
• 🔒 Type-safe: Written in TypeScript with full type definitions
• ⚡ Fast: No heavy dependencies
• 🧪 Well-tested: 100% test coverage
• 🌐 Multi-network support:
  • EVM (Ethereum, Polygon, BSC, etc.)
  • ENS Domains (including subdomains)
  • Bitcoin (Legacy, SegWit, Native SegWit)
  • Solana
  • Cosmos ecosystem (Cosmos, Osmosis, Juno, etc.)
  • Cardano
  • Polkadot
  • Ripple (XRP)
  • Algorand
  • Stellar
  • Core (ICAN)
• 📦 Modern package:
  • ESM and CommonJS support
  • Tree-shakeable
  • Zero configuration
  • Works in Node.js and browsers

Installation

# Using pnpm (recommended)
pnpm add blockchain-wallet-validator

# Using npm
npm install blockchain-wallet-validator

# Using yarn
yarn add blockchain-wallet-validator

Usage

import { validateWalletAddress } from 'blockchain-wallet-validator';

// Validate an Ethereum address
const evmResult = validateWalletAddress(
  '0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97',
);
console.log(evmResult);
// {
//   network: 'evm',
//   isValid: true,
//   description: 'Ethereum Virtual Machine compatible address (Ethereum, Polygon, BSC, etc.)',
//   metadata: {
//     isChecksumValid: true,
//     format: 'hex'
//   }
// }

// Validate a Bitcoin testnet address
const btcResult = validateWalletAddress(
  'tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx',
  { testnet: true },
);
console.log(btcResult);
// {
//   network: 'bitcoin',
//   isValid: true,
//   description: 'Bitcoin Native SegWit address',
//   metadata: {
//     format: 'Native SegWit',
//     isTestnet: true
//   }
// }

API Reference

validateWalletAddress(address: string, options?: ValidationOptions): NetworkInfo

Validates a blockchain wallet address and returns information about the network it belongs to.

Parameters

• address (string): The wallet address to validate
• options (optional): Validation options
  • testnet (boolean): Whether to validate as a testnet address (currently only supported for Bitcoin)
  • network (string): Specify the expected network (future use)

Returns

Returns a NetworkInfo object containing:

• network (string): The identified blockchain network
• isValid (boolean): Whether the address is valid
• description (string): Human-readable description of the address type
• metadata (object): Additional information about the address
  • Properties vary by network type
  • May include format, checksum validation, testnet status, etc.

Supported Networks

Performance

• Bundle size: < 10KB minified + gzipped
• No runtime dependencies except:
  • bs58check: For Bitcoin address validation
  • ethereum-cryptography: For EVM checksum validation
• Tree-shakeable: Only imports what you use
• Zero configuration required

Browser Support

• All modern browsers (Chrome, Firefox, Safari, Edge)
• IE11 not supported

Development

# Install dependencies
pnpm install

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

# Build the package
pnpm build

# Check bundle size
pnpm size

# Analyze bundle
pnpm analyze

# Format code
pnpm format

# Lint code
pnpm lint

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Requirements

• Node.js >= 16
• pnpm >= 8.10.0 (recommended) or npm/yarn

Security

This package helps validate the format of blockchain addresses but does not guarantee the security or ownership of the addresses. Always verify addresses through multiple sources before sending any transactions.

Changelog

See CHANGELOG.md for release history.

Credits

Created and maintained by Sergiy Dybskiy.