Flutter Wallet Validator #

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

Features #

• 🚀 Lightweight: Minimal impact on app size
• 🔒 Type-safe: Written in Dart with full type definitions
• ⚡ Fast: No heavy dependencies
• 🧪 Well-tested: Production-ready test coverage
• 🌐 Multi-network support:
  • Algorand
  • Bitcoin (Legacy, SegWit, Native SegWit)
  • Bitcoin Cash
  • Cardano
  • Core (ICAN)
  • Cosmos ecosystem (Cosmos, Osmosis, Juno, etc.)
  • NS domains on ENS standard (including subdomains and emoji support)
  • EVM-compatible chains (Ethereum, Polygon, BSC, etc.)
  • Litecoin (Legacy, SegWit, Native SegWit)
  • Polkadot
  • Ripple (XRP)
  • Solana
  • Stellar
  • Tron
• 📦 Modern package:
  • Null safety
  • Platform independent
  • Zero configuration
  • Works on all Flutter platforms

Installation #

dependencies:
  flutter_wallet_validator: ^0.1.2

Run:

flutter pub get

Usage #

Basic Example #

import 'package:flutter_wallet_validator/flutter_wallet_validator.dart';

void main() {
  // Validate an Ethereum address
  final result = validateWalletAddress(
    '0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97',
  );
  print(result);
  // NetworkInfo(
  //   network: 'evm',
  //   isValid: true,
  //   description: 'Ethereum Virtual Machine compatible address',
  //   metadata: {'isChecksumValid': true}
  // )
}

With Options #

// Validate with specific networks enabled
final result = validateWalletAddress(
  'vitalik.eth',
  options: ValidationOptions(
    network: ['ns'],
    nsDomains: ['eth'],
    testnet: false,
  ),
);

Flutter Widget Example #

class WalletAddressValidator extends StatelessWidget {
  final String address;

  const WalletAddressValidator({
    super.key,
    required this.address,
  });

  @override
  Widget build(BuildContext context) {
    final result = validateWalletAddress(address);

    return Card(
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('Network: ${result.network ?? 'Unknown'}'),
            Text('Valid: ${result.isValid}'),
            Text('Description: ${result.description ?? 'N/A'}'),
            if (result.metadata != null)
              Text('Metadata: ${result.metadata}'),
          ],
        ),
      ),
    );
  }
}

Platform Support #

Environment #

• 🎯 Dart SDK: >=3.5.0 <4.0.0
• 💙 Flutter: >=3.29.1
• 📱 Platforms: All Flutter supported platforms

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.

Contributing #

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

License #

Licensed under the CORE License.