Addresses & Balances

Query account balances and transaction history for wallet addresses.

RPCgetBalanceByAddressRead

Get the total balance of a single Sahyadri address. Used by wallets for balance display and exchanges for deposit verification. Uses the Account Model - direct balance lookup without UTXO scanning.

Parameters

Parameter	Type	Required	Description
`address`	string	Required	Sahyadri address (csm1s...)

{
  "id": 1,
  "method": "getBalanceByAddress",
  "params": ["csm1sexample..."]
}

// Response
{
  "balance": "2301100000000"  // in Kana (divide by 100000000 for CSM)
}

// Convert to CSM:
// 2301100000000 / 100000000 = 23011 CSM

RPCgetBalancesByAddressesRead

Get balances for multiple addresses in a single call. Efficient for exchanges managing many hot wallets. Single RPC call instead of multiple individual queries.

{
  "id": 2,
  "method": "getBalancesByAddresses",
  "params": [[
    "csm1saddress1...",
    "csm1saddress2...",
    "csm1saddress3..."
  ]]
}

// Response
{
  "entries": [
    { "address": "csm1saddress1...", "balance": "1000000000" },
    { "address": "csm1saddress2...", "balance": "500000000" },
    { "address": "csm1saddress3...", "balance": "0" }
  ]
}

Address Format

Sahyadri addresses use Bech32 encoding with csm1s prefix.

Format: csm1s + 38 base32 characters
Total Length: 42 characters
Charset: Base32 (no 0, O, I, l)

Example: csm1sexampleaddress0000000000000000000000000000000000

Sahyadri uses the Account Model.
No UTXO selection needed - balances are stored directly in account state. This eliminates dust, change addresses, and complex coin selection.

Balance Summary

Account

Balance Model

Decimals

csm1s

Address Prefix

Balance Methods