@zilliqa-js/viewblock v0.0.5

@zilliqa-js/viewblock

A library interfacing with the Zilliqa blockchain and ViewBlock's APIs

Table of Contents

• Setup
  • Client
• Transactions
  • getTx
  • getPendingTxs
  • createTx
• Addresses
  • getAddress
  • getAddressTxs
  • getAddressTokenTxs
• Smart Contracts
  • getSCInit
  • getSCState
• Blocks
  • getBlock
  • getBlockTxs
• Subscriptions
  • block
  • transaction
  • addressTx
  • contractEvent
• Misc
  • getGasPrice

Setup

Install using your favorite package manager.

yarn add @zilliqa-js/viewblock

Client

The library client is exposed as the default export in the form of a factory function.

:warning: Although not enforced, not providing an apiKey will disable most of the methods of the library. Get one on ViewBlock by creating an account and a key in your settings.

import Zilliqa from '@zilliqa-js/viewblock'

const client = Zilliqa({
  apiKey: 'xxx',
})

You can obviously use basic commonjs requires too:

const Zilliqa = require('@zilliqa-js/viewblock')

The agent parameter allows to use any http.Agent implementation of your choice. As an example, https-proxy-agent could be provided to proxy the requests.

These 3 parameters passed when creating the client act as a global default configuration, but can be overriden on each individual call for convenience purposes. As an example:

const client = Zilliqa({ apiKey: 'xxx' })

client.getBlock(42, { network: 'testnet' })
client.getGasPrice({ network: 'testnet' })

Here, although the client defaults to mainnet, we override it specifically for these two calls. It won't affect subsequent methods, as they will use the default network.

All the methods return a Promise, making it await compatible.

Transactions

getTx

Get one transaction by hash.

await client.getTx('0x65fd90f1fc2d3b631a0cf6a77be9947e9f4559d9ece9b9a1eef170d593bd9213')

{
  hash: '0x65fd90f1fc2d3b631a0cf6a77be9947e9f4559d9ece9b9a1eef170d593bd9213',
  blockHeight: 577008,
  from: 'zil1kshhphza3vlyfamjchamk2d3j022a55kn6es38',
  to: 'zil1z3zky3kv20f37z3wkq86qfy00t4a875fxxw7sw',
  value: '29000000000000',
  fee: '1000000000',
  timestamp: 1590005268574,
  signature:
    '0xEA74CF5062954368ECBEB9EA00014C9F78590391703E0DCEF002FAB50D30C1147D84BDC8A1703A33181CD3BDE315E6B28627EB0266DCD0D3CB886130B06312D1',
  nonce: 1,
  receiptSuccess: true,
  data: null,
  internalTransfers: [],
  events: [],
  transitions: []
}

getPendingTxs

:warning: Pending implementation.

createTx

Create a transaction using the JSON RPC. Follow the create transaction transaction parameters documentation to get a better idea on how to construct it.

await client.createTx({
  version: 65537,
  nonce: 1,
  toAddr: '0x4BAF5faDA8e5Db92C3d3242618c5B47133AE003C',
  amount: '1000000000000',
  pubKey: '0205273e54f262f8717a687250591dcfb5755b8ce4e3bd340c7abefd0de1276574',
  gasPrice: '1000000000',
  gasLimit: '1',
  code: '',
  data: '',
  signature: '29ad673848dcd7f5168f205f7a9fcd1e8109408e6c4d7d03e4e869317b9067e636b216a32314dd37176c35d51f9d4c24e0e519ba80e66206457c83c9029a490d',
  priority: false
})

{
  msg: 'Non-contract txn, sent to shard',
  hash: '2d1eea871d8845472e98dbe9b7a7d788fbcce226f52e4216612592167b89042c'
}

Addresses

getAddress

Retrieve one address by hash.

await client.getAddress('zil1hqn9w4tf23x8lxh6vk5jv9hupt0s85gemyetmu', { network: 'testnet' })

