payshares-lib
connects to the Payshares network via the WebSocket protocol. It runs in Node.js or in the browser.
- Connecting to a local or remote paysharesd in JavaScript (Node.js or browser)
- Issuing paysharesd API requests
- Listening to events on the payshares network (transaction, ledger, etc.)
- Signing and submitting transactions to the payshares network
- Overview
- Getting
payshares-lib
- Quickstart
- Running tests
Via npm for Node.js
$ npm install payshares-lib
Build from the source using gulp
$ git clone https://github.com/payshares/payshares-lib
$ cd payshares-lib
$ npm install
$ gulp
Then use the minified build/payshares-*-min.js
in your webpage
Remote
(remote.js) is the module responsible for managing connections to paysharesd
servers:
/* Loading payshares-lib with Node.js */
var Remote = require('payshares-lib').Remote;
/* Loading payshares-lib in a webpage */
// var Remote = payshares.Remote;
var remote = new Remote({
// see the API Reference for available options
trusted: true,
local_signing: true,
local_fee: true,
fee_cushion: 1.5,
servers: [
{
host: 'live.payshares.co'
, port: 9001
, secure: true
}
]
});
remote.connect(function() {
/* remote connected */
// see the API Reference for available functions
});
See The payshares-lib
Guides and The payshares-lib
API Reference for walkthroughs and details about all of the available functions and options.
-
Clone the repository
-
cd
into the repository and install dependencies withnpm install
-
npm test
ormake test
ornode_modules\.bin\mocha test\*-test.js
Generating code coverage
payshares-lib uses istanbul
to generate code coverage. To create a code coverage report, run npm test --coverage
. The report will be created in coverage/lcov-report/
.