Skip to content
Hyperion History HTTP API
Branch: master
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.
__tests__
examples
src
.gitignore
LICENSE
README.md
index.ts
jest.config.js
package.json
tsconfig.json
tslint.json
yarn.lock

README.md

Hyperion HTTP API Javascript library

Installation

Using Yarn:

yarn add @jafri/hyperion

or using NPM:

npm install --save @jafri/hyperion

Quick Start

CommonJS

const { JsonRpc } = require("@jafri/hyperion")
const fetch = require("isomorphic-fetch")

const endpoint = "https://br.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })

TypeScript

import { JsonRpc } from "@jafri/hyperion"
import fetch from "isomorphic-fetch"

const endpoint = "https://br.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })

ENV Variables

HYPERION_ENDPOINT=<Enter Hyperion Endpoint>  # "https://br.eosrio.io"

Supported Endpoints

/v2/history/alive
/v2/history/get_abi_snapshot
/v2/history/get_actions
/v2/history/get_creator
/v2/history/get_key_accounts
/v2/history/get_tokens
/v2/history/get_transacted_accounts
/v2/history/get_transaction
/v2/history/get_transfers

API

Table of Contents

JsonRpc

JsonRpc

Parameters

  • endpoint string hyperion endpoint
  • args (optional, default {})

Examples

const endpoint = "https://br.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })

alive

GET /v2/history/alive

simple server healthcheck

Examples
const response = await rpc.alive();
console.log(response);
// => {"status": "OK"}

Returns Promise<Alive> alive

get_abi_snapshot

GET /v2/history/get_abi_snapshot

fetch contract abi at specific block

Parameters
  • contract string contract account
  • block
  • number number target block
Examples
const response = await rpc.get_abi_snapshot("eosio", 200);
console.log(response.version);
// => "eosio::abi/1.0"

for (const table of response.tables) {
    console.log(table);
    // => { name: 'producers', index_type: 'i64', key_names: [ 'owner' ], key_types: [ 'uint64' ], type: 'producer_info' }
}

Returns Promise<GetAbiSnapshot> abi snapshot

get_actions

GET /v2/history/get_actions

get actions based on notified account

Parameters
  • options object Optional parameters (optional, default {})
    • options.account string? notified account
    • options.filter string? code::name filter
    • options.skip number? skip [n] actions (pagination)
    • options.limit number? limit of [n] actions per page
    • options.sort string? sort direction
    • options.after string? filter after specified date (ISO8601)
    • options.before string? filter before specified date (ISO8601)
    • options.transfer_to string? transfer filter to
    • options.transfer_from string? transfer filter from
    • options.transfer_symbol string? transfer filter symbol
    • options.act_name string? act name
    • options.act_account string? act account
Examples
const response = await rpc.get_actions({
    account: "eoscafeblock",
    filter: "eosio.token:*",
    skip: 100,
    limit: 100,
});

for (const action of response.actions) {
    console.log(action);
    // => { act: { account: 'eosio.token', name: 'transfer', ... } }
}

Returns Promise<GetActions> get actions

get_creator

GET /v2/history/get_creator

get account creator

Parameters
  • account string created account
Examples
const response = await rpc.get_creator("eosnationftw");
console.log(response);
// => { account: 'eosnationftw', creator: 'gyztcmrvgqge', timestamp: '2018-06-10T13:06:43.500', ... }

Returns Promise<GetAccountCreator> get creator

get_key_accounts

GET/v2/history/get_key_accounts

get account by public key

Parameters
  • public_key string Contract account targeted by the action.
Examples
const response = await rpc.get_key_accounts("EOS5Mto3Km6BCVxowb6LkkFaT9oaUwLVgswgcxvY4Qgc4rhHry4Tv");
console.log(response.account_names);
// => [ 'eoscafeblock' ]

Returns Promise<GetKeyAccounts> key accounts

get_tokens

GET /v2/history/get_tokens

get tokens

Parameters
Examples
const response = await rpc.get_tokens("eosnationftw");
for (const token of response.tokens) {
    console.log(token);
    // => { symbol: 'ZOS', precision: 4, amount: 140, contract: 'zosdiscounts' }
}

Returns Promise<GetTokens> get tokens

get_transacted_accounts

GET /v2/history/get_transacted_accounts

get all account that interacted with the source account provided

Parameters
  • account string source account
  • direction string search direction (in, out or both)
  • options object Optional parameters (optional, default {})
    • options.symbol string? token symbol
    • options.contract string? token contract
    • options.min number? minimum value
    • options.max number? maximum value
    • options.limit number? query limit
Examples
const response = await rpc.get_transacted_accounts("eoscafeblock", "in");
console.log(response);
// => { query_time: 268, account: 'eoscafeblock', total_in: 1092369.1827, inputs: [ ... ] }

Returns Promise<GetTransactedAccounts> transacted accounts

get_transaction

GET /v2/history/get_transaction

get all actions belonging to the same transaction

Parameters
Examples
const response = await rpc.get_transaction("42dacd5722001b734be46a2140917e06cd21d42425f927f506c07b4388b07f62");
for (const action of response.actions) {
    console.log(action);
    // => { act: { account: 'eosio', name: 'buyrambytes', ... }}
}

Returns Promise<GetTransaction> transaction

get_transfers

GET /v2/history/get_transfers

get token transfers utilizing the eosio.token standard

Parameters
  • options object Optional parameters (optional, default {})
    • options.from string? source account
    • options.to string? destination account
    • options.symbol string? token symbol
    • options.contract string? token contract
    • options.after string? filter after specified date (ISO8601)
    • options.before string? filter before specified date (ISO8601)
Examples
const response = await rpc.get_transfers({to: "eosnewyorkio"});
for (const action of response.actions) {
    console.log(action.act.data);
    // => { from: 'eosio.bpay', to: 'eosnewyorkio', amount: 326.524, symbol: 'EOS', memo: 'producer block pay' }
}

Returns Promise<GetTransfers> transfers

You can’t perform that action at this time.