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

Requirement

Build and run eosd or direct requests to a public testnet or production node.

Usage

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

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()

// A Promise is returned if a callback is not provided.
testnet.getInfo({}).then(result => console.log(result))
testnet.getBlock(1).then(result => console.log(result))

// For callbacks instead of Promises provide a callback
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)
testnet.getBlock({block_num_or_id: 1}).then(result => console.log(result))

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.