opinion-clob-sdk 0.1.0__py3-none-any.whl

chain/safe/utils.py

@@ -0,0 +1,218 @@
+import os
+from functools import lru_cache
+from typing import Any, Union
+
+import eth_abi
+from eth_account import Account
+from eth_typing import Address, AnyAddress, ChecksumAddress, Hash32, HexAddress, HexStr
+from eth_utils import to_normalized_address
+from hexbytes import HexBytes
+# from sha3 import keccak_256
+from web3.types import TxParams, Wei
+
+
+def get_empty_tx_params() -> TxParams:
+    """
+    :return: Empty tx params, so calls like `build_transaction` don't call the RPC trying to get information
+    """
+    return {
+        "gas": Wei(1),
+        "gasPrice": Wei(1),
+    }
+
+
+@lru_cache(maxsize=int(os.getenv("CACHE_KECCAK", 512)))
+def _keccak_256(value: bytes) -> bytes:
+    import web3
+    return web3.Web3.keccak(value)
+    # return keccak_256(value)
+
+
+def fast_keccak(value: bytes) -> Hash32:
+    """
+    Calculates ethereum keccak256 using fast library `pysha3`
+
+    :param value:
+    :return: Keccak256 used by ethereum as `HexBytes`
+    """
+    return Hash32(HexBytes(_keccak_256(value)))
+
+
+def fast_keccak_text(value: str) -> Hash32:
+    """
+    Calculates ethereum keccak256 using fast library `pysha3`
+
+    :param value:
+    :return: Keccak256 used by ethereum as `HexBytes`
+    """
+    return fast_keccak(value.encode())
+
+
+def fast_keccak_hex(value: bytes) -> HexStr:
+    """
+    Same as `fast_keccak`, but it's a little more optimal calling `hexdigest()`
+    than calling `digest()` and then `hex()`
+
+    :param value:
+    :return: Keccak256 used by ethereum as a hex string (not 0x prefixed)
+    """
+    return HexStr(_keccak_256(value).hex())
+
+
+def _build_checksum_address(
+    norm_address: HexStr, address_hash: HexStr
+) -> ChecksumAddress:
+    """
+    https://github.com/ethereum/EIPs/blob/master/EIPS/eip-55.md
+
+    :param norm_address: address in lowercase (not 0x prefixed)
+    :param address_hash: keccak256 of `norm_address` (not 0x prefixed)
+    :return:
+    """
+    return ChecksumAddress(
+        HexAddress(
+            HexStr(
+                "0x"
+                + (
+                    "".join(
+                        (
+                            norm_address[i].upper()
+                            if int(str(address_hash[i]), 16) > 7
+                            else norm_address[i]
+                        )
+                        for i in range(0, 40)
+                    )
+                )
+            )
+        )
+    )
+
+
+@lru_cache(maxsize=int(os.getenv("CACHE_CHECKSUM_ADDRESS", 1_000_000_000)))
+def _fast_to_checksum_address(address: HexAddress):
+    # print("_fast_to_checksum_address: {}".format(address))
+    address_hash = fast_keccak_hex(address.encode())
+    return _build_checksum_address(address, address_hash)
+
+
+def fast_to_checksum_address(value: Union[AnyAddress, str, bytes]) -> ChecksumAddress:
+    """
+    Converts to checksum_address. Uses more optimal `pysha3` instead of `eth_utils` for keccak256 calculation
+
+    :param value:
+    :return:
+    """
+    # print("fast_to_checksum_address: {}".format(value))
+    if isinstance(value, bytes):
+        if len(value) != 20:
+            raise ValueError(
+                "Cannot convert %s to a checksum address, 20 bytes were expected"
+            )
+
+    norm_address = HexAddress(HexStr(to_normalized_address(value)[2:]))
+    return _fast_to_checksum_address(norm_address)
+
+
+def fast_bytes_to_checksum_address(value: bytes) -> ChecksumAddress:
+    """
+    Converts to checksum_address. Uses more optimal `pysha3` instead of `eth_utils` for keccak256 calculation.
+    As input is already in bytes, some checks and conversions can be skipped, providing a speedup of ~50%
+
+    :param value:
+    :return:
+    """
+    if len(value) != 20:
+        raise ValueError(
+            "Cannot convert %s to a checksum address, 20 bytes were expected"
+        )
+    norm_address = HexAddress(HexStr(bytes(value).hex()))
+    return _fast_to_checksum_address(norm_address)
+
+
+def fast_is_checksum_address(value: Union[AnyAddress, str, bytes]) -> bool:
+    """
+    Fast version to check if an address is a checksum_address
+
+    :param value:
+    :return: `True` if checksummed, `False` otherwise
+    """
+    if not isinstance(value, str) or len(value) != 42 or not value.startswith("0x"):
+        return False
+    try:
+        return fast_to_checksum_address(value) == value
+    except ValueError:
+        return False
+
+
+def get_eth_address_with_invalid_checksum() -> str:
+    address = Account.create().address
+    return "0x" + "".join(
+        [c.lower() if c.isupper() else c.upper() for c in address[2:]]
+    )
+
+
+def decode_string_or_bytes32(data: bytes) -> str:
+    try:
+        return eth_abi.decode(["string"], data)[0]
+    except (OverflowError, eth_abi.exceptions.DecodingError):
+        name = eth_abi.decode(["bytes32"], data)[0]
+        end_position = name.find(b"\x00")
+        if end_position == -1:
+            return name.decode()
+        else:
+            return name[:end_position].decode()
+
+
+def remove_swarm_metadata(code: bytes) -> bytes:
+    """
+    Remove swarm metadata from Solidity bytecode
+
+    :param code:
+    :return: Code without metadata
+    """
+    swarm = b"\xa1\x65bzzr0"
+    position = code.rfind(swarm)
+    if position == -1:
+        raise ValueError("Swarm metadata not found in code %s" % code.hex())
+    return code[:position]
+
+
+def compare_byte_code(code_1: bytes, code_2: bytes) -> bool:
+    """
+    Compare code, removing swarm metadata if necessary
+
+    :param code_1:
+    :param code_2:
+    :return: True if same code, False otherwise
+    """
+    if code_1 == code_2:
+        return True
+    else:
+        codes = []
+        for code in (code_1, code_2):
+            try:
+                codes.append(remove_swarm_metadata(code))
+            except ValueError:
+                codes.append(code)
+
+        return codes[0] == codes[1]
+
+
+def bytes_to_float(value: Any) -> float:
+    """
+    Convert a value of type Any to float.
+
+    :param value: The value to convert.
+    :return: The converted float value.
+    :raises ValueError: If the value cannot be converted to float.
+    """
+    assert value is not None, "Cannot convert None to float"
+    if isinstance(value, (int, float)):
+        return float(value)
+    elif isinstance(value, bytes):
+        try:
+            return float(int.from_bytes(value, "big"))
+        except (ValueError, OverflowError) as e:
+            raise ValueError(f"Cannot convert bytes to float: {e}")
+    else:
+        raise ValueError(f"Unsupported type for conversion to float: {type(value)}")

