@agenttech/tpay-cli 0.0.1 → 0.0.2

package/README.md

@@ -1,6 +1,6 @@
-# @agentpay/tpay-cli
+# @agenttech/tpay-cli
 
-A CLI for AI agents to send USDC/USDT via the T402 x402 v2 payment protocol.
+A CLI for AI agents to send USDT via the T402 x402 v2 payment protocol on Solana.
 Output defaults to structured JSON. Use `--format text` for human-readable output. Logs go to stderr.
 
 ## Commands
@@ -9,7 +9,8 @@ Output defaults to structured JSON. Use `--format text` for human-readable outpu
 |---|---|
 | `tpay setup` | Configure wallet keys interactively |
 | `tpay setup --from-env <file>` | Import keys from an env file |
-| `tpay send --to <addr> --amount <n> --chain <chain>` | Send payment |
+| `tpay send --to <addr> --amount <n>` | Send payment |
+| `tpay balance --address <addr>` | Show wallet SOL and USDT balances |
 | `tpay intent status <intent_id>` | Check payment status |
 | `tpay version` | Print version |
 | `tpay help` / `tpay --help` | Show all commands |
@@ -21,36 +22,39 @@ Global flags:
 
 ```bash
 # JSON output (default, for programmatic use)
-tpay send --to 0x... --amount 10 --chain base
+tpay send --to <solana-address> --amount 10
 {"status":"success","intent_id":"...","tx_hash":"...","explorer_url":"..."}
 
 # Text output (human-readable)
-tpay send --to 0x... --amount 10 --chain base --format text
+tpay send --to <solana-address> --amount 10 --format text
 status: success
 intent_id: abc123
-tx_hash: 0x...
+tx_hash: ...
 explorer_url: https://...
 ```
 
-Stdin JSON mode: pipe `{"to":"...","amount":"...","chain":"..."}` to `tpay send`.
+```bash
+# Check wallet balance (read-only, no keys needed)
+tpay balance --address <solana-address>
+{"status":"ok","address":"<solana-address>","sol":"0.5","usdt":"100.0"}
+```
+
+Stdin JSON mode: pipe `{"to":"...","amount":"..."}` to `tpay send`.
 
 ## Supported Chains
 
-| `--chain` value | Network |
-|---|---|
-| `base` | Base Mainnet (EVM) |
-| `bsc` | BSC Mainnet (EVM) |
-| `base-sepolia` | Base Sepolia (EVM testnet) |
-| `solana` | Solana Mainnet |
-| `solana-devnet` | Solana Devnet |
+| Network |
+|---|
+| Solana Mainnet |
+| Solana Devnet |
 
 ## Runtime Environment Variables
 
 | Variable | Required | Description |
 |---|---|---|
-| `WALLET_PROVIDER` | No (default: `env`) | Wallet plugin name |
-| `WALLET_SEED_PHRASE` | Yes (for Solana) | BIP-39 mnemonic seed phrase |
-| `WALLET_EVM_PRIVATE_KEY` | For EVM chains | Hex private key (`0x...`) |
+| `WALLET_SEED_PHRASE` | Yes | BIP-39 mnemonic seed phrase |
+| `TPAY_PASSPHRASE` | No | Passphrase for decrypting config file (cleared from env after use) |
+| `SOLANA_FEE_PAYER` | No | Override fee payer address (build-time default used if unset) |
 
 ## Build
 
@@ -66,7 +70,7 @@ bun build --compile src/index.ts --outfile tpay
 ```bash
 bun install
 bun test
-T402_API_URL=https://... WALLET_EVM_PRIVATE_KEY=0x... bun run src/index.ts send --to 0x... --amount 1 --chain base
+WALLET_SEED_PHRASE="..." bun run src/index.ts send --to <solana-address> --amount 1
 ```
 
 ## Adding a New Chain Plugin
@@ -76,12 +80,3 @@ T402_API_URL=https://... WALLET_EVM_PRIVATE_KEY=0x... bun run src/index.ts send
 - [ ] Add to `CHAIN_PLUGIN_LOADERS` in `src/loader.ts`
 - [ ] Add to Supported Chains table above
 - [ ] Test: verify x402 payload structure matches T402 backend
-
-## Adding a New Wallet Plugin
-
-- [ ] Create `src/plugins/wallets/<name>.ts`
-- [ ] Implement `WalletPlugin` interface (`name`, `getEvmPrivateKey()`, `getSolanaSeed()`)
-- [ ] Add to `WALLET_PLUGINS` map in `src/loader.ts`
-- [ ] Document required env vars above
-- [ ] Ensure key/seed return values are never logged
-- [ ] Test: verify loads when `WALLET_PROVIDER=<name>` is set

package/dist/index.js

