@algodex/algodex-sdk/lib/utils/units/toBaseUnits.js

API calls for interacting with the Algorand blockchain

/*
 * Copyright (C) 2021-2022 Algodex VASP (BVI) Corp.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */

const Big = require('big.js');

/**
 * Converts an asset amount from whole units to base units
 *
 * Formula: amount * (10 ^ decimals)
 *
 * @param {Number} amount the asset amount in whole units
 * @param {Number} decimals asset's `decimals` property (default = 6 for ALGO)
 * @return {Number} the asset amount in base units, e.g. 2187000
 */
function toBaseUnits(amount, decimals = 6) {
  const multiplier = new Big(10).pow(decimals);
  const wholeUnits = new Big(amount).round(decimals);
  return wholeUnits.times(multiplier).toNumber();
}

module.exports = toBaseUnits;