opinion_clob_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: opinion_clob_sdk
+Version: 0.1.0
+Summary: Opinion CLOB SDK - Python SDK for Opinion Prediction Market Central Limit Order Book API
+Home-page: https://opinion.trade
+Author: Opinion Labs
+Author-email: support@opinion.trade
+Keywords: PredictionMarket,CLOB,Trading,Blockchain,Base,Opinion
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3>=2.3.0
+Requires-Dist: six>=1.17.0
+Requires-Dist: certifi>=2024.12.14
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: hexbytes>=1.2.1
+Requires-Dist: web3>=7.6.1
+Requires-Dist: eth_account>=0.13.0
+Requires-Dist: poly_eip712_structs>=0.0.1
+Requires-Dist: opinion_api>=0.1.0
+Requires-Dist: pytest>=7.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+# Opinion CLOB SDK
+
+Python SDK for interacting with Opinion prediction markets via the CLOB (Central Limit Order Book) API.
+
+## Features
+
+- Market data queries (markets, orderbooks, prices, candles)
+- Order management (place, cancel, query orders)
+- Position and balance tracking
+- Smart contract interactions (split, merge, redeem)
+- Support for Base mainnet (chain ID 8453)
+
+## Installation
+
+```bash
+pip install opinion_clob_sdk
+```
+
+## Quick Start
+
+```python
+from opinion_clob_sdk import Client
+
+client = Client(
+    host='https://api.opinion.trade',
+    apikey='your_api_key',
+    chain_id=8453,  # Base mainnet
+    rpc_url='your_rpc_url',
+    private_key='your_private_key',
+    multi_sig_addr='your_multi_sig_address'
+)
+
+# Get markets
+markets = client.get_markets(page=1, limit=10)
+
+# Get orderbook
+orderbook = client.get_orderbook(token_id='token_id')
+
+# Place an order
+from opinion_clob_sdk.chain.py_order_utils.model.order import PlaceOrderDataInput
+from opinion_clob_sdk.chain.py_order_utils.model.sides import OrderSide
+from opinion_clob_sdk.chain.py_order_utils.model.order_type import LIMIT_ORDER
+
+order_data = PlaceOrderDataInput(
+    marketId=123,
+    tokenId='token_id',
+    side=OrderSide.BUY,
+    orderType=LIMIT_ORDER,
+    price='0.5',
+    makerAmountInQuoteToken=10
+)
+
+result = client.place_order(order_data)
+```
+    

