# bchaddrjs-slp > Bitcoin Cash and SLP general purpose address translation. Latest version **0.2.14** (published 2021-04-11) · MIT license · 0 weekly downloads ## Install ```sh npm install bchaddrjs-slp pnpm add bchaddrjs-slp yarn add bchaddrjs-slp bun add bchaddrjs-slp ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.2.14 | | Published | 2021-04-11 | | First published | 2018-08-27 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | >= 6.0.0 | | Dependencies | 2 | | Unpacked size | 643.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 2 | | Author | Emilio Almansi | | Maintainers | jscramer | | Keywords | bitcoin-cash, bitcoin, bch, cryptocurrency, address, encoding, translation, base58, bitpay, cash-address | ## Links - npm: https://www.npmjs.com/package/bchaddrjs-slp - Repository: https://github.com/simpleledger/bchaddrjs - Homepage: https://github.com/simpleledger/bchaddrjs#readme - Issues: https://github.com/simpleledger/bchaddrjs/issues - npm.io page: https://npm.io/package/bchaddrjs-slp ## Dependencies (2) - [bs58check](https://npm.io/package/bs58check.md) ^2.1.2 - [cashaddrjs-slp](https://npm.io/package/cashaddrjs-slp.md) ^0.2.12 ## Alternatives - [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads - [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads - [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads - [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads - [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads ## Recent versions - 0.2.14 (latest) — 2021-04-11 - 0.2.13 — 2021-04-10 - 0.2.12 — 2021-01-15 - 0.2.11 — 2020-11-20 - 0.2.10 — 2020-11-20 - 0.2.9 — 2020-08-26 - 0.2.8 — 2019-11-21 - 0.2.7 — 2019-10-31 - 0.2.5 — 2018-08-27 - 0.2.4 — 2018-08-27 - 0.2.3 — 2018-08-27 - 0.2.2 — 2018-08-27 ## README # BchAddr.js: Bitcoin Cash general purpose address translation for Node.js and web browsers. [![NPM](https://nodei.co/npm/bchaddrjs-slp.png?downloads=true)](https://nodei.co/npm/bchaddrjs-slp/) [![JavaScript Style Guide](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard) Plug & Play JavaScript library for all Bitcoin Cash address format translation needs. Easy-to-use, thoroughly tested, and feature complete. Support for the new Bitcoin Cash address [format](https://github.com/Bitcoin-UAHF/spec/blob/master/bchaddr.md) which improves upon [BIP 173](https://github.com/bitcoin/bips/blob/master/bip-0173.mediawiki), as well as the Bitpay and Legacy formats. Test out a demo address translator powered by BchAddr.js [here](https://bitcoincashjs.github.io/address/). ## Installation ### Using NPM ```bsh $ npm install --save bchaddrjs-slp ``` ### Using Bower ```bsh $ bower install --save bchaddrjs-slp ``` ## Usage ### In Node.js ```typescript import * as bchaddr from "bchaddrjs-slp"; ``` ```javascript var bchaddr = require('bchaddrjs-slp'); ``` ### Browser #### Script Tag You may include a script tag in your HTML and the `bchaddr` module will be defined globally on subsequent scripts. ```html ... ... ``` ## Code Examples ### Supported formats, networks and address types. ```javascript var Format = bchaddr.Format; // Legacy, Bitpay or Cashaddr. var Network = bchaddr.Network; // Mainnet or Testnet. var Type = bchaddr.Type; // P2PKH or P2SH. ``` ### Test for address format. ```javascript var isLegacyAddress = bchaddr.isLegacyAddress; var isBitpayAddress = bchaddr.isBitpayAddress; var isCashAddress = bchaddr.isCashAddress; isLegacyAddress('1B9UNtBfkkpgt8kVbwLN9ktE62QKnMbDzR') // true isLegacyAddress('qph5kuz78czq00e3t85ugpgd7xmer5kr7c5f6jdpwk') // false isBitpayAddress('CScMwvXjdooDnGevHgfHjGWFi9cjk75Aaj') // true isBitpayAddress('1B9UNtBfkkpgt8kVbwLN9ktE62QKnMbDzR') // false isCashAddress('qph5kuz78czq00e3t85ugpgd7xmer5kr7c5f6jdpwk') // true isCashAddress('CScMwvXjdooDnGevHgfHjGWFi9cjk75Aaj') // false ``` ### Test for address network. ```javascript var isMainnetAddress = bchaddr.isMainnetAddress; var isTestnetAddress = bchaddr.isTestnetAddress; isMainnetAddress('1P238gziZdeS5Wj9nqLhQHSBK2Lz6zPSke') // true isMainnetAddress('mnbGP2FeRsbgdQCzDT35zPWDcYSKm4wrcg') // false isTestnetAddress('qqdcsl6c879esyxyacmz7g6vtzwjjwtznsggspc457') // true isTestnetAddress('CeUvhjLnSgcxyedaUafcyo4Cw9ZPwGq9JJ') // false ``` ### Test for address type. ```javascript var isP2PKHAddress = bchaddr.isP2PKHAddress; var isP2SHAddress = bchaddr.isP2SHAddress; isP2PKHAddress('1Mdob5JY1yuwoj6y76Vf3AQpoqUH5Aft8z') // true isP2PKHAddress('2NFGG7yRBizUANU48b4dASrnNftqsNwzSM1') // false isP2SHAddress('H92i9XpREZiBscxGu6Vx3M8jNGBKqscBBB') // true isP2SHAddress('CeUvhjLnSgcxyedaUafcyo4Cw9ZPwGq9JJ') // false ``` ### Detect address format. ```javascript var detectAddressFormat = bchaddr.detectAddressFormat; detectAddressFormat('qqdcsl6c879esyxyacmz7g6vtzwjjwtznsggspc457') // Format.Cashaddr detectAddressFormat('CScMwvXjdooDnGevHgfHjGWFi9cjk75Aaj') // Format.Bitpay ``` ### Detect address network. ```javascript var detectAddressNetwork = bchaddr.detectAddressNetwork; detectAddressNetwork('1P238gziZdeS5Wj9nqLhQHSBK2Lz6zPSke') // Network.Mainnet detectAddressNetwork('qqdcsl6c879esyxyacmz7g6vtzwjjwtznsggspc457') // Network.Testnet ``` ### Detect address type. ```javascript var detectAddressType = bchaddr.detectAddressType; detectAddressType('1P238gziZdeS5Wj9nqLhQHSBK2Lz6zPSke') // Type.P2PKH detectAddressType('3NKpWcnyZtEKttoQECAFTnmkxMkzgbT4WX') // Type.P2SH ``` ### Translate address from any address format into a specific format. ```javascript var toLegacyAddress = bchaddr.toLegacyAddress; var toBitpayAddress = bchaddr.toBitpayAddress; var toCashAddress = bchaddr.toCashAddress; toLegacyAddress('qph5kuz78czq00e3t85ugpgd7xmer5kr7c5f6jdpwk') // 1B9UNtBfkkpgt8kVbwLN9ktE62QKnMbDzR toBitpayAddress('1B9UNtBfkkpgt8kVbwLN9ktE62QKnMbDzR') // CScMwvXjdooDnGevHgfHjGWFi9cjk75Aaj toCashAddress('1B9UNtBfkkpgt8kVbwLN9ktE62QKnMbDzR') // bitcoincash:qph5kuz78czq00e3t85ugpgd7xmer5kr7c5f6jdpwk ``` ## Documentation ### Generate and Browse Locally ```bsh $ npm run docs ``` ### Online Browse automatically generated jsdocs [online](https://cdn.rawgit.com/simpleledger/bchaddrjs/master/jsdoc/index.html). --- _Source: https://npm.io/package/bchaddrjs-slp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._