Balances

import { BalanceArray, getBalancesForIds } from 'bitbadges';

// 1. Define
const userBalance = BalanceArray.From([
  {
    amount: 5n,
    tokenIds: [{ start: 1n, end: 5n }],
    ownershipTimes: [{ start: 1628770800000n, end: 1628857200000n }] // unix ms
  }
]);

// 2. Add (in place)
userBalance.addBalances([
  {
    amount: 3n,
    tokenIds: [{ start: 6n, end: 8n }],
    ownershipTimes: [{ start: 1628860800000n, end: 1628947200000n }]
  }
]);

// 3. Subtract (in place). Second argument allows negative results; default false throws on underflow.
userBalance.subtractBalances(
  [
    {
      amount: 2n,
      tokenIds: [{ start: 2n, end: 3n }],
      ownershipTimes: [{ start: 1628784400000n, end: 1628870800000n }]
    }
  ],
  false
);

// 4. Look up one token at one time
const amount = userBalance.getBalanceForIdAndTime(3n, 1628784400000n); // bigint

// 5. All balances for one token ID, or for one time
const forToken = userBalance.getBalancesForId(4n); // BalanceArray
const atTime = userBalance.getBalancesForTime(1628784400000n); // BalanceArray

// 6. Balances inside ranges of IDs and times (free function)
const subset = getBalancesForIds(
  [
    { start: 1n, end: 3n },
    { start: 5n, end: 7n }
  ],
  [
    { start: 1628770800000n, end: 1628857200000n },
    { start: 1628943600000n, end: 1629030000000n }
  ],
  userBalance
);