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).

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 the negation of this value.

Errors

Throws ParamError on arithmetic overflow.

Returns self minus other.

Errors

Throws ParamError on overflow/underflow.

Returns the canonical decimal string for JSON serialization.

Returns the canonical decimal string.

Builds a cash flow from a fee.

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.

Builds a cash flow from a P&L 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.

Builds an inflow cash flow from a volume.

Builds an outflow cash flow from a volume.

Returns the zero value.