htcli 1.1.0__py3-none-any.whl

src/htcli/commands/stake/__init__.py

@@ -0,0 +1,736 @@
+"""
+Stake command module - RPC-based operations.
+"""
+
+from textwrap import dedent
+from typing import Optional
+
+import typer
+
+from .handlers import (
+    add_stake_handler,
+    claim_handler,
+    delegate_add_handler,
+    delegate_donate_handler,
+    delegate_remove_handler,
+    delegate_swap_handler,
+    delegate_transfer_handler,
+    get_coldkey_stakes_handler,
+    get_delegate_stakes_handler,
+    get_node_delegate_stakes_handler,
+    remove_stake_handler,
+    swap_node_to_subnet_handler,
+    swap_queue_update_handler,
+    swap_subnet_to_node_handler,
+    swap_subnet_to_validator_handler,
+    swap_validator_to_subnet_handler,
+    verify_proof_of_stake_handler,
+)
+
+app = typer.Typer(name="stake", help="Staking operations")
+
+
+def _option_value(value):
+    return None if isinstance(value, typer.models.OptionInfo) else value
+
+
+ADD_STAKE_HELP = dedent("""\
+    Add stake to your node (direct staking - requires hotkey ownership).
+
+    \b
+    Usage:
+      - htcli stake add --subnet-id 1 --amount 100
+      - htcli stake add --subnet-id 1 --node-id 2 --amount 100
+      - htcli stake add --subnet-id 1 --hotkey-address 0x... --amount 100
+
+    \b
+    Note:
+      Use --node-id OR --hotkey-address, not both.
+    """)
+
+REMOVE_STAKE_HELP = dedent("""\
+    Remove stake from your node (direct staking).
+
+    \b
+    Note:
+      Use --hotkey (wallet name) OR --hotkey-address (0x...), not both.
+    """)
+
+DELEGATE_ADD_HELP = dedent("""\
+    Add delegate stake to a subnet, validator, or specific node.
+
+    \b
+    Usage:
+      - Subnet:    htcli stake delegate-add --subnet-id 1 --amount 100
+      - Validator: htcli stake delegate-add --validator-id 7 --amount 100
+      - Node:      htcli stake delegate-add --subnet-id 1 --node-id 5 --amount 100
+    """)
+
+DELEGATE_REMOVE_HELP = dedent("""\
+    Remove delegate stake from a subnet, validator, or specific node.
+
+    \b
+    Usage:
+      - Subnet:    htcli stake delegate-remove --subnet-id 1 --shares 1000
+      - Validator: htcli stake delegate-remove --validator-id 7 --shares 1000
+      - Node:      htcli stake delegate-remove --subnet-id 1 --node-id 5 --shares 1000
+    """)
+
+DELEGATE_SWAP_HELP = dedent("""\
+    Swap delegate stake between subnets, validators, or nodes.
+
+    \b
+    Usage:
+      - Subnet:    htcli stake delegate-swap --from-subnet-id 1 --to-subnet-id 2 --shares 1000
+      - Validator: htcli stake delegate-swap --from-validator-id 7 --to-validator-id 8 --shares 1000
+      - Node:      htcli stake delegate-swap --from-subnet-id 1 --from-node-id 5 --to-subnet-id 2 --to-node-id 3 --shares 1000
+    """)
+
+DELEGATE_TRANSFER_HELP = dedent("""\
+    Transfer delegate stake to another account.
+
+    \b
+    Usage:
+      - Subnet:    htcli stake delegate-transfer --subnet-id 1 --to-account 0x... --shares 1000
+      - Validator: htcli stake delegate-transfer --validator-id 7 --to-account 0x... --shares 1000
+      - Node:      htcli stake delegate-transfer --subnet-id 1 --node-id 5 --to-account 0x... --shares 1000
+    """)
+
+DELEGATE_DONATE_HELP = dedent("""\
+    Donate delegate stake to subnet treasury, validator pool, or node pool.
+
+    \b
+    Usage:
+      - Subnet:    htcli stake delegate-donate --subnet-id 1 --amount 100
+      - Validator: htcli stake delegate-donate --validator-id 7 --amount 100
+      - Node:      htcli stake delegate-donate --subnet-id 1 --node-id 5 --amount 100
+    """)
+
+LIST_DELEGATE_HELP = dedent("""\
+    List delegate stake information for an account.
+
+    \b
+    Usage:
+      - Subnet delegate: htcli stake list-delegate --account 0x...
+      - Node delegate:   htcli stake list-delegate --account 0x... --node-id 5
+    """)
+
+
+# ============================================================================
+# DIRECT STAKING COMMANDS (Owner-only, require hotkey ownership)
+# ============================================================================
+
+
+@app.command("add", help=ADD_STAKE_HELP)
+def add_stake(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (hotkey fetched automatically)"
+    ),
+    hotkey_address: Optional[str] = typer.Option(
+        None,
+        "--hotkey-address",
+        help="Hotkey address (0x...) - alternative to --node-id",
+    ),
+    amount: Optional[float] = typer.Option(None, "--amount", help="Amount in TENSOR"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Add stake to your node."""
+    add_stake_handler(subnet_id, node_id, hotkey_address, amount, coldkey)
+
+
+@app.command("remove", help=REMOVE_STAKE_HELP)
+def remove_stake(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    hotkey: Optional[str] = typer.Option(
+        None, "--hotkey", help="Hotkey wallet name (resolved under coldkey)"
+    ),
+    hotkey_address: Optional[str] = typer.Option(
+        None,
+        "--hotkey-address",
+        help="Hotkey address (0x...) - alternative to --hotkey",
+    ),
+    amount: Optional[float] = typer.Option(None, "--amount", help="Amount in TENSOR"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Remove stake from your node."""
+    # Resolve hotkey: prefer hotkey_address if provided, otherwise use hotkey (wallet name)
+    resolved_hotkey = hotkey_address if hotkey_address else hotkey
+    remove_stake_handler(subnet_id, resolved_hotkey, amount, coldkey)
+
+
+@app.command("claim")
+def claim_unbondings(
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt"),
+):
+    """Claim all unbonded tokens after unbonding period."""
+    claim_handler(coldkey, yes)
+
+
+# ============================================================================
+# UNIFIED DELEGATE STAKING COMMANDS
+# Use --node-id to target a specific node, otherwise targets the subnet
+# ============================================================================
+
+
+@app.command("delegate-add", help=DELEGATE_ADD_HELP)
+def delegate_add(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level delegation)"
+    ),
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID (for validator-level delegation)"
+    ),
+    amount: Optional[float] = typer.Option(None, "--amount", help="Amount in TENSOR"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Add delegate stake to a subnet, validator, or specific node."""
+    delegate_add_handler(
+        subnet_id=subnet_id,
+        node_id=node_id,
+        stake_amount=amount,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("node-delegate-add")
+def node_delegate_add(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level delegation)"
+    ),
+    amount: Optional[float] = typer.Option(None, "--amount", help="Amount in TENSOR"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Backward-compatible alias for adding node delegate stake."""
+    delegate_add_handler(subnet_id, node_id, amount, coldkey)
+
+
+@app.command("delegate-remove", help=DELEGATE_REMOVE_HELP)
+def delegate_remove(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level removal)"
+    ),
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID (for validator-level removal)"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to remove"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Remove delegate stake from a subnet, validator, or specific node."""
+    delegate_remove_handler(
+        subnet_id=subnet_id,
+        node_id=node_id,
+        shares_to_remove=shares,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("node-delegate-remove")
+def node_delegate_remove(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level removal)"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to remove"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Backward-compatible alias for removing node delegate stake."""
+    delegate_remove_handler(subnet_id, node_id, shares, coldkey)
+
+
+@app.command("validator-delegate-add")
+def validator_delegate_add(
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID to delegate to"
+    ),
+    amount: Optional[float] = typer.Option(None, "--amount", help="Amount in TENSOR"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Add delegate stake to a validator."""
+    delegate_add_handler(
+        stake_amount=amount,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("validator-delegate-remove")
+def validator_delegate_remove(
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID to remove delegate stake from"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to remove"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet name to sign the transaction"
+    ),
+):
+    """Remove delegate stake from a validator."""
+    delegate_remove_handler(
+        shares_to_remove=shares,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("delegate-swap", help=DELEGATE_SWAP_HELP)
+def delegate_swap(
+    from_subnet_id: Optional[int] = typer.Option(
+        None, "--from-subnet-id", help="Source subnet ID"
+    ),
+    from_node_id: Optional[int] = typer.Option(
+        None, "--from-node-id", help="Source node ID (for node-level swap)"
+    ),
+    from_validator_id: Optional[int] = typer.Option(
+        None, "--from-validator-id", help="Source validator ID"
+    ),
+    to_subnet_id: Optional[int] = typer.Option(
+        None, "--to-subnet-id", help="Destination subnet ID"
+    ),
+    to_node_id: Optional[int] = typer.Option(
+        None, "--to-node-id", help="Destination node ID (for node-level swap)"
+    ),
+    to_validator_id: Optional[int] = typer.Option(
+        None, "--to-validator-id", help="Destination validator ID"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to swap"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Swap delegate stake between subnets, validators, or nodes."""
+    delegate_swap_handler(
+        from_subnet_id=from_subnet_id,
+        from_node_id=from_node_id,
+        to_subnet_id=to_subnet_id,
+        to_node_id=to_node_id,
+        shares=shares,
+        coldkey=coldkey,
+        from_validator_id=_option_value(from_validator_id),
+        to_validator_id=_option_value(to_validator_id),
+    )
+
+
+@app.command("node-delegate-swap")
+def node_delegate_swap(
+    from_subnet_id: Optional[int] = typer.Option(
+        None, "--from-subnet-id", help="Source subnet ID"
+    ),
+    from_node_id: Optional[int] = typer.Option(
+        None, "--from-node-id", help="Source node ID"
+    ),
+    to_subnet_id: Optional[int] = typer.Option(
+        None, "--to-subnet-id", help="Destination subnet ID"
+    ),
+    to_node_id: Optional[int] = typer.Option(
+        None, "--to-node-id", help="Destination node ID"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to swap"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Backward-compatible alias for swapping node delegate stake."""
+    delegate_swap_handler(
+        from_subnet_id, from_node_id, to_subnet_id, to_node_id, shares, coldkey
+    )
+
+
+@app.command("delegate-transfer", help=DELEGATE_TRANSFER_HELP)
+def delegate_transfer(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level transfer)"
+    ),
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID (for validator-level transfer)"
+    ),
+    to_account: Optional[str] = typer.Option(
+        None, "--to-account", help="Destination account (0x...)"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to transfer"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Transfer delegate stake to another account."""
+    delegate_transfer_handler(
+        subnet_id=subnet_id,
+        node_id=node_id,
+        to_account=to_account,
+        shares=shares,
+        coldkey=coldkey,
+        validator_id=_option_value(validator_id),
+    )
+
+
+@app.command("validator-delegate-swap")
+def validator_delegate_swap(
+    from_validator_id: Optional[int] = typer.Option(
+        None, "--from-validator-id", help="Source validator ID"
+    ),
+    to_validator_id: Optional[int] = typer.Option(
+        None, "--to-validator-id", help="Destination validator ID"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to swap"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Swap delegate stake between validators."""
+    delegate_swap_handler(
+        shares=shares,
+        coldkey=coldkey,
+        from_validator_id=from_validator_id,
+        to_validator_id=to_validator_id,
+    )
+
+
+@app.command("validator-delegate-transfer")
+def validator_delegate_transfer(
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID"
+    ),
+    to_account: Optional[str] = typer.Option(
+        None, "--to-account", help="Destination account (0x...)"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to transfer"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Transfer validator delegate stake to another account."""
+    delegate_transfer_handler(
+        to_account=to_account,
+        shares=shares,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("node-delegate-transfer")
+def node_delegate_transfer(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(None, "--node-id", help="Node ID"),
+    to_account: Optional[str] = typer.Option(
+        None, "--to-account", help="Destination account (0x...)"
+    ),
+    shares: Optional[int] = typer.Option(
+        None, "--shares", help="Number of shares to transfer"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Backward-compatible alias for transferring node delegate stake."""
+    delegate_transfer_handler(subnet_id, node_id, to_account, shares, coldkey)
+
+
+@app.command("delegate-donate", help=DELEGATE_DONATE_HELP)
+def delegate_donate(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Node ID (for node-level donation)"
+    ),
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID (for validator-level donation)"
+    ),
+    amount: Optional[float] = typer.Option(
+        None, "--amount", help="Donation amount in TENSOR"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Donate delegate stake to subnet treasury, validator pool, or node pool."""
+    delegate_donate_handler(
+        subnet_id=subnet_id,
+        node_id=node_id,
+        amount=amount,
+        coldkey=coldkey,
+        validator_id=_option_value(validator_id),
+    )
+
+
+@app.command("validator-delegate-donate")
+def validator_delegate_donate(
+    validator_id: Optional[int] = typer.Option(
+        None, "--validator-id", help="Validator ID"
+    ),
+    amount: Optional[float] = typer.Option(
+        None, "--amount", help="Donation amount in TENSOR"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Donate delegate stake to a validator delegate pool."""
+    delegate_donate_handler(
+        amount=amount,
+        coldkey=coldkey,
+        validator_id=validator_id,
+    )
+
+
+@app.command("node-delegate-donate")
+def node_delegate_donate(
+    subnet_id: Optional[int] = typer.Option(None, "--subnet-id", help="Subnet ID"),
+    node_id: Optional[int] = typer.Option(None, "--node-id", help="Node ID"),
+    amount: Optional[float] = typer.Option(
+        None, "--amount", help="Donation amount in TENSOR"
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Backward-compatible alias for donating node delegate stake."""
+    delegate_donate_handler(subnet_id, node_id, amount, coldkey)
+
+
+# ============================================================================
+# CROSS-TYPE SWAP COMMANDS (Convert between node and subnet delegate)
+# ============================================================================
+
+
+@app.command("swap-node-to-subnet")
+def swap_node_to_subnet(
+    from_subnet_id: Optional[int] = typer.Option(
+        None, "--from-subnet-id", help="Source subnet ID"
+    ),
+    from_node_id: Optional[int] = typer.Option(
+        None, "--from-node-id", help="Source node ID"
+    ),
+    to_subnet_id: Optional[int] = typer.Option(
+        None, "--to-subnet-id", help="Destination subnet ID"
+    ),
+    shares: Optional[int] = typer.Option(None, "--shares", help="Shares to convert"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """
+    Convert node delegate stake to subnet delegate stake.
+
+    This operation swaps stake from a specific node's delegate pool to the general subnet delegate pool.
+    """
+    swap_node_to_subnet_handler(
+        from_subnet_id, from_node_id, to_subnet_id, shares, coldkey
+    )
+
+
+@app.command("swap-subnet-to-node")
+def swap_subnet_to_node(
+    from_subnet_id: Optional[int] = typer.Option(
+        None, "--from-subnet-id", help="Source subnet ID"
+    ),
+    to_subnet_id: Optional[int] = typer.Option(
+        None, "--to-subnet-id", help="Destination subnet ID"
+    ),
+    to_node_id: Optional[int] = typer.Option(
+        None, "--to-node-id", help="Destination node ID"
+    ),
+    shares: Optional[int] = typer.Option(None, "--shares", help="Shares to convert"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """
+    Convert subnet delegate stake to node delegate stake.
+
+    This operation swaps stake from the general subnet delegate pool to a specific node's delegate pool.
+    """
+    swap_subnet_to_node_handler(
+        from_subnet_id, to_subnet_id, to_node_id, shares, coldkey
+    )
+
+
+@app.command("swap-validator-to-subnet")
+def swap_validator_to_subnet(
+    from_validator_id: Optional[int] = typer.Option(
+        None, "--from-validator-id", help="Source validator ID"
+    ),
+    to_subnet_id: Optional[int] = typer.Option(
+        None, "--to-subnet-id", help="Destination subnet ID"
+    ),
+    shares: Optional[int] = typer.Option(None, "--shares", help="Shares to convert"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Convert validator delegate stake to subnet delegate stake."""
+    swap_validator_to_subnet_handler(
+        from_validator_id=from_validator_id,
+        to_subnet_id=to_subnet_id,
+        shares_to_swap=shares,
+        coldkey=coldkey,
+    )
+
+
+@app.command("swap-subnet-to-validator")
+def swap_subnet_to_validator(
+    from_subnet_id: Optional[int] = typer.Option(
+        None, "--from-subnet-id", help="Source subnet ID"
+    ),
+    to_validator_id: Optional[int] = typer.Option(
+        None, "--to-validator-id", help="Destination validator ID"
+    ),
+    shares: Optional[int] = typer.Option(None, "--shares", help="Shares to convert"),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Convert subnet delegate stake to validator delegate stake."""
+    swap_subnet_to_validator_handler(
+        from_subnet_id=from_subnet_id,
+        to_validator_id=to_validator_id,
+        shares_to_swap=shares,
+        coldkey=coldkey,
+    )
+
+
+@app.command("swap-update")
+def swap_queue_update(
+    queue_id: Optional[int] = typer.Option(None, "--queue-id", help="Queue entry ID"),
+    new_call_json: Optional[str] = typer.Option(
+        None,
+        "--new-call-json",
+        help='Replacement call JSON (e.g. {"type":"SwapToNodeDelegateStake","to_subnet_id":1,"to_subnet_node_id":2})',
+    ),
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey wallet to sign with"
+    ),
+):
+    """Update a queued swap entry."""
+    swap_queue_update_handler(queue_id, new_call_json, coldkey)
+
+
+# ============================================================================
+# QUERY COMMANDS (RPC-based, read-only)
+# ============================================================================
+
+
+@app.command("list")
+def list_stakes(
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey address to get stakes for"
+    ),
+):
+    """List all stake information for a coldkey (direct, delegate, and node delegate)."""
+    get_coldkey_stakes_handler(coldkey)
+
+
+@app.command("coldkey")
+def coldkey_stakes(
+    coldkey: Optional[str] = typer.Option(
+        None, "--coldkey", help="Coldkey address to get stakes for"
+    ),
+):
+    """Backward-compatible alias for listing all stake information for a coldkey."""
+    get_coldkey_stakes_handler(coldkey)
+
+
+@app.command("list-delegate", help=LIST_DELEGATE_HELP)
+def list_delegate_stakes(
+    account: Optional[str] = typer.Option(
+        None, "--account", help="Account address to query"
+    ),
+    subnet_id: Optional[int] = typer.Option(
+        None, "--subnet-id", help="Filter by subnet ID"
+    ),
+    node_id: Optional[int] = typer.Option(
+        None, "--node-id", help="Filter by node ID (shows node delegate stakes)"
+    ),
+):
+    """List delegate stake information for an account."""
+    if node_id is not None:
+        # Query node delegate stakes
+        get_node_delegate_stakes_handler(account)
+    else:
+        # Query subnet delegate stakes
+        get_delegate_stakes_handler(account)
+
+
+@app.command("delegate")
+def delegate_stakes(
+    account: Optional[str] = typer.Argument(None, help="Account address to query"),
+):
+    """Backward-compatible alias for listing delegate stakes for an account."""
+    get_delegate_stakes_handler(account)
+
+
+@app.command("node-delegate")
+def node_delegate_stakes(
+    account: Optional[str] = typer.Option(
+        None, "--account", help="Account address to query"
+    ),
+):
+    """Backward-compatible alias for listing node delegate stakes for an account."""
+    get_node_delegate_stakes_handler(account)
+
+
+@app.command("verify-proof")
+def verify_proof_of_stake(
+    subnet_id: Optional[int] = typer.Option(
+        None, "--subnet-id", help="Subnet ID to check"
+    ),
+    peer_id: Optional[str] = typer.Option(None, "--peer-id", help="Peer ID to verify"),
+    min_class: Optional[int] = typer.Option(
+        None, "--min-class", help="Minimum required class (0-3)"
+    ),
+):
+    """Verify proof of stake for a peer in a subnet."""
+    verify_proof_of_stake_handler(subnet_id, peer_id, min_class)
+
+
+@app.command("verify")
+def verify_proof_of_stake_alias(
+    subnet_id: Optional[int] = typer.Option(
+        None, "--subnet-id", help="Subnet ID to check"
+    ),
+    peer_id: Optional[str] = typer.Option(None, "--peer-id", help="Peer ID to verify"),
+    min_class: Optional[int] = typer.Option(
+        None, "--min-class", help="Minimum required class (0-3)"
+    ),
+):
+    """Backward-compatible alias for proof-of-stake verification."""
+    verify_proof_of_stake_handler(subnet_id, peer_id, min_class)
+
+
+__all__ = ["app"]