LIGHT API HTTP Javascript library
Installation
Using Yarn:
yarn add @eoscafe/light-api
or using NPM:
npm install --save @eoscafe/light-api
Quick Start
CommonJS
const { JsonRpc } = require("@eoscafe/light-api")
const fetch = require("isomorphic-fetch")
const endpoint = "https://api.light.xeos.me"
const rpc = new JsonRpc(endpoint, { fetch, chain: "eos" })
TypeScript
import { JsonRpc } from "@eoscafe/light-api"
import fetch from "isomorphic-fetch"
const endpoint = "https://api.light.xeos.me"
const rpc = new JsonRpc(endpoint, { fetch, chain: "eos" })
API
Table of Contents
- JsonRpc
- JsonRpc
- Error
- Error
JsonRpc
JsonRpc
Parameters
-
endpoint
string LIGHT API endpoint
Examples
const endpoint = "https://api.light.xeos.me"
const rpc = new JsonRpc(endpoint, { fetch, chain: "eos" })
get_account
[GET /api/account]
Retrieve all token balances, resources and authorization information for an account:
Parameters
-
accountName
string name of account
Returns Promise<GetAccount> account
get_account_info
[GET /api/accinfo]
Retrieve all resources and authorization information for an account:
Parameters
-
accountName
string name of account
Returns Promise<GetAccountInfo> account
get_balances
[GET /api/balances]
Retrieve only token balances for an account
Parameters
-
accountName
string name of account
Returns Promise<GetBalances> balances
get_key_accounts
[GET /api/key]
Retrieve all accounts in all known EOS networks dependent on a public key:
Parameters
-
key
string public key
Returns Promise<GetKeyAccounts> accounts
get_networks
[GET /api/networks]
Retrieve all accounts in all known EOS networks dependent on a public key:
Returns Promise<GetNetworks> accounts
get_sync_info
[GET /api/sync]
returns a plain text with delay in seconds that this server's blockchain database is behind the real time, and a status: OK if the delay is within 180 seconds, or 'OUT_OF_SYNC' otherwise.
Returns Promise<string> get sync
get_token_balance
[GET /api/tokenbalance]
returns a plain text with numeric output indicating the token balance. Zero is returned if the token is not present or does not exist.
Parameters
Returns Promise<string> token balance
get_topholders
[GET /api/topholders]
returns top NUM holders of a specified token in a JSON array containing arrays of (account, amount) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
contract
string token contract -
token
string token symbol -
num
string number of top holders (min 10, max 1000)
Returns Promise<string> token balance
get_usercount
[GET /api/usercount]
returns a plain text with total number of accounts in the network.
Returns Promise<string> token balance
get_topram
[GET /api/topram]
returns top NUM RAM buyers in a JSON array containing arrays of (account, bytes) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
num
string number of top holders (min 10, max 1000)
Returns Promise<GetTopRam> top ram holders
get_topstake
[GET /api/topstake]
returns top NUM RAM buyers in a JSON array containing arrays of (account, bytes) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
num
string returns top NUM stake holders by sum of CPU and Net stakes, in a JSON array containing arrays of (account, cpu_weight, net_weight) tuples. NUM must not be less than 10 or more than 1000.
Returns Promise<GetTopStake> top stake holders
get_codehash
[GET /api/codehash]
retrieves all accounts in all known EOS networks by contract hash.
Parameters
hash
-
num
string returns top NUM stake holders by sum of CPU and Net stakes, in a JSON array containing arrays of (account, cpu_weight, net_weight) tuples. NUM must not be less than 10 or more than 1000.
Returns Promise<GetCodehash> accounts
get_tokenholder_count
[GET /api/holdercount]
returns a plaintext integer indicating the number of accounts with positive balance for a specified token.
Parameters
JsonRpc
get_account
[GET /api/account]
Retrieve all token balances, resources and authorization information for an account:
Parameters
-
accountName
string name of account
Returns Promise<GetAccount> account
get_account_info
[GET /api/accinfo]
Retrieve all resources and authorization information for an account:
Parameters
-
accountName
string name of account
Returns Promise<GetAccountInfo> account
get_balances
[GET /api/balances]
Retrieve only token balances for an account
Parameters
-
accountName
string name of account
Returns Promise<GetBalances> balances
get_key_accounts
[GET /api/key]
Retrieve all accounts in all known EOS networks dependent on a public key:
Parameters
-
key
string public key
Returns Promise<GetKeyAccounts> accounts
get_networks
[GET /api/networks]
Retrieve all accounts in all known EOS networks dependent on a public key:
Returns Promise<GetNetworks> accounts
get_sync_info
[GET /api/sync]
returns a plain text with delay in seconds that this server's blockchain database is behind the real time, and a status: OK if the delay is within 180 seconds, or 'OUT_OF_SYNC' otherwise.
Returns Promise<string> get sync
get_token_balance
[GET /api/tokenbalance]
returns a plain text with numeric output indicating the token balance. Zero is returned if the token is not present or does not exist.
Parameters
Returns Promise<string> token balance
get_topholders
[GET /api/topholders]
returns top NUM holders of a specified token in a JSON array containing arrays of (account, amount) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
contract
string token contract -
token
string token symbol -
num
string number of top holders (min 10, max 1000)
Returns Promise<string> token balance
get_usercount
[GET /api/usercount]
returns a plain text with total number of accounts in the network.
Returns Promise<string> token balance
get_topram
[GET /api/topram]
returns top NUM RAM buyers in a JSON array containing arrays of (account, bytes) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
num
string number of top holders (min 10, max 1000)
Returns Promise<GetTopRam> top ram holders
get_topstake
[GET /api/topstake]
returns top NUM RAM buyers in a JSON array containing arrays of (account, bytes) pairs. NUM must not be less than 10 or more than 1000.
Parameters
-
num
string returns top NUM stake holders by sum of CPU and Net stakes, in a JSON array containing arrays of (account, cpu_weight, net_weight) tuples. NUM must not be less than 10 or more than 1000.
Returns Promise<GetTopStake> top stake holders
get_codehash
[GET /api/codehash]
retrieves all accounts in all known EOS networks by contract hash.
Parameters
hash
-
num
string returns top NUM stake holders by sum of CPU and Net stakes, in a JSON array containing arrays of (account, cpu_weight, net_weight) tuples. NUM must not be less than 10 or more than 1000.
Returns Promise<GetCodehash> accounts
get_tokenholder_count
[GET /api/holdercount]
returns a plaintext integer indicating the number of accounts with positive balance for a specified token.