xflows 1.1.0 → 1.2.0

package/README.md

@@ -15,6 +15,12 @@ A command-line interface for the [Wanchain XFlows](https://docs.wanchain.org/dev
   - [RPC Endpoints](#rpc-endpoints)
 - [Commands](#commands)
   - [Wallet Management](#wallet-management)
+    - [`wallet create`](#wallet-create----create-a-new-wallet)
+    - [`wallet list`](#wallet-list----list-all-saved-wallets)
+    - [`wallet show`](#wallet-show----show-wallet-details)
+    - [`wallet balance`](#wallet-balance----check-native-token-balance)
+    - [`wallet token-balance`](#wallet-token-balance----check-erc20-token-balance)
+    - [`wallet delete`](#wallet-delete----delete-a-wallet)
   - [Query Commands](#query-commands)
   - [Quote](#quote)
   - [Send Transaction](#send-transaction)
@@ -335,6 +341,32 @@ xflows wallet balance --name alice --chain-id 1 --rpc https://my-rpc.example.com
 | `--password <pw>` | No | Password for encrypted wallets |
 | `--rpc <url>` | No | Override default RPC endpoint |
 
+#### `wallet token-balance` -- Check ERC20 token balance
+
+```bash
+# Check USDC balance on Ethereum
+xflows wallet token-balance --name alice --chain-id 1 \
+  --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
+
+# Check USDT balance on BSC (auto-detect decimals)
+xflows wallet token-balance --name alice --chain-id 56 \
+  --token 0x55d398326f99059fF775485246999027B3197955
+
+# Check with explicit decimals and custom RPC
+xflows wallet token-balance --name alice --chain-id 1 \
+  --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --decimals 6 --rpc https://my-rpc.example.com
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--name <name>` | Yes | Wallet name |
+| `--chain-id <id>` | Yes | Chain ID to query balance on |
+| `--token <addr>` | Yes | ERC20 token contract address |
+| `--decimals <n>` | No | Token decimals (auto-detected if omitted) |
+| `--password <pw>` | No | Password for encrypted wallets |
+| `--rpc <url>` | No | Override default RPC endpoint |
+
 #### `wallet delete` -- Delete a wallet
 
 ```bash

package/dist/index.js

@@ -18660,7 +18660,7 @@ import * as readline from "readline";
 // package.json
 var package_default = {
   name: "xflows",
-  version: "1.1.0",
+  version: "1.2.0",
   description: "CLI tool for Wanchain XFlows cross-chain bridge - wallet management, quote queries, and cross-chain transactions",
   type: "module",
   bin: {
@@ -18958,6 +18958,42 @@ walletCmd.command("balance").description(`Check native token balance on a specif
     process.exit(1);
   }
 });
+walletCmd.command("token-balance").description(`Check ERC20 token balance on a specific chain
+
+` + `Examples:
+` + `  # Check USDC balance on Ethereum
+` + "  xflows wallet token-balance --name alice --chain-id 1 \\\n" + `    --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
+
+` + `  # Check USDT balance on BSC with explicit decimals
+` + "  xflows wallet token-balance --name alice --chain-id 56 \\\n" + "    --token 0x55d398326f99059fF775485246999027B3197955 --decimals 18").requiredOption("--name <name>", "Wallet name").requiredOption("--chain-id <chainId>", "Chain ID to check balance on").requiredOption("--token <address>", "ERC20 token contract address").option("--decimals <decimals>", "Token decimals (auto-detected if omitted)").option("--password <password>", "Password to decrypt encrypted wallet").option("--rpc <url>", "Custom RPC URL (overrides default)").action(async (opts) => {
+  try {
+    const wallet = loadWallet(opts.name, opts.password);
+    const provider = opts.rpc ? new JsonRpcProvider(opts.rpc) : getProvider2(opts.chainId);
+    const tokenContract = new Contract(opts.token, ERC20_ABI, provider);
+    let decimals;
+    if (opts.decimals !== undefined) {
+      decimals = Number(opts.decimals);
+    } else {
+      try {
+        decimals = Number(await tokenContract.decimals());
+      } catch {
+        throw new Error("Could not auto-detect token decimals. Please provide --decimals manually.");
+      }
+    }
+    let symbol = "TOKEN";
+    try {
+      symbol = await tokenContract.symbol();
+    } catch {}
+    const balance = await tokenContract.balanceOf(wallet.address);
+    console.log(`Address: ${wallet.address}`);
+    console.log(`Chain:   ${opts.chainId}`);
+    console.log(`Token:   ${opts.token} (${symbol})`);
+    console.log(`Balance: ${formatUnits(balance, decimals)}`);
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+});
 walletCmd.command("delete").description("Delete a saved wallet").requiredOption("--name <name>", "Wallet name to delete").option("--force", "Skip confirmation", false).action(async (opts) => {
   const walletDir = getWalletDir();
   const filePath = path.join(walletDir, `${opts.name}.json`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xflows",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI tool for Wanchain XFlows cross-chain bridge - wallet management, quote queries, and cross-chain transactions",
   "type": "module",
   "bin": {