poly-web3 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

examples/example_redeem.py

@@ -41,11 +41,20 @@ if __name__ == "__main__":
             )
         ),
     )
-    condition_id = "0xc3df016175463c44f9c9f98bddaa3bf3daaabb14b069fb7869621cffe73ddd1c"
-    service = PolyWeb3Service(clob_client=client, relayer_client=relayer_client)
+    condition_id = "0x38124532c68bf16aa5800433118463acdbf09152237b45bb9e11bd4b73e0d1c4"
+    service = PolyWeb3Service(
+        clob_client=client,
+        relayer_client=relayer_client,
+        rpc_url="https://polygon-bor.publicnode.com",
+    )
+    # Redeem by condition_id
     redeem = service.redeem(condition_id=condition_id)
     print(redeem)
 
+    # Redeem all positions that are currently redeemable (returns list or None)
+    redeem_all = service.redeem_all()
+    print(redeem_all)
+
     # Optional - Query operations (可选操作，用于查询)
     # can_redeem = service.is_condition_resolved(condition_id)
     # redeem_balance = service.get_redeemable_index_and_balance(

poly_web3/__init__.py

@@ -16,7 +16,9 @@ from poly_web3.web3_service import SafeWeb3Service, EOAWeb3Service, ProxyWeb3Ser
 
 
 def PolyWeb3Service(
-    clob_client: ClobClient, relayer_client: RelayClient = None
+    clob_client: ClobClient,
+    relayer_client: RelayClient = None,
+    rpc_url: str | None = None,
 ) -> Union[SafeWeb3Service, EOAWeb3Service, ProxyWeb3Service]:  # noqa
     services = {
         WalletType.EOA: EOAWeb3Service,
@@ -26,6 +28,6 @@ def PolyWeb3Service(
 
     wallet_type = WalletType.get_with_code(clob_client.builder.sig_type)
     if service := services.get(wallet_type):
-        return service(clob_client, relayer_client)
+        return service(clob_client, relayer_client, rpc_url=rpc_url)
     else:
         raise Exception(f"Unknown wallet type: {wallet_type}")

poly_web3/const.py

@@ -12,7 +12,7 @@ GET_TRANSACTION = "/transaction"
 GET_TRANSACTIONS = "/transactions"
 SUBMIT_TRANSACTION = "/submit"
 GET_DEPLOYED = "/deployed"
-RPC_URL = "https://polygon-rpc.com"
+RPC_URL = "https://polygon-bor.publicnode.com" # "https://polygon-rpc.com"
 RELAYER_URL = "https://relayer-v2.polymarket.com"
 
 STATE_NEW = ("STATE_NEW",)

poly_web3/log.py

@@ -0,0 +1,18 @@
+# -*- coding = utf-8 -*-
+# @Time: 2026-01-13 14:40:20
+# @Author: PinBar
+# @Site: 
+# @File: log.py
+# @Software: PyCharm
+import sys
+import logging
+
+logger = logging.getLogger("poly_web3")
+handler = logging.StreamHandler(sys.stdout)
+formatter = logging.Formatter(
+    '%(asctime)s | %(levelname)s | %(name)s | %(filename)s:%(lineno)d  %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S'
+)
+handler.setFormatter(formatter)
+logger.addHandler(handler)
+logger.setLevel(logging.INFO)

poly_web3/web3_service/base.py

@@ -24,13 +24,15 @@ from poly_web3.const import (
     NEG_RISK_ADAPTER_ABI_REDEEM,
 )
 from poly_web3.schema import WalletType
+from poly_web3.log import logger
 
 
 class BaseWeb3Service:
     def __init__(
-        self,
-        clob_client: ClobClient = None,
-        relayer_client: RelayClient = None,
+            self,
+            clob_client: ClobClient = None,
+            relayer_client: RelayClient = None,
+            rpc_url: str | None = None,
     ):
         self.relayer_client = relayer_client
         self.clob_client: ClobClient = clob_client
@@ -40,10 +42,43 @@ class BaseWeb3Service:
             )
         else:
             self.wallet_type = WalletType.PROXY
-        self.w3: Web3 = Web3(Web3.HTTPProvider(RPC_URL))
+        self.rpc_url = rpc_url or RPC_URL
+        self.w3: Web3 = Web3(Web3.HTTPProvider(self.rpc_url))
         if self.wallet_type == WalletType.PROXY and relayer_client is None:
             raise Exception("relayer_client must be provided")
 
+    def _resolve_user_address(self):
+        funder = getattr(getattr(self.clob_client, "builder", None), "funder", None)
+        if funder:
+            return funder
+        return self.clob_client.get_address()
+
+    @classmethod
+    def fetch_positions(cls, user_address: str) -> list[dict]:
+        """
+        Fetches current positions for a user from the official Polymarket API.
+
+        :param user_address: User wallet address (0x-prefixed, 40 hex chars)
+        :return: List of position dictionaries from the API
+        """
+        url = "https://data-api.polymarket.com/positions"
+        params = {
+            "user": user_address,
+            "sizeThreshold": 1,
+            "limit": 100,
+            "redeemable": True,
+            "sortBy": "RESOLVING",
+            "sortDirection": "DESC",
+        }
+        try:
+            response = requests.get(url, params=params)
+            response.raise_for_status()
+            positions = response.json()
+            return [i for i in positions if i.get("percentPnl") > 0]
+        except Exception as e:
+            logger.error(f"Failed to fetch positions from API: {e}")
+            return []
+
     def is_condition_resolved(self, condition_id: str) -> bool:
         ctf = self.w3.eth.contract(address=CTF_ADDRESS, abi=CTF_ABI_PAYOUT)
         return ctf.functions.payoutDenominator(condition_id).call() > 0
@@ -60,8 +95,9 @@ class BaseWeb3Service:
         return winners
 
     def get_redeemable_index_and_balance(
-        self, condition_id: str, owner: str
+            self, condition_id: str
     ) -> list[tuple]:
+        owner = self._resolve_user_address()
         winners = self.get_winning_indexes(condition_id)
         if not winners:
             return []
@@ -92,7 +128,7 @@ class BaseWeb3Service:
         )._encode_transaction_data()
 
     def build_neg_risk_redeem_tx_data(
-        self, condition_id: str, redeem_amounts: list[int]
+            self, condition_id: str, redeem_amounts: list[int]
     ) -> str:
         nr_adapter = self.w3.eth.contract(
             address=NEG_RISK_ADAPTER_ADDRESS, abi=NEG_RISK_ADAPTER_ABI_REDEEM
@@ -124,7 +160,7 @@ class BaseWeb3Service:
             "id": 1,
         }
 
