Blockchain Queries

The ToroForge Node.js SDK provides access to on-chain data from the Toronet blockchain — allowing developers to build block explorers, track transactions, and monitor network health in real time.

🧾 What You Can Query

  • Latest blockchain status

  • Most recent block data

  • Recent on-chain transactions

  • Historical block information

  • Current exchange rates for supported tokens

📟 Get Blockchain Status

Returns general metadata about the current blockchain state.

import { getBlockchainStatus } from 'torosdk';

const status = await getBlockchainStatus();

console.log(status);
/*
{
  lastblock: '45021',
  peers: 4,
  pendingtx: 2,
  status: 'online'
}
*/

⛓️ Get Latest Block Data

Retrieve metadata about the most recent block.

import { getLatestBlockData } from 'torosdk';

const latestBlock = await getLatestBlockData();

📦 Get Recent Transactions

Get a list of the most recent blockchain transactions.

import { getBlockchainTransactions } from 'torosdk';

const transactions = await getBlockchainTransactions(10); // Fetch last 10 txs

📚 Get Historical Block Data

Query any specific number of recent blocks.

import { getBlocksData } from 'torosdk';

const blocks = await getBlocksData(5); // Last 5 blocks

Each block includes details such as:

  • Timestamp

  • Block height

  • Transactions

  • Hashes

  • Block creator

💱 Get Exchange Rates

Returns the latest known exchange rates between fiat and ToroG.

import { getSupportedAssetsExchangeRates } from 'torosdk';

const rates = await getSupportedAssetsExchangeRates();

Example response:

{
  NGN: 1,
  USD: 0.014,
  KSH: 1.85
}

Use this data to:

  • Display fiat → token conversion

  • Calculate deposits or rewards

  • Validate exchange values

🧠 Use Cases

  • Build a block explorer interface

  • Display live block activity on dashboards

  • Provide transaction history inside user apps

  • Integrate real-time token pricing

⚠️ Tips

  • Always implement retry or fallback logic — nodes may rate-limit requests.

  • You may cache block results to avoid unnecessary network calls in frontend apps.

  • Use getBlockchainTransactions only when you need general network activity (not tied to a specific address).

🔗 Related Docs

PreviousTransfersNextUtilities & Helpers

Last updated