#The Ripple JavaScript Library

ripple-lib connects to the Ripple network via the WebSocket protocol and runs in Node.js as well as in the browser.

###In this file:

1. Overview
2. Getting ripple-lib
3. Quickstart
4. Running tests

###For additional documentation see:

1. The ripple-lib Guides (docs/GUIDES.md)
2. The ripple-lib API Reference (docs/REFERENCE.md)
3. https://ripple.com/wiki/Ripple_JavaScript_library

###Also see:

• https://ripple.com/wiki
• https://ripple.com

##Getting ripple-lib

1. Via npm for Node.js: npm install ripple-lib
2. Build from the source using grunt and load the minified ripple-#.#.#-min.js into your webpage

##Quickstart

Remote (remote.js) is the module responsible for managing connections to rippled servers:

/* Loading ripple-lib with Node.js */
var Remote = require('ripple-lib').Remote;

/* Loading ripple-lib in a webpage */
// var Remote = ripple.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:    's1.ripple.com'
      , port:    443
      , secure:  true
    }
  ]
});

remote.connect(function() {
  /* remote connected */

  // see the API Reference for available functions
});

See The ripple-lib Guides and The ripple-lib API Reference for walkthroughs and details about all of the available functions and options.

##Running tests

1. Clone the repository

2. cd into the repository and install dependencies with npm install

3. npm test or make test or node_modules\.bin\mocha test\*-test.js

Generating code coverage

ripple-lib uses jscoverage to generate code coverage. To generate a file coverage.html, run make coverage