polymarket-apis 0.3.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

polymarket_apis/utilities/web3/abis/SafeProxyFactory.json

@@ -0,0 +1,224 @@
+[
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_masterCopy",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "_fallbackHandler",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "constructor"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "contract GnosisSafe",
+        "name": "proxy",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "owner",
+        "type": "address"
+      }
+    ],
+    "name": "ProxyCreation",
+    "type": "event"
+  },
+  {
+    "inputs": [ ],
+    "name": "CREATE_PROXY_TYPEHASH",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "DOMAIN_TYPEHASH",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "NAME",
+    "outputs": [
+      {
+        "internalType": "string",
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "user",
+        "type": "address"
+      }
+    ],
+    "name": "computeProxyAddress",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "paymentToken",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "payment",
+        "type": "uint256"
+      },
+      {
+        "internalType": "address payable",
+        "name": "paymentReceiver",
+        "type": "address"
+      },
+      {
+        "components": [
+          {
+            "internalType": "uint8",
+            "name": "v",
+            "type": "uint8"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "r",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "s",
+            "type": "bytes32"
+          }
+        ],
+        "internalType": "struct SafeProxyFactory.Sig",
+        "name": "createSig",
+        "type": "tuple"
+      }
+    ],
+    "name": "createProxy",
+    "outputs": [ ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "domainSeparator",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "fallbackHandler",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "getContractBytecode",
+    "outputs": [
+      {
+        "internalType": "bytes",
+        "name": "",
+        "type": "bytes"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "user",
+        "type": "address"
+      }
+    ],
+    "name": "getSalt",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "pure",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "masterCopy",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [ ],
+    "name": "proxyCreationCode",
+    "outputs": [
+      {
+        "internalType": "bytes",
+        "name": "",
+        "type": "bytes"
+      }
+    ],
+    "stateMutability": "pure",
+    "type": "function"
+  }
+]

polymarket_apis/utilities/web3/helpers.py

@@ -1,3 +1,13 @@
+import re
+from collections.abc import Iterable
+from typing import Any
+
+from eth_account import Account
+from eth_account.messages import encode_defunct
+from web3.constants import ADDRESS_ZERO
+from web3.contract import Contract
+
+
 def get_market_index(question_id: str) -> int:
     """Extract the market index from a question ID (last 2 hex characters)."""
     return int(question_id[-2:], 16)
@@ -7,3 +17,145 @@ def get_index_set(question_ids: list[str]) -> int:
     """Calculate bitwise index set from question IDs."""
     indices = [get_market_index(question_id) for question_id in question_ids]
     return sum(1 << index for index in set(indices))
