@botwallet/cli 0.1.0-beta.1

package/README.md

@@ -0,0 +1,79 @@
+# @botwallet/cli
+
+Command-line interface for AI agents to manage their Botwallet accounts.
+
+## Installation
+
+```bash
+npm install -g @botwallet/cli
+```
+
+## Quick Start
+
+```bash
+# Register a new wallet (FROST threshold key generation)
+botwallet register --name "My Agent Wallet" --owner human@example.com
+
+# Check your balance (after wallet is claimed)
+botwallet wallet balance
+
+# Two-step payment flow
+botwallet pay @merchant 10.00              # Step 1: Create intent
+botwallet pay confirm <transaction_id>     # Step 2: FROST sign & submit
+```
+
+`register` is the recommended way to create a wallet. `wallet create` does the same thing.
+
+## Commands
+
+| Group | Commands |
+|-------|----------|
+| `wallet` | `create`, `info`, `balance`, `list`, `use`, `deposit`, `owner`, `backup`, `export`, `import` |
+| `pay` | `(default)`, `confirm`, `preview`, `list`, `cancel` |
+| `paylink` | `create`, `send`, `get`, `list`, `cancel` |
+| `fund` | `(default)`, `ask`, `list` |
+| `withdraw` | `(default)`, `confirm`, `get` |
+| `x402` | `fetch`, `fetch confirm`, `discover` |
+| Utilities | `register`, `history`, `limits`, `approvals`, `approval status`, `events`, `lookup`, `ping`, `version`, `docs` |
+
+Run `botwallet docs` for full embedded documentation.
+
+## Output Modes
+
+- **JSON (default)** — Machine-readable for bots and scripts
+- **`--human`** — Formatted output with colors and tips
+
+## Authentication
+
+Credentials are saved automatically on `register`. Or set manually:
+
+```bash
+export BOTWALLET_API_KEY="bw_bot_your_key_here"
+```
+
+Use `--wallet <name>` to switch between multiple wallets, or `--api-key` for explicit auth.
+
+## Two-Step Flows
+
+Payments, withdrawals, and x402 API access use a two-step flow:
+
+1. **Create intent** — CLI validates, server checks guard rails
+2. **Confirm** — FROST threshold signing (agent + server cooperate), then submit to Solana
+
+This ensures neither party can sign alone.
+
+## Alternative Installation
+
+### Direct Download
+
+Download from [GitHub Releases](https://github.com/botwallet-co/agent-cli/releases).
+
+### From Source
+
+```bash
+go install github.com/botwallet-co/agent-cli@latest
+```
+
+## License
+
+Apache 2.0 — See [LICENSE](../LICENSE) for details.

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@botwallet/cli",
+  "version": "0.1.0-beta.1",
+  "description": "CLI for AI agents to manage their Botwallet accounts",
+  "keywords": [
+    "botwallet",
+    "ai",
+    "agent",
+    "cli",
+    "payments",
+    "wallet",
+    "cryptocurrency",
+    "solana",
+    "usdc"
+  ],
+  "homepage": "https://botwallet.co",
+  "bugs": {
+    "url": "https://github.com/botwallet-co/agent-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/botwallet-co/agent-cli.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Botwallet <support@botwallet.co>",
+  "bin": {
+    "botwallet": "./bin/botwallet"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+// =============================================================================
+// Botwallet CLI npm postinstall script
+// =============================================================================
+// Downloads the appropriate binary for the user's platform.
+// =============================================================================
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const PACKAGE_VERSION = require('../package.json').version;
+const GITHUB_RELEASE_URL = `https://github.com/botwallet-co/agent-cli/releases/download/v${PACKAGE_VERSION}`;
+
+// Platform mapping
+const PLATFORM_MAP = {
+  darwin: 'darwin',
+  linux: 'linux',
+  win32: 'windows'
+};
+
+const ARCH_MAP = {
+  x64: 'amd64',
+  arm64: 'arm64'
+};
+
+function getPlatform() {
+  const platform = PLATFORM_MAP[process.platform];
+  if (!platform) {
+    throw new Error(`Unsupported platform: ${process.platform}`);
+  }
+  return platform;
+}
+
+function getArch() {
+  const arch = ARCH_MAP[process.arch];
+  if (!arch) {
+    throw new Error(`Unsupported architecture: ${process.arch}`);
+  }
+  return arch;
+}
+
+function getBinaryName() {
+  const platform = getPlatform();
+  const arch = getArch();
+  const ext = platform === 'windows' ? '.exe' : '';
+  return `botwallet_${PACKAGE_VERSION}_${platform}_${arch}${ext}`;
+}
+
+function getArchiveName() {
+  const platform = getPlatform();
+  const arch = getArch();
+  const ext = platform === 'windows' ? 'zip' : 'tar.gz';
+  return `botwallet_${PACKAGE_VERSION}_${platform}_${arch}.${ext}`;
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    
+    const request = https.get(url, (response) => {
+      // Handle redirects
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        file.close();
+        fs.unlinkSync(dest);
+        return downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+      }
+      
+      if (response.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(dest);
+        reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+        return;
+      }
+      
+      response.pipe(file);
+      
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    });
+    
+    request.on('error', (err) => {
+      fs.unlink(dest, () => {}); // Delete partial file
+      reject(err);
+    });
+  });
+}
+
+function extractArchive(archivePath, destDir) {
+  const platform = getPlatform();
+  
+  if (platform === 'windows') {
+    // Use PowerShell to extract zip
+    execSync(`powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${destDir}' -Force"`, {
+      stdio: 'inherit'
+    });
+  } else {
+    // Use tar for tar.gz
+    execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, {
+      stdio: 'inherit'
+    });
+  }
+}
+
+async function install() {
+  console.log('Installing Botwallet CLI...');
+  
+  const binDir = path.join(__dirname, '..', 'bin');
+  const tmpDir = path.join(__dirname, '..', 'tmp');
+  
+  // Create directories
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+  if (!fs.existsSync(tmpDir)) {
+    fs.mkdirSync(tmpDir, { recursive: true });
+  }
+  
+  try {
+    const archiveName = getArchiveName();
+    const archiveUrl = `${GITHUB_RELEASE_URL}/${archiveName}`;
+    const archivePath = path.join(tmpDir, archiveName);
+    
+    console.log(`Downloading ${archiveName}...`);
+    await downloadFile(archiveUrl, archivePath);
+    
+    console.log('Extracting...');
+    extractArchive(archivePath, tmpDir);
+    
+    // Move binary to bin directory
+    const platform = getPlatform();
+    const srcBinary = path.join(tmpDir, platform === 'windows' ? 'botwallet.exe' : 'botwallet');
+    const destBinary = path.join(binDir, platform === 'windows' ? 'botwallet.exe' : 'botwallet');
+    
+    // Handle case where binary is inside the archive with full name
+    if (!fs.existsSync(srcBinary)) {
+      const binaryName = getBinaryName();
+      const altSrcBinary = path.join(tmpDir, binaryName);
+      if (fs.existsSync(altSrcBinary)) {
+        fs.renameSync(altSrcBinary, destBinary);
+      } else {
+        throw new Error(`Binary not found in archive: ${srcBinary} or ${altSrcBinary}`);
+      }
+    } else {
+      fs.renameSync(srcBinary, destBinary);
+    }
+    
+    // Make executable on Unix
+    if (platform !== 'windows') {
+      fs.chmodSync(destBinary, 0o755);
+    }
+    
+    // Clean up
+    fs.rmSync(tmpDir, { recursive: true });
+    
+    console.log('Botwallet CLI installed successfully!');
+    console.log('Run "botwallet --help" to get started.');
+    
+  } catch (error) {
+    console.error('Installation failed:', error.message);
+    console.error('');
+    console.error('You can manually download the binary from:');
+    console.error(`https://github.com/botwallet-co/agent-cli/releases/tag/v${PACKAGE_VERSION}`);
+    process.exit(1);
+  }
+}
+
+// Run installation
+install();
+
+
+
+
+
+
+
+