polynode 0.6.1__tar.gz → 0.6.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polynode
-Version: 0.6.1
+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.1 → 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.1 → polynode-0.6.2}/polynode/trading/__init__.py

@@ -5,6 +5,7 @@ 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
 
@@ -20,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.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.1 → polynode-0.6.2}/polynode/trading/trader.py

@@ -478,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.1 → polynode-0.6.2}/polynode/trading/types.py

@@ -153,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.1 → polynode-0.6.2}/pyproject.toml

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