+
+
+def _pack_primitive(typ: str, val: Any) -> bytes:
+    if isinstance(val, str) and val.startswith("0x"):
+        raw = bytes.fromhex(val[2:])
+    elif isinstance(val, bytes):
+        raw = val
+    else:
+        raw = val
+
+    if typ == "string":
+        if not isinstance(raw, (bytes, str)):
+            msg = "string value must be str or bytes"
+            raise TypeError(msg)
+        return raw.encode() if isinstance(raw, str) else raw
+    if typ == "bytes":
+        if isinstance(raw, int):
+            msg = "bytes value must be hex/bytes/str"
+            raise TypeError(msg)
+        if isinstance(raw, str):
+            return raw.encode()
+        return raw
+
+    m = re.match(r"^bytes(\d+)$", typ)
+    if m:
+        n = int(m.group(1))
+        if isinstance(raw, int):
+            b = raw.to_bytes(n, "big")
+        elif isinstance(raw, str) and raw.startswith("0x"):
+            b = bytes.fromhex(raw[2:])
+        elif isinstance(raw, (bytes, bytearray)):
+            b = bytes(raw)
+        else:
+            msg = f"unsupported value for {typ}"
+            raise TypeError(msg)
+        if len(b) != n:
+            if len(b) > n:
+                return b[:n]
+            return b.ljust(n, b"\x00")
+        return b
+
+    if typ == "address":
+        if isinstance(raw, str) and raw.startswith("0x"):
+            addr = raw[2:]
+        elif isinstance(raw, str):
+            addr = raw
+        elif isinstance(raw, (bytes, bytearray)):
+            return bytes(raw[-20:])
+        else:
+            msg = "address must be hex string or bytes"
+            raise TypeError(msg)
+        addr = addr.rjust(40, "0")[-40:]
+        return bytes.fromhex(addr)
+
+    m = re.match(r"^u?int(\d*)$", typ)
+    if m:
+        bits = int(m.group(1)) if m.group(1) else 256
+        size = bits // 8
+        if isinstance(raw, (bytes, bytearray)):
+            intval = int.from_bytes(raw, "big")
+        elif isinstance(raw, str) and raw.startswith("0x"):
+            intval = int(raw, 16)
+        elif isinstance(raw, int):
+            intval = raw
+        else:
+            msg = f"unsupported value for {typ}"
+            raise TypeError(msg)
+        if intval < 0:
+            intval &= (1 << bits) - 1
+        return intval.to_bytes(size, "big")
+
+    msg = f"unsupported type {typ}"
+    raise ValueError(msg)
+
+
+def abi_encode_packed(*params: dict) -> bytes:
+    """
+    Takes in sequence of {'type': str, 'value': any}.
+
+    returns: concatenated packed bytes (no 0x prefix).
+    """
+    parts: list[bytes] = []
+    for p in params:
+        typ = p["type"]
+        val = p["value"]
+        if typ.endswith("[]"):
+            inner = typ[:-2]
+            if not isinstance(val, Iterable):
+                msg = f"expected array value for {typ}"
+                raise TypeError(msg)
+            for elem in val:
+                parts.append(abi_encode_packed({"type": inner, "value": elem}))
+            continue
+        parts.append(_pack_primitive(typ, val))
+    return b"".join(parts)
+
+
+def sign_safe_transaction(
+    account: Account, safe: Contract, safe_txn: dict, nonce: int
+) -> bytes:
+    safe_tx_gas = 0
+    base_gas = 0
+    gas_price = 0
+    gas_token = ADDRESS_ZERO
+    refund_receiver = ADDRESS_ZERO
+
+    tx_hash_bytes = safe.functions.getTransactionHash(
+        safe_txn["to"],
+        safe_txn["value"],
+        safe_txn["data"],
+        safe_txn.get("operation", 0),
+        safe_tx_gas,
+        base_gas,
+        gas_price,
+        gas_token,
+        refund_receiver,
+        nonce,
+    ).call()
+
+    tx_hash_hex = tx_hash_bytes.hex()
+    message = encode_defunct(hexstr=tx_hash_hex)
+    signed = account.sign_message(message)
+    r = signed.r
+    s = signed.s
+    v = signed.v
+
+    match v:
+        case 0 | 1:
+            v += 31
+        case 27 | 28:
+            v += 4
+        case _:
+            msg = "Invalid signature V value"
+            raise ValueError(msg)
+
+    packed_sig = abi_encode_packed(
+        {"type": "uint256", "value": r},
+        {"type": "uint256", "value": s},
+        {"type": "uint8", "value": v},
+    )
+
+    return packed_sig

