crypto-wallet-validator

Network-first cryptocurrency wallet address validator for Node.js, web, and React Native.

This library validates addresses by network / token standard, not by coin ticker. Example keys: erc20, trc20, bep20, spl, bitcoin, ton.

Features

• One entrypoint: validate(network, address)
• Works with Node.js, browser bundles, and React Native
• Supports both full validators and regex-based fallbacks
• Includes browser bundle output at dist/browser.js

Installation

npm install crypto-wallet-validator

Usage

const { validate } = require('crypto-wallet-validator');

const ok = validate('erc20', '0x742d35Cc6634C0532925a3b844Bc454e4438f44e');
console.log(ok); // true

Get supported network options

const { networkOptions } = require('crypto-wallet-validator');

console.log(networkOptions);

Browser usage

Build the package:

npm run build

Then include the generated browser bundle:

<script src="./dist/browser.js"></script>
<script>
  const { validate, networkOptions } = globalThis.cryptoWalletValidator;
  console.log(validate('bitcoin', '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa'));
</script>

Public API

Supported networks

Type means how validation is performed:

• Validator — dedicated validator logic
• Regex — regex-only fallback

Aliases

The validator also accepts many aliases from validationMap. Examples:

• erc20, ethereum, eth, evm
• trc20, tron, trx
• bep20, bsc, binancesmartchain
• spl, sol, solana
• arb, arbitrum
• op, optimism
• avaxc, cchain, avalanche

Development

npm install
npm run build

Build output:

• dist/index.js
• dist/config/networks.js
• dist/validator.js
• dist/browser.js

Notes

• Validation is network-based, not token-symbol-based
• Browser and React Native support do not rely on Node built-in crypto
• Some networks currently use regex fallback until a dedicated validator is added

License

MIT