ripple-binary-codec 2.4.1 → 2.5.0

package/dist/types/number.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SerializedNumber = void 0;
-const serialized_type_1 = require("./serialized-type");
-/**
- * Limits of representation after normalization of mantissa and exponent
- */
-const MIN_MANTISSA = BigInt('1000000000000000');
-const MAX_MANTISSA = BigInt('9999999999999999');
-const MIN_EXPONENT = -32768;
-const MAX_EXPONENT = 32768;
-const DEFAULT_VALUE_EXPONENT = -2147483648;
-/**
- * Helper: Write 64-bit big-endian integer to buffer.
- */
-function add64(val) {
-    const buf = new Uint8Array(8);
-    for (let i = 0; i < 8; i++) {
-        buf[7 - i] = Number((val >> BigInt(8 * i)) & BigInt(0xff));
-    }
-    return buf;
-}
-/**
- * Helper: Write 32-bit big-endian integer to buffer.
- */
-function add32(val) {
-    const buf = new Uint8Array(4);
-    for (let i = 0; i < 4; i++) {
-        buf[3 - i] = (val >> (8 * i)) & 0xff;
-    }
-    return buf;
-}
-/**
- * Extract mantissa, exponent, and sign from string.
- */
-function extractNumberPartsFromString(val) {
-    // Regex: sign, integer part, optional .fraction, optional e/E exponent
-    const regex = /^([-+]?)(0|[1-9][0-9]*)(?:\.([0-9]+))?(?:[eE]([+-]?[0-9]+))?$/;
-    const match = regex.exec(val);
-    if (!match)
-        throw new Error(`Unable to parse number from string: ${val}`);
-    const [, sign, intPart, fracPart, expPart] = match;
-    let mantissaStr = intPart;
-    let exponent = 0;
-    if (fracPart) {
-        mantissaStr += fracPart;
-        exponent -= fracPart.length;
-    }
-    if (expPart)
-        exponent += parseInt(expPart, 10);
-    let mantissa = BigInt(mantissaStr);
-    if (sign === '-')
-        mantissa = -mantissa;
-    const isNegative = mantissa < BigInt(0);
-    return { mantissa, exponent, isNegative };
-}
-/**
- * Normalize mantissa and exponent to XRP Number constraints.
- */
-function normalize(mantissa, exponent) {
-    let m = mantissa < BigInt(0) ? -mantissa : mantissa;
-    const isNegative = mantissa < BigInt(0);
-    while (m !== BigInt(0) && m < MIN_MANTISSA && exponent > MIN_EXPONENT) {
-        exponent -= 1;
-        m *= BigInt(10);
-    }
-    while (m > MAX_MANTISSA) {
-        if (exponent >= MAX_EXPONENT)
-            throw new Error('Mantissa and exponent are too large');
-        exponent += 1;
-        m /= BigInt(10);
-    }
-    if (isNegative)
-        m = -m;
-    return { mantissa: m, exponent };
-}
-/**
- * SerializedType for the XRPL Number type (12 bytes).
- */
-class SerializedNumber extends serialized_type_1.SerializedType {
-    constructor(bytes) {
-        super(bytes);
-    }
-    /**
-     * Creates a SerializedNumber from a string value.
-     * Accepts only string input to avoid precision loss (as per XRPL and blockchain best practices).
-     * Throws if a number or bigint is passed.
-     * @param value string representing the number (decimal, integer, or scientific notation)
-     * @returns SerializedNumber instance
-     */
-    static from(value) {
-        if (typeof value !== 'string') {
-            throw new Error('SerializedNumber.from: value must be a string representing the number. ' +
-                'Numbers and bigints are not accepted to avoid precision loss. ' +
-                'Convert your value to a string first.');
-        }
-        return SerializedNumber.fromValue(value);
-    }
-    static fromValue(val) {
-        const { mantissa, exponent, isNegative } = extractNumberPartsFromString(val);
-        let normalizedMantissa, normalizedExponent;
-        if (mantissa === BigInt(0) && exponent === 0 && !isNegative) {
-            normalizedMantissa = BigInt(0);
-            normalizedExponent = DEFAULT_VALUE_EXPONENT;
-        }
-        else {
-            ;
-            ({ mantissa: normalizedMantissa, exponent: normalizedExponent } =
-                normalize(mantissa, exponent));
-        }
-        const mantissaBytes = add64(normalizedMantissa);
-        const exponentBytes = add32(normalizedExponent);
-        const bytes = new Uint8Array(12);
-        bytes.set(mantissaBytes, 0);
-        bytes.set(exponentBytes, 8);
-        return new SerializedNumber(bytes);
-    }
-    static fromParser(parser) {
-        return new SerializedNumber(parser.read(12));
-    }
-    // eslint-disable-next-line complexity -- needed
-    toJSON() {
-        // Decompose mantissa (signed 64-bit) and exponent (signed 32-bit)
-        const b = this.bytes;
-        let mantissa = BigInt(0);
-        for (let i = 0; i < 8; i++) {
-            mantissa = (mantissa << BigInt(8)) | BigInt(b[i]);
-        }
-        // interpret as signed 64
-        if (b[0] & 0x80)
-            mantissa -= BigInt('0x10000000000000000');
-        let exponent = (b[8] << 24) | (b[9] << 16) | (b[10] << 8) | b[11];
-        if (b[8] & 0x80)
-            exponent = exponent - 0x100000000;
-        // Special case: 0
-        if (mantissa === BigInt(0) && exponent === DEFAULT_VALUE_EXPONENT) {
-            return '0';
-        }
-        if (exponent === 0)
-            return mantissa.toString();
-        // Use scientific notation for small/large exponents, decimal otherwise
-        if (exponent < -25 || exponent > -5) {
-            return `${mantissa}e${exponent}`;
-        }
-        // Else, output as decimal with a dot
-        const isNegative = mantissa < BigInt(0);
-        let mantissaAbs = mantissa < BigInt(0) ? -mantissa : mantissa;
-        const padPrefix = 27, padSuffix = 23;
-        let mantissaStr = mantissaAbs.toString();
-        let rawValue = '0'.repeat(padPrefix) + mantissaStr + '0'.repeat(padSuffix);
-        const OFFSET = exponent + 43;
-        let integerPart = rawValue.slice(0, OFFSET).replace(/^0+/, '') || '0';
-        let fractionPart = rawValue.slice(OFFSET).replace(/0+$/, '');
-        return `${isNegative ? '-' : ''}${integerPart}${fractionPart ? '.' + fractionPart : ''}`;
-    }
-}
-exports.SerializedNumber = SerializedNumber;
-//# sourceMappingURL=number.js.map

package/dist/types/number.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/types/number.ts"],"names":[],"mappings":"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"}