Skip to content

MonsieurNicolas/stellar-lib

 
 

Repository files navigation

#The Stellar JavaScript Library

stellar-lib connects to the Stellar network via the WebSocket protocol. It runs in Node.js or in the browser.

###Use stellar-lib for:

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

###In this file:

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

###For additional documentation see:

  1. The stellar-lib Guides (docs/GUIDES.md)
  2. The stellar-lib API Reference (docs/REFERENCE.md)

###Also see:

##Getting stellar-lib

Via npm for Node.js

  $ npm install stellar-lib

Build from the source using gulp

  $ git clone https://github.com/stellar/stellar-lib
  $ cd stellar-lib
  $ npm install
  $ gulp

Then use the minified build/stellar-*-min.js in your webpage

##Quickstart

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

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

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

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

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

See The stellar-lib Guides and The stellar-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

stellar-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/.

About

JS library to facilitate talking to stellard.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 98.7%
  • Other 1.3%