7.0.4 • Published 5 years ago

seatjs-api v7.0.4

Weekly downloads
4
License
MIT
Repository
github
Last release
5 years ago

NPM

Seat API

Application programming interface to SEAT blockchain nodes. This is for read-only API calls. If you need to sign transactions use seatjs instead.

Include

  • Install with: npm install seatjs-api
  • Html script tag, see releases for the correct version and its matching script integrity hash.
<html>
<head>
  <meta charset="utf-8">
  <!--
  sha512-n3CgU6w9TJVf/pVIMHYhk3Gxv8lEQYjVrSSTLXvEBENLF+CQd1Kp0jxXj09yGUOkWerdv2mJlh1Mnz3aRfYqWw== lib/seat-api.js
  sha512-Cj2FQb94MMtDPgHb1R1577pEMjYhc+P5pNgv1/QwoJD9ntuR9rnWlqJACS/xNniNK5cFS6Y6CpQlHWpzWUeEbw== lib/seat-api.min.js
  sha512-4C6oDKarS8DaXO99o342USbeQwqW98qik+QSzVGfof939gUpIyRDCnbGIGQAIkLNpYZIV4XanmRy3wcis6UW8w== lib/seat-api.min.js.map
  -->
  <script src="https://cdn.jsdelivr.net/npm/seatjs-api@7.0.4/lib/seat-api.min.js"
    integrity="sha512-LLDsX/GdVZYA82k9TVz3zUxSjvaX8s5b1FJm64W51JGxLFKI2z+ljqYQtsUZIOxh9pSUqvLA5HCoxXqdRxusKw=="
    crossorigin="anonymous"></script>

</head>
<body>
  See console object: SeatApi
</body>
</html>

SeatApi

Run nodeseat

Usage

SeatApi = require('seatjs-api') // Or SeatApi = require('./src')

seat = SeatApi() // // 127.0.0.1:8888

// 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 seatjs/json/api/v1..
seat.getInfo()

// A Promise is returned if a callback is not provided.
seat.getInfo({}).then(result => console.log(result))
seat.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
seat.getInfo(callback)

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

// Parameters can be an object
seat.getBlock({block_num_or_id: 1}, callback)
seat.getBlock({block_num_or_id: 1}).then(result => console.log(result))

Configuration

SeatApi = require('seatjs-api') // Or SeatApi = require('./src')

// everything is optional
options = {
  httpEndpoint: 'http://127.0.0.1:8888', // default, null for cold-storage
  verbose: false, // API logging
  logger: { // Default logging functions
    log: config.verbose ? console.log : null,
    error: config.verbose ? console.error : null
  },
  fetchConfiguration: {}
}

seat = SeatApi(options)

options.logger example

During testing, an error may be expected and checked as follows:

options.logger = {
  error: err => {
    assert.equal(err, 'expected error')
    done()
  }
}

options.fetchConfiguration example

options.fetchConfiguration = {
  credentials: 'same-origin'
}

Every seatjs-api request will run fetch with this configuration:

fetch('https://example.com', {
  credentials: 'same-origin'
})

Environment

Node and browser (es2015)