Token & Balances

The ToroForge SDK provides simple, secure methods to retrieve wallet balances across different supported currencies on the Toronet blockchain.

Supported tokens:

  • NGN (Naira – fiat-backed)

  • USD (US Dollar – fiat-backed)

  • ToroG (Toronet’s native token)

📦 Get Wallet Balance

To get a wallet’s full balance breakdown (NGN, USD, ToroG):

import { getBalance } from 'torosdk';

const balances = await getBalance({
  address: '0xYourWalletAddress',
});

console.log(balances);
/*
{
  ngnBalance: '1000',
  usdBalance: '25.50',
  toroGBalance: '430'
}
*/

Returned object includes:

  • ngnBalance: Naira balance

  • usdBalance: USD balance

  • toroGBalance: Native ToroG token amount

📊 Response Format

{
  ngnBalance: string;
  usdBalance: string;
  toroGBalance: string;
}

Note: All amounts are returned as strings, already normalized for display (i.e. not in smallest unit like wei).

🧩 Use Cases

You can use this method to:

  • Display balances on a user dashboard

  • Validate available funds before initiating a transaction

  • Refresh balances after a fiat deposit or on-chain token transfer

⚠️ Important Notes

  • Ensure the address passed in is a valid Toronet address.

  • Fiat-backed tokens like NGN and USD require successful KYC verification for high-volume usage.

  • For real-time updates, consider calling this method after:

    • Successful deposits

    • Transfers between wallets

    • KYC approval confirmation

🔗 Related Docs

PreviousWallet ManagementNextFiat Deposit & Verification

Last updated