cashaddrjs-slp
Version:
SLP & Bitcoin Cash cashaddr address format support for Node.js and web browsers.
72 lines (47 loc) • 2.4 kB
Markdown
# SLP CashAddr.js: The new Bitcoin Cash address format for Node.js and web browsers.
[](https://nodei.co/npm/cashaddrjs-slp/)
JavaScript implementation for the new CashAddr address format for Bitcoin Cash and SLP.
Compliant with the original CashAddr [specification](https://github.com/Bitcoin-UAHF/spec/blob/master/cashaddr.md) which improves upon [BIP 173](https://github.com/bitcoin/bips/blob/master/bip-0173.mediawiki).
*Note:* This is a JavaScript implementation of the CashAddr format specification. If you are looking for a general purpose Bitcoin Cash address translation library, check out the easy-to-use and well-tested [BchAddr.js](https://github.com/bitcoincashjs/bchaddrjs).
## Installation
### Using NPM
```bsh
$ npm install --save cashaddrjs-slp
```
### Using Bower
```bsh
$ bower install --save cashaddrjs-slp
```
### Manually
You may also download the distribution file manually and place it within your third-party scripts directory: [dist/cashaddrjs-{{ version }}.min.js](https://cdn.rawgit.com/bitcoincashjs/cashaddrjs/master/dist/cashaddrjs-{{ version }}.min.js).
## Usage
### In Node.js
```javascript
const cashaddr = require('cashaddrjs');
const address = 'bitcoincash:qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a';
const { prefix, type, hash } = cashaddr.decode(address);
console.log(prefix); // 'bitcoincash'
console.log(type); // 'P2PKH'
console.log(hash); // Uint8Array [ 118, 160, ..., 115 ]
console.log(cashaddr.encode(prefix, type, hash)); // 'bitcoincash:qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a'
```
*Note:* This is a JavaScript implementation of the CashAddr format specification. If you are looking for an easy-to-use and well-tested library to translate between different formats, check out [BchAddr.js](https://github.com/bitcoincashjs/bchaddrjs).
### Browser
#### Script Tag
You may include a script tag in your HTML and the `cashaddr` module will be defined globally on subsequent scripts.
```html
<html>
<head>
...
<script src="https://cdn.rawgit.com/bitcoincashjs/cashaddrjs/master/dist/cashaddrjs-{{ version }}.min.js"></script>
</head>
...
</html>
```
## Documentation
### Generate and Browse Locally
```bsh
$ npm run docs
```
### Online
Browse automatically generated jsdocs [online](https://cdn.rawgit.com/bitcoincashjs/cashaddrjs/master/docs/index.html).