{polymarket_apis-0.3.1.dist-info → polymarket_apis-0.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polymarket-apis
-Version: 0.3.1
+Version: 0.3.3
 Summary: Unified Polymarket APIs with Pydantic data validation - Clob, Gamma, Data, Web3, Websockets, GraphQL clients.
 Author-email: Razvan Gheorghe <razvan@gheorghe.me>
 Requires-Python: >=3.12
@@ -94,15 +94,36 @@ flowchart LR
   ### PolymarketGammaClient - Market/Event related operations
     - #### Market
       - get **GammaMarket** by `market_id`
+      - get **GammaMarket** by `slug`
       - get **GammaMarkets** with pagination (offset and limit), filter by `slug`s, `market_id`s, `token_id`s, `condition_id`s, `tag_id` or filtered by active, closed, archived, liquidity window, volume window, start date window, end date window and ordered
+      - get **Tags** for a **Market** by `market_id`
     - #### Event
       - get **Event** by `event_id`
+      - get **Event** by `slug`
       - get **Events** with pagination, filter by `slug`s, `event_id`s, `tag_id` or filtered by active, closed, archived, liquidity window, volume window, start date window, end date window and ordered
       - get all **Events** given some filtration
-      - search **Events**, filter by text query, active/resolved, sort by volume/volume_24hr/liquidity/start_date/end_date/competitive (tries to mimic the web app search bar)
-    - #### Miscellaneous
+      - search **Events**, **Tags**, **Profiles**, filter by text query, tags, active/resolved, recurrence, sort by volume/volume_24hr/liquidity/start_date/end_date/competitive
       - grok event summary by **Event** `slug`
       - grok election market explanation by candidate name and election title
+      - get **Tags** for an **Event** by `event_id`
+    - #### Tag
+      - get **Tags** with pagination, order by any **Tag** field
+      - get all **Tags**
+      - get **Tag** by `tag_id`
+      - get **Tag** relations by `tag_id` or `slug`
+      - get **Tags** related to a **Tag** by `tag_id` or `slug`
+    - #### Sport
+      - get **Teams** with pagination, filter by `league`, `name`, `abbreviation`
+      - get all **Teams** given some filtration
+      - get **Sports** with pagination, filter by `name`
+      - get **Sports** metadata
+    - #### Series
+      - get **Series** with pagination, filter by `slug`, closed status, order by any **Series** field
+      - get all **Series** given some filtration
+    - #### Comments
+      - get comments by `parent_entity_type` and `parent_entity_id` with pagination, order by any **Comment** field
+      - get comments by `comment_id` - gets all comments in a thread.
+      - get comments by user base address (not proxy address) with pagination, order by any **Comment** field
 
   ### PolymarketDataClient - Portfolio related operations
   - #### Positions
@@ -118,13 +139,19 @@ flowchart LR
       - `condition_ids` is ***None*** → total value of positions
       - `condition_ids` is ***str*** → value of positions on a market
       - `condition_ids` is ***list[str]*** → sum of values of positions on multiple markets
+  - #### Closed positions
+    - get closed positions, filter by condition_ids
   - #### Miscellaneous
+    - get total number of markets traded by user address
+    - get open interest for a list of condition_ids
+    - get live volume for an event by `event_id`
     - get pnl timeseries by user address for a period (1d, 1w, 1m, all) with frequency (1h, 3h, 12h, 1d)
     - get overall pnl/volume by user address for a recent window (1d, 7d, 30d, all)
     - get user rank on the profit/volume leaderboards by user address for a recent window (1d, 7d, 30d, all)
     - get top users on the profit/volume leaderboards (at most 100) for a recent window (1d, 7d, 30d, all)
 
   ### PolymarketWeb3Client - Blockchain related operations
+  - #### Supporting both Email/Magic wallets (signature_type=1) and Safe/Gnosis wallets (signature_type=2)
   - #### Balance
     - get usdc balance by user address
     - get token balance by `token_id` and user address

{polymarket_apis-0.3.1.dist-info → polymarket_apis-0.3.3.dist-info}/RECORD

@@ -1,20 +1,20 @@
-polymarket_apis/__init__.py,sha256=ObH4CmMcXUsccDBDzQ30EBlUkkcb71eAYwEu2FnRJ24,1098
+polymarket_apis/__init__.py,sha256=hhFBeFCjzptC4uFwwYbCYjh_-8URUhOUeP_elZeCbVw,1126
 polymarket_apis/clients/__init__.py,sha256=ruMvFEA4HNkbWEYqbnrCuYXR4PUwkV1XWG0w63we-LA,759
-polymarket_apis/clients/clob_client.py,sha256=0w3ZheNo_sQrBGF0AnGwWszMAU0GoUfQEt-nc1pliiU,32063
-polymarket_apis/clients/data_client.py,sha256=vSTjzPeEFaN2_eCuilQuC4OtASvUVxkUZ_RtFuKzTbM,8750
-polymarket_apis/clients/gamma_client.py,sha256=8HtfLc0ZUHvT-QJqViKmIwvr0Uft8U6hXB03nAj2R5k,12286
+polymarket_apis/clients/clob_client.py,sha256=dDXkEf31tQnLHC7KsN7UIMfnLDJJFHrJ4VD_WwaTFbI,32102
+polymarket_apis/clients/data_client.py,sha256=SAPxgfWwPK_YuNBOvDxKgUIzdh-hMo2YlnTZ0rFDMXE,12000
+polymarket_apis/clients/gamma_client.py,sha256=tBR_z03c3wh1_sxFbjNx54DcrFEjFB0TmJiOYNUc_pk,27632
 polymarket_apis/clients/graphql_client.py,sha256=KgjxbXNWEXp82ZEz464in5mCn1PydnZqWq-g11xu9YU,1839
-polymarket_apis/clients/web3_client.py,sha256=spCZzftMS19D62GBBpIN5I8JosZuNITNXDr7MrGoHwc,12191
+polymarket_apis/clients/web3_client.py,sha256=J3j7T39cgZVb4PrYs7FoPoasO3PBP_7SbSuQzA--m64,20162
 polymarket_apis/clients/websockets_client.py,sha256=gaGcsjqp1ZRyxrL6EWvZ9XaTv7koTPDzlcShj0u0B2A,7737
-polymarket_apis/types/__init__.py,sha256=rw8HiDvmgwxa0iskCC710o09ZgUc9ocyeNiaMrsBdJM,3868
-polymarket_apis/types/clob_types.py,sha256=xWnHmsYoilJWfkw2Fxga8cUm9JXuymDRYggJhPKt50Q,11744
-polymarket_apis/types/common.py,sha256=CceB6B9w_-HWRSKSMGdAinAq-Pwd0ezGSlPzlNdpzgk,1639
-polymarket_apis/types/data_types.py,sha256=n8nHwZx97O81u0MjTWOUh6rIA9EzDavsUz00aa5DXkc,4426
-polymarket_apis/types/gamma_types.py,sha256=VwyKTHS3wZvzHwFqP_5IaZey1WF8C3n14SF0cpb4MYs,12637
-polymarket_apis/types/websockets_types.py,sha256=YOlGTeoPaCNCj1Hwr0cnPItx3PMPFjcUjS2_fOJOOTM,12367
+polymarket_apis/types/__init__.py,sha256=cyrAPNX0ty0wkMwZqB0lNA7n3JoOJCSeTpclmamMh9k,3258
+polymarket_apis/types/clob_types.py,sha256=PmD_afx7zowX0cFJ39PQQ4jywGtwNjLfoke1H7iZZnI,11744
+polymarket_apis/types/common.py,sha256=RYu6Dfh0HUIogpK_kZ1AQQQEiqQD3hHACU5fMKSUoMU,1003
+polymarket_apis/types/data_types.py,sha256=F6GDhWNtIoQ8kvLvUdlRt596aUfnuc1aHg8m8UweT_M,4641
+polymarket_apis/types/gamma_types.py,sha256=MoIUI6csqEp_vij7mkFi2IlIA99c5UNzI3zODSONWzQ,30641
+polymarket_apis/types/websockets_types.py,sha256=XGTpfix2rFFQg-97ZkPagS_tHJJpSnB5mCMf_sT2MOI,11180
 polymarket_apis/utilities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polymarket_apis/utilities/config.py,sha256=kQymQRy9fVg5jt8CcQJxsSgIZFbfjPx2q_gNnZI5b24,2449
-polymarket_apis/utilities/constants.py,sha256=OdxaAsyYzAK1RXty5VtvidMgan8YW-JfHS3Rdxp6n_U,580
+polymarket_apis/utilities/constants.py,sha256=rGX-XXu5tLy2yUurFQCQNRtSvZPPcRAUCmjlqVtTAvY,580
 polymarket_apis/utilities/endpoints.py,sha256=bxZyrJBPbVauWc-eR0RMh6KDqU-SmO_3LfQwVMNJ6vE,1235
 polymarket_apis/utilities/exceptions.py,sha256=nLVkwGNkX8mBhOi3L3lLEJ5UCPd5OBjl2f7kcct3K3A,368
 polymarket_apis/utilities/headers.py,sha256=Cc5WEnIBLYAgfwvmCXRBwA2zUYME8fDy4PbwlwlB6Oo,1510
@@ -27,15 +27,17 @@ polymarket_apis/utilities/signing/hmac.py,sha256=1VPfO2yT8nyStk6U4AQeyTzQTt5-69P
 polymarket_apis/utilities/signing/model.py,sha256=kVduuJGth7WSCUDCVVydCgPd4yEVI85gEmMxohXsvp0,191
 polymarket_apis/utilities/signing/signer.py,sha256=7-nFALFrz0qg4F4lZRyHI41S7IWxr7t0WMLOHqHzJcg,732
 polymarket_apis/utilities/web3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-polymarket_apis/utilities/web3/helpers.py,sha256=EZ5FiU54vCMeRQMSXbCDWAiGqrFRd1rS7D_CtUn8fHQ,404
+polymarket_apis/utilities/web3/helpers.py,sha256=QEpBaA_g7DRzFUZAfiKr6kg5T5_u5FaVZ0mGGNzo6mo,4698
 polymarket_apis/utilities/web3/abis/CTFExchange.json,sha256=zt8fZnUaOrD8Vh5njM0EEUpeITWhuu0SZrIZigWxgV8,38499
 polymarket_apis/utilities/web3/abis/ConditionalTokens.json,sha256=3TUcX7He74VMkoL1kxbDbtULZ70VY_EBe01pfByprsk,12584
 polymarket_apis/utilities/web3/abis/NegRiskAdapter.json,sha256=HABIoRF1s1NgctpRTdaaNDqzODzgdZLE-s2E6ef4nAY,18867
 polymarket_apis/utilities/web3/abis/NegRiskCtfExchange.json,sha256=QOgLKekWnPVcMGXExcLjEIOHLS89tPUoZFkVm-yRnbY,38612
 polymarket_apis/utilities/web3/abis/ProxyWalletFactory.json,sha256=5KjBHUWdkc_kdlWPNax84o1vStpFuLgZKTMn3jc4zvU,5553
+polymarket_apis/utilities/web3/abis/Safe.json,sha256=iXxTY7XM1hBOifAjHO9FK8e2FaQfCHrW7jK7WPvJiEM,24361
+polymarket_apis/utilities/web3/abis/SafeProxyFactory.json,sha256=bdr2WdYCRClXLTT0jarNs4C-Rz9bxozuwZgmcew-uAY,4211
 polymarket_apis/utilities/web3/abis/UChildERC20Proxy.json,sha256=ZyQC38U0uxInlmnW2VXDVD3TJfTIRmSNMkTxQsaG7oA,27396
 polymarket_apis/utilities/web3/abis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polymarket_apis/utilities/web3/abis/custom_contract_errors.py,sha256=GjCVn2b6iRheT7s-kc8Po9uwH9LfaHA1yRpJyjXRcxs,1172
-polymarket_apis-0.3.1.dist-info/METADATA,sha256=TGrtCHEi0PnuDZCBBIeTVXz_-ELhsab4zlCIIibK3cc,10723
-polymarket_apis-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-polymarket_apis-0.3.1.dist-info/RECORD,,
+polymarket_apis-0.3.3.dist-info/METADATA,sha256=5jvX-fOSD09sCoWwBuBEPh_LFDhB4u3nzGVKfPXzRPk,12193
+polymarket_apis-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+polymarket_apis-0.3.3.dist-info/RECORD,,