tusdt-cli 0.2.5__tar.gz → 0.2.6__tar.gz

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tusdt-cli
-Version: 0.2.5
+Version: 0.2.6
 Summary: CLI for interacting with the TUSDT ink! smart contract system on subtensor(bittensor)
 Project-URL: Homepage, https://github.com/tensorusd/tusdt-cli
 Project-URL: Repository, https://github.com/tensorusd/tusdt-cli

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tusdt-cli"
-version = "0.2.5"
+version = "0.2.6"
 description = "CLI for interacting with the TUSDT ink! smart contract system on subtensor(bittensor)"
 readme = "README.md"
 license = "MIT"

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/src/tusdt_cli/__init__.py

@@ -1,3 +1,3 @@
 """TUSDT CLI - Command-line interface for the TUSDT ink! smart contract system."""
 
-__version__ = "0.2.5"
+__version__ = "0.2.6"

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/src/tusdt_cli/client.py

@@ -722,6 +722,37 @@ class TUSDTClient:
         """Transfer *amount* TUSDT tokens to *to*."""
         return self._exec(self.token, keypair, "transfer", args={"to": to, "value": amount})
 
+    def token_controller(self, keypair: Keypair) -> str:
+        """Return the controller address of the TUSDT token contract."""
+        result = self._read(self.token, keypair, "controller")
+        return unwrap_plain(result)
+
+    def token_mint(self, keypair: Keypair, to: str, amount: int) -> dict[str, Any]:
+        """Mint *amount* TUSDT tokens to *to* (controller only)."""
+        return self._exec(self.token, keypair, "mint", args={"to": to, "value": amount})
+
+    def token_burn(self, keypair: Keypair, from_addr: str, amount: int) -> dict[str, Any]:
+        """Burn *amount* TUSDT tokens from *from_addr* (controller only)."""
+        return self._exec(self.token, keypair, "burn", args={"from": from_addr, "value": amount})
+
+    def token_increase_allowance(self, keypair: Keypair, spender: str, delta: int) -> dict[str, Any]:
+        """Increase *spender*'s allowance by *delta* TUSDT tokens."""
+        return self._exec(
+            self.token, keypair, "increase_allowance", args={"spender": spender, "delta_value": delta}
+        )
+
+    def token_decrease_allowance(self, keypair: Keypair, spender: str, delta: int) -> dict[str, Any]:
+        """Decrease *spender*'s allowance by *delta* TUSDT tokens."""
+        return self._exec(
+            self.token, keypair, "decrease_allowance", args={"spender": spender, "delta_value": delta}
+        )
+
+    def token_transfer_from(self, keypair: Keypair, from_addr: str, to: str, amount: int) -> dict[str, Any]:
+        """Transfer *amount* TUSDT tokens from *from_addr* to *to* (requires allowance)."""
+        return self._exec(
+            self.token, keypair, "transfer_from", args={"from": from_addr, "to": to, "value": amount}
+        )
+
     # ==================================================================
     # AUCTION OPERATIONS
     # ==================================================================
@@ -826,6 +857,70 @@ class TUSDTClient:
             return None
         return raw if isinstance(raw, dict) else raw
 
