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

Adds a quantity on the given side.

Errors

Throws ParamError on overflow or when side is invalid.

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 close [Quantity, ("BUY"|"SELL")|undefined] pair.

The side is undefined when the position is flat.

Returns the canonical decimal string for JSON serialization.

Returns the open [Quantity, "BUY"|"SELL"] pair as a 2-element array.

Returns the canonical decimal string.

Builds a position size 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 position size from a P&L value.

Builds a signed position size from a quantity and a side.

Errors

Throws ParamError when side is not "BUY"/"SELL".

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.