-        response = requests.post(RPC_URL, json=payload)
+        response = requests.post(self.rpc_url, json=payload)
         result = response.json()
 
         if "result" in result:
@@ -135,9 +171,12 @@ class BaseWeb3Service:
             raise Exception("Estimate gas error: " + str(result))
 
     def redeem(
-        self,
-        condition_id: str,
-        neg_risk: bool = False,
-        redeem_amounts: list[int] | None = None,
+            self,
+            condition_id: str,
+            neg_risk: bool = False,
+            redeem_amounts: list[int] | None = None,
     ):  # noqa:
         raise ImportError()
+
+    def redeem_all(self) -> list[dict] | None:
+        raise ImportError()

poly_web3/web3_service/proxy_service.py

@@ -24,6 +24,7 @@ from poly_web3.web3_service.base import BaseWeb3Service
 from poly_web3.signature.build import derive_proxy_wallet, create_struct_hash
 from poly_web3.signature.hash_message import hash_message
 from poly_web3.signature import secp256k1
+from poly_web3.log import logger
 
 
 class ProxyWeb3Service(BaseWeb3Service):
@@ -94,10 +95,10 @@ class ProxyWeb3Service(BaseWeb3Service):
         return function_data
 
     def redeem(
-        self,
-        condition_id: str,
-        neg_risk: bool = False,
-        redeem_amounts: list[int] | None = None,
+            self,
+            condition_id: str,
+            neg_risk: bool = False,
+            redeem_amounts: list[int] | None = None,
     ):
         if neg_risk:
             if redeem_amounts is None or len(redeem_amounts) != 2:
@@ -133,3 +134,33 @@ class ProxyWeb3Service(BaseWeb3Service):
             max_polls=100,
         )
         return redeem_res