@@ -64009,6 +64009,7 @@ async function runHelp(ctx) {
     commands: {
       setup: 'Configure wallet keys with encryption. Use --from-env <file> to import. Non-interactive: WALLET_SEED_PHRASE="..." TPAY_PASSPHRASE="..." tpay setup',
       send: "Send USDC/USDT via T402. Args: --to, --amount",
+      balance: "Show wallet SOL and USDT balances",
       "intent status <intent_id>": "Fetch current status of a payment intent",
       version: "Print CLI version",
       help: "Show this help"
@@ -64036,7 +64037,7 @@ async function runHelp(ctx) {
 async function runVersion(ctx) {
   output(ctx.format, {
     name: "@agenttech/tpay-cli",
-    version: "0.0.1"
+    version: "0.0.2"
   });
   return 0;
 }
@@ -64236,7 +64237,6 @@ var CONFIG = {
     feePayer: ""
   }
 };
-console.log("CONFIG", CONFIG);
 
 class SendCommand extends BaseCommand {
   async execute(opts) {
@@ -64344,12 +64344,85 @@ async function runIntentStatus(ctx, intentId) {
   return command.execute(intentId);
 }
 
+// src/cli/commands/balance.ts
+init_index_cjs();
+var CONFIG3 = {
+  apiUrl: "https://api-staging-t402-pay.agent.tech",
+  solana: {
+    rpcUrl: "https://api.mainnet-beta.solana.com",
+    feePayer: ""
+  }
+};
+var USDT_MINT = new $PublicKey("Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB");
+var TOKEN_PROGRAM_ID2 = new $PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+var LAMPORTS_PER_SOL = 1000000000n;
+var USDT_DECIMALS = 6;
+
+class BalanceCommand extends BaseCommand {
+  async execute(opts) {
+    const address3 = this.requireArg(opts.address, "address");
+    let pubkey;
+    try {
+      pubkey = new $PublicKey(address3);
+    } catch {
+      throw new ValidationError(`Invalid Solana address: ${address3}`);
+    }
+    const connection = new $Connection(CONFIG3.solana.rpcUrl);
+    try {
+      this.ctx.logger.debug("Fetching balances", { address: address3 });
+      const [solLamports, tokenAccounts] = await Promise.all([
+        connection.getBalance(pubkey),
+        connection.getParsedTokenAccountsByOwner(pubkey, { mint: USDT_MINT, programId: TOKEN_PROGRAM_ID2 })
+      ]);
+      let usdtRaw = 0n;
+      for (const { account } of tokenAccounts.value) {
+        const amount = account.data.parsed?.info?.tokenAmount?.amount;
+        if (amount)
+          usdtRaw += BigInt(amount);
+      }
+      output(this.ctx.format, {
+        status: "ok",
+        address: address3,
+        sol: formatLamports(BigInt(solLamports)),
+        usdt: formatToken(usdtRaw, USDT_DECIMALS)
+      });
+      return 0;
+    } catch (error) {
+      if (error instanceof ValidationError)
+        throw error;
+      if (error instanceof Error && error.message.includes("Server error")) {
+        throw new NetworkError(error.message, error);
+      }
+      throw error;
+    }
+  }
+}
+function formatLamports(lamports) {
+  const whole = lamports / LAMPORTS_PER_SOL;
+  const frac = lamports % LAMPORTS_PER_SOL;
+  if (frac === 0n)
+    return whole.toString();
+  return `${whole}.${frac.toString().padStart(9, "0").replace(/0+$/, "")}`;
+}
+function formatToken(raw, decimals) {
+  const divisor = 10n ** BigInt(decimals);
+  const whole = raw / divisor;
+  const frac = raw % divisor;
+  if (frac === 0n)
+    return whole.toString();
+  return `${whole}.${frac.toString().padStart(decimals, "0").replace(/0+$/, "")}`;
+}
+async function runBalance(ctx, opts) {
+  const command = new BalanceCommand(ctx);
+  return command.execute(opts);
+}
+
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command;
   const versionInfo = {
     name: "@agenttech/tpay-cli",
-    version: "0.0.1"
+    version: "0.0.2"
   };
   const versionString = typeof versionInfo === "string" ? versionInfo : versionInfo.version;
   program2.name("tpay").version(versionString, "-v, --version", "Show version").option("--verbose", "Enable debug logging to stderr").option("--format <fmt>", "Output format: json | text", "json");
@@ -64389,6 +64462,9 @@ function registerCommands(program2) {
     await loadEnv();
     process.exitCode = await runSend(getContext(), opts);
   });
+  program2.command("balance").description("Show wallet SOL and USDT balances").option("--address <addr>", "Solana wallet address to query").action(async (opts) => {
+    process.exitCode = await runBalance(getContext(), opts);
+  });
   const intentCmd = program2.command("intent").description("Payment intent operations");
   intentCmd.command("status [intentId]").description("Check payment intent status").action(async (intentId) => {
     process.exitCode = await runIntentStatus(getContext(), intentId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenttech/tpay-cli",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "T402 CLI for agent automation",
   "type": "module",
   "main": "dist/index.js",