Skip to content

Operate

Reconciliation: supply integrity check

Compares the nTZS total supply on Base against the sum of every wallet balance the platform tracks. Use it as an independent integrity signal alongside your own ledger.

This is a platform-wide figure, not your statement. It answers “is total supply backed by the balances we know about” across every wallet on the platform, not “does my account balance.” To reconcile your own books, sum the resources you created: deposits, transfers, withdrawals and spends, each read back by id.
Reading the result. isReconciled allows under 1 TZS of rounding. A positive difference means supply exists that is not in a tracked wallet. That is expected if tokens are held at an address the platform does not manage (a treasury or an external transfer out). A sustained negative difference is the one that warrants a conversation with us.
Cost. This reads every tracked wallet from chain in batches, so latency grows with walletsChecked and it can take tens of seconds. Call it on a schedule (daily, or when your own reconciliation disagrees), never per request or in a user-facing path.
GET /api/v1/reconcile
const res = await fetch('https://www.ntzs.co.tz/api/v1/reconcile', {
  headers: { Authorization: 'Bearer ntzs_live_xxx' },
})

{
  "onChainSupplyTzs": 4820000,   // totalSupply() on Base
  "dbTotalBalanceTzs": 4820000,  // sum of balanceOf() over every tracked wallet
  "difference": 0,               // onChain − sum, in whole TZS
  "isReconciled": true,          // |difference| < 1 TZS
  "walletsChecked": 1284,
  "contractAddress": "0x…",
  "chain": "base"
}