interstellar-network

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:

• Read Getting started doc.
• Install interstellar-workspace.
• Contribute to our open-source modules or develop your own.

Default configuration

{
  "horizon": {
    "secure": true,
    "hostname": "horizon-testnet.stellar.org",
    "port": 443
  }
}

Read more about modules configuration.

Module contents

Classes

None

Services

• interstellar-network.AccountObservable
• interstellar-network.Server

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 js-stellar-lib Server object created using application configuration. For more information please read js-stellar-lib 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.