ox/dist/core/internal/quantity.js

Ethereum Standard Library

import * as Hex from '../Hex.js';
/** @internal */
export class MissingFieldError extends Error {
    name = 'Quantity.MissingFieldError';
    constructor(args) {
        const { field, container } = args;
        super(container
            ? `Missing required field \`${field}\` on \`${container}\`.`
            : `Missing required field \`${field}\`.`);
    }
}
/**
 * Converts an optional RPC quantity (`Hex.Hex | undefined | null`) to `bigint | undefined`.
 *
 * Returns `undefined` for both `undefined` and `null` (RPC encoders may use either to mean "absent").
 *
 * @internal
 */
export function toBigInt(value) {
    if (value === undefined || value === null)
        return undefined;
    return BigInt(value);
}
/**
 * Converts a required RPC quantity to `bigint`. Throws `MissingFieldError` if the
 * value is `undefined` or `null`.
 *
 * @internal
 */
export function toBigIntRequired(value, field, container) {
    if (value === undefined || value === null)
        throw new MissingFieldError(container ? { field, container } : { field });
    return BigInt(value);
}
/**
 * Converts an optional RPC quantity to `number | undefined` via `BigInt` to avoid
 * silent precision loss on values that overflow Number.MAX_SAFE_INTEGER.
 *
 * Returns `undefined` for both `undefined` and `null`.
 *
 * @internal
 */
export function toNumber(value) {
    if (value === undefined || value === null)
        return undefined;
    return Number(value);
}
/**
 * Converts a "numberish" value (`Hex.Hex | bigint | number`) to an RPC quantity
 * (`Hex.Hex`). Hex values are passed through unchanged; numbers and bigints are
 * encoded via {@link ox#Hex.(fromNumber:function)}.
 *
 * @internal
 */
export function fromNumberish(value, options) {
    if (typeof value === 'string')
        return value;
    return Hex.fromNumber(value, options);
}
/**
 * Converts an optional "numberish" value to an RPC quantity (`Hex.Hex | undefined`).
 * Returns `undefined` for both `undefined` and `null`.
 *
 * @internal
 */
export function fromNumberishOptional(value, options) {
    if (value === undefined || value === null)
        return undefined;
    return fromNumberish(value, options);
}
/**
 * Converts an optional `bigint` to an RPC quantity (`Hex.Hex | undefined`).
 *
 * @internal
 */
export function fromBigInt(value) {
    if (typeof value !== 'bigint')
        return undefined;
    return Hex.fromNumber(value);
}
/**
 * Converts an optional `number` to an RPC quantity (`Hex.Hex | undefined`).
 *
 * @internal
 */
export function fromNumber(value) {
    if (typeof value !== 'number')
        return undefined;
    return Hex.fromNumber(value);
}
//# sourceMappingURL=quantity.js.map