+    def get_auction_controller(self, keypair: Keypair) -> str:
+        """Return the auction controller address."""
+        result = self._read(self.auction, keypair, "controller")
+        return unwrap_plain(result)
+
+    def get_auction_governance(self, keypair: Keypair) -> str:
+        """Return the auction governance address."""
+        result = self._read(self.auction, keypair, "governance")
+        return unwrap_plain(result)
+
+    def get_auction_admin(self, keypair: Keypair) -> str | None:
+        """Return the auction admin address, or None if not set."""
+        result = self._read(self.auction, keypair, "admin")
+        return unwrap_option(result)
+
+    def create_auction(
+        self,
+        keypair: Keypair,
+        vault_owner: str,
+        vault_id: int,
+        collateral_balance: int,
+        debt_balance: int,
+        min_bid: int,
+        liquidation_price: int,
+        duration_ms: int,
+    ) -> dict[str, Any]:
+        """Create a new liquidation auction (controller only)."""
+        return self._exec(
+            self.auction,
+            keypair,
+            "create_auction",
+            args={
+                "vault_owner": vault_owner,
+                "vault_id": vault_id,
+                "collateral_balance": collateral_balance,
+                "debt_balance": debt_balance,
+                "min_bid": min_bid,
+                "liquidation_price": liquidation_price,
+                "duration_ms": duration_ms,
+            },
+        )
+
+    def auction_set_admin(self, keypair: Keypair, admin: str | None) -> dict[str, Any]:
+        """Set or clear the auction admin (governance only). Pass None to clear."""
+        return self._exec(self.auction, keypair, "set_admin", args={"admin": admin})
+
+    def auction_update_governance(self, keypair: Keypair, new_governance: str) -> dict[str, Any]:
+        """Transfer auction governance to a new account (controller only)."""
+        return self._exec(self.auction, keypair, "update_governance", args={"new_governance": new_governance})
+
+    def auction_transfer_winning_bid(
+        self,
+        keypair: Keypair,
+        auction_id: int,
+        recipient: str,
+    ) -> dict[str, Any]:
+        """Transfer the winning bid amount to a recipient (controller only)."""
+        return self._exec(
+            self.auction,
+            keypair,
+            "transfer_winning_bid",
+            args={"auction_id": auction_id, "recipient": recipient},
+        )
+
     # ==================================================================
     # ORACLE OPERATIONS
     # ==================================================================

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/src/tusdt_cli/commands/auction.py

@@ -32,7 +32,18 @@ _wallet_option = click.option(
 )
 
 
-_AUCTION_ADVANCED = {"list-all", "total-count", "vault-auction", "bids", "bid-info"}
+_AUCTION_ADVANCED = {
+    "list-all",
+    "total-count",
+    "vault-auction",
+    "bids",
+    "bid-info",
+    "create",
+    "set-admin",
+    "update-governance",
+    "transfer-winning-bid",
+}
+_AUCTION_BASIC_READS = {"controller", "governance", "admin-address"}
 
 
 @click.group("auction", cls=ModeAwareGroup, advanced_commands=_AUCTION_ADVANCED)
@@ -605,3 +616,331 @@ def bid_info(ctx: click.Context, auction_id: int, bid_id: int, network: str | No
             "Withdrawn": data.get("is_withdrawn", False),
         },
     )
