eosjs-api

Eos API

Application programming interface to EOS blockchain nodes. This is mostly for read-only API calls. If you decide you need to sign transactions, your better off using this API in the eosjs package.

Status: Beta

Usage

Testnet = require('eosjs-api/testnet') // Or Testnet = require('./testnet')
assert = require('assert')

testnet = Testnet() // See ./testnet.js for configuration

// Any API call without a callback parameter will print documentation: description,
// parameters, return value, and possible errors.  All methods and documentation
// are created from JSON files in eosjs/json/api/v1..
testnet.getInfo()

// For promises instead of callbacks, use something like npmjs 'sb-promisify'
callback = (err, res) => {err ? console.error(err) : console.log(res)}

// The server does not expect any parameters only the callback is needed
testnet.getInfo(callback)

// Parameters are added before the callback
testnet.getBlock(1, callback)

// Parameters can be an object
testnet.getBlock({block_num_or_id: 1}, callback)

API Documentation

The API methods and documentation are stored in JSON files in this folder.

Environment

Node 6+ and browser (browserify, webpack, etc)

TODO

Automate code-coverage after a public testnet is available.