ethers.js/packages/bignumber/lib.esm/bignumber.js

258 lines
7.9 KiB
JavaScript
Raw Permalink Normal View History

2019-05-14 18:48:48 -04:00
"use strict";
/**
* BigNumber
*
* A wrapper around the BN.js object. We use the BN.js library
* because it is used by elliptic, so it is required regardles.
*
*/
import { BN } from "bn.js";
import { hexlify, isBytes, isHexString } from "@ethersproject/bytes";
import { Logger } from "@ethersproject/logger";
import { version } from "./_version";
const logger = new Logger(version);
const _constructorGuard = {};
const MAX_SAFE = 0x1fffffffffffff;
export function isBigNumberish(value) {
2019-06-11 17:57:04 -04:00
return (value != null) && (BigNumber.isBigNumber(value) ||
(typeof (value) === "number" && (value % 1) === 0) ||
(typeof (value) === "string" && !!value.match(/^-?[0-9]+$/)) ||
isHexString(value) ||
2019-06-11 17:57:04 -04:00
(typeof (value) === "bigint") ||
isBytes(value));
2019-05-14 18:48:48 -04:00
}
export class BigNumber {
constructor(constructorGuard, hex) {
logger.checkNew(new.target, BigNumber);
2019-05-14 18:48:48 -04:00
if (constructorGuard !== _constructorGuard) {
2020-04-23 23:35:39 -04:00
logger.throwError("cannot call constructor directly; use BigNumber.from", Logger.errors.UNSUPPORTED_OPERATION, {
2019-05-14 18:48:48 -04:00
operation: "new (BigNumber)"
});
}
2019-06-11 17:57:04 -04:00
this._hex = hex;
this._isBigNumber = true;
Object.freeze(this);
2019-05-14 18:48:48 -04:00
}
fromTwos(value) {
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).fromTwos(value));
}
toTwos(value) {
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).toTwos(value));
}
abs() {
2019-05-14 18:48:48 -04:00
if (this._hex[0] === "-") {
return BigNumber.from(this._hex.substring(1));
}
return this;
}
add(other) {
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).add(toBN(other)));
}
sub(other) {
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).sub(toBN(other)));
}
div(other) {
2019-11-20 18:57:38 +09:00
const o = BigNumber.from(other);
2019-05-14 18:48:48 -04:00
if (o.isZero()) {
throwFault("division by zero", "div");
}
return toBigNumber(toBN(this).div(toBN(other)));
}
mul(other) {
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).mul(toBN(other)));
}
mod(other) {
2020-04-15 18:28:04 -04:00
const value = toBN(other);
if (value.isNeg()) {
throwFault("cannot modulo negative values", "mod");
}
return toBigNumber(toBN(this).umod(value));
}
pow(other) {
2020-07-05 00:01:57 -04:00
const value = toBN(other);
if (value.isNeg()) {
throwFault("cannot raise to negative values", "pow");
}
return toBigNumber(toBN(this).pow(value));
}
2020-04-15 18:28:04 -04:00
and(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
throwFault("cannot 'and' negative values", "and");
}
return toBigNumber(toBN(this).and(value));
}
or(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
throwFault("cannot 'or' negative values", "or");
}
return toBigNumber(toBN(this).or(value));
}
xor(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
throwFault("cannot 'xor' negative values", "xor");
}
return toBigNumber(toBN(this).xor(value));
}
mask(value) {
if (this.isNegative() || value < 0) {
throwFault("cannot mask negative values", "mask");
}
2019-05-14 18:48:48 -04:00
return toBigNumber(toBN(this).maskn(value));
}
2020-04-15 18:28:04 -04:00
shl(value) {
if (this.isNegative() || value < 0) {
throwFault("cannot shift negative values", "shl");
}
return toBigNumber(toBN(this).shln(value));
}
shr(value) {
if (this.isNegative() || value < 0) {
throwFault("cannot shift negative values", "shr");
}
return toBigNumber(toBN(this).shrn(value));
}
eq(other) {
2019-05-14 18:48:48 -04:00
return toBN(this).eq(toBN(other));
}
lt(other) {
2019-05-14 18:48:48 -04:00
return toBN(this).lt(toBN(other));
}
lte(other) {
2019-05-14 18:48:48 -04:00
return toBN(this).lte(toBN(other));
}
gt(other) {
2019-05-14 18:48:48 -04:00
return toBN(this).gt(toBN(other));
}
gte(other) {
2019-05-14 18:48:48 -04:00
return toBN(this).gte(toBN(other));
}
2020-04-15 18:28:04 -04:00
isNegative() {
return (this._hex[0] === "-");
}
isZero() {
2019-05-14 18:48:48 -04:00
return toBN(this).isZero();
}
toNumber() {
2019-05-14 18:48:48 -04:00
try {
return toBN(this).toNumber();
}
catch (error) {
throwFault("overflow", "toNumber", this.toString());
}
return null;
}
toString() {
2019-05-14 18:48:48 -04:00
// Lots of people expect this, which we do not support, so check
if (arguments.length !== 0) {
logger.throwError("bigNumber.toString does not accept parameters", Logger.errors.UNEXPECTED_ARGUMENT, {});
2019-05-14 18:48:48 -04:00
}
return toBN(this).toString(10);
}
toHexString() {
2019-05-14 18:48:48 -04:00
return this._hex;
}
static from(value) {
2019-05-14 18:48:48 -04:00
if (value instanceof BigNumber) {
return value;
}
if (typeof (value) === "string") {
2020-07-07 23:19:00 -04:00
if (value.match(/^-?0x[0-9a-f]+$/i)) {
2019-05-14 18:48:48 -04:00
return new BigNumber(_constructorGuard, toHex(value));
}
if (value.match(/^-?[0-9]+$/)) {
return new BigNumber(_constructorGuard, toHex(new BN(value)));
2019-05-14 18:48:48 -04:00
}
2019-08-02 02:10:58 -04:00
return logger.throwArgumentError("invalid BigNumber string", "value", value);
2019-05-14 18:48:48 -04:00
}
if (typeof (value) === "number") {
if (value % 1) {
throwFault("underflow", "BigNumber.from", value);
}
if (value >= MAX_SAFE || value <= -MAX_SAFE) {
throwFault("overflow", "BigNumber.from", value);
}
return BigNumber.from(String(value));
}
if (typeof (value) === "bigint") {
return BigNumber.from(value.toString());
}
if (isBytes(value)) {
return BigNumber.from(hexlify(value));
2019-05-14 18:48:48 -04:00
}
if (value._hex && isHexString(value._hex)) {
2019-05-14 18:48:48 -04:00
return BigNumber.from(value._hex);
}
if (value.toHexString) {
value = value.toHexString();
if (typeof (value) === "string") {
return BigNumber.from(value);
}
}
2019-08-02 02:10:58 -04:00
return logger.throwArgumentError("invalid BigNumber value", "value", value);
}
static isBigNumber(value) {
2019-06-11 17:57:04 -04:00
return !!(value && value._isBigNumber);
}
}
2019-05-14 18:48:48 -04:00
// Normalize the hex string
function toHex(value) {
// For BN, call on the hex string
if (typeof (value) !== "string") {
return toHex(value.toString(16));
}
// If negative, prepend the negative sign to the normalized positive value
if (value[0] === "-") {
// Strip off the negative sign
value = value.substring(1);
// Cannot have mulitple negative signs (e.g. "--0x04")
if (value[0] === "-") {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("invalid hex", "value", value);
2019-05-14 18:48:48 -04:00
}
// Call toHex on the positive component
value = toHex(value);
// Do not allow "-0x00"
if (value === "0x00") {
return value;
}
// Negate the value
return "-" + value;
}
// Add a "0x" prefix if missing
if (value.substring(0, 2) !== "0x") {
value = "0x" + value;
}
// Normalize zero
if (value === "0x") {
return "0x00";
}
// Make the string even length
if (value.length % 2) {
value = "0x0" + value.substring(2);
}
// Trim to smallest even-length string
while (value.length > 4 && value.substring(0, 4) === "0x00") {
value = "0x" + value.substring(4);
}
return value;
}
function toBigNumber(value) {
return BigNumber.from(toHex(value));
}
function toBN(value) {
2019-11-20 18:57:38 +09:00
const hex = BigNumber.from(value).toHexString();
2019-05-14 18:48:48 -04:00
if (hex[0] === "-") {
return (new BN("-" + hex.substring(3), 16));
2019-05-14 18:48:48 -04:00
}
return new BN(hex.substring(2), 16);
2019-05-14 18:48:48 -04:00
}
function throwFault(fault, operation, value) {
2019-11-20 18:57:38 +09:00
const params = { fault: fault, operation: operation };
2019-05-14 18:48:48 -04:00
if (value != null) {
params.value = value;
}
return logger.throwError(fault, Logger.errors.NUMERIC_FAULT, params);
2019-05-14 18:48:48 -04:00
}
2020-07-13 08:03:56 -04:00
//# sourceMappingURL=bignumber.js.map