0.10.3 • Public • Published

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/
  2. The stellar-lib API Reference (docs/

Also see:

Getting stellar-lib

Via npm for Node.js

  $ npm install stellar-lib

Build from the source using gulp

  $ git clone
  $ cd stellar-lib
  $ npm install
  $ gulp

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


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:    ''
      , 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/.




npm i stellar-lib

DownloadsWeekly Downloads






Last publish


  • piyalbasu
  • cassiomg
  • stellar-npm-ci
  • stellar-npm
  • bartekn
  • quietbits
  • jacekn
  • fnando_sdf