{
  hash: 'zil1hqn9w4tf23x8lxh6vk5jv9hupt0s85gemyetmu',
  balance: '999962495000000000',
  nonce: 4,
  type: 'normal'
}

getAddressTxs

Get the transactions made by an address.

await client.getAddressTxs('zil16awfafxs789g8nthnm5s9p4l8vnxs5zpfr3upr', { page: 1 })

{
  docs: [
    {
      hash: '0xced4731d535e1b0ba72d562d6c1dfd0ef71d1189abfa1ead8341667ca22aa01b',
      blockHeight: 1128974,
      from: 'zil15wglkgh0vht9zeaqe9x4axmw4nkw2mr79z6g3x',
      to: 'zil16awfafxs789g8nthnm5s9p4l8vnxs5zpfr3upr',
      value: '25000000000000',
      fee: '3026000000000',
      timestamp: 1581304554974,
      signature:
        '0x2E293AB15F747F90292D1262731DCD597008C456266E654466823728F92BDC6F6FB7E819C9A1518DA827C0031E1A7DD349FA920B04C420359053808E3E177648',
      direction: 'in',
      nonce: 312,
      receiptSuccess: true,
      data: '{"_tag": "request", "params": []}',
      internalTransfers: [
        {
          from: 'zil16awfafxs789g8nthnm5s9p4l8vnxs5zpfr3upr',
          to: 'zil1mejpsqd5cw589xyq3llzvrk0nvetm9v0l5kcn7',
          value: '25000000000000',
          direction: 'in',
          depth: '0,0',
        },
      ],
      events: [
        {
          address: 'zil1mejpsqd5cw589xyq3llzvrk0nvetm9v0l5kcn7',
          name: 'request',
          details:
            'request (String msg, Uint32 id, ByStr20 from, Uint32 reqtype, Uint128 gaslimit, Uint128 gasprice, String paramdata, Uint128 fee)',
          params: {
            msg: 'send request success',
            id: '10',
            from: '0xa391fb22ef65d65167a0c94d5e9b6eacece56c7e',
            reqtype: '1',
            gaslimit: '20000',
            gasprice: '1000000000',
            paramdata:
              "{'url':'https://samples.openweathermap.org/data/2.5/weather',\n    'params':{'q':'London,uk','appid':'b6907d289e10d714a6e88b30761fae22'}}",
            fee: '3999000000000',
          },
        },
      ],
      transitions: [
        {
          addr: '0xd75c9ea4d0f1ca83cd779ee90286bf3b26685041',
          depth: 0,
          msg: {
            _amount: '25000000000000',
            _recipient: '0xde641801b4c3a87298808ffe260ecf9b32bd958f',
            _tag: 'request',
            params: [
              {
                type: 'ByStr20',
                value: '0xa391fb22ef65d65167a0c94d5e9b6eacece56c7e',
                vname: 'user_addr',
              },
              {
                type: 'Uint32',
                value: '1',
                vname: 'request_type',
              },
              {
                type: 'String',
                value:
                  "{'url':'https://samples.openweathermap.org/data/2.5/weather',\n    'params':{'q':'London,uk','appid':'b6907d289e10d714a6e88b30761fae22'}}",
                vname: 'param_data',
              },
              {
                type: 'Uint128',
                value: '1000000000',
                vname: 'gas_price',
              },
              {
                type: 'Uint128',
                value: '20000',
                vname: 'gas_limit',
              },
              {
                type: 'String',
                value: 'callback',
                vname: 'callback_func',
              },
            ],
          },
        },
        {
          addr: '0xde641801b4c3a87298808ffe260ecf9b32bd958f',
          depth: 1,
          msg: {
            _amount: '25000000000000',
            _recipient: '0xc4818b8c0d0c2ae775e8ed1998d72c7aa0743063',
            _tag: '',
            params: [],
          },
        },
      ],
    },
    {
      hash: '0x6bc8fcd7a14bef419eae03d8d9ac68de0bcc279a50a86fe3a00c24d99833c5e3',
      blockHeight: 1064704,
      from: 'zil10h9339zp277h8gmdhds6zuq0elgpsf5qga4qvh',
      to: 'zil16awfafxs789g8nthnm5s9p4l8vnxs5zpfr3upr',
      value: '0',
      fee: '2590000000000',
      timestamp: 1579266403473,
      signature:
        '0x5A72F6B4826EBCE69F62DB2D85991D780A54ED4C459BB0732EB1F8B2C77DDE8F2B3DB6F022797561809E30310E830E755A98EDAE526F96675A76137815BBF81C',
      direction: 'in',
      nonce: 208,
      receiptSuccess: true,
      data:
        '[{"vname": "_scilla_version", "type": "Uint32", "value": "0"}, {"vname": "owner", "type": "ByStr20", "value": "0x7dcb18944157bd73a36dbb61a1700fcfd0182680"}]',
      internalTransfers: [],
      events: [],
      transitions: [],
    },
  ],
  page: 1,
  totalPages: 1,
  total: 2,
  limit: 25,
  nextPage: null,
  prevPage: null
}

