opinion-clob-sdk 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

opinion_clob_sdk/__init__.py

@@ -12,7 +12,7 @@ from opinion_clob_sdk.chain.exception import (
     InsufficientGasBalance
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
 __all__ = [
     "Client",
     "TopicStatus",

opinion_clob_sdk/chain/py_order_utils/utils.py

@@ -29,6 +29,40 @@ def generate_seed() -> int:
     return round(now * random())
 
 
+def round_to_significant_digits(value: int, n: int) -> int:
+    """
+    Round an integer to n significant digits.
+
+    Args:
+        value: The integer to round
+        n: Number of significant digits to keep
+
+    Returns:
+        The rounded integer
+
+    Example:
+        round_to_significant_digits(123456789, 6) -> 123457000
+        round_to_significant_digits(10000000000000000000, 6) -> 10000000000000000000
+    """
+    if value == 0:
+        return 0
+
+    # Get the magnitude (number of digits)
+    magnitude = len(str(abs(value)))
+
+    # If already n digits or fewer, return as-is
+    if magnitude <= n:
+        return value
+
+    # Calculate the divisor to round to n significant digits
+    divisor = 10 ** (magnitude - n)
+
+    # Round to n significant digits
+    rounded = round(value / divisor) * divisor
+
+    return int(rounded)
+
+
 def prepend_zx(in_str: str) -> str:
     """
     Prepend 0x to the input string if it is missing
@@ -79,50 +113,59 @@ def calculate_order_amounts(price: float, maker_amount: int, side: OrderSide, de
 
     if side == OrderSide.BUY:
         # For BUY: price = maker/taker
-        # Goal: Find maximum taker such that floor(taker * price) <= maker
-        # Then use recalculated_maker = floor(taker * price)
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        # to match the matching engine's precision requirement
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit / price) to 6 significant digits
+        # 3. Recalculate maker = round(taker_6digit * price) to verify precision
         #
-        # This ensures precision: given (recalculated_maker, taker, price),
-        # you can always verify: recalculated_maker = floor(taker * price)
+        # This ensures: maker_6digit / taker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker / price
-        exact_taker = maker_decimal / price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Start with floor(exact_taker)
+        # Step 2: Calculate taker = maker / price
+        exact_taker = Decimal(str(maker_6digit)) / price_decimal
         taker_amount = int(exact_taker)
 
-        # Calculate corresponding maker = floor(taker * price)
-        recalculated_maker_decimal = Decimal(str(taker_amount)) * price_decimal
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Step 4: Recalculate maker using 6-digit taker to ensure precision
+        recalculated_maker_decimal = Decimal(str(taker_6digit)) * price_decimal
         recalculated_maker_amount = int(recalculated_maker_decimal)
 
-        # Try to increment taker to use more of the available maker amount
-        # but ensure we don't exceed the original maker_amount
-        while taker_amount > 0:
-            test_taker = taker_amount + 1
-            test_maker_decimal = Decimal(str(test_taker)) * price_decimal
-            test_maker = int(test_maker_decimal)
-
-            if test_maker <= maker_amount:
-                # We can use this higher taker value
-                taker_amount = test_taker
-                recalculated_maker_amount = test_maker
-            else:
-                # Can't increase further without exceeding maker_amount
-                break
+        # Step 5: Round recalculated maker to 6 significant digits
+        recalculated_maker_6digit = round_to_significant_digits(recalculated_maker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = recalculated_maker_6digit
 
     else:  # SELL
         # For SELL: price = taker/maker
-        # We want: taker = floor(maker * price)
-        # Maker stays the same
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit * price) to 6 significant digits
+        # 3. This ensures: taker_6digit / maker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker * price
-        exact_taker = maker_decimal * price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Round down to get integer taker
+        # Step 2: Calculate taker = maker * price
+        exact_taker = Decimal(str(maker_6digit)) * price_decimal
         taker_amount = int(exact_taker)
 
-        # For SELL, maker amount doesn't change
-        recalculated_maker_amount = int(maker_amount)
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = maker_6digit
 
     # Ensure amounts are at least 1
     taker_amount = int(max(1, taker_amount))

opinion_clob_sdk/opinion_clob_sdk/__init__.py

@@ -12,7 +12,7 @@ from opinion_clob_sdk.chain.exception import (
     InsufficientGasBalance
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
 __all__ = [
     "Client",
     "TopicStatus",

opinion_clob_sdk/opinion_clob_sdk/chain/py_order_utils/utils.py

@@ -29,6 +29,40 @@ def generate_seed() -> int:
     return round(now * random())
 
 
+def round_to_significant_digits(value: int, n: int) -> int:
+    """
+    Round an integer to n significant digits.
+
+    Args:
+        value: The integer to round
+        n: Number of significant digits to keep
+
+    Returns:
+        The rounded integer
+
+    Example:
+        round_to_significant_digits(123456789, 6) -> 123457000
+        round_to_significant_digits(10000000000000000000, 6) -> 10000000000000000000
+    """
+    if value == 0:
+        return 0
+
+    # Get the magnitude (number of digits)
+    magnitude = len(str(abs(value)))
+
+    # If already n digits or fewer, return as-is
+    if magnitude <= n:
+        return value
+
+    # Calculate the divisor to round to n significant digits
+    divisor = 10 ** (magnitude - n)
+
+    # Round to n significant digits
+    rounded = round(value / divisor) * divisor
+
+    return int(rounded)
+
+
 def prepend_zx(in_str: str) -> str:
     """
     Prepend 0x to the input string if it is missing
@@ -79,50 +113,59 @@ def calculate_order_amounts(price: float, maker_amount: int, side: OrderSide, de
 
     if side == OrderSide.BUY:
         # For BUY: price = maker/taker
-        # Goal: Find maximum taker such that floor(taker * price) <= maker
-        # Then use recalculated_maker = floor(taker * price)
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        # to match the matching engine's precision requirement
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit / price) to 6 significant digits
+        # 3. Recalculate maker = round(taker_6digit * price) to verify precision
         #
-        # This ensures precision: given (recalculated_maker, taker, price),
-        # you can always verify: recalculated_maker = floor(taker * price)
+        # This ensures: maker_6digit / taker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker / price
-        exact_taker = maker_decimal / price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Start with floor(exact_taker)
+        # Step 2: Calculate taker = maker / price
+        exact_taker = Decimal(str(maker_6digit)) / price_decimal
         taker_amount = int(exact_taker)
 
-        # Calculate corresponding maker = floor(taker * price)
-        recalculated_maker_decimal = Decimal(str(taker_amount)) * price_decimal
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Step 4: Recalculate maker using 6-digit taker to ensure precision
+        recalculated_maker_decimal = Decimal(str(taker_6digit)) * price_decimal
         recalculated_maker_amount = int(recalculated_maker_decimal)
 
-        # Try to increment taker to use more of the available maker amount
-        # but ensure we don't exceed the original maker_amount
-        while taker_amount > 0:
-            test_taker = taker_amount + 1
-            test_maker_decimal = Decimal(str(test_taker)) * price_decimal
-            test_maker = int(test_maker_decimal)
-
-            if test_maker <= maker_amount:
-                # We can use this higher taker value
-                taker_amount = test_taker
-                recalculated_maker_amount = test_maker
-            else:
-                # Can't increase further without exceeding maker_amount
-                break
+        # Step 5: Round recalculated maker to 6 significant digits
+        recalculated_maker_6digit = round_to_significant_digits(recalculated_maker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = recalculated_maker_6digit
 
     else:  # SELL
         # For SELL: price = taker/maker
-        # We want: taker = floor(maker * price)
-        # Maker stays the same
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit * price) to 6 significant digits
+        # 3. This ensures: taker_6digit / maker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker * price
-        exact_taker = maker_decimal * price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Round down to get integer taker
+        # Step 2: Calculate taker = maker * price
+        exact_taker = Decimal(str(maker_6digit)) * price_decimal
         taker_amount = int(exact_taker)
 
-        # For SELL, maker amount doesn't change
-        recalculated_maker_amount = int(maker_amount)
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = maker_6digit
 
     # Ensure amounts are at least 1
     taker_amount = int(max(1, taker_amount))

opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/__init__.py

@@ -12,7 +12,7 @@ from opinion_clob_sdk.chain.exception import (
     InsufficientGasBalance
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
 __all__ = [
     "Client",
     "TopicStatus",

opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/chain/py_order_utils/utils.py

@@ -29,6 +29,40 @@ def generate_seed() -> int:
     return round(now * random())
 
 
+def round_to_significant_digits(value: int, n: int) -> int:
+    """
+    Round an integer to n significant digits.
+
+    Args:
+        value: The integer to round
+        n: Number of significant digits to keep
+
+    Returns:
+        The rounded integer
+
+    Example:
+        round_to_significant_digits(123456789, 6) -> 123457000
+        round_to_significant_digits(10000000000000000000, 6) -> 10000000000000000000
+    """
+    if value == 0:
+        return 0
+
+    # Get the magnitude (number of digits)
+    magnitude = len(str(abs(value)))
+
+    # If already n digits or fewer, return as-is
+    if magnitude <= n:
+        return value
+
+    # Calculate the divisor to round to n significant digits
+    divisor = 10 ** (magnitude - n)
+
+    # Round to n significant digits
+    rounded = round(value / divisor) * divisor
+
+    return int(rounded)
+
+
 def prepend_zx(in_str: str) -> str:
     """
     Prepend 0x to the input string if it is missing
@@ -79,50 +113,59 @@ def calculate_order_amounts(price: float, maker_amount: int, side: OrderSide, de
 
     if side == OrderSide.BUY:
         # For BUY: price = maker/taker
-        # Goal: Find maximum taker such that floor(taker * price) <= maker
-        # Then use recalculated_maker = floor(taker * price)
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        # to match the matching engine's precision requirement
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit / price) to 6 significant digits
+        # 3. Recalculate maker = round(taker_6digit * price) to verify precision
         #
-        # This ensures precision: given (recalculated_maker, taker, price),
-        # you can always verify: recalculated_maker = floor(taker * price)
+        # This ensures: maker_6digit / taker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker / price
-        exact_taker = maker_decimal / price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Start with floor(exact_taker)
+        # Step 2: Calculate taker = maker / price
+        exact_taker = Decimal(str(maker_6digit)) / price_decimal
         taker_amount = int(exact_taker)
 
-        # Calculate corresponding maker = floor(taker * price)
-        recalculated_maker_decimal = Decimal(str(taker_amount)) * price_decimal
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Step 4: Recalculate maker using 6-digit taker to ensure precision
+        recalculated_maker_decimal = Decimal(str(taker_6digit)) * price_decimal
         recalculated_maker_amount = int(recalculated_maker_decimal)
 
-        # Try to increment taker to use more of the available maker amount
-        # but ensure we don't exceed the original maker_amount
-        while taker_amount > 0:
-            test_taker = taker_amount + 1
-            test_maker_decimal = Decimal(str(test_taker)) * price_decimal
-            test_maker = int(test_maker_decimal)
-
-            if test_maker <= maker_amount:
-                # We can use this higher taker value
-                taker_amount = test_taker
-                recalculated_maker_amount = test_maker
-            else:
-                # Can't increase further without exceeding maker_amount
-                break
+        # Step 5: Round recalculated maker to 6 significant digits
+        recalculated_maker_6digit = round_to_significant_digits(recalculated_maker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = recalculated_maker_6digit
 
     else:  # SELL
         # For SELL: price = taker/maker
-        # We want: taker = floor(maker * price)
-        # Maker stays the same
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit * price) to 6 significant digits
+        # 3. This ensures: taker_6digit / maker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker * price
-        exact_taker = maker_decimal * price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Round down to get integer taker
+        # Step 2: Calculate taker = maker * price
+        exact_taker = Decimal(str(maker_6digit)) * price_decimal
         taker_amount = int(exact_taker)
 
-        # For SELL, maker amount doesn't change
-        recalculated_maker_amount = int(maker_amount)
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = maker_6digit
 
     # Ensure amounts are at least 1
     taker_amount = int(max(1, taker_amount))

opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/__init__.py

@@ -12,7 +12,7 @@ from opinion_clob_sdk.chain.exception import (
     InsufficientGasBalance
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
 __all__ = [
     "Client",
     "TopicStatus",

opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/chain/py_order_utils/utils.py

@@ -29,6 +29,40 @@ def generate_seed() -> int:
     return round(now * random())
 
 
+def round_to_significant_digits(value: int, n: int) -> int:
+    """
+    Round an integer to n significant digits.
+
+    Args:
+        value: The integer to round
+        n: Number of significant digits to keep
+
+    Returns:
+        The rounded integer
+
+    Example:
+        round_to_significant_digits(123456789, 6) -> 123457000
+        round_to_significant_digits(10000000000000000000, 6) -> 10000000000000000000
+    """
+    if value == 0:
+        return 0
+
+    # Get the magnitude (number of digits)
+    magnitude = len(str(abs(value)))
+
+    # If already n digits or fewer, return as-is
+    if magnitude <= n:
+        return value
+
+    # Calculate the divisor to round to n significant digits
+    divisor = 10 ** (magnitude - n)
+
+    # Round to n significant digits
+    rounded = round(value / divisor) * divisor
+
+    return int(rounded)
+
+
 def prepend_zx(in_str: str) -> str:
     """
     Prepend 0x to the input string if it is missing
@@ -79,50 +113,59 @@ def calculate_order_amounts(price: float, maker_amount: int, side: OrderSide, de
 
     if side == OrderSide.BUY:
         # For BUY: price = maker/taker
-        # Goal: Find maximum taker such that floor(taker * price) <= maker
-        # Then use recalculated_maker = floor(taker * price)
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        # to match the matching engine's precision requirement
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit / price) to 6 significant digits
+        # 3. Recalculate maker = round(taker_6digit * price) to verify precision
         #
-        # This ensures precision: given (recalculated_maker, taker, price),
-        # you can always verify: recalculated_maker = floor(taker * price)
+        # This ensures: maker_6digit / taker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker / price
-        exact_taker = maker_decimal / price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Start with floor(exact_taker)
+        # Step 2: Calculate taker = maker / price
+        exact_taker = Decimal(str(maker_6digit)) / price_decimal
         taker_amount = int(exact_taker)
 
-        # Calculate corresponding maker = floor(taker * price)
-        recalculated_maker_decimal = Decimal(str(taker_amount)) * price_decimal
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Step 4: Recalculate maker using 6-digit taker to ensure precision
+        recalculated_maker_decimal = Decimal(str(taker_6digit)) * price_decimal
         recalculated_maker_amount = int(recalculated_maker_decimal)
 
-        # Try to increment taker to use more of the available maker amount
-        # but ensure we don't exceed the original maker_amount
-        while taker_amount > 0:
-            test_taker = taker_amount + 1
-            test_maker_decimal = Decimal(str(test_taker)) * price_decimal
-            test_maker = int(test_maker_decimal)
-
-            if test_maker <= maker_amount:
-                # We can use this higher taker value
-                taker_amount = test_taker
-                recalculated_maker_amount = test_maker
-            else:
-                # Can't increase further without exceeding maker_amount
-                break
+        # Step 5: Round recalculated maker to 6 significant digits
+        recalculated_maker_6digit = round_to_significant_digits(recalculated_maker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = recalculated_maker_6digit
 
     else:  # SELL
         # For SELL: price = taker/maker
-        # We want: taker = floor(maker * price)
-        # Maker stays the same
+        # Goal: Calculate taker and maker with only 6 significant digits each
+        #
+        # Strategy:
+        # 1. Round maker_amount to 6 significant digits
+        # 2. Calculate taker = round(maker_6digit * price) to 6 significant digits
+        # 3. This ensures: taker_6digit / maker_6digit = price (exact match within 6 digits)
 
-        # Calculate exact taker = maker * price
-        exact_taker = maker_decimal * price_decimal
+        # Step 1: Round maker to 6 significant digits
+        maker_6digit = round_to_significant_digits(maker_amount, 6)
 
-        # Round down to get integer taker
+        # Step 2: Calculate taker = maker * price
+        exact_taker = Decimal(str(maker_6digit)) * price_decimal
         taker_amount = int(exact_taker)
 
-        # For SELL, maker amount doesn't change
-        recalculated_maker_amount = int(maker_amount)
+        # Step 3: Round taker to 6 significant digits
+        taker_6digit = round_to_significant_digits(taker_amount, 6)
+
+        # Use the 6-digit values
+        taker_amount = taker_6digit
+        recalculated_maker_amount = maker_6digit
 
     # Ensure amounts are at least 1
     taker_amount = int(max(1, taker_amount))

opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/opinion_clob_sdk/__init__.py

@@ -12,7 +12,7 @@ from opinion_clob_sdk.chain.exception import (
     InsufficientGasBalance
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
 __all__ = [
     "Client",
     "TopicStatus",