hyperliquid-cli-python 0.1.5__tar.gz → 0.1.6__tar.gz

{hyperliquid_cli_python-0.1.5/src/hyperliquid_cli_python.egg-info → hyperliquid_cli_python-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperliquid-cli-python
-Version: 0.1.5
+Version: 0.1.6
 Summary: Python CLI for Hyperliquid DEX
 Author: hyperliquid-cli contributors
 License-Expression: BSD-2-Clause
@@ -72,7 +72,7 @@ python3 -m pip install --user -e .
 Install from PyPI:
 
 ```bash
-pip install hyperliquid-cli-python
+pip install --user hyperliquid-cli-python
 ```
 
 After installation, the `hl` command is available:
@@ -223,7 +223,8 @@ Order side semantics:
 ### TWAP Orders
 
 `hyperliquid-python-sdk` does not provide a high-level TWAP method, so this CLI signs and submits the official
-`exchange` actions `twapOrder` / `twapCancel`.
+`exchange` actions `twapOrder` / `twapCancel`. Successful submissions store the returned `twapId`
+locally under `~/.hl/twap_orders.json` so the CLI can show and cancel tracked TWAPs later.
 
 TWAP is perp-only, so use `long` / `short`.
 
@@ -239,6 +240,9 @@ hl order twap short 2.0 ETH 5,10 --randomize
 
 # Cancel TWAP
 hl order twap-cancel BTC 12345
+
+# Or list tracked active TWAPs and pick one interactively
+hl order twap-cancel
 ```
 
 ### Stake-Based Orders

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/README.md

@@ -57,7 +57,7 @@ python3 -m pip install --user -e .
 Install from PyPI:
 
 ```bash
-pip install hyperliquid-cli-python
+pip install --user hyperliquid-cli-python
 ```
 
 After installation, the `hl` command is available:
@@ -208,7 +208,8 @@ Order side semantics:
 ### TWAP Orders
 
 `hyperliquid-python-sdk` does not provide a high-level TWAP method, so this CLI signs and submits the official
-`exchange` actions `twapOrder` / `twapCancel`.
+`exchange` actions `twapOrder` / `twapCancel`. Successful submissions store the returned `twapId`
+locally under `~/.hl/twap_orders.json` so the CLI can show and cancel tracked TWAPs later.
 
 TWAP is perp-only, so use `long` / `short`.
 
@@ -224,6 +225,9 @@ hl order twap short 2.0 ETH 5,10 --randomize
 
 # Cancel TWAP
 hl order twap-cancel BTC 12345
+
+# Or list tracked active TWAPs and pick one interactively
+hl order twap-cancel
 ```
 
 ### Stake-Based Orders

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyperliquid-cli-python"
-version = "0.1.5"
+version = "0.1.6"
 description = "Python CLI for Hyperliquid DEX"
 readme = "README.md"
 requires-python = ">=3.10"

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/src/hl_cli/cli/argparse_main.py

@@ -318,11 +318,11 @@ def _build_parser() -> argparse.ArgumentParser:
     ord_twap_cancel = add_cmd_parser(
         ord_sub,
         "twap-cancel",
-        "Cancel native TWAP order",
-        ["hl order twap-cancel BTC 12345"],
+        "Cancel native TWAP order (interactive if omitted)",
+        ["hl order twap-cancel BTC 12345", "hl order twap-cancel"],
     )
-    ord_twap_cancel.add_argument("coin")
-    ord_twap_cancel.add_argument("twap_id")
+    ord_twap_cancel.add_argument("coin", nargs="?")
+    ord_twap_cancel.add_argument("twap_id", nargs="?")
 
     ord_cancel = add_cmd_parser(
         ord_sub,

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/src/hl_cli/commands/order.py

@@ -11,6 +11,12 @@ from ..cli.runtime import run_blocking
 from ..core.context import CLIContext
 from ..core.order_config import get_order_config, update_order_config
 from ..core.testnet_policy import uses_main_perp_only
+from ..infra.twap_registry import (
+    find_twap_order,
+    list_twap_orders,
+    mark_twap_cancelled,
+    register_twap_order,
+)
 from ..utils.output import out, out_success
 from ..utils.validators import (
     normalize_side,
@@ -486,6 +492,38 @@ def _fetch_orders(context: CLIContext, user: str) -> list[dict[str, Any]]:
         for o in orders
     ]
 
+def _network_name(context: CLIContext) -> str:
+    return "testnet" if context.config.testnet else "mainnet"
+
+def _extract_twap_id(response: dict[str, Any]) -> Optional[int]:
+    status = response.get("response", {}).get("data", {}).get("status", {})
+    if not isinstance(status, dict):
+        return None
+    running = status.get("running")
+    if not isinstance(running, dict):
+        return None
+    try:
+        return int(running["twapId"])
+    except (KeyError, TypeError, ValueError):
+        return None
+
+def _render_twap_orders(title: str, records: list[Any]) -> None:
+    _render_table(
+        title,
+        ["TWAP ID", "Coin", "Side", "Total Size", "Minutes", "Submitted"],
+        [
+            [
+                record.twap_id,
+                record.coin,
+                record.side,
+                record.total_size,
+                record.duration_minutes,
+                record.submitted_at,
+            ]
+            for record in records
+        ],
+    )
+
 @cli_command
 def order_ls(
     ctx: Any,
@@ -494,6 +532,7 @@ def order_ls(
 ) -> None:
     context = _ctx(ctx)
     address = user if user else context.get_wallet_address()
+    tracked_twaps = list_twap_orders(network=_network_name(context), user=address)
     if watch:
         watch_loop(
             lambda: _fetch_orders(context, address),
@@ -505,7 +544,16 @@ def order_ls(
             as_json=_json(ctx),
         )
         return
-    out(_fetch_orders(context, address), _json(ctx))
+    orders = _fetch_orders(context, address)
+    if _json(ctx):
+        if tracked_twaps:
+            out({"openOrders": orders, "trackedTwaps": [record.__dict__ for record in tracked_twaps]}, True)
+        else:
+            out(orders, True)
+    else:
+        if tracked_twaps:
+            _render_twap_orders("Tracked TWAP Orders", tracked_twaps)
+        out(orders, False)
     _done(ctx)
 
 @cli_command
@@ -790,6 +838,7 @@ def order_twap(
         "twap": {
             "side": "buy" if is_buy else "sell",
             "coin": coin,
+            "resolvedCoin": resolved_coin,
             "totalSize": total_size,
             "stake": stake,
             "durationMinutes": minutes,
@@ -800,6 +849,23 @@ def order_twap(
             "response": response,
         }
     }
+    twap_id = _extract_twap_id(response)
+    if twap_id is not None:
+        # TODO: Replace the local TWAP registry with an official info endpoint once
+        # Hyperliquid exposes an API for listing/retrieving active TWAP orders by twapId.
+        register_twap_order(
+            network=_network_name(context),
+            user=context.get_wallet_address(),
+            coin=coin,
+            resolved_coin=resolved_coin,
+            twap_id=twap_id,
+            side="buy" if is_buy else "sell",
+            total_size=total_size,
+            duration_minutes=minutes,
+            randomize=randomize,
+            reduce_only=reduce_only,
+        )
+        result["twap"]["twapId"] = twap_id
     if _json(ctx):
         out(result, True)
     else:
@@ -815,14 +881,61 @@ def order_twap(
             print(f"Total size: {total_size} {coin}")
             print(f"Duration: {minutes} min")
             print(f"Randomize: {'on' if randomize else 'off'}")
+            if twap_id is not None:
+                print(f"TWAP ID: {twap_id}")
+                print("Manage it with 'hl order ls' or 'hl order twap-cancel'.")
     _done(ctx)
 
 @cli_command
-def order_twap_cancel(ctx: Any, coin: str, twap_id: str) -> None:
+def order_twap_cancel(ctx: Any, coin: Optional[str] = None, twap_id: Optional[str] = None) -> None:
     context = _ctx(ctx)
-    twap_num = validate_positive_integer(twap_id, "twap_id")
-    response = _cancel_native_twap(context=context, coin=coin, twap_id=twap_num)
-    out({"twapCancel": {"coin": coin, "twapId": twap_num, "response": response}}, _json(ctx))
+    address = context.get_wallet_address()
+    if coin is not None and twap_id is not None:
+        resolved_coin = coin
+        twap_num = validate_positive_integer(twap_id, "twap_id")
+    else:
+        records = list_twap_orders(network=_network_name(context), user=address)
+        if coin is not None:
+            records = [record for record in records if coin in {record.coin, record.resolved_coin}]
+        if not records:
+            raise RuntimeError("No tracked active TWAP orders found")
+        if twap_id is not None:
+            twap_num = validate_positive_integer(twap_id, "twap_id")
+            record = find_twap_order(
+                network=_network_name(context),
+                user=address,
+                twap_id=twap_num,
+                coin=coin,
+            )
+            if record is None:
+                raise RuntimeError(f"Tracked TWAP {twap_num} not found")
+            resolved_coin = record.resolved_coin
+        elif _json(ctx):
+            latest = records[0]
+            resolved_coin = latest.resolved_coin
+            twap_num = latest.twap_id
+        else:
+            _render_twap_orders("Tracked TWAP Orders", records)
+            selected = input("Select TWAP ID to cancel: ").strip()
+            twap_num = validate_positive_integer(selected, "twap_id")
+            record = find_twap_order(
+                network=_network_name(context),
+                user=address,
+                twap_id=twap_num,
+            )
+            if record is None:
+                raise RuntimeError(f"Tracked TWAP {twap_num} not found")
+            resolved_coin = record.resolved_coin
+    response = _cancel_native_twap(context=context, coin=resolved_coin, twap_id=twap_num)
+    status = response.get("response", {}).get("data", {}).get("status", {})
+    if not (isinstance(status, dict) and status.get("error")):
+        mark_twap_cancelled(
+            network=_network_name(context),
+            user=address,
+            twap_id=twap_num,
+            coin=resolved_coin,
+        )
+    out({"twapCancel": {"coin": resolved_coin, "twapId": twap_num, "response": response}}, _json(ctx))
     _done(ctx)
 
 @cli_command

hyperliquid_cli_python-0.1.6/src/hl_cli/infra/twap_registry.py

@@ -0,0 +1,144 @@
+import json
+from dataclasses import asdict, dataclass
+from datetime import datetime, timezone
+from typing import Optional
+
+from .paths import HL_DIR
+
+TWAP_REGISTRY_PATH = HL_DIR / "twap_orders.json"
+
+
+@dataclass
+class TwapRecord:
+    network: str
+    user: str
+    coin: str
+    resolved_coin: str
+    twap_id: int
+    side: str
+    total_size: float
+    duration_minutes: int
+    randomize: bool
+    reduce_only: bool
+    submitted_at: str
+    status: str = "active"
+    cancelled_at: Optional[str] = None
+
+
+def _utc_now() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+def _load_all() -> list[TwapRecord]:
+    if not TWAP_REGISTRY_PATH.exists():
+        return []
+    try:
+        raw = json.loads(TWAP_REGISTRY_PATH.read_text(encoding="utf-8"))
+    except Exception:
+        return []
+    if not isinstance(raw, list):
+        return []
+    records: list[TwapRecord] = []
+    for item in raw:
+        if not isinstance(item, dict):
+            continue
+        try:
+            records.append(TwapRecord(**item))
+        except TypeError:
+            continue
+    return records
+
+
+def _save_all(records: list[TwapRecord]) -> None:
+    HL_DIR.mkdir(parents=True, exist_ok=True)
+    TWAP_REGISTRY_PATH.write_text(
+        json.dumps([asdict(record) for record in records], ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )
+
+
+def register_twap_order(
+    *,
+    network: str,
+    user: str,
+    coin: str,
+    resolved_coin: str,
+    twap_id: int,
+    side: str,
+    total_size: float,
+    duration_minutes: int,
+    randomize: bool,
+    reduce_only: bool,
+) -> None:
+    records = _load_all()
+    records = [
+        record
+        for record in records
+        if not (
+            record.network == network
+            and record.user.lower() == user.lower()
+            and record.twap_id == twap_id
+            and record.resolved_coin == resolved_coin
+        )
+    ]
+    records.append(
+        TwapRecord(
+            network=network,
+            user=user,
+            coin=coin,
+            resolved_coin=resolved_coin,
+            twap_id=twap_id,
+            side=side,
+            total_size=total_size,
+            duration_minutes=duration_minutes,
+            randomize=randomize,
+            reduce_only=reduce_only,
+            submitted_at=_utc_now(),
+        )
+    )
+    _save_all(records)
+
+
+def list_twap_orders(*, network: str, user: str, active_only: bool = True) -> list[TwapRecord]:
+    records = [
+        record
+        for record in _load_all()
+        if record.network == network and record.user.lower() == user.lower()
+    ]
+    if active_only:
+        records = [record for record in records if record.status == "active"]
+    records.sort(key=lambda record: record.submitted_at, reverse=True)
+    return records
+
+
+def find_twap_order(
+    *,
+    network: str,
+    user: str,
+    twap_id: int,
+    coin: Optional[str] = None,
+) -> Optional[TwapRecord]:
+    for record in list_twap_orders(network=network, user=user, active_only=False):
+        if record.twap_id != twap_id:
+            continue
+        if coin and coin not in {record.coin, record.resolved_coin}:
+            continue
+        return record
+    return None
+
+
+def mark_twap_cancelled(*, network: str, user: str, twap_id: int, coin: Optional[str] = None) -> None:
+    records = _load_all()
+    updated = False
+    for record in records:
+        if record.network != network or record.user.lower() != user.lower():
+            continue
+        if record.twap_id != twap_id:
+            continue
+        if coin and coin not in {record.coin, record.resolved_coin}:
+            continue
+        record.status = "cancelled"
+        record.cancelled_at = _utc_now()
+        updated = True
+    if updated:
+        _save_all(records)

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6/src/hyperliquid_cli_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperliquid-cli-python
-Version: 0.1.5
+Version: 0.1.6
 Summary: Python CLI for Hyperliquid DEX
 Author: hyperliquid-cli contributors
 License-Expression: BSD-2-Clause
@@ -72,7 +72,7 @@ python3 -m pip install --user -e .
 Install from PyPI:
 
 ```bash
-pip install hyperliquid-cli-python
+pip install --user hyperliquid-cli-python
 ```
 
 After installation, the `hl` command is available:
@@ -223,7 +223,8 @@ Order side semantics:
 ### TWAP Orders
 
 `hyperliquid-python-sdk` does not provide a high-level TWAP method, so this CLI signs and submits the official
-`exchange` actions `twapOrder` / `twapCancel`.
+`exchange` actions `twapOrder` / `twapCancel`. Successful submissions store the returned `twapId`
+locally under `~/.hl/twap_orders.json` so the CLI can show and cancel tracked TWAPs later.
 
 TWAP is perp-only, so use `long` / `short`.
 
@@ -239,6 +240,9 @@ hl order twap short 2.0 ETH 5,10 --randomize
 
 # Cancel TWAP
 hl order twap-cancel BTC 12345
+
+# Or list tracked active TWAPs and pick one interactively
+hl order twap-cancel
 ```
 
 ### Stake-Based Orders

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/src/hyperliquid_cli_python.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ src/hl_cli/infra/account_repo.py
 src/hl_cli/infra/db.py
 src/hl_cli/infra/db_crypto.py
 src/hl_cli/infra/paths.py
+src/hl_cli/infra/twap_registry.py
 src/hl_cli/services/account_fetch.py
 src/hl_cli/utils/__init__.py
 src/hl_cli/utils/market_table.py
@@ -41,4 +42,5 @@ tests/test_completion.py
 tests/test_json_patterns.py
 tests/test_markets_testnet_mode.py
 tests/test_order_testnet_routing.py
-tests/test_testnet_context.py
+tests/test_testnet_context.py
+tests/test_twap_registry.py

{hyperliquid_cli_python-0.1.5 → hyperliquid_cli_python-0.1.6}/tests/test_order_testnet_routing.py

@@ -3,6 +3,7 @@ from unittest.mock import patch
 
 from hl_cli.commands.order import (
     _close_position_perp_dexs,
+    _extract_twap_id,
     _resolve_coin_for_side,
     _resolve_spot_coin,
     _validate_side_mode_args,
@@ -78,5 +79,19 @@ class OrderTestnetRoutingTests(unittest.TestCase):
         context.info = _FakeInfo()
         self.assertEqual(_resolve_spot_coin(context, "@1035"), "@1035")
 
+    def test_extract_twap_id_from_running_status(self):
+        response = {
+            "response": {
+                "data": {
+                    "status": {
+                        "running": {
+                            "twapId": 12345,
+                        }
+                    }
+                }
+            }
+        }
+        self.assertEqual(_extract_twap_id(response), 12345)
+
 if __name__ == "__main__":
     unittest.main()

hyperliquid_cli_python-0.1.6/tests/test_twap_registry.py

@@ -0,0 +1,44 @@
+import json
+import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+from hl_cli.infra import twap_registry
+
+
+class TwapRegistryTests(unittest.TestCase):
+    def test_register_list_find_and_cancel(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            path = Path(tmp) / "twap_orders.json"
+            with patch.object(twap_registry, "TWAP_REGISTRY_PATH", path):
+                twap_registry.register_twap_order(
+                    network="testnet",
+                    user="0xabc",
+                    coin="BTC",
+                    resolved_coin="BTC",
+                    twap_id=123,
+                    side="buy",
+                    total_size=1.25,
+                    duration_minutes=10,
+                    randomize=False,
+                    reduce_only=False,
+                )
+
+                active = twap_registry.list_twap_orders(network="testnet", user="0xabc")
+                self.assertEqual(len(active), 1)
+                self.assertEqual(active[0].twap_id, 123)
+
+                record = twap_registry.find_twap_order(network="testnet", user="0xabc", twap_id=123)
+                self.assertIsNotNone(record)
+                self.assertEqual(record.resolved_coin, "BTC")
+
+                twap_registry.mark_twap_cancelled(network="testnet", user="0xabc", twap_id=123)
+                self.assertEqual(twap_registry.list_twap_orders(network="testnet", user="0xabc"), [])
+
+                raw = json.loads(path.read_text(encoding="utf-8"))
+                self.assertEqual(raw[0]["status"], "cancelled")
+
+
+if __name__ == "__main__":
+    unittest.main()