getAddressTokenTxs

Get the token transactions associated with an address. Note token can be specified to filter for specific token transactions.

await client.getAddressTokenTxs('zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml', {
  page: 1,
  token: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
})

{
  docs: [
    {
      hash: '0x3c60b3194a175fa4d484fb3074f3bd7ba9bfd62c7d6dc1da6f86a4c948bb7f92',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0.02',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776290,
      timestamp: 1599139330519,
      direction: 'in',
    },
    {
      hash: '0x7b7555d456cf4415c1f58af26a8b8788ebb3431c41ccb893d0c3a06c2157c064',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776298,
      timestamp: 1599139497307,
      direction: 'in',
    },
    {
      hash: '0xc5f582866251b022ac32e98a6e4598319288234ef8722b04bf5c285122094af1',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0.01',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776348,
      timestamp: 1599140579375,
      direction: 'in',
    },
    {
      hash: '0x7b1356842d1e595384ee2de38df7fc24ed1a57f5df65c3cc23c7b4f02415cdeb',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0.04',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776384,
      timestamp: 1599141333323,
      direction: 'in',
    },
    {
      hash: '0x7e1da8fb622bfb6203d65573cb4367077f85fd65b90697fd82ca3e8e145b0841',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776390,
      timestamp: 1599141458698,
      direction: 'in',
    },
    {
      hash: '0xe0094c46b4bd1fb0ef0fbb623c9d0431f835d850a28e8a5b81886ca7e91061b2',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776704,
      timestamp: 1599148162726,
      direction: 'in',
    },
    {
      hash: '0x785f21e312a10307907ac3f06da0d6056056082fa0265ef64fa8b402676425ab',
      from: 'zil1qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq9yf6pz',
      to: 'zil1my8ju5uvur0cnjp88jknkclvgj3ufmvz5pxyml',
      value: '0.0196969696',
      tokenAddress: 'zil1l8mn5r5urrlxzf6q9z790zz2c5a9ya8366hzre',
      blockHeight: 1776986,
      timestamp: 1599154120380,
      direction: 'in',
    },
  ],
  page: 1,
  totalPages: 1,
  total: 7,
  limit: 25,
  nextPage: null,
  prevPage: null
}

Smart Contracts

getSCInit

Get the init parameters of a given smart contract.

await client.getSCInit('zil1cm2x24v7807w7yjvmkz0am0y37vkys8lwtxsth') 