opinion_clob_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+chain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/contract_caller.py,sha256=AKCD1ZvLTbJX_YWFJecRtZ4Pi7L3_20Q7YOSGfAolEY,17148
+chain/exception.py,sha256=6SSx4T_WZL8BxzRbfGSDp6eGD4zJ5ACeBB58DlrpmoA,234
+chain/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/contracts/conditional_tokens.py,sha256=P_MpetUKMNnT_hchZ0A9q7-g_ZKjkOr-BLldPXB4J7o,13998
+chain/contracts/erc20.py,sha256=C56GdZeMxcgdJTmMQKSfA8xHzDdNT71SaNf6xhJIVMY,2843
+chain/py_order_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/py_order_utils/constants.py,sha256=afsZ0OahGbCzNPE2rXKU1k8gQymkh4ODLKh4KPklvnA,70
+chain/py_order_utils/signer.py,sha256=NAMHcMREbRUgrz1-28sqpPoMD8LkRJSyUn7-FLUkYsM,447
+chain/py_order_utils/utils.py,sha256=-sf0Vq16bJ8eAc-p63r0TLqtbQkKWEQ6ccSAoQy1r7M,3837
+chain/py_order_utils/builders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/py_order_utils/builders/base_builder.py,sha256=lw925Mz6MerqCyXNgonhNP-495gZPm_me4HtlhyhVHM,1272
+chain/py_order_utils/builders/exception.py,sha256=525fSH8Q241VjxdllBkWi3DiW_-6I1AmG-iHwZBTp4E,47
+chain/py_order_utils/builders/order_builder.py,sha256=NybKbNhRd1jceSjtp6lL9x1DjDzJ4ClhsAK2zS58P4c,2968
+chain/py_order_utils/builders/order_builder_test.py,sha256=0xPLO9rEDsw_s3UQiooquEarvFe8KneafiaY6PgkLIo,1773
+chain/py_order_utils/model/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/py_order_utils/model/order.py,sha256=fI2NhqX_cdUmZivliki4rHXJCxQQY5ykjh8a58FFfPE,5852
+chain/py_order_utils/model/order_type.py,sha256=kYXJ0Ikk3Qnr00yCIfrtJibFve8DUjNSJ_xiLw7IphY,185
+chain/py_order_utils/model/sides.py,sha256=FZVZnutyLmgiNCVoz-1fjxxFzhH3z24xy5BY6pkIfs8,177
+chain/py_order_utils/model/signatures.py,sha256=lKoqi7gVay9NjCv_2QTdelP4EFy61Ez0UeY1ytOmooM,224
+chain/safe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/safe/constants.py,sha256=H4UKUXJxR9pvwRHU4WM1p6wZ6yGjApOpWfEMYj-W_iE,572
+chain/safe/enums.py,sha256=aP9-PfC97ZYtX0dKOYKAyxITVrCDMIAY2_mHMdU8IJM,90
+chain/safe/exceptions.py,sha256=kp0jfnP93JyEkEgwPERL6MZ9D8ozbioURcKjMwSLjgE,1498
+chain/safe/multisend.py,sha256=l-lWlb7jSzmNCyFbpAr-d8SYEKM4QRm_h0tF53T3CzE,12659
+chain/safe/safe.py,sha256=OO-010or-qCCwCSTSh4qKGmoSwEsL2IYECW8IYmSmKQ,5216
+chain/safe/safe_signature.py,sha256=W1Xn73DSzE3PZ6ITyikhdWhosY3wdey-scX0Jci037I,12559
+chain/safe/safe_test.py,sha256=pbCYOLa_6cQbC0KOA7t41ItunauhHfgN7uneENfMXPk,1384
+chain/safe/safe_tx.py,sha256=QxKzv0EA7uwjakFMDVoDLrzYlZANpEhblPBQ7ZcF9zE,17211
+chain/safe/signatures.py,sha256=8l6t6R21E9Mj4_USagIp1GiUlJmAp0Cqq9VpB7Zk960,1978
+chain/safe/typing.py,sha256=wytgXXRbpyccM_HxpQLeDzfo40Ch_K-Z_ivORb-eNZo,419
+chain/safe/utils.py,sha256=1u4yKwMCvfOlg9NsWbsM2WszQoO1wd6D2Z2aGAb1jjo,6469
+chain/safe/eip712/__init__.py,sha256=ge0S6t2RtFc_mLFr4D93l6WLS2EONKgkuPGkcP_nDJ4,5915
+chain/safe/safe_contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chain/safe/safe_contracts/compatibility_fallback_handler_v1_3_0.py,sha256=_aENMzhiQgKSzXxn-TnVFWE84lIgDv1Iiw-VdIC1IMw,5968
+chain/safe/safe_contracts/multisend_v1_3_0.py,sha256=8oGhNkS2k2Cy5pG6YNt_BKytS3AEtPeXv4rkyXv_p0M,380
+chain/safe/safe_contracts/safe_v1_3_0.py,sha256=YCUWTpf_pR44iUUkDl42f3n2YXSVGlTBcvMtReN7rlM,21922
+chain/safe/safe_contracts/utils.py,sha256=xnW8JSq8tVMfvZ4lhT-L96P3Usjs2zrZ5jzrNZvFHjc,631
+opinion_clob_sdk-0.1.0.dist-info/METADATA,sha256=PaYXOI7kFUuxqyrPEZ320lR-A0xCCYcRqQyIDOow-nw,2776
+opinion_clob_sdk-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+opinion_clob_sdk-0.1.0.dist-info/top_level.txt,sha256=O2U8tt1VAqoTZR-urcArMMWdyf_x0FZEcZ1-vur6gus,6
+opinion_clob_sdk-0.1.0.dist-info/RECORD,,

opinion_clob_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

opinion_clob_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+chain