+
+
+# ------------------------------------------------------------------
+# controller
+# ------------------------------------------------------------------
+
+
+@auction_group.command("controller")
+@_network_option
+@click.pass_context
+def auction_controller_cmd(ctx: click.Context, network: str | None) -> None:
+    """Show the controller address of the auction contract.
+
+    \b
+    Examples:
+      tusdt auction controller
+      tusdt auction controller --network testnet
+    """
+    config = load_config(network=network)
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        addr = client.get_auction_controller(keypair)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_dict("Auction Controller", {"Address": addr})
+
+
+# ------------------------------------------------------------------
+# governance
+# ------------------------------------------------------------------
+
+
+@auction_group.command("governance")
+@_network_option
+@click.pass_context
+def auction_governance_cmd(ctx: click.Context, network: str | None) -> None:
+    """Show the governance address of the auction contract.
+
+    \b
+    Examples:
+      tusdt auction governance
+      tusdt auction governance --network testnet
+    """
+    config = load_config(network=network)
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        addr = client.get_auction_governance(keypair)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_dict("Auction Governance", {"Address": addr})
+
+
+# ------------------------------------------------------------------
+# admin-address
+# ------------------------------------------------------------------
+
+
+@auction_group.command("admin-address")
+@_network_option
+@click.pass_context
+def auction_admin_cmd(ctx: click.Context, network: str | None) -> None:
+    """Show the admin address of the auction contract, if set.
+
+    \b
+    Examples:
+      tusdt auction admin-address
+      tusdt auction admin-address --network testnet
+    """
+    config = load_config(network=network)
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        admin = client.get_auction_admin(keypair)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    if admin is None:
+        print_info("No admin set")
+    else:
+        print_dict("Auction Admin", {"Address": admin})
+
+
+# ------------------------------------------------------------------
+# create
+# ------------------------------------------------------------------
+
+
+@auction_group.command("create")
+@click.argument("vault_owner", type=str, metavar="<ss58-address>")
+@click.argument("vault_id", type=int, metavar="<vault-id>")
+@click.option(
+    "--collateral-balance",
+    type=str,
+    required=True,
+    help="Collateral balance in human-readable units (e.g. 10.0)",
+)
+@click.option(
+    "--debt-balance", type=str, required=True, help="Debt balance in human-readable units (e.g. 100.0)"
+)
+@click.option("--min-bid", type=str, required=True, help="Minimum bid in human-readable units (e.g. 10.0)")
+@click.option(
+    "--liquidation-price", type=int, required=True, help="Liquidation price as raw integer (10^18 scale)"
+)
+@click.option("--duration-ms", type=int, required=True, help="Auction duration in milliseconds (integer)")
+@_wallet_option
+@_network_option
+@click.pass_context
+def create_auction_cmd(
+    ctx: click.Context,
+    vault_owner: str,
+    vault_id: int,
+    collateral_balance: str,
+    debt_balance: str,
+    min_bid: str,
+    liquidation_price: int,
+    duration_ms: int,
+    wallet_name: str | None,
+    network: str | None,
+) -> None:
+    """Create a new liquidation auction (controller only).
+
+    \b
+    VAULT_OWNER is the SS58 address of the vault owner.
+    VAULT_ID    is the numeric vault ID (integer).
+    Examples:
+      tusdt auction create 5GrwvaEF... 0 --collateral-balance 10 --debt-balance 100 --min-bid 10 --liquidation-price 1500000000000000000 --duration-ms 86400000 --wallet-name MyWallet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+
+    raw_collateral = parse_balance(collateral_balance, decimals)
+    raw_debt = parse_balance(debt_balance, decimals)
+    raw_min_bid = parse_balance(min_bid, decimals)
+
+    try:
+        vault_owner = resolve_ss58(vault_owner, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Creating auction for vault {vault_id} (owner: {vault_owner})...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.create_auction(
+            keypair,
+            vault_owner,
+            vault_id,
+            raw_collateral,
+            raw_debt,
+            raw_min_bid,
+            liquidation_price,
+            duration_ms,
+        )
+        print_success("Auction created!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# set-admin
+# ------------------------------------------------------------------
+
+
+@auction_group.command("set-admin")
+@click.argument("address", type=str, metavar="<ss58-address>", required=False)
+@click.option("--clear", is_flag=True, default=False, help="Clear the admin (set to None)")
+@_wallet_option
+@_network_option
+@click.pass_context
+def auction_set_admin_cmd(
+    ctx: click.Context,
+    address: str | None,
+    clear: bool,
+    wallet_name: str | None,
+    network: str | None,
+) -> None:
+    """Set or clear the auction admin (governance only).
+
+    \b
+    ADDRESS is the SS58 address of the admin, or omit and use --clear to remove.
+    Examples:
+      tusdt auction set-admin 5GrwvaEF... --wallet-name MyWallet
+      tusdt auction set-admin --clear --wallet-name MyWallet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+
+    admin = None if clear else address
+    if not clear and not address:
+        print_error("Provide an SS58 address or use --clear to remove the admin")
+        return
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    action = "Clearing" if clear else f"Setting to {address}"
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"{action} auction admin...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.auction_set_admin(keypair, admin)
+        print_success("Auction admin updated!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# update-governance
+# ------------------------------------------------------------------
+
+
+@auction_group.command("update-governance")
+@click.argument("address", type=str, metavar="<ss58-address>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def auction_update_governance_cmd(
+    ctx: click.Context,
+    address: str,
+    wallet_name: str | None,
+    network: str | None,
+) -> None:
+    """Transfer auction governance to a new account (controller only).
+
+    \b
+    ADDRESS is the SS58 address of the new governance account.
+    Examples:
+      tusdt auction update-governance 5GrwvaEF... --wallet-name MyWallet
+      tusdt auction update-governance 5GrwvaEF... --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Updating auction governance to {address}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.auction_update_governance(keypair, address)
+        print_success("Auction governance updated!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# transfer-winning-bid
+# ------------------------------------------------------------------
+
+
+@auction_group.command("transfer-winning-bid")
+@click.argument("auction_id", type=int, metavar="<auction-id>")
+@click.argument("recipient", type=str, metavar="<ss58-address>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def transfer_winning_bid_cmd(
+    ctx: click.Context,
+    auction_id: int,
+    recipient: str,
+    wallet_name: str | None,
+    network: str | None,
+) -> None:
+    """Transfer the winning bid amount to a recipient (controller only).
+
+    \b
+    AUCTION_ID is the numeric auction ID (integer).
+    RECIPIENT  is the SS58 address to receive the winning bid tokens.
+    Examples:
+      tusdt auction transfer-winning-bid 0 5GrwvaEF... --wallet-name MyWallet
+      tusdt auction transfer-winning-bid 5 5GrwvaEF... --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+
+    try:
+        recipient = resolve_ss58(recipient, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Transferring winning bid for auction {auction_id} to {recipient}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.auction_transfer_winning_bid(keypair, auction_id, recipient)
+        print_success("Winning bid transferred!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))

{tusdt_cli-0.2.5 → tusdt_cli-0.2.6}/src/tusdt_cli/commands/governance.py

@@ -1300,9 +1300,7 @@ def vote_cmd(
             ph = ph[2:]
         proof_bytes = bytes.fromhex(ph)
         if len(proof_bytes) != 32:
-            print_error(
-                f"Each --proof must be exactly 32 bytes (64 hex chars), got {len(proof_bytes)} bytes"
-            )
+            print_error(f"Each --proof must be exactly 32 bytes (64 hex chars), got {len(proof_bytes)} bytes")
             return
         proof_list.append(list(proof_bytes))
 

tusdt_cli-0.2.6/src/tusdt_cli/commands/token.py

@@ -0,0 +1,538 @@
+"""Token (ERC-20) CLI commands."""
+
+import click
+
+from tusdt_cli.client import TUSDTClient
+from tusdt_cli.config import NETWORKS, load_config
+from tusdt_cli.utils import (
+    ModeAwareGroup,
+    format_balance,
+    parse_balance,
+    print_dict,
+    print_error,
+    print_info,
+    print_success,
+    print_tx_result,
+)
+from tusdt_cli.wallet import get_reader_keypair, get_signer_keypair, resolve_ss58
+
+_network_option = click.option(
+    "--network",
+    type=click.Choice(list(NETWORKS.keys()), case_sensitive=False),
+    default=None,
+    help="Network preset (overrides rpc & contract addresses)",
+)
+
+_wallet_option = click.option(
+    "--wallet-name",
+    default=None,
+    help="Bittensor wallet name for signing (prompts for coldkey password)",
+)
+
+
+_TOKEN_ADVANCED = {"mint", "burn", "increase-allowance", "decrease-allowance", "transfer-from"}
+
+
+@click.group("token", cls=ModeAwareGroup, advanced_commands=_TOKEN_ADVANCED)
+def token_group() -> None:
+    """TUSDT token operations."""
+
+
+# ------------------------------------------------------------------
+# balance
+# ------------------------------------------------------------------
+
+
+@token_group.command("balance")
+@click.option("--owner", default=None, help="Account SS58 address or wallet name (defaults to --wallet-name)")
+@_wallet_option
+@_network_option
+@click.pass_context
+def balance(ctx: click.Context, owner: str | None, wallet_name: str | None, network: str | None) -> None:
+    """Show the TUSDT token balance for an account.
+
+    \b
+    Owner is resolved from --wallet-name, or pass --owner explicitly.
+    Examples:
+      tusdt token balance --wallet-name MyWallet
+      tusdt token balance --owner 5GrwvaEF... --network testnet
+    """
+    config = load_config(network=network)
+    decimals = config.get("decimals", 9)
+
+    try:
+        if owner:
+            account = resolve_ss58(owner, config.get("wallet_path"))
+        elif wallet_name:
+            account = resolve_ss58(wallet_name, config.get("wallet_path"))
+        else:
+            print_error("Provide --owner (address or wallet name) or --wallet-name")
+            return
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        raw = client.balance_of(keypair, account)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_dict(
+        "Token Balance",
+        {
+            "Account": account,
+            "Balance": format_balance(raw, decimals),
+            "Raw": raw,
+        },
+    )
+
+
+# ------------------------------------------------------------------
+# approve
+# ------------------------------------------------------------------
+
+
+@token_group.command("approve")
+@click.argument("spender", type=str, metavar="<spender>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def approve(
+    ctx: click.Context, spender: str, amount: str, wallet_name: str | None, network: str | None
+) -> None:
+    """Approve a spender to use your TUSDT tokens.
+
+    \b
+    SPENDER is the SS58 address or wallet name of the account to approve.
+    AMOUNT  is the human-readable token amount to approve (e.g. 1000).
+    Examples:
+      tusdt token approve 5GrwvaEF... 1000 --wallet-name MyWallet
+      tusdt token approve SpenderWallet 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_amount = parse_balance(amount, decimals)
+
+    try:
+        spender = resolve_ss58(spender, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Approving {spender} to spend {amount} tokens...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.approve(keypair, spender, raw_amount)
+        print_success("Approval successful!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# allowance
+# ------------------------------------------------------------------
+
+
+@token_group.command("allowance")
+@click.argument("spender", type=str, metavar="<spender>")
+@click.option("--owner", default=None, help="Owner SS58 address or wallet name (defaults to --wallet-name)")
+@_wallet_option
+@_network_option
+@click.pass_context
+def allowance(
+    ctx: click.Context, spender: str, owner: str | None, wallet_name: str | None, network: str | None
+) -> None:
+    """Show the allowance a spender has for an owner's tokens.
+
+    \b
+    SPENDER is the SS58 address or wallet name of the spender account.
+    Owner is resolved from --wallet-name, or pass --owner explicitly.
+    Examples:
+      tusdt token allowance 5GrwvaEF... --wallet-name MyWallet
+      tusdt token allowance SpenderWallet --owner 5Abc123... --network testnet
+    """
+    config = load_config(network=network)
+    decimals = config.get("decimals", 9)
+
+    try:
+        if owner:
+            owner = resolve_ss58(owner, config.get("wallet_path"))
+        elif wallet_name:
+            owner = resolve_ss58(wallet_name, config.get("wallet_path"))
+        else:
+            print_error("Provide --owner (address or wallet name) or --wallet-name")
+            return
+        spender = resolve_ss58(spender, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        raw = client.allowance(keypair, owner, spender)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_dict(
+        "Allowance",
+        {
+            "Owner": owner,
+            "Spender": spender,
+            "Allowance": format_balance(raw, decimals),
+            "Raw": raw,
+        },
+    )
+
+
+# ------------------------------------------------------------------
+# transfer
+# ------------------------------------------------------------------
+
+
+@token_group.command("transfer")
+@click.argument("to", type=str, metavar="<recipient>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def transfer(ctx: click.Context, to: str, amount: str, wallet_name: str | None, network: str | None) -> None:
+    """Transfer TUSDT tokens to another account.
+
+    \b
+    TO     is the SS58 address or wallet name of the recipient.
+    AMOUNT is the human-readable token amount to send (e.g. 50).
+    Examples:
+      tusdt token transfer 5GrwvaEF... 50 --wallet-name MyWallet
+      tusdt token transfer RecipientWallet 100.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_amount = parse_balance(amount, decimals)
+
+    try:
+        to = resolve_ss58(to, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Transferring {amount} tokens to {to}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.transfer(keypair, to, raw_amount)
+        print_success("Transfer successful!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# controller
+# ------------------------------------------------------------------
+
+
+@token_group.command("controller")
+@_network_option
+@click.pass_context
+def token_controller_cmd(ctx: click.Context, network: str | None) -> None:
+    """Show the controller address of the TUSDT token contract.
+
+    \b
+    Examples:
+      tusdt token controller
+      tusdt token controller --network testnet
+    """
+    config = load_config(network=network)
+
+    try:
+        keypair = get_reader_keypair(config)
+        client = TUSDTClient(config)
+        addr = client.token_controller(keypair)
+    except Exception as exc:
+        print_error(str(exc))
+        return
+
+    print_dict("Token Controller", {"Address": addr})
+
+
+# ------------------------------------------------------------------
+# mint
+# ------------------------------------------------------------------
+
+
+@token_group.command("mint")
+@click.argument("to", type=str, metavar="<ss58-address>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def mint(ctx: click.Context, to: str, amount: str, wallet_name: str | None, network: str | None) -> None:
+    """Mint TUSDT tokens to an account (controller only).
+
+    \b
+    TO     is the SS58 address of the recipient.
+    AMOUNT is the human-readable token amount to mint (e.g. 1000).
+    Examples:
+      tusdt token mint 5GrwvaEF... 1000 --wallet-name MyWallet
+      tusdt token mint 5GrwvaEF... 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_amount = parse_balance(amount, decimals)
+
+    try:
+        to = resolve_ss58(to, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Minting {amount} tokens to {to}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.token_mint(keypair, to, raw_amount)
+        print_success("Mint successful!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# burn
+# ------------------------------------------------------------------
+
+
+@token_group.command("burn")
+@click.argument("from_addr", type=str, metavar="<ss58-address>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def burn(
+    ctx: click.Context, from_addr: str, amount: str, wallet_name: str | None, network: str | None
+) -> None:
+    """Burn TUSDT tokens from an account (controller only).
+
+    \b
+    FROM   is the SS58 address to burn tokens from.
+    AMOUNT is the human-readable token amount to burn (e.g. 1000).
+    Examples:
+      tusdt token burn 5GrwvaEF... 1000 --wallet-name MyWallet
+      tusdt token burn 5GrwvaEF... 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_amount = parse_balance(amount, decimals)
+
+    try:
+        from_addr = resolve_ss58(from_addr, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Burning {amount} tokens from {from_addr}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.token_burn(keypair, from_addr, raw_amount)
+        print_success("Burn successful!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# increase-allowance
+# ------------------------------------------------------------------
+
+
+@token_group.command("increase-allowance")
+@click.argument("spender", type=str, metavar="<ss58-address>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def increase_allowance_cmd(
+    ctx: click.Context, spender: str, amount: str, wallet_name: str | None, network: str | None
+) -> None:
+    """Increase a spender's allowance by a given amount.
+
+    \b
+    SPENDER is the SS58 address of the spender account.
+    AMOUNT  is the human-readable token amount to add to the allowance (e.g. 1000).
+    Examples:
+      tusdt token increase-allowance 5GrwvaEF... 1000 --wallet-name MyWallet
+      tusdt token increase-allowance 5GrwvaEF... 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_delta = parse_balance(amount, decimals)
+
+    try:
+        spender = resolve_ss58(spender, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Increasing {spender}'s allowance by {amount} tokens...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.token_increase_allowance(keypair, spender, raw_delta)
+        print_success("Allowance increased!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# decrease-allowance
+# ------------------------------------------------------------------
+
+
+@token_group.command("decrease-allowance")
+@click.argument("spender", type=str, metavar="<ss58-address>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def decrease_allowance_cmd(
+    ctx: click.Context, spender: str, amount: str, wallet_name: str | None, network: str | None
+) -> None:
+    """Decrease a spender's allowance by a given amount.
+
+    \b
+    SPENDER is the SS58 address of the spender account.
+    AMOUNT  is the human-readable token amount to subtract from the allowance (e.g. 1000).
+    Examples:
+      tusdt token decrease-allowance 5GrwvaEF... 1000 --wallet-name MyWallet
+      tusdt token decrease-allowance 5GrwvaEF... 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_delta = parse_balance(amount, decimals)
+
+    try:
+        spender = resolve_ss58(spender, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Decreasing {spender}'s allowance by {amount} tokens...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.token_decrease_allowance(keypair, spender, raw_delta)
+        print_success("Allowance decreased!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))
+
+
+# ------------------------------------------------------------------
+# transfer-from
+# ------------------------------------------------------------------
+
+
+@token_group.command("transfer-from")
+@click.argument("from_addr", type=str, metavar="<from-ss58-address>")
+@click.argument("to", type=str, metavar="<to-ss58-address>")
+@click.argument("amount", type=str, metavar="<amount>")
+@_wallet_option
+@_network_option
+@click.pass_context
+def transfer_from_cmd(
+    ctx: click.Context,
+    from_addr: str,
+    to: str,
+    amount: str,
+    wallet_name: str | None,
+    network: str | None,
+) -> None:
+    """Transfer TUSDT tokens from one account to another (requires allowance).
+
+    \b
+    FROM   is the SS58 address to transfer tokens from.
+    TO     is the SS58 address of the recipient.
+    AMOUNT is the human-readable token amount to transfer (e.g. 1000).
+    Examples:
+      tusdt token transfer-from 5GrwvaEF... 5FHneW... 1000 --wallet-name MyWallet
+      tusdt token transfer-from 5GrwvaEF... 5FHneW... 500.5 --wallet-name MyWallet --network testnet
+    """
+    config = load_config(network=network)
+    if wallet_name:
+        config["wallet_name"] = wallet_name
+    decimals = config.get("decimals", 9)
+    raw_amount = parse_balance(amount, decimals)
+
+    try:
+        from_addr = resolve_ss58(from_addr, config.get("wallet_path"))
+        to = resolve_ss58(to, config.get("wallet_path"))
+    except Exception as exc:
+        print_error(str(exc))
+
+    try:
+        keypair = get_signer_keypair(config)
+    except Exception as exc:
+        print_error(str(exc))
+
+    print_info(f"Signer: {keypair.ss58_address}")
+    print_info(f"Transferring {amount} tokens from {from_addr} to {to}...")
+
+    try:
+        client = TUSDTClient(config)
+        result = client.token_transfer_from(keypair, from_addr, to, raw_amount)
+        print_success("Transfer successful!")
+        print_tx_result(result, config.get("network", "finney"))
+    except Exception as exc:
+        print_error(str(exc))

tusdt_cli-0.2.5/src/tusdt_cli/commands/token.py

@@ -1,245 +0,0 @@
-"""Token (ERC-20) CLI commands."""
-
-import click
-
-from tusdt_cli.client import TUSDTClient
-from tusdt_cli.config import NETWORKS, load_config
-from tusdt_cli.utils import (
-    HelpfulGroup,
-    format_balance,
-    parse_balance,
-    print_dict,
-    print_error,
-    print_info,
-    print_success,
-    print_tx_result,
-)
-from tusdt_cli.wallet import get_reader_keypair, get_signer_keypair, resolve_ss58
-
-_network_option = click.option(
-    "--network",
-    type=click.Choice(list(NETWORKS.keys()), case_sensitive=False),
-    default=None,
-    help="Network preset (overrides rpc & contract addresses)",
-)
-
-_wallet_option = click.option(
-    "--wallet-name",
-    default=None,
-    help="Bittensor wallet name for signing (prompts for coldkey password)",
-)
-
-
-@click.group("token", cls=HelpfulGroup)
-def token_group() -> None:
-    """TUSDT token operations."""
-
-
-# ------------------------------------------------------------------
-# balance
-# ------------------------------------------------------------------
-
-
-@token_group.command("balance")
-@click.option("--owner", default=None, help="Account SS58 address or wallet name (defaults to --wallet-name)")
-@_wallet_option
-@_network_option
-@click.pass_context
-def balance(ctx: click.Context, owner: str | None, wallet_name: str | None, network: str | None) -> None:
-    """Show the TUSDT token balance for an account.
-
-    \b
-    Owner is resolved from --wallet-name, or pass --owner explicitly.
-    Examples:
-      tusdt token balance --wallet-name MyWallet
-      tusdt token balance --owner 5GrwvaEF... --network testnet
-    """
-    config = load_config(network=network)
-    decimals = config.get("decimals", 9)
-
-    try:
-        if owner:
-            account = resolve_ss58(owner, config.get("wallet_path"))
-        elif wallet_name:
-            account = resolve_ss58(wallet_name, config.get("wallet_path"))
-        else:
-            print_error("Provide --owner (address or wallet name) or --wallet-name")
-            return
-    except Exception as exc:
-        print_error(str(exc))
-        return
-
-    try:
-        keypair = get_reader_keypair(config)
-        client = TUSDTClient(config)
-        raw = client.balance_of(keypair, account)
-    except Exception as exc:
-        print_error(str(exc))
-        return
-
-    print_dict(
-        "Token Balance",
-        {
-            "Account": account,
-            "Balance": format_balance(raw, decimals),
-            "Raw": raw,
-        },
-    )
-
-
-# ------------------------------------------------------------------
-# approve
-# ------------------------------------------------------------------
-
-
-@token_group.command("approve")
-@click.argument("spender", type=str, metavar="<spender>")
-@click.argument("amount", type=str, metavar="<amount>")
-@_wallet_option
-@_network_option
-@click.pass_context
-def approve(
-    ctx: click.Context, spender: str, amount: str, wallet_name: str | None, network: str | None
-) -> None:
-    """Approve a spender to use your TUSDT tokens.
-
-    \b
-    SPENDER is the SS58 address or wallet name of the account to approve.
-    AMOUNT  is the human-readable token amount to approve (e.g. 1000).
-    Examples:
-      tusdt token approve 5GrwvaEF... 1000 --wallet-name MyWallet
-      tusdt token approve SpenderWallet 500.5 --wallet-name MyWallet --network testnet
-    """
-    config = load_config(network=network)
-    if wallet_name:
-        config["wallet_name"] = wallet_name
-    decimals = config.get("decimals", 9)
-    raw_amount = parse_balance(amount, decimals)
-
-    try:
-        spender = resolve_ss58(spender, config.get("wallet_path"))
-    except Exception as exc:
-        print_error(str(exc))
-
-    try:
-        keypair = get_signer_keypair(config)
-    except Exception as exc:
-        print_error(str(exc))
-
-    print_info(f"Signer: {keypair.ss58_address}")
-    print_info(f"Approving {spender} to spend {amount} tokens...")
-
-    try:
-        client = TUSDTClient(config)
-        result = client.approve(keypair, spender, raw_amount)
-        print_success("Approval successful!")
-        print_tx_result(result, config.get("network", "finney"))
-    except Exception as exc:
-        print_error(str(exc))
-
-
-# ------------------------------------------------------------------
-# allowance
-# ------------------------------------------------------------------
-
-
-@token_group.command("allowance")
-@click.argument("spender", type=str, metavar="<spender>")
-@click.option("--owner", default=None, help="Owner SS58 address or wallet name (defaults to --wallet-name)")
-@_wallet_option
-@_network_option
-@click.pass_context
-def allowance(
-    ctx: click.Context, spender: str, owner: str | None, wallet_name: str | None, network: str | None
-) -> None:
-    """Show the allowance a spender has for an owner's tokens.
-
-    \b
-    SPENDER is the SS58 address or wallet name of the spender account.
-    Owner is resolved from --wallet-name, or pass --owner explicitly.
-    Examples:
-      tusdt token allowance 5GrwvaEF... --wallet-name MyWallet
-      tusdt token allowance SpenderWallet --owner 5Abc123... --network testnet
-    """
-    config = load_config(network=network)
-    decimals = config.get("decimals", 9)
-
-    try:
-        if owner:
-            owner = resolve_ss58(owner, config.get("wallet_path"))
-        elif wallet_name:
-            owner = resolve_ss58(wallet_name, config.get("wallet_path"))
-        else:
-            print_error("Provide --owner (address or wallet name) or --wallet-name")
-            return
-        spender = resolve_ss58(spender, config.get("wallet_path"))
-    except Exception as exc:
-        print_error(str(exc))
-        return
-
-    try:
-        keypair = get_reader_keypair(config)
-        client = TUSDTClient(config)
-        raw = client.allowance(keypair, owner, spender)
-    except Exception as exc:
-        print_error(str(exc))
-        return
-
-    print_dict(
-        "Allowance",
-        {
-            "Owner": owner,
-            "Spender": spender,
-            "Allowance": format_balance(raw, decimals),
-            "Raw": raw,
-        },
-    )
-
-
-# ------------------------------------------------------------------
-# transfer
-# ------------------------------------------------------------------
-
-
-@token_group.command("transfer")
-@click.argument("to", type=str, metavar="<recipient>")
-@click.argument("amount", type=str, metavar="<amount>")
-@_wallet_option
-@_network_option
-@click.pass_context
-def transfer(ctx: click.Context, to: str, amount: str, wallet_name: str | None, network: str | None) -> None:
-    """Transfer TUSDT tokens to another account.
-
-    \b
-    TO     is the SS58 address or wallet name of the recipient.
-    AMOUNT is the human-readable token amount to send (e.g. 50).
-    Examples:
-      tusdt token transfer 5GrwvaEF... 50 --wallet-name MyWallet
-      tusdt token transfer RecipientWallet 100.5 --wallet-name MyWallet --network testnet
-    """
-    config = load_config(network=network)
-    if wallet_name:
-        config["wallet_name"] = wallet_name
-    decimals = config.get("decimals", 9)
-    raw_amount = parse_balance(amount, decimals)
-
-    try:
-        to = resolve_ss58(to, config.get("wallet_path"))
-    except Exception as exc:
-        print_error(str(exc))
-
-    try:
-        keypair = get_signer_keypair(config)
-    except Exception as exc:
-        print_error(str(exc))
-
-    print_info(f"Signer: {keypair.ss58_address}")
-    print_info(f"Transferring {amount} tokens to {to}...")
-
-    try:
-        client = TUSDTClient(config)
-        result = client.transfer(keypair, to, raw_amount)
-        print_success("Transfer successful!")
-        print_tx_result(result, config.get("network", "finney"))
-    except Exception as exc:
-        print_error(str(exc))