Constructs from a DecimalInput (string | number | bigint).

A generic number must be a safe integer. Use fromFloat explicitly for imprecise fractional input.

Errors

Throws ParamError on an invalid value or type.

Returns the sum of self and other.

Errors

Throws ParamError on overflow (or sign violation for unsigned types).

Computes the volume as quantity * price.

Errors

Throws ParamError on arithmetic overflow.

Returns a fresh wrapper holding the same value.

Value types are cheap to copy. Ordinary setters already borrow/clone wrapper inputs; this method is a convenience when an explicit second wrapper object is useful.

Compares against other: -1, 0, or 1.

Divides by a number | bigint scalar.

Errors

Throws ParamError on division by zero, overflow, or an invalid scalar.

Returns true when both values are equal.

Returns true when the value is exactly zero.

Computes the remainder against a number | bigint scalar.

Errors

Throws ParamError on division by zero, overflow, or an invalid scalar.

Multiplies by a number | bigint scalar.

bigint is exact; number is imprecise.

Errors

Throws ParamError on overflow or an invalid scalar.

Returns self minus other.

Errors

Throws ParamError on overflow/underflow.

Returns the canonical decimal string for JSON serialization.

Converts this quantity into an unsigned position size.

Returns the canonical decimal string.

Constructs from a JS number (imprecise; prefer fromString).

Errors

Throws ParamError on a non-finite or out-of-domain value.

Constructs from a JS number then quantizes to scale.

WARNING: the float source is imprecise; prefer fromStringRounded.

Errors

Throws ParamError on an invalid value, scale, or strategy.

Constructs from an exact integer (bigint).

Errors

Throws ParamError on an out-of-domain value.

Constructs losslessly from a decimal string.

Errors

Throws ParamError on an invalid format or out-of-domain value.

Parses a decimal string then quantizes to scale using strategy.

Errors

Throws ParamError on an invalid value, scale, or strategy.

Returns the zero value.