Stefan Thomas a003d261ea Log: New logging system.
Right now, all I've done is move the logging function from utils to its own
file. I've also refactored it and created some classes.

Next step would be to somehow get rid of the trace setting. The Remote class
should have nothing to do with logging settings. Perhaps we can keep the setting
for backwards compatibility only, but the main way to turn logging on/off or
filter logging messages should be through the Log class.
2014-02-27 23:38:45 -08:00
2014-01-22 12:49:36 +07:00
2013-04-26 08:59:48 +02:00
2014-02-27 23:38:45 -08:00
2014-02-15 09:31:59 +07:00
2013-09-21 05:41:19 -07:00
2013-09-24 13:02:35 -07:00
2014-01-07 03:14:07 -08:00
2013-09-21 05:41:19 -07:00
2014-02-20 15:49:13 -08:00
2013-12-03 12:01:01 -08:00

#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.

Use ripple-lib for

  • Connecting to a local or remote rippled in JavaScript (Node.js or browser)
  • Issuing rippled API requests
  • Listening to events on the Ripple network (transaction, ledger, etc.)
  • Signing and submitting transactions to the Ripple network

###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:

##Getting ripple-lib

Via npm for Node.js

  $ npm install ripple-lib

Build from the source using grunt

  $ git clone https://github.com/ripple/ripple-lib
  $ npm install
  $ grunt

Then use the minified build/ripple-*-min.js in 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

Description
A JavaScript/TypeScript API for interacting with the Xahau Ledger in Node.js and the browser
Readme 48 MiB
Languages
TypeScript 97.4%
JavaScript 2.6%