+
+    def redeem_all(self) -> list[dict]:
+        logger.info("test")
+        return
+        positions = self.fetch_positions(user_address=self._resolve_user_address())
+        if not positions:
+            return []
+        redeem_list = []
+        for pos in positions:
+            condition_id = pos.get("conditionId")
+            try:
+                can_redeem = self.get_redeemable_index_and_balance(condition_id)
+                if not can_redeem:
+                    continue
+                if pos.get("negativeRisk"):
+                    amounts = [0, 0]
+                    amounts[pos.get("outcomeIndex")] = pos.get("size")
+                    int_amounts = [int(amount * 1e6) for amount in amounts]
+                    redeem_res = self.redeem(condition_id=condition_id, redeem_amounts=int_amounts, neg_risk=True)
+                else:
+                    redeem_res = self.redeem(condition_id=condition_id)
+            except Exception as e:
+                logger.error(f"redeem error, {condition_id=}, error={e}")
+            else:
+                redeem_list.append(redeem_res)
+                buy_price = pos.get("avgPrice")
+                size = pos.get("size")
+                volume = 1 / buy_price * (buy_price * size)
+                logger.info(f"slug={pos.get('slug')} redeem success, volume={volume:.4f} usdc")
+        return redeem_list

{poly_web3-0.0.1.dist-info → poly_web3-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poly-web3
-Version: 0.0.1
+Version: 0.0.3
 Summary: Polymarket Proxy wallet redeem SDK - Execute redeem operations on Polymarket using proxy wallets
 Home-page: https://github.com/tosmart01/poly-web3
 Author: PinBar
@@ -27,7 +27,7 @@ Dynamic: requires-python
 
 # poly-web3
 
-Python SDK for Polymarket Proxy wallet redeem operations. Supports executing Conditional Token Fund (CTF) redeem operations on Polymarket through proxy wallets.
+Python SDK for Polymarket Proxy wallet redeem operations. Supports executing Conditional Token Fund (CTF) redeem operations on Polymarket through proxy wallets, Free gas.
 
 [English](README.md) | [中文](README.zh.md)
 
@@ -39,6 +39,11 @@ This project is a Python rewrite of Polymarket's official TypeScript implementat
 - This project **only implements the official redeem functionality**, focusing on Conditional Token Fund (CTF) redeem operations
 - Other features (such as trading, order placement, etc.) are not within the scope of this project
 
+**Some Polymarket-related redeem or write operations implemented in this project depend on access granted through Polymarket's Builder program. To perform real redeem operations against Polymarket, you must apply for and obtain a Builder key/credentials via Polymarket's official Builder application process. After approval you will receive the credentials required to use the Builder API—only then will the redeem flows in this repository work against the live service. For local development or automated tests, use mocks or testnet setups instead of real keys to avoid exposing production credentials.**
+
+Reference：
+- Polymarket Builders — Introduction: https://docs.polymarket.com/developers/builders/builder-intro
+
 **Current Status:**
 - ✅ **Proxy Wallet** - Fully supported for redeem functionality
 - 🚧 **Safe Wallet** - Under development
@@ -120,12 +125,20 @@ relayer_client = RelayClient(
 )
 
 # Create service instance
-service = PolyWeb3Service(clob_client=client, relayer_client=relayer_client)
+service = PolyWeb3Service(
+    clob_client=client,
+    relayer_client=relayer_client,
+    rpc_url="https://polygon-bor.publicnode.com",  # optional
+)
 
 # Execute redeem operation
 condition_id = "0xc3df016175463c44f9c9f98bddaa3bf3daaabb14b069fb7869621cffe73ddd1c"
 redeem_result = service.redeem(condition_id=condition_id)
 print(f"Redeem result: {redeem_result}")
+
+# Redeem all positions that are currently redeemable
+redeem_all_result = service.redeem_all()
+print(f"Redeem all result: {redeem_all_result}")
 ```
 
 ### Optional - Query Operations
@@ -211,6 +224,20 @@ result = service.redeem(
 )
 ```
 
+##### `redeem_all() -> list[dict] | None`
+
+Redeem all positions that are currently redeemable for the authenticated account.
+
+**Returns:**
+- `list[dict] | None`: List of redeem results, or `None` if no redeemable positions
+
+**Examples:**
+
+```python
+# Redeem all positions that can be redeemed
+service.redeem_all()
+```
+
 ## Project Structure
 
 ```

{poly_web3-0.0.1.dist-info → poly_web3-0.0.3.dist-info}/RECORD

@@ -1,17 +1,18 @@
-examples/example_redeem.py,sha256=2KxsDjEtFrm9eo8Fme0CVAQ3NDu24G0Gfgwk4GdbzSo,1807
-poly_web3/__init__.py,sha256=sOPcaBjGctd_wT-UjztKq8rvcYBRA_HGhCr7rLXJOPM,1055
-poly_web3/const.py,sha256=VhH-UdsHN2DO993f60vnO093vSHAbaDwd6UIxb-GMuI,5091
+examples/example_redeem.py,sha256=jBTHM_qHbTMDwBfeD_M2oc9sDXbd-8GseBUHxpQ0M3Q,2063
+poly_web3/__init__.py,sha256=9SfcOZtFSMErtmGG7rTtd5L2xb3pg9I7e9ctto3u3qE,1111
+poly_web3/const.py,sha256=mmNbN4rUMHjH_65aIGoVIB1c7My_8dB1uL0eiH36f_I,5130
+poly_web3/log.py,sha256=UaMJkBntAuWFO4yLFVQRUQHqFTiRLXnexdaBrWIGkOI,487
 poly_web3/schema.py,sha256=sxZOzYglLLyQLwbSlQGpQzQ3IB7R059XQzJAO9T5frg,457
 poly_web3/signature/__init__.py,sha256=g5z1cPO_o-LPdvKb3VQu4aEcpJMMjJW-a9h9Mo6qczo,129
 poly_web3/signature/build.py,sha256=iSOzrMQOte6NWA981gQYPkCtRSoXhlFEcmV0bI7XMrA,3727
 poly_web3/signature/hash_message.py,sha256=IYCtqdV9HKE6bG6DZXt3wedrrXUn8KQ4RBgcqZq45aI,1367
 poly_web3/signature/secp256k1.py,sha256=AGpItsDFTAJR9ZpAfyC26llKaNmIfpD8v6HM3qqMAIA,1557
 poly_web3/web3_service/__init__.py,sha256=pxW7XqlSDZeoYc3ohwCcdtd_9aK3gJBIQ2ANXwHXUcE,324
-poly_web3/web3_service/base.py,sha256=5lfTKubdazwSNcG1o6Q0oTM6JM4-kgtzWkfohR3dBkI,4909
+poly_web3/web3_service/base.py,sha256=7GIDYseLFuGfpfxmrfePNwywlMOUc9DGoj1U1XNpLIA,6377
 poly_web3/web3_service/eoa_service.py,sha256=MmwaAmpD_WLk4M-2w99_F7iHTZ-pKtAnPw4m5x2h6CA,446
-poly_web3/web3_service/proxy_service.py,sha256=qIhBqa8ESSTH0e5W9WVvqLPVpJpEM5sYeRLrkHLvC1Y,4760
+poly_web3/web3_service/proxy_service.py,sha256=L_bNWzKAKv1nQ3cBn5AxbuP6Hv3D3SbqMZgp19DtNsw,6204
 poly_web3/web3_service/safe_service.py,sha256=KPmToVjqxFqFhFrDbY0hfR3Z00Alu9w31QKMyyluzX8,449
-poly_web3-0.0.1.dist-info/METADATA,sha256=3hej2oW7wH7z9KGMAEPW2UrmnirviY6ra__cJjbgAMI,8914
-poly_web3-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-poly_web3-0.0.1.dist-info/top_level.txt,sha256=wW40wsocHfhFgqSWWvYWrhwKGQU5IWkhyaz5J90vmHo,19
-poly_web3-0.0.1.dist-info/RECORD,,
+poly_web3-0.0.3.dist-info/METADATA,sha256=wiZzR2j8aDtjj3meYr1kXmZKaRtlojHEe6LSrRptd0Y,10212
+poly_web3-0.0.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+poly_web3-0.0.3.dist-info/top_level.txt,sha256=wW40wsocHfhFgqSWWvYWrhwKGQU5IWkhyaz5J90vmHo,19
+poly_web3-0.0.3.dist-info/RECORD,,