xflows 1.1.0 → 1.3.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)
@@ -321,6 +327,9 @@ xflows wallet balance --name alice --chain-id 56
 # Check WAN balance on Wanchain
 xflows wallet balance --name alice --chain-id 888
 
+# Check any address (no wallet needed)
+xflows wallet balance --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain-id 1
+
 # Encrypted wallet
 xflows wallet balance --name alice --chain-id 1 --password mypassword
 
@@ -330,11 +339,43 @@ xflows wallet balance --name alice --chain-id 1 --rpc https://my-rpc.example.com
 
 | Flag | Required | Description |
 |------|----------|-------------|
-| `--name <name>` | Yes | Wallet name |
+| `--name <name>` | One of `--name` or `--address` | Wallet name |
+| `--address <addr>` | One of `--name` or `--address` | Query any address (no wallet needed) |
 | `--chain-id <id>` | Yes | Chain ID to query balance on |
 | `--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 any address's USDC balance (no wallet needed)
+xflows wallet token-balance --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 \
+  --chain-id 1 --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
+
+# 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>` | One of `--name` or `--address` | Wallet name |
+| `--address <addr>` | One of `--name` or `--address` | Query any address (no wallet needed) |
+| `--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

@@ -7241,6 +7241,13 @@ function getCreateAddress(tx) {
 function isAddressable(value) {
   return value && typeof value.getAddress === "function";
 }
+function isAddress(value) {
+  try {
+    getAddress(value);
+    return true;
+  } catch (error) {}
+  return false;
+}
 async function checkAddress(target, promise) {
   const result = await promise;
   if (result == null || result === "0x0000000000000000000000000000000000000000") {
@@ -18660,7 +18667,7 @@ import * as readline from "readline";
 // package.json
 var package_default = {
   name: "xflows",
-  version: "1.1.0",
+  version: "1.3.0",
   description: "CLI tool for Wanchain XFlows cross-chain bridge - wallet management, quote queries, and cross-chain transactions",
   type: "module",
   bin: {
@@ -18945,12 +18952,25 @@ walletCmd.command("balance").description(`Check native token balance on a specif
 
 ` + `Examples:
 ` + `  xflows wallet balance --name myWallet --chain-id 1
-` + "  xflows wallet balance --name myWallet --chain-id 56 --password mysecret").requiredOption("--name <name>", "Wallet name").requiredOption("--chain-id <chainId>", "Chain ID to check balance on").option("--password <password>", "Password to decrypt encrypted wallet").option("--rpc <url>", "Custom RPC URL (overrides default)").action(async (opts) => {
+` + `  xflows wallet balance --name myWallet --chain-id 56 --password mysecret
+` + "  xflows wallet balance --address 0x1234...abcd --chain-id 1").option("--name <name>", "Wallet name").option("--address <address>", "Query balance for any address (no wallet needed)").requiredOption("--chain-id <chainId>", "Chain ID to check balance on").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);
+    if (!opts.name && !opts.address) {
+      throw new Error("Please provide either --name or --address");
+    }
+    let targetAddress;
+    if (opts.address) {
+      if (!isAddress(opts.address)) {
+        throw new Error(`Invalid address: ${opts.address}`);
+      }
+      targetAddress = opts.address;
+    } else {
+      const wallet = loadWallet(opts.name, opts.password);
+      targetAddress = wallet.address;
+    }
     const provider = opts.rpc ? new JsonRpcProvider(opts.rpc) : getProvider2(opts.chainId);
-    const balance = await provider.getBalance(wallet.address);
-    console.log(`Address: ${wallet.address}`);
+    const balance = await provider.getBalance(targetAddress);
+    console.log(`Address: ${targetAddress}`);
     console.log(`Chain:   ${opts.chainId}`);
     console.log(`Balance: ${formatUnits(balance, 18)} (native token)`);
   } catch (e) {
@@ -18958,6 +18978,57 @@ 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
+
+` + `  # Check any address's USDC balance (no wallet needed)
+` + "  xflows wallet token-balance --address 0x1234...abcd --chain-id 1 \\\n" + "    --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48").option("--name <name>", "Wallet name").option("--address <address>", "Query balance for any address (no wallet needed)").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 {
+    if (!opts.name && !opts.address) {
+      throw new Error("Please provide either --name or --address");
+    }
+    let targetAddress;
+    if (opts.address) {
+      if (!isAddress(opts.address)) {
+        throw new Error(`Invalid address: ${opts.address}`);
+      }
+      targetAddress = opts.address;
+    } else {
+      const wallet = loadWallet(opts.name, opts.password);
+      targetAddress = wallet.address;
+    }
+    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(targetAddress);
+    console.log(`Address: ${targetAddress}`);
+    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.3.0",
   "description": "CLI tool for Wanchain XFlows cross-chain bridge - wallet management, quote queries, and cross-chain transactions",
   "type": "module",
   "bin": {