[
  {
    "type": "Uint32",
    "value": "0",
    "vname": "_scilla_version"
  },
  {
    "type": "List ByStr20",
    "value": {
      "argtypes": [
        "ByStr20"
      ],
      "arguments": [
        "0x5B42879E9c497EdAE5b3A7B3DCfD40920feC0599",
        {
          "argtypes": [
            "ByStr20"
          ],
          "arguments": [
            "0x98c656454b4E27762ab62D176246f31def011875",
            {
              "argtypes": [
                "ByStr20"
              ],
              "arguments": [
                "0x09EE3238528247354862700f5C00A349a499badB",
                {
                  "argtypes": [
                    "ByStr20"
                  ],
                  "arguments": [
                    "0x705856236100A28106BD3b760ADaFDea7F990dFB",
                    {
                      "argtypes": [
                        "ByStr20"
                      ],
                      "arguments": [],
                      "constructor": "Nil"
                    }
                  ],
                  "constructor": "Cons"
                }
              ],
              "constructor": "Cons"
            }
          ],
          "constructor": "Cons"
        }
      ],
      "constructor": "Cons"
    },
    "vname": "owners_list"
  },
  {
    "type": "Uint32",
    "value": "2",
    "vname": "required_signatures"
  },
  {
    "type": "BNum",
    "value": "300675",
    "vname": "_creation_block"
  },
  {
    "type": "ByStr20",
    "value": "0xc6d465559e3bfcef124cdd84feede48f996240ff",
    "vname": "_this_address"
  }
]

getSCState

Get the state or sub-state of a smart contract.

await client.getSCState('zil1cm2x24v7807w7yjvmkz0am0y37vkys8lwtxsth') 

{
  _balance: "762000001000000000000",
  contract_valid: {
    argtypes: [],
    arguments: [],
    constructor: 'Valid'
  },
  owners: {
    '0x09ee3238528247354862700f5c00a349a499badb': {
      argtypes: [],
      arguments: [],
      constructor: 'True'
    },
    '0x5b42879e9c497edae5b3a7b3dcfd40920fec0599': {
      argtypes: [],
      arguments: [],
      constructor: 'True'
    },
    '0x705856236100a28106bd3b760adafdea7f990dfb': {
      "argtypes": [],
      "arguments": [],
      "constructor": 'True'
    },
    '0x98c656454b4e27762ab62d176246f31def011875': {
      argtypes: [],
      arguments: [],
      constructor: 'True'
    }
  },
  signature_counts: {},
  signatures: {},
  transactionCount: '0',
  transactions: {}
}

If you want to retrieve only part of the contract state, send an object payload and provide the optional name or indices parameters:

await client.getSCState({
  address: 'zil1cm2x24v7807w7yjvmkz0am0y37vkys8lwtxsth',
  name: 'owners',
  indices: ['0x09ee3238528247354862700f5c00a349a499badb'],
}) 

{
  owners: {
    '0x09ee3238528247354862700f5c00a349a499badb': {
      argtypes: [],
      arguments: [],
      constructor: 'True'
    }
  }
}

Blocks

getBlock

Retrieve one block information by its height.

await client.getBlock(59903)

{
  height: 59903,
  timestamp: 1554172478877,
  txCount: 890,
  dsHeight: 600,
  gasLimit: '1500000',
  gasUsed: '890',
  minerPubKey: '0x0227939F72067FE1AC79276CE779A27C560391A660D42FDE0102229964F1C2C511',
  microBlocks: [
    {
      hash: '3b7041c131b80fc8ab6aa65fc1590272f08ce13c0919a621563e90ab544f948c',
      shardId: 0,
      txRootHash: 'ed461421c0a698ed009aeefddc5a4d1c0a03570081931efdc75d5e5d54e4e017'
    },
    {
      hash: 'ed64ecba273c3366e4fc558c218f8d67d7c1e2ccf77dc10379f41fb279af70ee',
      shardId: 1,
      txRootHash: '692374ea2ad4ac5240ec8ee89d9d3a5899a6ed8c1c25d96ed9ad2066ce0539c5'
    },
    {
      hash: '4f3dcf4078ecc0e4cae69068565b72fbd47012daa0f858bafb028edf1536a3ff',
      shardId: 2,
      txRootHash: '0000000000000000000000000000000000000000000000000000000000000000'
    }
  ],
  stateDeltaHash: '6e62ee3e1af7927a1c9ee8ec375951770b38a34305f3eae772f673942dfb5923',
  stateRootHash: '6dde256dd2be07ef69906a31790c539266b410ffdfba64198e6f16ed7b62d888'
}

