LBRYCommunity/bitcoinjs-lib
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

README: add notes about ES5, Node LTS feature tracking

Browse source
This commit is contained in:
Daniel Cousens 2017-09-25 09:30:53 +10:00
parent d364e65677
commit a9434f71ec
1 changed files with 19 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
README.md
View file

@ -41,41 +41,41 @@ var bitcoin = require('bitcoinjs-lib')
### Browser ### Browser
If you're familiar with how to use browserify, ignore this and proceed normally. If you're familiar with how to use browserify, ignore this and proceed normally.
These steps are advisory only, and may not be necessary for your application. These steps are advisory only, and may not be suitable for your application.
[Browserify](https://github.com/substack/node-browserify) is assumed to be installed for these steps. [Browserify](https://github.com/substack/node-browserify) is assumed to be installed for these steps.
From your repository, create an `index.js` file For your project, create an `index.js` file
``` javascript ``` javascript
let bitcoin = require('bitcoinjs-lib')
// your code here
function myFunction () {
return bitcoin.ECPair.makeRandom().toWIF()
}
module.exports = { module.exports = {
base58: require('bs58'), myFunction
bitcoin: require('bitcoinjs-lib'),
ecurve: require('ecurve'),
BigInteger: require('bigi')
} }
``` ```
Install each of the above packages locally Now, to compile for the browser:
``` bash ``` bash
npm install bs58 bitcoinjs-lib ecurve bigi browserify index.js --standalone foo > app.js
``` ```
After installation, use browserify to compile `index.js` for use in the browser: You can now put `<script src="app.js" />` in your web page, using `foo.myFunction` to create a new Bitcoin private key.
``` bash
$ browserify index.js --standalone foo > app.js
```
You will now be able to use `<script src="app.js" />` in your browser, with each of the above exports accessible via the global `foo` object (or whatever you chose for the `--standalone` parameter above). **NOTE**: If you uglify the javascript, you must exclude the following variable names from being mangled: `BigInteger`, `ECPair`, `Point`.
**NOTE**: See our package.json for the currently supported version of browserify used by this repository.
**NOTE**: When uglifying the javascript, you must exclude the following variable names from being mangled: `Array`, `BigInteger`, `Boolean`, `ECPair`, `Function`, `Number`, `Point` and `Script`.
This is because of the function-name-duck-typing used in [typeforce](https://github.com/dcousens/typeforce). This is because of the function-name-duck-typing used in [typeforce](https://github.com/dcousens/typeforce).
Example: Example:
``` bash ``` bash
uglifyjs ... --mangle --reserved 'Array,BigInteger,Boolean,ECPair,Function,Number,Point' uglifyjs ... --mangle --reserved 'BigInteger,ECPair,Point'
``` ```
**NOTE**: This library tracks Node LTS features, if you need strict ES5, use [`--transform babelify`](https://github.com/babel/babelify) in conjunction with your `browserify` step (using an [`es2015`](http://babeljs.io/docs/plugins/preset-es2015/) preset).
**NOTE**: If you expect this library to run on an iOS 10 device, ensure that you are using [buffer@5.0.5](https://github.com/feross/buffer/pull/155) or greater. **NOTE**: If you expect this library to run on an iOS 10 device, ensure that you are using [buffer@5.0.5](https://github.com/feross/buffer/pull/155) or greater.
@ -85,7 +85,7 @@ Type declarations for Typescript are available for version `^3.0.0` of the libra
npm install @types/bitcoinjs-lib npm install @types/bitcoinjs-lib
``` ```
You can now use `bitcoinjs-lib` as a typescript compliant library. You can now use `bitcoinjs-lib` as a typescript compliant library.
``` javascript ``` javascript
import { HDNode, Transaction } from 'bitcoinjs-lib' import { HDNode, Transaction } from 'bitcoinjs-lib'
``` ```