clawcloud 1.0.0

package/README.md

@@ -0,0 +1,178 @@
+# ClawCloud CLI
+
+☁️ **Cloud infrastructure AI agents can own**
+
+Command-line interface for managing ClawCloud - autonomous cloud VMs purchased with crypto, owned as NFTs.
+
+## Quick Start
+
+```bash
+npx clawcloud
+```
+
+## Installation
+
+### Use with npx (recommended)
+
+```bash
+npx clawcloud register
+```
+
+### Install globally
+
+```bash
+npm install -g clawcloud
+clawcloud register
+```
+
+## Getting Started
+
+### 1. Register Your Agent
+
+```bash
+npx clawcloud register
+```
+
+You'll get an Agent ID like `agent_1738445234_k9x2m`
+
+### 2. Get Your Wallet (Telegram)
+
+Open Telegram and message [@clawcloud_devbot](https://t.me/clawcloud_devbot):
+
+```
+/start agent_1738445234_k9x2m
+```
+
+The bot will:
+- Verify your agent ID
+- Create a wallet
+- Send you the private key
+- Provide funding instructions
+
+### 3. Configure CLI
+
+```bash
+npx clawcloud configure
+```
+
+Enter your Agent ID and private key from Telegram.
+
+### 4. Make Your Agent Autonomous
+
+```bash
+npx clawcloud export
+```
+
+Choose your framework:
+- **OpenClaw / Clawd / Molt** - Installs skill automatically
+- **Node.js SDK** - Exports config for custom agents
+- **Python SDK** - Coming soon
+- **Environment Variables** - For any language
+
+## Commands
+
+### Setup
+- `npx clawcloud` - Interactive menu
+- `npx clawcloud register` - Register new agent
+- `npx clawcloud configure` - Link wallet after Telegram
+- `npx clawcloud fund` - Show funding instructions
+
+### Autonomous Mode
+- `npx clawcloud export` - Export for autonomous agents
+- `npx clawcloud export --framework openclaw` - Install OpenClaw skill
+
+### Wallet & Balance
+- `npx clawcloud balance` - Check USDC balance
+
+### VMs & NFTs
+- `npx clawcloud list` - List your VMs and NFTs
+- `npx clawcloud status <nft-id>` - View NFT/VM details
+- `npx clawcloud ssh <nft-id>` - SSH into VM
+- `npx clawcloud transfer <nft-id>` - Transfer NFT/VM ownership
+- `npx clawcloud terminate <nft-id>` - Destroy VM & burn NFT
+
+### Help
+- `npx clawcloud help` - Detailed help
+- `npx clawcloud docs` - Open documentation
+
+## Autonomous Agent Example
+
+After running `npx clawcloud export`, your agent can:
+
+```javascript
+import ClawCloud from '@clawcloud/sdk';
+
+const cloud = new ClawCloud({
+  configPath: '~/.clawcloud/autonomous-config.json'
+});
+
+// Agent decides: "I need to run a backtest"
+const balance = await cloud.wallet.balance();
+
+if (balance > 10) {
+  // Purchase VM autonomously
+  const vm = await cloud.vms.purchase({
+    tier: 'SMALL',
+    months: 1
+  });
+  
+  // Wait for provisioning
+  await vm.waitReady();
+  
+  // Deploy code
+  await vm.deployCode('./my-strategy');
+  
+  // Run task
+  await vm.execute('npm run backtest');
+}
+```
+
+## NFTs
+
+When you purchase a VM:
+- An ERC-721 NFT is minted to your wallet
+- NFT token ID = VM identifier
+- Own the NFT = Own the VM
+- Transfer NFT = Transfer VM ownership
+
+View your NFTs on [OpenSea](https://opensea.io) or [BaseScan](https://basescan.org).
+
+## Features
+
+- 🤖 **Autonomous**: Agents purchase VMs on their own
+- 🎨 **NFT-Based**: VMs are owned as ERC-721 tokens
+- ⛓️ **Base Blockchain**: Fast, cheap transactions
+- ☁️ **Multi-Cloud**: GCP, AWS, private servers
+- 💰 **Pay-as-you-go**: Starting at $0.08/hour
+- 🔐 **Non-Custodial**: You control your keys
+
+## Requirements
+
+- Node.js >= 18.0.0
+- USDC on Base blockchain
+- Telegram account (for wallet setup)
+
+## Configuration
+
+Config stored in `~/.clawcloud/`:
+- `agents.json` - Registered agents
+- `wallet.json` - Wallet configuration (secure!)
+- `config.json` - API endpoints and settings
+
+## Links
+
+- **Website**: https://clawcloud.co
+- **Docs**: https://docs.clawcloud.co
+- **Telegram**: https://t.me/clawcloud_devbot
+- **GitHub**: https://github.com/clawcloud/clawcloud
+- **Twitter**: https://twitter.com/clawcloudx
+
+## Support
+
+- 💬 Telegram: https://t.me/clawcloud
+- 🐛 Issues: https://github.com/clawcloud/clawcloud/issues
+- 📧 Email: support@clawcloud.co
+
+## License
+
+MIT © ClawCloud

package/bin/clawcloud.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import { register } from '../src/commands/register.js';
+import { configure } from '../src/commands/configure.js';
+import { exportConfig } from '../src/commands/export.js';
+import { balance } from '../src/commands/balance.js';
+import { buy } from '../src/commands/buy.js';
+import { list } from '../src/commands/list.js';
+import { status } from '../src/commands/status.js';
+import { ssh } from '../src/commands/ssh.js';
+import { transfer } from '../src/commands/transfer.js';
+import { terminate } from '../src/commands/terminate.js';
+import { fund } from '../src/commands/fund.js';
+import { nfts } from '../src/commands/nfts.js';
+import { interactive } from '../src/commands/interactive.js';
+import { displayHelp } from '../src/utils/help.js';
+import { getVersion } from '../src/utils/version.js';
+
+const version = getVersion();
+
+program
+  .name('clawcloud')
+  .description('☁️  Cloud infrastructure AI agents can own')
+  .version(version, '-v, --version', 'Output the current version');
+
+// Interactive mode (default when no command)
+program
+  .action(() => {
+    interactive();
+  });
+
+// Registration & Setup
+program
+  .command('register')
+  .description('Register a new AI agent')
+  .action(register);
+
+program
+  .command('configure')
+  .description('Configure agent wallet after Telegram setup')
+  .action(configure);
+
+program
+  .command('fund')
+  .description('Show funding instructions')
+  .action(fund);
+
+// Autonomous Mode (Primary)
+program
+  .command('export')
+  .description('Export configuration for autonomous agents')
+  .option('-f, --framework <type>', 'Agent framework (openclaw, nodejs, python, env)', 'openclaw')
+  .option('-o, --output <path>', 'Output path')
+  .action(exportConfig);
+
+// Wallet & Balance
+program
+  .command('balance')
+  .alias('bal')
+  .description('Check USDC balance')
+  .option('--json', 'Output as JSON')
+  .action(balance);
+
+// NFT/VM Management
+program
+  .command('list')
+  .alias('ls')
+  .description('List your VMs and NFTs')
+  .option('--json', 'Output as JSON')
+  .action(list);
+
+program
+  .command('nfts')
+  .description('View your NFT collection')
+  .action(nfts);
+
+program
+  .command('status <nft-id>')
+  .description('View NFT and VM details')
+  .option('--json', 'Output as JSON')
+  .action(status);
+
+program
+  .command('buy')
+  .description('Purchase a VM (manual mode)')
+  .option('-t, --tier <tier>', 'VM tier (MICRO, SMALL, MEDIUM, LARGE, XLARGE)')
+  .option('-m, --months <months>', 'Duration in months (1-12)')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(buy);
+
+program
+  .command('renew <nft-id>')
+  .description('Renew/extend a VM')
+  .option('-m, --months <months>', 'Additional months')
+  .option('-y, --yes', 'Skip confirmation')
+  .action((nftId, options) => {
+    console.log(chalk.yellow('Renew feature coming soon!'));
+  });
+
+program
+  .command('ssh <nft-id>')
+  .description('SSH into a VM')
+  .action(ssh);
+
+program
+  .command('transfer <nft-id>')
+  .description('Transfer NFT/VM to another address')
+  .option('-t, --to <address>', 'Recipient address')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(transfer);
+
+program
+  .command('terminate <nft-id>')
+  .alias('destroy')
+  .description('Destroy VM and burn NFT')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(terminate);
+
+// Documentation & Help
+program
+  .command('docs')
+  .description('Open documentation in browser')
+  .action(() => {
+    const { exec } = require('child_process');
+    exec('open https://docs.clawcloud.co');
+    console.log(chalk.blue('📖 Opening documentation...'));
+  });
+
+program
+  .command('help')
+  .description('Display detailed help')
+  .action(displayHelp);
+
+// Hidden dev commands
+program
+  .command('contract')
+  .description('Show contract addresses')
+  .option('--testnet', 'Show testnet contracts')
+  .action((options) => {
+    const { getConfig } = require('../src/utils/config.js');
+    const config = getConfig();
+    console.log(chalk.cyan('\n📝 Contract Addresses:\n'));
+    if (options.testnet) {
+      console.log(chalk.gray('Base Sepolia:'), '0x...');
+    } else {
+      console.log(chalk.gray('Base Mainnet:'), config.CONTRACT_ADDRESS || 'Not configured');
+    }
+  });
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  interactive();
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "clawcloud",
+  "version": "1.0.0",
+  "description": "☁️ Cloud infrastructure AI agents can own - CLI tool",
+  "main": "bin/clawcloud.js",
+  "type": "module",
+  "bin": {
+    "clawcloud": "./bin/clawcloud.js"
+  },
+  "scripts": {
+    "test": "echo \"Tests coming soon\"",
+    "prepublishOnly": "chmod +x bin/clawcloud.js"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cloud",
+    "vm",
+    "infrastructure",
+    "autonomous",
+    "blockchain",
+    "base",
+    "nft",
+    "openclaw",
+    "depin"
+  ],
+  "author": "ClawCloud",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawcloud/clawcloud.git",
+    "directory": "cli"
+  },
+  "homepage": "https://clawcloud.co",
+  "bugs": {
+    "url": "https://github.com/clawcloud/clawcloud/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "boxen": "^7.1.1",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^11.1.0",
+    "ethers": "^6.10.0",
+    "inquirer": "^9.2.12",
+    "ora": "^7.0.1"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/api/agents.js

@@ -0,0 +1,22 @@
+import { getConfig } from '../utils/config.js';
+
+export async function registerAgent(name, description) {
+  const config = getConfig();
+  
+  // TODO: Replace with real API call
+  // const response = await fetch(`${config.API_URL}/agents/register`, {
+  //   method: 'POST',
+  //   headers: { 'Content-Type': 'application/json' },
+  //   body: JSON.stringify({ name, description })
+  // });
+  
+  // Mock response for now
+  await new Promise(resolve => setTimeout(resolve, 1000));
+  
+  return {
+    agent_id: `agent_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+    name,
+    description,
+    created_at: new Date().toISOString()
+  };
+}

package/src/api/vms.js

@@ -0,0 +1,23 @@
+import { getConfig } from '../utils/config.js';
+
+export async function getVMs(address) {
+  const config = getConfig();
+  
+  // TODO: Replace with real API call
+  // const response = await fetch(`${config.API_URL}/vms?address=${address}`);
+  
+  // Mock response for now
+  await new Promise(resolve => setTimeout(resolve, 1000));
+  
+  return [
+    // Example: NFT #42, SMALL tier, active
+    // {
+    //   nft_id: 42,
+    //   tier: 'SMALL',
+    //   status: 'active',
+    //   ip_address: '34.123.45.67',
+    //   expires_at: '2026-02-28',
+    //   expires_in_days: 28
+    // }
+  ];
+}

package/src/api/wallet.js

@@ -0,0 +1,21 @@
+import { ethers } from 'ethers';
+import { getConfig } from '../utils/config.js';
+
+export async function getBalance(address) {
+  const config = getConfig();
+  
+  try {
+    const provider = new ethers.JsonRpcProvider(config.RPC_URL);
+    const usdcContract = new ethers.Contract(
+      config.USDC_ADDRESS,
+      ['function balanceOf(address) view returns (uint256)'],
+      provider
+    );
+    
+    const balance = await usdcContract.balanceOf(address);
+    return ethers.formatUnits(balance, 6); // USDC has 6 decimals
+  } catch (error) {
+    // Fallback for development
+    return '0.00';
+  }
+}

package/src/commands/balance.js

@@ -0,0 +1,27 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getWalletConfig } from '../utils/config.js';
+import { getBalance } from '../api/wallet.js';
+
+export async function balance(options = {}) {
+  const wallet = getWalletConfig();
+  
+  if (!wallet) {
+    console.log(chalk.red('\n❌ No wallet configured!\n'));
+    return;
+  }
+  
+  const spinner = ora('Checking balance...').start();
+  
+  try {
+    const bal = await getBalance(wallet.address);
+    spinner.succeed(`Balance: ${chalk.yellow(bal)} USDC`);
+    
+    if (options.json) {
+      console.log(JSON.stringify({ balance: bal, currency: 'USDC' }));
+    }
+  } catch (error) {
+    spinner.fail('Failed to check balance');
+    console.error(chalk.red(`Error: ${error.message}`));
+  }
+}

package/src/commands/buy.js

@@ -0,0 +1,8 @@
+import chalk from 'chalk';
+export async function buy(options = {}) {
+  console.log(chalk.yellow('\n⚠️  Manual Purchase Mode\n'));
+  console.log(chalk.white('Note: ClawCloud is designed for AUTONOMOUS agents.'));
+  console.log(chalk.white('      Your agent can purchase VMs on its own!\n'));
+  console.log(chalk.cyan('Run: npx clawcloud export\n'));
+  console.log(chalk.gray('Manual purchase coming soon...\n'));
+}

package/src/commands/configure.js

@@ -0,0 +1,86 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import boxen from 'boxen';
+import { ethers } from 'ethers';
+import { saveWallet, getAgent } from '../utils/config.js';
+import { getBalance } from '../api/wallet.js';
+
+export async function configure() {
+  console.log(chalk.cyan.bold('\n🔐 Configure Agent Wallet\n'));
+  
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'agentId',
+      message: 'Agent ID:',
+      validate: (input) => input.startsWith('agent_') || 'Invalid agent ID format'
+    },
+    {
+      type: 'password',
+      name: 'privateKey',
+      message: 'Private Key (from Telegram bot):',
+      validate: (input) => {
+        try {
+          new ethers.Wallet(input);
+          return true;
+        } catch {
+          return 'Invalid private key';
+        }
+      }
+    }
+  ]);
+  
+  const spinner = ora('Verifying...').start();
+  
+  try {
+    // Create wallet from private key
+    const wallet = new ethers.Wallet(answers.privateKey);
+    const address = wallet.address;
+    
+    // Get agent info
+    const agent = getAgent(answers.agentId);
+    
+    if (!agent) {
+      spinner.fail('Agent not found');
+      console.log(chalk.yellow(`\n⚠️  Agent ID not found locally. Did you run 'npx clawcloud register'?\n`));
+      return;
+    }
+    
+    // Save wallet configuration
+    saveWallet(answers.agentId, answers.privateKey, address);
+    
+    // Check balance
+    const balance = await getBalance(address);
+    
+    spinner.succeed('Agent Configured!');
+    
+    console.log(boxen(
+      chalk.bold.white(`Agent: ${chalk.cyan(agent.name)}\n`) +
+      chalk.white(`Wallet: ${chalk.green(address)}\n`) +
+      chalk.white(`Balance: ${chalk.yellow(balance)} USDC\n`) +
+      chalk.white(`Network: ${chalk.blue('Base')}\n\n`) +
+      chalk.yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n') +
+      (balance === '0.00' ? 
+        chalk.white.bold('💰 Fund your agent:\n') +
+        chalk.blue(`   https://clawcloud.co/fund/${answers.agentId}\n\n`) :
+        chalk.green.bold('✅ Agent is funded and ready!\n\n')
+      ) +
+      chalk.white('Next steps:\n') +
+      chalk.cyan('  npx clawcloud balance') + chalk.gray('      - Check USDC balance\n') +
+      chalk.cyan('  npx clawcloud export') + chalk.gray('       - Enable autonomous mode'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'green'
+      }
+    ));
+    
+    console.log(chalk.gray(`\n🔒 Wallet saved securely to: ~/.clawcloud/wallet.json\n`));
+    
+  } catch (error) {
+    spinner.fail('Configuration failed');
+    console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+  }
+}