xflows 1.0.2 → 1.2.0

package/README.md

@@ -15,9 +15,17 @@ 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)
+  - [Transfer (Native Token)](#transfer-native-token)
+  - [Transfer Token (ERC20)](#transfer-token-erc20)
   - [Transaction Status](#transaction-status)
   - [RPC List](#rpc-list)
 - [Complete Workflow Example](#complete-workflow-example)
@@ -333,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
@@ -511,6 +545,76 @@ xflows send \
 7. Waits for on-chain confirmation
 8. Prints the transaction hash and a ready-to-use `xflows status` command for tracking
 
+### Transfer (Native Token)
+
+Send native tokens (ETH, BNB, WAN, etc.) on the same chain. This is a simple transfer, not a cross-chain bridge operation.
+
+```bash
+# Send 0.1 ETH on Ethereum
+xflows transfer --wallet alice --chain-id 1 --to 0xRecipient --amount 0.1
+
+# Send 1.5 BNB on BSC with encrypted wallet
+xflows transfer --wallet alice --password mysecret --chain-id 56 --to 0xRecipient --amount 1.5
+
+# Dry run (preview without sending)
+xflows transfer --wallet alice --chain-id 1 --to 0xRecipient --amount 0.1 --dry-run
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--wallet <name>` | Yes | Wallet name to use for signing |
+| `--chain-id <id>` | Yes | Chain ID to send on |
+| `--to <address>` | Yes | Recipient address |
+| `--amount <amount>` | Yes | Amount to send (human-readable, e.g., `0.1`) |
+| `--password <pw>` | No | Password for encrypted wallet |
+| `--rpc <url>` | No | Override default RPC endpoint |
+| `--gas-limit <limit>` | No | Custom gas limit |
+| `--dry-run` | No | Build but do not send the transaction |
+
+### Transfer Token (ERC20)
+
+Send ERC20 tokens on the same chain. Token decimals are auto-detected from the contract, or can be specified manually.
+
+```bash
+# Send 100 USDC on Ethereum (auto-detect decimals)
+xflows transfer-token --wallet alice --chain-id 1 \
+  --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --to 0xRecipient --amount 100
+
+# Send with explicit decimals
+xflows transfer-token --wallet alice --chain-id 1 \
+  --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --to 0xRecipient --amount 100 --decimals 6
+
+# Send 50 USDT on BSC with encrypted wallet
+xflows transfer-token --wallet alice --password mysecret --chain-id 56 \
+  --token 0x55d398326f99059fF775485246999027B3197955 \
+  --to 0xRecipient --amount 50
+
+# Dry run (preview without sending)
+xflows transfer-token --wallet alice --chain-id 1 \
+  --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
+  --to 0xRecipient --amount 100 --dry-run
+```
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `--wallet <name>` | Yes | Wallet name to use for signing |
+| `--chain-id <id>` | Yes | Chain ID to send on |
+| `--token <address>` | Yes | ERC20 token contract address |
+| `--to <address>` | Yes | Recipient address |
+| `--amount <amount>` | Yes | Amount to send (human-readable, e.g., `100`) |
+| `--decimals <n>` | No | Token decimals (auto-detected if omitted) |
+| `--password <pw>` | No | Password for encrypted wallet |
+| `--rpc <url>` | No | Override default RPC endpoint |
+| `--gas-limit <limit>` | No | Custom gas limit |
+| `--dry-run` | No | Build but do not send the transaction |
+
+**Features:**
+- Auto-detects token decimals and symbol from the contract
+- Checks token balance before sending to provide a clear error message
+- Supports Wanchain gas price enforcement
+
 ### Transaction Status
 
 Check the current state of a cross-chain transaction.

package/dist/index.js

@@ -3955,6 +3955,9 @@ function parseUnits(value, unit) {
   }
   return FixedNumber.fromString(value, { decimals, width: 512 }).value;
 }
+function parseEther(ether) {
+  return parseUnits(ether, 18);
+}
 // node_modules/ethers/lib.esm/utils/uuid.js
 function uuidV4(randomBytes) {
   const bytes = getBytes(randomBytes, "randomBytes");
@@ -18657,7 +18660,7 @@ import * as readline from "readline";
 // package.json
 var package_default = {
   name: "xflows",
-  version: "1.0.2",
+  version: "1.2.0",
   description: "CLI tool for Wanchain XFlows cross-chain bridge - wallet management, quote queries, and cross-chain transactions",
   type: "module",
   bin: {
@@ -18826,14 +18829,18 @@ function printJson(data) {
 }
 var ERC20_ABI = [
   "function approve(address spender, uint256 amount) returns (bool)",
-  "function allowance(address owner, address spender) view returns (uint256)"
+  "function allowance(address owner, address spender) view returns (uint256)",
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address owner) view returns (uint256)",
+  "function decimals() view returns (uint8)",
+  "function symbol() view returns (string)"
 ];
 var program2 = new Command;
 program2.name("xflows").version(VERSION).description(`XFlows Cross-Chain Bridge CLI Tool
 
 ` + `A command-line interface for Wanchain XFlows cross-chain bridge.
 ` + `Supports wallet management, quote queries, cross-chain transactions,
-` + `and all XFlows API query endpoints.
+` + `same-chain native/ERC20 transfers, and all XFlows API query endpoints.
 
 ` + `Wallet files are stored in ~/.xflows/wallets/
 
@@ -18842,6 +18849,8 @@ program2.name("xflows").version(VERSION).description(`XFlows Cross-Chain Bridge
 ` + `  xflows wallet create --name secureWallet --encrypt
 ` + `  xflows chains
 ` + `  xflows tokens --chain-id 1
+` + `  xflows transfer --wallet myWallet --chain-id 1 --to 0x... --amount 0.1
+` + `  xflows transfer-token --wallet myWallet --chain-id 1 --token 0x... --to 0x... --amount 100
 ` + `  xflows quote --from-chain 1 --to-chain 56 --from-token 0x0...0 --to-token 0x0...0 --from-address 0x... --to-address 0x... --amount 1.0
 ` + `  xflows send --wallet myWallet --from-chain 1 --to-chain 56 --from-token 0x0...0 --to-token 0x0...0 --to-address 0x... --amount 1.0
 ` + "  xflows status --hash 0x... --from-chain 1 --to-chain 56 --from-token 0x0...0 --to-token 0x0...0 --from-address 0x... --to-address 0x... --amount 1.0");
@@ -18949,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`);
@@ -19181,6 +19226,141 @@ You can track the cross-chain status with:`);
     process.exit(1);
   }
 });
+program2.command("transfer").description(`Send native tokens (ETH/BNB/WAN/etc.) on the same chain
+
+` + `This is a simple same-chain transfer, NOT a cross-chain bridge operation.
+
+` + `Examples:
+` + `  # Send 0.1 ETH on Ethereum
+` + `  xflows transfer --wallet alice --chain-id 1 --to 0xRecipient --amount 0.1
+
+` + `  # Send 1.5 BNB on BSC with encrypted wallet
+` + "  xflows transfer --wallet alice --password mysecret --chain-id 56 --to 0xRecipient --amount 1.5").requiredOption("--wallet <name>", "Wallet name to use for signing").requiredOption("--chain-id <chainId>", "Chain ID to send on").requiredOption("--to <address>", "Recipient address").requiredOption("--amount <amount>", "Amount to send (human-readable, e.g., 0.1)").option("--password <password>", "Password to decrypt encrypted wallet").option("--rpc <url>", "Custom RPC URL (overrides default)").option("--gas-limit <limit>", "Custom gas limit").option("--dry-run", "Only build the transaction, don't send it", false).action(async (opts) => {
+  try {
+    const wallet = loadWallet(opts.wallet, opts.password);
+    const provider = opts.rpc ? new JsonRpcProvider(opts.rpc) : getProvider2(opts.chainId);
+    const signer = wallet.connect(provider);
+    const txRequest = {
+      to: opts.to,
+      value: parseEther(opts.amount)
+    };
+    if (opts.gasLimit) {
+      txRequest.gasLimit = BigInt(opts.gasLimit);
+    }
+    const isWanchain = opts.chainId === "888";
+    if (isWanchain) {
+      const feeData = await provider.getFeeData();
+      const minBaseFee = parseUnits("1", "gwei");
+      if (feeData.gasPrice && feeData.gasPrice < minBaseFee) {
+        txRequest.gasPrice = minBaseFee;
+        console.log("Wanchain: enforcing minimum gasPrice of 1 gwei");
+      } else if (feeData.maxFeePerGas) {
+        const maxFee = feeData.maxFeePerGas < minBaseFee ? minBaseFee : feeData.maxFeePerGas;
+        txRequest.gasPrice = maxFee;
+        console.log(`Wanchain: using gasPrice ${formatUnits(maxFee, "gwei")} gwei`);
+      }
+    }
+    if (opts.dryRun) {
+      console.log("[Dry Run] Transaction details:");
+      printJson({
+        from: wallet.address,
+        to: opts.to,
+        value: txRequest.value.toString(),
+        chainId: opts.chainId
+      });
+      return;
+    }
+    console.log(`Sending ${opts.amount} native token to ${opts.to} on chain ${opts.chainId}...`);
+    const sentTx = await signer.sendTransaction(txRequest);
+    console.log(`Transaction hash: ${sentTx.hash}`);
+    console.log("Waiting for confirmation...");
+    const receipt = await sentTx.wait();
+    console.log(`Transaction confirmed in block ${receipt?.blockNumber}`);
+    console.log(`Gas used: ${receipt?.gasUsed.toString()}`);
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+});
+program2.command("transfer-token").description(`Send ERC20 tokens on the same chain
+
+` + `This is a simple same-chain ERC20 transfer, NOT a cross-chain bridge operation.
+
+` + `Examples:
+` + `  # Send 100 USDC on Ethereum (6 decimals)
+` + "  xflows transfer-token --wallet alice --chain-id 1 \\\n" + "    --token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \\\n" + `    --to 0xRecipient --amount 100 --decimals 6
+
+` + `  # Send 50 USDT on BSC (auto-detect decimals)
+` + "  xflows transfer-token --wallet alice --chain-id 56 \\\n" + "    --token 0x55d398326f99059fF775485246999027B3197955 \\\n" + "    --to 0xRecipient --amount 50").requiredOption("--wallet <name>", "Wallet name to use for signing").requiredOption("--chain-id <chainId>", "Chain ID to send on").requiredOption("--token <address>", "ERC20 token contract address").requiredOption("--to <address>", "Recipient address").requiredOption("--amount <amount>", "Amount to send (human-readable, e.g., 100)").option("--decimals <decimals>", "Token decimals (auto-detected from contract if omitted)").option("--password <password>", "Password to decrypt encrypted wallet").option("--rpc <url>", "Custom RPC URL (overrides default)").option("--gas-limit <limit>", "Custom gas limit").option("--dry-run", "Only build the transaction, don't send it", false).action(async (opts) => {
+  try {
+    const wallet = loadWallet(opts.wallet, opts.password);
+    const provider = opts.rpc ? new JsonRpcProvider(opts.rpc) : getProvider2(opts.chainId);
+    const signer = wallet.connect(provider);
+    const tokenContract = new Contract(opts.token, ERC20_ABI, signer);
+    let decimals;
+    if (opts.decimals !== undefined) {
+      decimals = Number(opts.decimals);
+    } else {
+      try {
+        decimals = Number(await tokenContract.decimals());
+        console.log(`Token decimals: ${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 amount = parseUnits(opts.amount, decimals);
+    const balance = await tokenContract.balanceOf(wallet.address);
+    if (balance < amount) {
+      console.error(`Insufficient ${symbol} balance: ${formatUnits(balance, decimals)} < ${opts.amount}`);
+      process.exit(1);
+    }
+    if (opts.dryRun) {
+      console.log("[Dry Run] Transaction details:");
+      printJson({
+        from: wallet.address,
+        to: opts.to,
+        token: opts.token,
+        symbol,
+        amount: opts.amount,
+        amountWei: amount.toString(),
+        decimals,
+        chainId: opts.chainId
+      });
+      return;
+    }
+    console.log(`Sending ${opts.amount} ${symbol} to ${opts.to} on chain ${opts.chainId}...`);
+    const txOverrides = {};
+    if (opts.gasLimit) {
+      txOverrides.gasLimit = BigInt(opts.gasLimit);
+    }
+    const isWanchain = opts.chainId === "888";
+    if (isWanchain) {
+      const feeData = await provider.getFeeData();
+      const minBaseFee = parseUnits("1", "gwei");
+      if (feeData.gasPrice && feeData.gasPrice < minBaseFee) {
+        txOverrides.gasPrice = minBaseFee;
+        console.log("Wanchain: enforcing minimum gasPrice of 1 gwei");
+      } else if (feeData.maxFeePerGas) {
+        const maxFee = feeData.maxFeePerGas < minBaseFee ? minBaseFee : feeData.maxFeePerGas;
+        txOverrides.gasPrice = maxFee;
+        console.log(`Wanchain: using gasPrice ${formatUnits(maxFee, "gwei")} gwei`);
+      }
+    }
+    const sentTx = await tokenContract.transfer(opts.to, amount, txOverrides);
+    console.log(`Transaction hash: ${sentTx.hash}`);
+    console.log("Waiting for confirmation...");
+    const receipt = await sentTx.wait();
+    console.log(`Transaction confirmed in block ${receipt?.blockNumber}`);
+    console.log(`Gas used: ${receipt?.gasUsed.toString()}`);
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+});
 program2.command("status").description(`Check cross-chain transaction status
 
 ` + `Status codes:

package/package.json

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