interstellar-network provides a communication layer between Interstellar applications and the Stellar network.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
services Fix Network select Oct 12, 2015
test Removed Sessions dependency Jun 3, 2015
.gitignore Init Mar 23, 2015
CONTRIBUTING.md Updates Jun 5, 2015
LICENSE.txt Create LICENSE.txt Jun 5, 2015
README.md
index.es6
package.json 0.0.12 Sep 13, 2016

README.md

interstellar-network

The interstellar-network module is part of the Interstellar Module System.

It provides a communication layer between Interstellar applications and the Stellar network.

Quick start to developing in the Interstellar eco-system:

Default configuration

{
  "networkPassphrase": "Test SDF Network ; September 2015",
  "horizon": {
    "secure": true,
    "hostname": "horizon-testnet.stellar.org",
    "port": 443
  }
}

interstellar-network module exports two consts:

  • NETWORK_PUBLIC - containing Public Global Stellar Network passphrase,
  • NETWORK_TESTNET - containing Test SDF Network passphrase

Read more about modules configuration.

Module contents

Classes

None

Services

Widgets

None

interstellar-network.AccountObservable service

interstellar-network.AccountObservable provides a shared space for accounts state and events. Let's say there are 2 widgets displaying a current balance. Without interstellar-network.AccountObservable each of them would have to make it's own requests to horizon server in order to get balance data. This service saves a recently fetched account information in the internal cache so every widget can get the latest information about the account without having to make requests to horizon.

getBalances(address) method

Returns the cached balance data for address. If there is no cache data will be requested from horizon and then returned.

AccountObservable.getBalances(address)
  .then(balances => {
    console.log(balances);
  });

Returns a Promise.

getTransactions(address) method

Returns the transactions list for address. This data will not be cached so it will be requested from horizon every time it's used.

AccountObservable.getTransactions(address)
  .then(transactions => {
    console.log(transactions);
  });

Returns a Promise.

registerBalanceChangeListener(address, callback) method

Registers listener for balance changes. callback function will be called every time there is a change in one or more user balances.

AccountObservable.registerBalanceChangeListener(address, balances => {
  console.log(balances);
});

registerTransactionListener(address, callback) method

Registers listener for new transactions. callback function will be called every time there is a new transaction in address.

AccountObservable.registerTransactionListener(address, transaction => {
  console.log(transaction);
});

interstellar-network.Server service

interstellar-network.Server is a stellar-sdk Server object created using application configuration. For more information please read stellar-sdk documentation.

Publishing to npm

npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease]
npm publish

npm >=2.13.0 required. Read more about npm version.