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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tusdt-cli
-Version: 0.2.4
+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.4 → tusdt_cli-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tusdt-cli"
-version = "0.2.4"
+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.4 → 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.4"
+__version__ = "0.2.6"

{tusdt_cli-0.2.4 → 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.4 → 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.4 → tusdt_cli-0.2.6}/src/tusdt_cli/commands/governance.py

@@ -1257,10 +1257,11 @@ def submit_proposal_cmd(
 )
 @click.option(
     "--proof",
-    type=str,
+    "proofs",
+    multiple=True,
     required=True,
     metavar="<hex-string>",
-    help="Merkle proof as hex-encoded bytes (e.g. 0x...)",
+    help="Merkle proof hash as hex-encoded 32 bytes (repeatable, e.g. --proof 0xabc... --proof 0xdef...)",
 )
 @_wallet_option
 @_network_option
@@ -1272,7 +1273,7 @@ def vote_cmd(
     support: bool,
     balance: str,
     multiplier_bps: int,
-    proof: str,
+    proofs: tuple[str, ...],
     wallet_name: str | None,
     network: str | None,
 ) -> None:
@@ -1280,9 +1281,10 @@ def vote_cmd(
 
     \b
     PROPOSAL_ID is the numeric proposal ID (integer).
+    Each --proof is a hex-encoded 32-byte Merkle proof hash; repeat for multiple proof nodes.
     Examples:
-      tusdt governance vote 0 --hotkey 5GrwvaEF... --support --balance 1000 --multiplier-bps 10000 --proof 0xabcdef --wallet-name MyWallet
-      tusdt governance vote 0 --hotkey 5GrwvaEF... --oppose --balance 500 --multiplier-bps 10000 --proof 0xabcdef --wallet-name MyWallet
+      tusdt governance vote 0 --hotkey 5GrwvaEF... --support --balance 1000 --multiplier-bps 10000 --proof 0x5637... --wallet-name MyWallet
+      tusdt governance vote 0 --hotkey 5GrwvaEF... --oppose --balance 500 --multiplier-bps 10000 --proof 0x5637... --proof 0x8087... --wallet-name MyWallet
     """
     config = load_config(network=network)
     if wallet_name:
@@ -1290,12 +1292,17 @@ def vote_cmd(
     decimals = config.get("decimals", 9)
     raw_balance = parse_balance(balance, decimals)
 
-    # Convert hex proof to list of ints
-    proof_hex = proof.strip()
-    if proof_hex.startswith("0x"):
-        proof_hex = proof_hex[2:]
-    proof_bytes = bytes.fromhex(proof_hex)
-    proof_list = list(proof_bytes)
+    # Convert each hex proof hash to a list of 32 bytes (MerkleHash = [u8; 32])
+    proof_list = []
+    for proof_hex in proofs:
+        ph = proof_hex.strip()
+        if ph.startswith("0x"):
+            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")
+            return
+        proof_list.append(list(proof_bytes))
 
     try:
         keypair = get_signer_keypair(config)