Hyperion HTTP API Javascript library
Installation
Using Yarn:
yarn add @eoscafe/hyperion
or using NPM:
npm install --save @eoscafe/hyperion
Quick Start
CommonJS
const { JsonRpc } = require("@eoscafe/hyperion")
const fetch = require("isomorphic-fetch")
const endpoint = "https://eos.hyperion.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })
TypeScript
import { JsonRpc } from "@eoscafe/hyperion"
import fetch from "isomorphic-fetch"
const endpoint = "https://eos.hyperion.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })
ENV Variables
HYPERION_ENDPOINT=<Enter Hyperion Endpoint>
Supported Endpoints
/v2/state/alive
/v2/state/get_key_accounts
/v2/state/get_tokens
/v2/state/get_voters
/v2/state/get_links
/v2/history/get_abi_snapshot
/v2/history/get_actions
/v2/history/get_created_accounts
/v2/history/get_creator
/v2/history/get_deltas
/v2/history/get_transacted_accounts
/v2/history/get_transaction
/v2/history/get_transfers
API
Table of Contents
JsonRpc
JsonRpc
Parameters
endpoint
string hyperion endpoint
Examples
const endpoint = "https://br.eosrio.io"
const rpc = new JsonRpc(endpoint, { fetch })
alive
GET /v2/state/alive
simple server healthcheck
Examples
const response = await rpc.alive();
console.log(response);
Returns Promise<Alive> alive
get_abi_snapshot
GET /v2/history/get_abi_snapshot
fetch contract abi at specific block
Parameters
contract
string contract accountblock
number
number target block
Examples
const response = await rpc.get_abi_snapshot("eosio", 200);
console.log(response.version);
for (const table of response.tables) {
console.log(table);
}
Returns Promise<GetAbiSnapshot> abi snapshot
get_voters
GET /v2/state/get_voters
get voters
Parameters
options
object Optional parameters (optional, default {}
)
options.producer
string? filter by voted producer (comma separated)options.proxy
boolean? true or falseoptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per page
Examples
const response = await rpc.get_voters({ producer: "eoscafeblock", limit: 100 });
console.log(response.voters);
Returns Promise<GetVoters> voters
get_actions
GET /v2/history/get_actions
get actions based on notified account
Parameters
account
string notified accountoptions
object Optional parameters (optional, default {}
)
options.filter
string? code::name filteroptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per pageoptions.sort
string? sort directionoptions.after
string? filter after specified date (ISO8601)options.before
string? filter before specified date (ISO8601)options.transfer_to
string? transfer filter tooptions.transfer_from
string? transfer filter fromoptions.transfer_symbol
string? transfer filter symboloptions.act_name
string? act nameoptions.act_account
string? act account
Examples
const response = await rpc.get_actions("eoscafeblock", {
filter: "eosio.token:*",
skip: 100,
limit: 100,
});
for (const action of response.actions) {
console.log(action);
}
Returns Promise<GetActions> get actions
get_created_accounts
GET /v2/history/get_created_accounts
get created accounts
Parameters
account
string created account
Examples
const response = await rpc.get_created_accounts("eosnationftw");
console.log(response);
Returns Promise<GetCreatedAccounts> get creator
get_creator
GET /v2/history/get_creator
get creator
Parameters
account
string created account
Examples
const response = await rpc.get_creator("eosnationftw");
console.log(response);
Returns Promise<GetCreator> get creator
get_deltas
GET /v2/history/get_deltas
get deltas
Parameters
Examples
const response = await rpc.get_deltas("eosio.token", "eosnationftw", "accounts", "eosnationftw");
console.log(response);
Returns Promise<GetDeltas> get deltas
get_key_accounts
GET/v2/state/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);
Returns Promise<GetKeyAccounts> key accounts
get_tokens
GET /v2/state/get_tokens
get tokens
Parameters
Examples
const response = await rpc.get_tokens("eosnationftw");
for (const token of response.tokens) {
console.log(token);
}
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 accountdirection
string search direction (in, out or both)options
Examples
const response = await rpc.get_transacted_accounts("eoscafeblock", "in");
console.log(response);
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);
}
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 accountoptions.to
string? destination accountoptions.symbol
string? token symboloptions.contract
string? token contractoptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per pageoptions.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);
}
Returns Promise<GetTransfers> transfers
JsonRpc
alive
GET /v2/state/alive
simple server healthcheck
Examples
const response = await rpc.alive();
console.log(response);
Returns Promise<Alive> alive
get_abi_snapshot
GET /v2/history/get_abi_snapshot
fetch contract abi at specific block
Parameters
contract
string contract accountblock
number
number target block
Examples
const response = await rpc.get_abi_snapshot("eosio", 200);
console.log(response.version);
for (const table of response.tables) {
console.log(table);
}
Returns Promise<GetAbiSnapshot> abi snapshot
get_voters
GET /v2/state/get_voters
get voters
Parameters
options
object Optional parameters (optional, default {}
)
options.producer
string? filter by voted producer (comma separated)options.proxy
boolean? true or falseoptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per page
Examples
const response = await rpc.get_voters({ producer: "eoscafeblock", limit: 100 });
console.log(response.voters);
Returns Promise<GetVoters> voters
get_actions
GET /v2/history/get_actions
get actions based on notified account
Parameters
account
string notified accountoptions
object Optional parameters (optional, default {}
)
options.filter
string? code::name filteroptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per pageoptions.sort
string? sort directionoptions.after
string? filter after specified date (ISO8601)options.before
string? filter before specified date (ISO8601)options.transfer_to
string? transfer filter tooptions.transfer_from
string? transfer filter fromoptions.transfer_symbol
string? transfer filter symboloptions.act_name
string? act nameoptions.act_account
string? act account
Examples
const response = await rpc.get_actions("eoscafeblock", {
filter: "eosio.token:*",
skip: 100,
limit: 100,
});
for (const action of response.actions) {
console.log(action);
}
Returns Promise<GetActions> get actions
get_created_accounts
GET /v2/history/get_created_accounts
get created accounts
Parameters
account
string created account
Examples
const response = await rpc.get_created_accounts("eosnationftw");
console.log(response);
Returns Promise<GetCreatedAccounts> get creator
get_creator
GET /v2/history/get_creator
get creator
Parameters
account
string created account
Examples
const response = await rpc.get_creator("eosnationftw");
console.log(response);
Returns Promise<GetCreator> get creator
get_deltas
GET /v2/history/get_deltas
get deltas
Parameters
Examples
const response = await rpc.get_deltas("eosio.token", "eosnationftw", "accounts", "eosnationftw");
console.log(response);
Returns Promise<GetDeltas> get deltas
get_key_accounts
GET/v2/state/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);
Returns Promise<GetKeyAccounts> key accounts
get_tokens
GET /v2/state/get_tokens
get tokens
Parameters
Examples
const response = await rpc.get_tokens("eosnationftw");
for (const token of response.tokens) {
console.log(token);
}
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 accountdirection
string search direction (in, out or both)options
Examples
const response = await rpc.get_transacted_accounts("eoscafeblock", "in");
console.log(response);
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);
}
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 accountoptions.to
string? destination accountoptions.symbol
string? token symboloptions.contract
string? token contractoptions.skip
number? skip [n] actions (pagination)options.limit
number? limit of [n] actions per pageoptions.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);
}
Returns Promise<GetTransfers> transfers
Error
Error