@4i/crypto-address-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 @4i/crypto-address-validator

Usage

const { validate } = require("@4i/crypto-address-validator");

const result = validate("erc20", "0x742d35Cc6634C0532925a3b844Bc454e4438f44e");

console.log(result);
// {
//   isValid: true,
//   type: { isValidAddress: [Function: isValidAddress] }
// }

Get supported network options

const { networkOptions } = require("@4i/crypto-address-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

validate(network, address) result

{
  isValid: boolean;
  type: ValidatorModule | "regex" | null;
}

Where:

• isValid — final validation result
• type: "regex" — regex-only validation path was used
• type: ValidatorModule — dedicated validator module handled the address
• type: null — invalid input or unknown network

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