/wallet-address-validator

Useful library for validation of Bitcoin, Litecoin, Ethereum and other cryptocoin addresses

Primary LanguageJavaScriptMIT LicenseMIT

wallet-address-validator

Simple wallet address validator for validating Bitcoin and other altcoins addresses in Node.js and browser.

Forked from ryanralph/altcoin-address.

File size is ~17 kB (minifed and gzipped).

Installation

NPM

npm install wallet-address-validator

Browser

<script src="wallet-address-validator.min.js"></script>

API

validate (address [, currency = 'bitcoin'[, networkType = 'prod']])
Parameters
  • address - Wallet address to validate.
  • currency - Optional. Currency name or symbol, e.g. 'bitcoin' (default), 'litecoin' or 'LTC'
  • networkType - Optional. Use 'prod' (default) to enforce standard address, 'testnet' to enforce testnet address and 'both' to enforce nothing.

Returns true if the address (string) is a valid wallet address for the crypto currency specified, see below for supported currencies.

getAddressType (address)
Parameters
  • address - Wallet address.

Returns address type (as 2 character hex string) if valid base58 address, otherwise null.

Supported crypto currencies

  • Auroracoin/AUR, 'auroracoin' or 'AUR'

  • BeaverCoin/BVC, 'beavercoin' or 'BVC'

  • Biocoin/BIO, 'biocoin' or 'BIO'

  • Bitcoin/BTC, 'bitcoin' or 'BTC'

  • BitcoinCash/BCH, 'bitcoincash' or 'BCH'

  • BitcoinGold/BTG, 'bitcoingold' or 'BTG'

  • Callisto/CLO, 'callisto' or 'CLO'

  • Dash, 'dash' or 'DASH'

  • Decred/DCR, 'decred' or 'DCR'

  • Digibyte/DGB, 'digibyte' or 'DGB'

  • Dogecoin/DOGE, 'dogecoin' or 'DOGE'

  • Ethereum/ETH, 'ethereum' or 'ETH'

  • EthereumClassic/ETH, 'ethereumclassic' or 'ETC'

  • EthereumZero/ETZ, 'etherzero' or 'ETZ'

  • Freicoin/FRC, 'freicoin' or 'FRC'

  • Garlicoin/GRLC, 'garlicoin' or 'GRLC'

  • Litecoin/LTC, 'litecoin' or 'LTC'

  • Megacoin/MEC, 'megacoin' or 'MEC'

  • Namecoin/NMC, 'namecoin' or 'NMC'

  • NEO/NEO, 'NEO' or 'NEO'

  • Peercoin/PPCoin/PPC, 'peercoin' or 'PPC'

  • Primecoin/XPM, 'primecoin' or 'XPM'

  • Protoshares/PTS, 'protoshares' or 'PTS'

  • Qtum/QTUM, 'qtum' or 'QTUM'

  • Ripple/XRP, 'ripple' or 'XRP'

  • Vertcoin/VTC, 'vertcoin' or 'VTC'

Usage example

Node

var WAValidator = require('wallet-address-validator');

var valid = WAValidator.validate('1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck', 'BTC');
if(valid)
	console.log('This is a valid address');
else
	console.log('Address INVALID');

// This will log 'This is a valid address' to the console.
var WAValidator = require('wallet-address-validator');

var valid = WAValidator.validate('1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck', 'litecoin', 'testnet');
if(valid)
      console.log('This is a valid address');
else
      console.log('Address INVALID');

// As this is a invalid litecoin address 'Address INVALID' will be logged to console.

Browser

<script src="wallet-address-validator.min.js"></script>
// WAValidator is exposed as a global (window.WAValidator)
var valid = WAValidator.validate('1KFzzGtDdnq5hrwxXGjwVnKzRbvf8WVxck', 'bitcoin');
if(valid)
    alert('This is a valid address');
else
    alert('Address INVALID');

// This should show a pop up with text 'This is a valid address'.