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

306 lines
9.6 KiB
JavaScript
Raw Normal View History

2019-05-15 01:48:48 +03:00
"use strict";
/**
* BigNumber
*
* A wrapper around the BN.js object. We use the BN.js library
2020-11-20 01:44:10 +03:00
* because it is used by elliptic, so it is required regardless.
2019-05-15 01:48:48 +03:00
*
*/
2020-11-17 07:07:24 +03:00
import _BN from "bn.js";
var BN = _BN.BN;
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-12 00:57:04 +03:00
return (value != null) && (BigNumber.isBigNumber(value) ||
(typeof (value) === "number" && (value % 1) === 0) ||
(typeof (value) === "string" && !!value.match(/^-?[0-9]+$/)) ||
isHexString(value) ||
2019-06-12 00:57:04 +03:00
(typeof (value) === "bigint") ||
isBytes(value));
2019-05-15 01:48:48 +03:00
}
2020-11-23 06:44:33 +03:00
// Only warn about passing 10 into radix once
let _warnedToStringRadix = false;
export class BigNumber {
constructor(constructorGuard, hex) {
logger.checkNew(new.target, BigNumber);
2019-05-15 01:48:48 +03:00
if (constructorGuard !== _constructorGuard) {
2020-04-24 06:35:39 +03:00
logger.throwError("cannot call constructor directly; use BigNumber.from", Logger.errors.UNSUPPORTED_OPERATION, {
2019-05-15 01:48:48 +03:00
operation: "new (BigNumber)"
});
}
2019-06-12 00:57:04 +03:00
this._hex = hex;
this._isBigNumber = true;
Object.freeze(this);
2019-05-15 01:48:48 +03:00
}
fromTwos(value) {
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).fromTwos(value));
}
toTwos(value) {
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).toTwos(value));
}
abs() {
2019-05-15 01:48:48 +03:00
if (this._hex[0] === "-") {
return BigNumber.from(this._hex.substring(1));
}
return this;
}
add(other) {
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).add(toBN(other)));
}
sub(other) {
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).sub(toBN(other)));
}
div(other) {
2019-11-20 12:57:38 +03:00
const o = BigNumber.from(other);
2019-05-15 01:48:48 +03:00
if (o.isZero()) {
2022-03-09 10:56:08 +03:00
throwFault("division-by-zero", "div");
2019-05-15 01:48:48 +03:00
}
return toBigNumber(toBN(this).div(toBN(other)));
}
mul(other) {
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).mul(toBN(other)));
}
mod(other) {
2020-04-16 01:28:04 +03:00
const value = toBN(other);
if (value.isNeg()) {
2022-03-09 10:56:08 +03:00
throwFault("division-by-zero", "mod");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).umod(value));
}
pow(other) {
2020-07-05 07:01:57 +03:00
const value = toBN(other);
if (value.isNeg()) {
2022-03-09 10:56:08 +03:00
throwFault("negative-power", "pow");
2020-07-05 07:01:57 +03:00
}
return toBigNumber(toBN(this).pow(value));
}
2020-04-16 01:28:04 +03:00
and(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
2022-03-09 10:56:08 +03:00
throwFault("unbound-bitwise-result", "and");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).and(value));
}
or(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
2022-03-09 10:56:08 +03:00
throwFault("unbound-bitwise-result", "or");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).or(value));
}
xor(other) {
const value = toBN(other);
if (this.isNegative() || value.isNeg()) {
2022-03-09 10:56:08 +03:00
throwFault("unbound-bitwise-result", "xor");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).xor(value));
}
mask(value) {
if (this.isNegative() || value < 0) {
2022-03-09 10:56:08 +03:00
throwFault("negative-width", "mask");
2020-04-16 01:28:04 +03:00
}
2019-05-15 01:48:48 +03:00
return toBigNumber(toBN(this).maskn(value));
}
2020-04-16 01:28:04 +03:00
shl(value) {
if (this.isNegative() || value < 0) {
2022-03-09 10:56:08 +03:00
throwFault("negative-width", "shl");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).shln(value));
}
shr(value) {
if (this.isNegative() || value < 0) {
2022-03-09 10:56:08 +03:00
throwFault("negative-width", "shr");
2020-04-16 01:28:04 +03:00
}
return toBigNumber(toBN(this).shrn(value));
}
eq(other) {
2019-05-15 01:48:48 +03:00
return toBN(this).eq(toBN(other));
}
lt(other) {
2019-05-15 01:48:48 +03:00
return toBN(this).lt(toBN(other));
}
lte(other) {
2019-05-15 01:48:48 +03:00
return toBN(this).lte(toBN(other));
}
gt(other) {
2019-05-15 01:48:48 +03:00
return toBN(this).gt(toBN(other));
}
gte(other) {
2019-05-15 01:48:48 +03:00
return toBN(this).gte(toBN(other));
}
2020-04-16 01:28:04 +03:00
isNegative() {
return (this._hex[0] === "-");
}
isZero() {
2019-05-15 01:48:48 +03:00
return toBN(this).isZero();
}
toNumber() {
2019-05-15 01:48:48 +03:00
try {
return toBN(this).toNumber();
}
catch (error) {
throwFault("overflow", "toNumber", this.toString());
}
return null;
}
2021-03-30 22:22:45 +03:00
toBigInt() {
try {
return BigInt(this.toString());
}
catch (e) { }
return logger.throwError("this platform does not support BigInt", Logger.errors.UNSUPPORTED_OPERATION, {
value: this.toString()
});
}
toString() {
2020-11-23 06:44:33 +03:00
// Lots of people expect this, which we do not support, so check (See: #889)
if (arguments.length > 0) {
if (arguments[0] === 10) {
if (!_warnedToStringRadix) {
_warnedToStringRadix = true;
logger.warn("BigNumber.toString does not accept any parameters; base-10 is assumed");
}
}
else if (arguments[0] === 16) {
logger.throwError("BigNumber.toString does not accept any parameters; use bigNumber.toHexString()", Logger.errors.UNEXPECTED_ARGUMENT, {});
}
else {
logger.throwError("BigNumber.toString does not accept parameters", Logger.errors.UNEXPECTED_ARGUMENT, {});
}
2019-05-15 01:48:48 +03:00
}
return toBN(this).toString(10);
}
toHexString() {
2019-05-15 01:48:48 +03:00
return this._hex;
}
2020-08-25 08:53:48 +03:00
toJSON(key) {
return { type: "BigNumber", hex: this.toHexString() };
}
static from(value) {
2019-05-15 01:48:48 +03:00
if (value instanceof BigNumber) {
return value;
}
if (typeof (value) === "string") {
2020-07-08 06:19:00 +03:00
if (value.match(/^-?0x[0-9a-f]+$/i)) {
2019-05-15 01:48:48 +03:00
return new BigNumber(_constructorGuard, toHex(value));
}
if (value.match(/^-?[0-9]+$/)) {
return new BigNumber(_constructorGuard, toHex(new BN(value)));
2019-05-15 01:48:48 +03:00
}
2019-08-02 09:10:58 +03:00
return logger.throwArgumentError("invalid BigNumber string", "value", value);
2019-05-15 01:48:48 +03: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));
}
2020-08-25 08:53:48 +03:00
const anyValue = value;
if (typeof (anyValue) === "bigint") {
return BigNumber.from(anyValue.toString());
2019-05-15 01:48:48 +03:00
}
2020-08-25 08:53:48 +03:00
if (isBytes(anyValue)) {
return BigNumber.from(hexlify(anyValue));
2019-05-15 01:48:48 +03:00
}
2020-08-25 08:53:48 +03:00
if (anyValue) {
2021-10-16 09:29:27 +03:00
// Hexable interface (takes priority)
2020-08-25 08:53:48 +03:00
if (anyValue.toHexString) {
const hex = anyValue.toHexString();
if (typeof (hex) === "string") {
return BigNumber.from(hex);
}
}
else {
// For now, handle legacy JSON-ified values (goes away in v6)
let hex = anyValue._hex;
// New-form JSON
if (hex == null && anyValue.type === "BigNumber") {
hex = anyValue.hex;
}
if (typeof (hex) === "string") {
if (isHexString(hex) || (hex[0] === "-" && isHexString(hex.substring(1)))) {
return BigNumber.from(hex);
}
}
2019-05-15 01:48:48 +03:00
}
}
2019-08-02 09:10:58 +03:00
return logger.throwArgumentError("invalid BigNumber value", "value", value);
}
static isBigNumber(value) {
2019-06-12 00:57:04 +03:00
return !!(value && value._isBigNumber);
}
}
2019-05-15 01:48:48 +03: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);
2021-10-16 09:29:27 +03:00
// Cannot have multiple negative signs (e.g. "--0x04")
2019-05-15 01:48:48 +03:00
if (value[0] === "-") {
2019-08-02 09:10:58 +03:00
logger.throwArgumentError("invalid hex", "value", value);
2019-05-15 01:48:48 +03: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 12:57:38 +03:00
const hex = BigNumber.from(value).toHexString();
2019-05-15 01:48:48 +03:00
if (hex[0] === "-") {
return (new BN("-" + hex.substring(3), 16));
2019-05-15 01:48:48 +03:00
}
return new BN(hex.substring(2), 16);
2019-05-15 01:48:48 +03:00
}
function throwFault(fault, operation, value) {
2019-11-20 12:57:38 +03:00
const params = { fault: fault, operation: operation };
2019-05-15 01:48:48 +03:00
if (value != null) {
params.value = value;
}
return logger.throwError(fault, Logger.errors.NUMERIC_FAULT, params);
2019-05-15 01:48:48 +03:00
}
2020-11-17 07:07:24 +03:00
// value should have no prefix
export function _base36To16(value) {
return (new BN(value, 36)).toString(16);
}
// value should have no prefix
export function _base16To36(value) {
return (new BN(value, 16)).toString(36);
}
2020-07-13 15:03:56 +03:00
//# sourceMappingURL=bignumber.js.map