xflows 1.2.0 → 1.3.0

package/README.md

@@ -327,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
 
@@ -336,7 +339,8 @@ 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 |
@@ -352,6 +356,10 @@ xflows wallet token-balance --name alice --chain-id 1 \
 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 \
@@ -360,7 +368,8 @@ xflows wallet token-balance --name alice --chain-id 1 \
 
 | 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 |
 | `--token <addr>` | Yes | ERC20 token contract address |
 | `--decimals <n>` | No | Token decimals (auto-detected if omitted) |

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.2.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) {
@@ -18965,9 +18985,24 @@ walletCmd.command("token-balance").description(`Check ERC20 token balance on a s
 ` + "  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) => {
+` + "  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 {
-    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 tokenContract = new Contract(opts.token, ERC20_ABI, provider);
     let decimals;
@@ -18984,8 +19019,8 @@ walletCmd.command("token-balance").description(`Check ERC20 token balance on a s
     try {
       symbol = await tokenContract.symbol();
     } catch {}
-    const balance = await tokenContract.balanceOf(wallet.address);
-    console.log(`Address: ${wallet.address}`);
+    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)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xflows",
-  "version": "1.2.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": {