tusdt-cli 0.1.0__tar.gz

tusdt_cli-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+.venv/
+__pycache__/
+dist/
+build/
+*.egg-info/

tusdt_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tensorusd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tusdt_cli-0.1.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: tusdt-cli
+Version: 0.1.0
+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
+Project-URL: Issues, https://github.com/tensorusd/tusdt-cli/issues
+Author-email: tensorusd <admin@tensorusd.com>, benup <benup211@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: pynacl>=1.5.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: substrate-interface>=1.7.0
+Description-Content-Type: text/markdown
+
+# tusdt-cli
+
+Command-line interface for interacting with the **TUSDT** ink! smart-contract
+system (Vault, Auction, ERC-20 Token, Oracle) on the Bittensor network.
+
+## Installation
+
+```bash
+cd tusdt-cli
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Quickstart
+
+The CLI comes pre-configured with the Finney RPC endpoint, contract addresses,
+and bundled ABI metadata. No upfront configuration is required — pass
+`--wallet-name` on any command that needs signing.
+
+### 1. List wallets
+
+```bash
+tusdt wallet list
+```
+
+### 2. Vault operations
+
+Anywhere an address is expected you can pass a **wallet name** instead and the
+CLI resolves the SS58 address from `coldkeypub.txt` automatically.
+
+```bash
+# Create a vault (prompts for coldkey password)
+tusdt vault create --amount 10 --wallet-name MyWallet
+
+# View your vault (no password needed – reads coldkeypub.txt)
+tusdt vault info MyWallet 0
+# …or via --wallet-name
+tusdt vault info --wallet-name MyWallet 0
+
+# List all vaults for a wallet
+tusdt vault list MyWallet
+# …or via --wallet-name
+tusdt vault list --wallet-name MyWallet
+
+# Add more collateral
+tusdt vault add-collateral 0 --amount 5 --wallet-name MyWallet
+
+# Borrow against collateral
+tusdt vault borrow 0 100 --wallet-name MyWallet
+
+# Repay borrowed tokens
+tusdt vault repay 0 50 --wallet-name MyWallet
+
+# Release collateral
+tusdt vault release-collateral 0 2 --wallet-name MyWallet
+
+# Check max borrow capacity
+tusdt vault max-borrow MyWallet 0
+tusdt vault max-borrow --wallet-name MyWallet 0
+
+# Check collateral value
+tusdt vault collateral-value MyWallet 0
+tusdt vault collateral-value --wallet-name MyWallet 0
+```
+
+### 3. Token operations
+
+```bash
+# Check balance (wallet name or SS58 address)
+tusdt token balance MyWallet
+tusdt token balance --wallet-name MyWallet
+
+# Transfer tokens
+tusdt token transfer RecipientWallet 100 --wallet-name MyWallet
+
+# Approve spender
+tusdt token approve SpenderWallet 1000 --wallet-name MyWallet
+
+# Check allowance (both args accept wallet names)
+tusdt token allowance MyWallet SpenderWallet
+```
+
+### 4. Auction operations
+
+```bash
+# List active liquidation auctions
+tusdt auction list-active
+
+# View auction details
+tusdt auction info 0
+
+# Place a bid (with optional hotkey for metadata)
+tusdt auction bid 0 500 --wallet-name MyWallet --wallet-hotkey default
+
+# Finalize a completed auction
+tusdt auction finalize 0 --wallet-name MyWallet
+
+# Withdraw refund for a non-winning bid
+tusdt auction withdraw-refund 0 1 --wallet-name MyWallet
+
+# Check your bid (resolves address from coldkeypub.txt, no password)
+tusdt auction my-bid 0 --wallet-name MyWallet
+```
+
+### 5. Oracle operations
+
+```bash
+# View latest price
+tusdt oracle price
+
+# View current round
+tusdt oracle round
+```
+
+## Network selection
+
+Two networks are available: **finney** (mainnet, default) and **testnet**.
+
+```bash
+# Per-command override (not saved)
+tusdt vault list MyWallet --network testnet
+tusdt oracle price --network testnet
+
+# Save as default
+tusdt config set --network testnet
+
+# Switch back
+tusdt config set --network finney
+```
+
+## Configuration
+
+Configuration is stored in `~/.tusdt-cli/config.json`.
+Most users won't need to edit it — `--wallet-name` and `--network` on
+each command cover the common cases.
+
+```bash
+# View current config
+tusdt config show
+
+# Pre-configure a wallet (avoids passing --wallet-name every time)
+tusdt config set --wallet-name MyWallet
+
+# Use a mnemonic seed phrase instead
+tusdt config set --signer "word1 word2 word3 ... word12"
+
+# Override contract addresses or RPC
+tusdt config set --rpc wss://custom-endpoint:443
+tusdt config set --vault 5Hh...
+```
+
+| Key                | Description                          | Default                                              |
+|--------------------|--------------------------------------|------------------------------------------------------|
+| `network`          | Active network preset                | `finney`                                             |
+| `rpc`              | WebSocket RPC endpoint               | `wss://entrypoint-finney.opentensor.ai:443`          |
+| `vault_address`    | Vault contract SS58 address          | `5HhJKNf7XjmppAyPeBKN5xQk6joNMWHTnEgup4msxfcKcYKp`   |
+| `token_address`    | Token (ERC-20) contract SS58 address | `5GGqBAYWW84wvdTeZGM68dHng1UaWTxxc4ZzFhuQXF9zqK9J`   |
+| `auction_address`  | Auction contract SS58 address        | `5Cninzamn4GVi1J1St578ENyNEDrMi5hXucY7rUj1WzREgAt`   |
+| `oracle_address`   | Oracle contract SS58 address         | `5FqciR795agP8wEojv2TRegwN757EJURyzjDREUvzCX3cqZS`   |
+| `vault_metadata`   | Path to vault ABI JSON               | bundled                                              |
+| `token_metadata`   | Path to token ABI JSON               | bundled                                              |
+| `auction_metadata` | Path to auction ABI JSON             | bundled                                              |
+| `oracle_metadata`  | Path to oracle ABI JSON              | bundled                                              |
+| `signer`           | Mnemonic seed phrase or keyfile path | —                                                    |
+| `wallet_name`      | Default bittensor wallet name        | —                                                    |
+| `wallet_path`      | Path to wallets directory            | `~/.bittensor/wallets`                               |
+| `decimals`         | Decimal places for balance display   | `9`                                                  |
+
+## Networks
+
+| Network   | RPC endpoint                                |
+|-----------|---------------------------------------------|
+| `finney`  | `wss://entrypoint-finney.opentensor.ai:443` |
+| `testnet` | `wss://test.finney.opentensor.ai:443`       |
+
+## Transaction output
+
+All write operations (create vault, borrow, transfer, bid, etc.) display a
+progress spinner and, on success, print the extrinsic hash with a
+[Taostats](https://taostats.io) explorer link:
+
+```
+Finalized
+┌─ Transaction ──────────────────────────────────────────────────┐
+│  Extrinsic: 0xabc123…                                          │
+│  Block: 0xdef456…                                              │
+│  Explorer: https://taostats.io/hash/0xabc…?network=finney │
+└────────────────────────────────────────────────────────────────┘
+```
+
+The `network` parameter in the URL matches the `--network` flag (or the
+configured default).
+
+## Repositories
+
+- TUSDT smart contracts: https://github.com/TensorUSD/TUSDT-SmartContract.git
+- tusdt-cli repository: https://github.com/TensorUSD/tusdt-cli
+
+## License
+
+MIT

tusdt_cli-0.1.0/README.md

@@ -0,0 +1,202 @@
+# tusdt-cli
+
+Command-line interface for interacting with the **TUSDT** ink! smart-contract
+system (Vault, Auction, ERC-20 Token, Oracle) on the Bittensor network.
+
+## Installation
+
+```bash
+cd tusdt-cli
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Quickstart
+
+The CLI comes pre-configured with the Finney RPC endpoint, contract addresses,
+and bundled ABI metadata. No upfront configuration is required — pass
+`--wallet-name` on any command that needs signing.
+
+### 1. List wallets
+
+```bash
+tusdt wallet list
+```
+
+### 2. Vault operations
+
+Anywhere an address is expected you can pass a **wallet name** instead and the
+CLI resolves the SS58 address from `coldkeypub.txt` automatically.
+
+```bash
+# Create a vault (prompts for coldkey password)
+tusdt vault create --amount 10 --wallet-name MyWallet
+
+# View your vault (no password needed – reads coldkeypub.txt)
+tusdt vault info MyWallet 0
+# …or via --wallet-name
+tusdt vault info --wallet-name MyWallet 0
+
+# List all vaults for a wallet
+tusdt vault list MyWallet
+# …or via --wallet-name
+tusdt vault list --wallet-name MyWallet
+
+# Add more collateral
+tusdt vault add-collateral 0 --amount 5 --wallet-name MyWallet
+
+# Borrow against collateral
+tusdt vault borrow 0 100 --wallet-name MyWallet
+
+# Repay borrowed tokens
+tusdt vault repay 0 50 --wallet-name MyWallet
+
+# Release collateral
+tusdt vault release-collateral 0 2 --wallet-name MyWallet
+
+# Check max borrow capacity
+tusdt vault max-borrow MyWallet 0
+tusdt vault max-borrow --wallet-name MyWallet 0
+
+# Check collateral value
+tusdt vault collateral-value MyWallet 0
+tusdt vault collateral-value --wallet-name MyWallet 0
+```
+
+### 3. Token operations
+
+```bash
+# Check balance (wallet name or SS58 address)
+tusdt token balance MyWallet
+tusdt token balance --wallet-name MyWallet
+
+# Transfer tokens
+tusdt token transfer RecipientWallet 100 --wallet-name MyWallet
+
+# Approve spender
+tusdt token approve SpenderWallet 1000 --wallet-name MyWallet
+
+# Check allowance (both args accept wallet names)
+tusdt token allowance MyWallet SpenderWallet
+```
+
+### 4. Auction operations
+
+```bash
+# List active liquidation auctions
+tusdt auction list-active
+
+# View auction details
+tusdt auction info 0
+
+# Place a bid (with optional hotkey for metadata)
+tusdt auction bid 0 500 --wallet-name MyWallet --wallet-hotkey default
+
+# Finalize a completed auction
+tusdt auction finalize 0 --wallet-name MyWallet
+
+# Withdraw refund for a non-winning bid
+tusdt auction withdraw-refund 0 1 --wallet-name MyWallet
+
+# Check your bid (resolves address from coldkeypub.txt, no password)
+tusdt auction my-bid 0 --wallet-name MyWallet
+```
+
+### 5. Oracle operations
+
+```bash
+# View latest price
+tusdt oracle price
+
+# View current round
+tusdt oracle round
+```
+
+## Network selection
+
+Two networks are available: **finney** (mainnet, default) and **testnet**.
+
+```bash
+# Per-command override (not saved)
+tusdt vault list MyWallet --network testnet
+tusdt oracle price --network testnet
+
+# Save as default
+tusdt config set --network testnet
+
+# Switch back
+tusdt config set --network finney
+```
+
+## Configuration
+
+Configuration is stored in `~/.tusdt-cli/config.json`.
+Most users won't need to edit it — `--wallet-name` and `--network` on
+each command cover the common cases.
+
+```bash
+# View current config
+tusdt config show
+
+# Pre-configure a wallet (avoids passing --wallet-name every time)
+tusdt config set --wallet-name MyWallet
+
+# Use a mnemonic seed phrase instead
+tusdt config set --signer "word1 word2 word3 ... word12"
+
+# Override contract addresses or RPC
+tusdt config set --rpc wss://custom-endpoint:443
+tusdt config set --vault 5Hh...
+```
+
+| Key                | Description                          | Default                                              |
+|--------------------|--------------------------------------|------------------------------------------------------|
+| `network`          | Active network preset                | `finney`                                             |
+| `rpc`              | WebSocket RPC endpoint               | `wss://entrypoint-finney.opentensor.ai:443`          |
+| `vault_address`    | Vault contract SS58 address          | `5HhJKNf7XjmppAyPeBKN5xQk6joNMWHTnEgup4msxfcKcYKp`   |
+| `token_address`    | Token (ERC-20) contract SS58 address | `5GGqBAYWW84wvdTeZGM68dHng1UaWTxxc4ZzFhuQXF9zqK9J`   |
+| `auction_address`  | Auction contract SS58 address        | `5Cninzamn4GVi1J1St578ENyNEDrMi5hXucY7rUj1WzREgAt`   |
+| `oracle_address`   | Oracle contract SS58 address         | `5FqciR795agP8wEojv2TRegwN757EJURyzjDREUvzCX3cqZS`   |
+| `vault_metadata`   | Path to vault ABI JSON               | bundled                                              |
+| `token_metadata`   | Path to token ABI JSON               | bundled                                              |
+| `auction_metadata` | Path to auction ABI JSON             | bundled                                              |
+| `oracle_metadata`  | Path to oracle ABI JSON              | bundled                                              |
+| `signer`           | Mnemonic seed phrase or keyfile path | —                                                    |
+| `wallet_name`      | Default bittensor wallet name        | —                                                    |
+| `wallet_path`      | Path to wallets directory            | `~/.bittensor/wallets`                               |
+| `decimals`         | Decimal places for balance display   | `9`                                                  |
+
+## Networks
+
+| Network   | RPC endpoint                                |
+|-----------|---------------------------------------------|
+| `finney`  | `wss://entrypoint-finney.opentensor.ai:443` |
+| `testnet` | `wss://test.finney.opentensor.ai:443`       |
+
+## Transaction output
+
+All write operations (create vault, borrow, transfer, bid, etc.) display a
+progress spinner and, on success, print the extrinsic hash with a
+[Taostats](https://taostats.io) explorer link:
+
+```
+Finalized
+┌─ Transaction ──────────────────────────────────────────────────┐
+│  Extrinsic: 0xabc123…                                          │
+│  Block: 0xdef456…                                              │
+│  Explorer: https://taostats.io/hash/0xabc…?network=finney │
+└────────────────────────────────────────────────────────────────┘
+```
+
+The `network` parameter in the URL matches the `--network` flag (or the
+configured default).
+
+## Repositories
+
+- TUSDT smart contracts: https://github.com/TensorUSD/TUSDT-SmartContract.git
+- tusdt-cli repository: https://github.com/TensorUSD/tusdt-cli
+
+## License
+
+MIT

tusdt_cli-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tusdt-cli"
+version = "0.1.0"
+description = "CLI for interacting with the TUSDT ink! smart contract system on subtensor(bittensor)"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "tensorusd", email = "admin@tensorusd.com" },
+    { name = "benup", email = "benup211@gmail.com" }
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+]
+
+dependencies = [
+    "click>=8.1.0",
+    "substrate-interface>=1.7.0",
+    "rich>=13.0.0",
+    "pynacl>=1.5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tensorusd/tusdt-cli"
+Repository = "https://github.com/tensorusd/tusdt-cli"
+Issues = "https://github.com/tensorusd/tusdt-cli/issues"
+
+[project.scripts]
+tusdt = "tusdt_cli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tusdt_cli"]

tusdt_cli-0.1.0/src/tusdt_cli/__init__.py

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