getBlockTxs

Retrieve the transactions confirmed in a block.

await client.getBlockTxs(59903, { page: 1 })

{
  docs: [
    {
      hash: '0xfe55cf4954507a5b809cdfa8725a499d0656e3644838c2cd826eaa57a8e48f62',
      from: 'zil16ttxueshqnnun5hlen8ql8q5rvx7vvtm63ccna',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '703140978601111',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xfd816a3d5118d7a21e4a56d2c91f06a30315e0ba8851cfdaf6b9a6c61fc524fd',
      from: 'zil1mtzdp32j5jm7hfj4n3mxzf24lt779mf93pw0dy',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '1887350370678611',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xfd0448f629b93038b5e4cddd51d2b90f9682882cd40ef3ee465bc4f0e55e357b',
      from: 'zil19n6d3h6a3jalkucg9aue8m3gaqdjt3ltayktml',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '749245402553526',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xfbc097da285c436171d4724c3a4fbf6aa6c309868bf717aa6bebf6bab09cdc10',
      from: 'zil1ph8pkmdgche9y9n529qdu9z4q772440eaae5pe',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '569420970197693',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xfa8bf7715d4cbe23524e72ab7920efac722be6284445dccdade4b0b6f6a4caac',
      from: 'zil1ujn9s37yc7hs0eklnwfnhrkgvtqljdwafgxjm2',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '426896695040558',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf9072f1aafad82a8f144b32b4404f685649fbcc82518d3c731835ec745211179',
      from: 'zil18ejxkf2u3cfknr6kulp36g6drsvylf6t3w0cpe',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '1193069646888861',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf8fc4928dfd539f9bf84a52531c8b06d59a95615c7845e4cb37b5f92aae775cd',
      from: 'zil1thtkpmzjpx26jhyvau2xdy5s7e66rvu9xcu2gh',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '996044741466089',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf8b489747fa37488634eb2c14d38784729157ee9c46be59744a70dbd133cf587',
      from: 'zil10pfk76qdxmykvxqfu7ffajkgshe240v3x26w65',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '270809781797106',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf895b7f488bbecc8c91e8101163c1a2fa2731e6af1ca70dd49f45a18ecb4ca81',
      from: 'zil1mwz4xelqdkddqdnvdptagx57mmzktjfaz2mjpz',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '1504033644577742',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf8339e2ae31695d1ca04a9fd238029f9c75de36665f06726fe0d5096aad85b8b',
      from: 'zil1phfhqqh5axt7ehmlj3vul3syc48xhyp47h65gr',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '1477095734460620',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf81b71e96f13760d405f88b7f97ee7a4ef71174e7018d041b03c0f27a3760b4b',
      from: 'zil1xrr4s95lsgxur9seqp34ck5g7ml7relmp7v5rz',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '458516000791614',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf78f7c922e5b4134020ce0f3db293b7a73a3eb417b25cf9ec519aab78355d216',
      from: 'zil17m0k2yrwkwakgg20hncpmd5sqdsl2qfhdhncds',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '1935315546888898',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf78f0b36d102e3ef84df276400a0c3ae226a822df89204a7a525bda7f87b39c7',
      from: 'zil1df9a5sjwc2z26nt04u8tzyepp4m8ffvav4m6r3',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '553574187949524',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf74a6e9bd7966c3511ef64babcef2ae3ce5d92f3385bd27f1385615ba830ab35',
      from: 'zil1zyz8prlg4d8vgd4v33y5j8chzn5tuerlue9lst',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '1303886940618567',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf73f85115573583f3e9df51311b309c17671e400e0627d6637dad64bb590e4d8',
      from: 'zil1g3s4wcum26qxansyd0kyyxl7fua5gj8hataw72',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '735988218756618',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf73c0822667907d34d8c68ce479cac1d135858675fa1c6744a4fbbe0b2a67855',
      from: 'zil1lv6ndxd32z6tva3umadggmhat94swsk3ze24xt',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '771788300225705',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf6f31a96e497dfee0d365ad3c82a4c7cea79530a22a2dcd1bee4a951b755d881',
      from: 'zil15w6xm7uhlng98qflsqfjf8u3kw785nh42yyhz4',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '633389789623963',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf59bc4f6e7d0f242850f54cd05405d44996057ce24f358425f74672099166a16',
      from: 'zil1fmp5jhpxhj4g3zgq5nymwcnpnuwftq0fzcu5yw',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '916336607383980',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf53b2045870539c2a2afbc2198f55059477f2a366b1671a2a31303e351836385',
      from: 'zil19zjpgvsm2nh3qf5r2c0k2gfyznnnp39mxfvqua',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '754173130172251',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf4effdc7b51e640031d296db79f06581355afb2962898ad0927997d65562e7df',
      from: 'zil1dvugerq6rg35jxvplvmx7c3w5rvset3rt4fk7x',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '498768754250469',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf4e059c173886bd7ff2a752df35f056a04152957079eb5a81de8d28027a925f7',
      from: 'zil17kd4gs50y8mhj7f6e5ryq4qwpwp4tvrn8cdhue',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '799534610127843',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []    },
    {
      hash: '0xf415e05851f7e94437f54e8ad4616d909bd082c1af746aca952582a315f0ba11',
      from: 'zil10dapalzz0gua9z9gkrm6rdfg0j33ypq4ey37dm',
      to: 'zil1ggkgt2mcl92hw6yccer0f2q694xqkr6dk25cag',
      value: '666457777688691',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf3c9bebca62fcb2362e4a55d6bdbd9def62c1de6ac5f561e934faa0428f1bd58',
      from: 'zil1kvzkh7hly8dd97xzaursd9xhvy2z0rhr6sqsgy',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '711495675155375',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf3545f099634bff0a536d9f8dfa74e361e1691b4c14df110b8099e4611622b6f',
      from: 'zil1jmwcy29y7whd5y8mys693hprjxsju83h384h7j',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '365449579421433',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    },
    {
      hash: '0xf2a8773c01d5f3df44bcfa529b49118cf90d261ff63087609651cdc336f177f7',
      from: 'zil1h55wdqlhy8eaenlleyr38wnv0mj4wmkaq8xr87',
      to: 'zil1m9pv2cr087ewxncupyeujsr0q3fmulu6ep5elv',
      value: '724632233105521',
      fee: '1000000000',
      timestamp: 1554172478877,
      nonce: 1,
      receiptSuccess: true,
      events: [],
      data: null,
      internalTransfers: [],
      transitions: []
    }
  ],
  totalDocs: 890,
  limit: 25,
  hasPrevPage: false,
  hasNextPage: true,
  page: 1,
  totalPages: 36,
  pagingCounter: 1,
  prevPage: null,
  nextPage: 2,
  pages: 36,
  total: 890
}

Subscriptions

Allows to listen on a variety of events.

:warning: We do not guarantee either the order upon which the messages are sent, nor that all the messages will be delivered successfully (typically in case of an outage or disruption of service).

block

Subscribe to new blocks.

client.subscribe('block', console.log)

transaction

Subscribe to new transactions.

client.subscribe('transaction', console.log)

addressTx

Subscribe to transactions made to or from a specific address.

client.subscribe({ event: 'addressTx', param: 'zil1gqww6yq9d9nefhg3rec989kxsqs4zm8dzeyr0q' }, console.log)

contractEvent

Subscribe to events emitted by one contract.

client.subscribe({ event: 'contractEvent', param: 'zil1vszj220406ez4gglpf6jvlds5jkszju63kpvax' }, console.log)

Misc

getGasPrice

Get the current minimum gas price for this DS epoch.

await client.getGasPrice()

'1000000000'