polynode 0.6.0__tar.gz → 0.6.2__tar.gz

{polynode-0.6.0 → polynode-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polynode
-Version: 0.6.0
+Version: 0.6.2
 Summary: Python SDK for the PolyNode real-time prediction market data platform
 Project-URL: Homepage, https://polynode.dev
 Project-URL: Documentation, https://docs.polynode.dev

{polynode-0.6.0 → polynode-0.6.2}/polynode/short_form.py

@@ -37,7 +37,7 @@ COIN_SYMBOLS: dict[ShortFormCoin, str] = {
 }
 
 INTERVAL_VARIANT: dict[ShortFormInterval, str] = {
-    "5m": "five", "15m": "fifteen", "1h": "sixty",
+    "5m": "fiveminute", "15m": "fifteen", "1h": "hourly",
 }
 
 WINDOW_SECONDS: dict[ShortFormInterval, int] = {

{polynode-0.6.0 → polynode-0.6.2}/polynode/trading/__init__.py

@@ -5,11 +5,13 @@ from .constants import *  # noqa: F401, F403
 from .signer import NormalizedSigner, normalize_signer
 from .cosigner import build_l2_headers, send_via_cosigner
 from .onboarding import derive_safe_address, derive_proxy_address, detect_wallet_type
+from .position_management import build_split_txn, build_merge_txn, build_convert_txn
 from .trader import PolyNodeTrader
 from .privy import PrivySigner, PrivyConfig
 
 __all__ = [
     "PolyNodeTrader",
+    "BuilderCredentials",
     "PrivySigner",
     "PrivyConfig",
     "NormalizedSigner",
@@ -19,4 +21,7 @@ __all__ = [
     "derive_safe_address",
     "derive_proxy_address",
     "detect_wallet_type",
+    "build_split_txn",
+    "build_merge_txn",
+    "build_convert_txn",
 ]

{polynode-0.6.0 → polynode-0.6.2}/polynode/trading/clob_api.py

@@ -17,6 +17,7 @@ async def post_order(
     credentials: dict[str, str],
     wallet_address: str,
     order_body: str,
+    builder_credentials: Any | None = None,
 ) -> dict[str, Any]:
     """Submit a signed order to the CLOB."""
     from .cosigner import send_via_cosigner
@@ -36,6 +37,7 @@ async def post_order(
         polynode_key,
         fallback_direct,
         {"method": "POST", "path": "/order", "body": order_body, "headers": headers},
+        builder_credentials=builder_credentials,
     )
 
 
@@ -46,6 +48,7 @@ async def cancel_order(
     credentials: dict[str, str],
     wallet_address: str,
     order_id: str,
+    builder_credentials: Any | None = None,
 ) -> dict[str, Any]:
     """Cancel a specific order."""
     from .cosigner import send_via_cosigner
@@ -67,6 +70,7 @@ async def cancel_order(
         polynode_key,
         fallback_direct,
         {"method": "DELETE", "path": "/order", "body": body, "headers": headers},
+        builder_credentials=builder_credentials,
     )
 
 
@@ -77,6 +81,7 @@ async def cancel_all_orders(
     credentials: dict[str, str],
     wallet_address: str,
     market: str | None = None,
+    builder_credentials: Any | None = None,
 ) -> dict[str, Any]:
     """Cancel all orders, optionally for a specific market."""
     from .cosigner import send_via_cosigner
@@ -99,6 +104,7 @@ async def cancel_all_orders(
         polynode_key,
         fallback_direct,
         {"method": "DELETE", "path": path, "body": body, "headers": headers},
+        builder_credentials=builder_credentials,
     )
 
 
@@ -110,6 +116,7 @@ async def get_open_orders(
     wallet_address: str,
     market: str | None = None,
     asset_id: str | None = None,
+    builder_credentials: Any | None = None,
 ) -> list[dict[str, Any]]:
     """Get open orders from the CLOB."""
     from .cosigner import send_via_cosigner
@@ -137,6 +144,7 @@ async def get_open_orders(
         polynode_key,
         fallback_direct,
         {"method": "GET", "path": path, "headers": headers},
+        builder_credentials=builder_credentials,
     )
 
     if isinstance(result, list):

{polynode-0.6.0 → polynode-0.6.2}/polynode/trading/cosigner.py

@@ -48,10 +48,17 @@ async def send_via_cosigner(
     polynode_key: str,
     fallback_direct: bool,
     request: dict[str, Any],
+    builder_credentials: Any | None = None,
 ) -> Any:
     """Send a request through the co-signer with optional fallback to direct CLOB."""
     if cosigner_url:
         try:
+            if builder_credentials is not None:
+                request["builder_credentials"] = {
+                    "key": builder_credentials.key,
+                    "secret": builder_credentials.secret,
+                    "passphrase": builder_credentials.passphrase,
+                }
             async with httpx.AsyncClient(timeout=10.0) as http:
                 resp = await http.post(
                     f"{cosigner_url}/submit",

polynode-0.6.2/polynode/trading/position_management.py

@@ -0,0 +1,104 @@
+"""
+Position management — build transactions for split, merge, and convert on Polymarket.
+
+These functions return TransactionRequest objects containing the contract address
+and ABI-encoded calldata. Submit them via the Polymarket relayer (gasless for
+Safe wallets) or directly on-chain.
+
+    from polynode.trading.position_management import build_split_txn, build_convert_txn
+
+    # Split $100 into YES + NO tokens
+    tx = build_split_txn("0xabc...conditionId", 100.0, neg_risk=True)
+
+    # Convert NO positions on outcomes 0 and 1
+    tx = build_convert_txn("0xdef...marketId", [0, 1], 50.0)
+"""
+
+from .constants import CTF, NEG_RISK_ADAPTER, USDC
+from .types import TransactionRequest
+
+
+def build_split_txn(condition_id: str, amount: float, neg_risk: bool = True) -> TransactionRequest:
+    """Build a split transaction: USDC -> YES + NO outcome tokens.
+
+    Routes to NegRiskAdapter for neg-risk markets, CTF for standard markets.
+    Amount is in USDC (e.g. 100.0 = $100).
+    """
+    amount_raw = int(amount * 1_000_000)
+
+    if neg_risk:
+        # NegRiskAdapter.splitPosition(bytes32 conditionId, uint256 amount)
+        data = "0xa3d7da1d" + _encode_bytes32(condition_id) + _encode_uint256(amount_raw)
+        return TransactionRequest(to=NEG_RISK_ADAPTER, data=data)
+    else:
+        # CTF.splitPosition(address, bytes32, bytes32, uint256[], uint256)
+        data = (
+            "0x72108503"
+            + _encode_address(USDC)
+            + "00" * 32  # parentCollectionId = bytes32(0)
+            + _encode_bytes32(condition_id)
+            + _encode_uint256(160)  # offset to partition array
+            + _encode_uint256(amount_raw)
+            + _encode_uint256(2)  # partition length
+            + _encode_uint256(1)
+            + _encode_uint256(2)
+        )
+        return TransactionRequest(to=CTF, data=data)
+
+
+def build_merge_txn(condition_id: str, amount: float, neg_risk: bool = True) -> TransactionRequest:
+    """Build a merge transaction: YES + NO outcome tokens -> USDC."""
+    amount_raw = int(amount * 1_000_000)
+
+    if neg_risk:
+        # NegRiskAdapter.mergePositions(bytes32 conditionId, uint256 amount)
+        data = "0x5d03f453" + _encode_bytes32(condition_id) + _encode_uint256(amount_raw)
+        return TransactionRequest(to=NEG_RISK_ADAPTER, data=data)
+    else:
+        # CTF.mergePositions(address, bytes32, bytes32, uint256[], uint256)
+        data = (
+            "0xcad9440e"
+            + _encode_address(USDC)
+            + "00" * 32
+            + _encode_bytes32(condition_id)
+            + _encode_uint256(160)
+            + _encode_uint256(amount_raw)
+            + _encode_uint256(2)
+            + _encode_uint256(1)
+            + _encode_uint256(2)
+        )
+        return TransactionRequest(to=CTF, data=data)
+
+
+def build_convert_txn(market_id: str, outcome_indices: list[int], amount: float) -> TransactionRequest:
+    """Build a convert transaction: NO positions -> USDC + YES on complementary outcomes.
+
+    Only works on neg-risk multi-outcome markets.
+    outcome_indices: which outcomes' NOs to convert (e.g. [0, 1]).
+    """
+    amount_raw = int(amount * 1_000_000)
+
+    # Compute indexSet bitmask
+    index_set = 0
+    for idx in outcome_indices:
+        index_set |= 1 << idx
+
+    # NegRiskAdapter.convertPositions(bytes32 marketId, uint256 indexSet, uint256 amount)
+    data = "0xc64748c4" + _encode_bytes32(market_id) + _encode_uint256(index_set) + _encode_uint256(amount_raw)
+    return TransactionRequest(to=NEG_RISK_ADAPTER, data=data)
+
+
+# ── Encoding helpers ──
+
+def _encode_bytes32(hex_str: str) -> str:
+    s = hex_str.removeprefix("0x")
+    return s.zfill(64)[:64]
+
+
+def _encode_address(addr: str) -> str:
+    s = addr.removeprefix("0x")
+    return s.lower().zfill(64)
+
+
+def _encode_uint256(val: int) -> str:
+    return hex(val)[2:].zfill(64)

{polynode-0.6.0 → polynode-0.6.2}/polynode/trading/trader.py

@@ -60,6 +60,7 @@ class PolyNodeTrader:
         self._fallback_direct = c.fallback_direct
         self._default_sig_type = c.default_signature_type
         self._rpc_url = c.rpc_url
+        self._builder_credentials = c.builder_credentials
 
         self._db: TradingSqliteBackend | None = None
         self._active_signer: NormalizedSigner | None = None
@@ -382,6 +383,7 @@ class PolyNodeTrader:
         result = await send_via_cosigner(
             self._cosigner_url, self._polynode_key, self._fallback_direct,
             {"method": "POST", "path": "/order", "body": body_str, "headers": headers},
+            builder_credentials=self._builder_credentials,
         )
 
         order_id = result.get("orderID") or result.get("orderId")
@@ -409,6 +411,7 @@ class PolyNodeTrader:
             self._cosigner_url, self._polynode_key, self._fallback_direct,
             {"apiKey": creds.api_key, "apiSecret": creds.api_secret, "apiPassphrase": creds.api_passphrase},
             creds.wallet_address, order_id,
+            builder_credentials=self._builder_credentials,
         )
         return CancelResult(
             canceled=result.get("canceled", []),
@@ -421,6 +424,7 @@ class PolyNodeTrader:
             self._cosigner_url, self._polynode_key, self._fallback_direct,
             {"apiKey": creds.api_key, "apiSecret": creds.api_secret, "apiPassphrase": creds.api_passphrase},
             creds.wallet_address, market,
+            builder_credentials=self._builder_credentials,
         )
         return CancelResult(
             canceled=result.get("canceled", []),
@@ -435,6 +439,7 @@ class PolyNodeTrader:
             self._cosigner_url, self._polynode_key, self._fallback_direct,
             {"apiKey": creds.api_key, "apiSecret": creds.api_secret, "apiPassphrase": creds.api_passphrase},
             creds.wallet_address, market, asset_id,
+            builder_credentials=self._builder_credentials,
         )
         return [
             OpenOrder(
@@ -473,6 +478,30 @@ class PolyNodeTrader:
         db.upsert_market_meta(meta)
         return meta
 
+    # ── Position Management (split/merge/convert) ──
+
+    def split(self, params: "SplitParams") -> "TransactionRequest":
+        """Build a split transaction: USDC -> YES + NO outcome tokens.
+
+        Returns a TransactionRequest to submit via the Polymarket relayer or on-chain.
+        For gasless execution, use the TypeScript SDK's trader.split().
+        """
+        from .position_management import build_split_txn
+        return build_split_txn(params.condition_id, params.amount, neg_risk=True)
+
+    def merge(self, params: "MergeParams") -> "TransactionRequest":
+        """Build a merge transaction: YES + NO outcome tokens -> USDC."""
+        from .position_management import build_merge_txn
+        return build_merge_txn(params.condition_id, params.amount, neg_risk=True)
+
+    def convert(self, params: "ConvertParams") -> "TransactionRequest":
+        """Build a convert transaction: NO positions -> USDC + YES on complementary outcomes.
+
+        Only works on neg-risk multi-outcome markets.
+        """
+        from .position_management import build_convert_txn
+        return build_convert_txn(params.market_id, params.outcome_indices, params.amount)
+
     # ── History ──
 
     def get_order_history(self, params: HistoryParams | None = None) -> list[OrderHistoryRow]:

{polynode-0.6.0 → polynode-0.6.2}/polynode/trading/types.py

@@ -33,6 +33,14 @@ class GeneratedWallet:
     address: str
 
 
+@dataclass
+class BuilderCredentials:
+    """Polymarket builder credentials for order attribution."""
+    key: str
+    secret: str
+    passphrase: str
+
+
 @dataclass
 class TraderConfig:
     polynode_key: str = ""
@@ -41,6 +49,7 @@ class TraderConfig:
     fallback_direct: bool = True
     default_signature_type: SignatureType = SignatureType.POLY_GNOSIS_SAFE
     rpc_url: str = "https://polygon-bor-rpc.publicnode.com"
+    builder_credentials: BuilderCredentials | None = None
 
 
 @dataclass
@@ -144,6 +153,48 @@ class OpenOrder:
     order_type: str
 
 
+# ── Position Management (split/merge/convert) ──
+
+
+@dataclass
+class SplitParams:
+    """Parameters for splitting USDC into YES + NO outcome tokens."""
+    condition_id: str
+    amount: float  # USDC amount (e.g. 100.0 = $100)
+
+
+@dataclass
+class MergeParams:
+    """Parameters for merging YES + NO outcome tokens back into USDC."""
+    condition_id: str
+    amount: float
+
+
+@dataclass
+class ConvertParams:
+    """Parameters for converting NO positions on selected outcomes.
+    Only works on neg-risk multi-outcome markets."""
+    market_id: str
+    outcome_indices: list[int]  # e.g. [0, 1]
+    amount: float
+
+
+@dataclass
+class TransactionRequest:
+    """A pre-built transaction ready for submission."""
+    to: str
+    data: str  # hex-encoded calldata
+    value: str = "0"
+
+
+@dataclass
+class PositionResult:
+    """Result of a position management operation."""
+    success: bool
+    tx_hash: str | None = None
+    error: str | None = None
+
+
 @dataclass
 class MarketMeta:
     token_id: str

{polynode-0.6.0 → polynode-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "polynode"
-version = "0.6.0"
+version = "0.6.2"
 description = "Python SDK for the PolyNode real-time prediction market data platform"
 readme = "README.md"
 requires-python = ">=3.10"