clawcloud 1.0.0 → 1.0.1

package/README.md

@@ -1,178 +1,313 @@
-# ClawCloud CLI
+# 🦞 ClawCloud CLI
 
-☁️ **Cloud infrastructure AI agents can own**
+Decentralized cloud infrastructure for AI agents. Purchase and manage VMs with crypto on Base.
 
-Command-line interface for managing ClawCloud - autonomous cloud VMs purchased with crypto, owned as NFTs.
-
-## Quick Start
+## 🚀 Quick Start
 
 ```bash
-npx clawcloud
+# Check available VM tiers
+npx clawcloud tiers
+
+# Purchase a VM
+npx clawcloud purchase
+
+# List your VMs
+npx clawcloud list
+
+# Get VM credentials
+npx clawcloud get <tokenId>
 ```
 
-## Installation
+## 📦 Installation
 
-### Use with npx (recommended)
+### Option 1: npx (No installation needed)
+```bash
+npx clawcloud <command>
+```
 
+### Option 2: Global Install
 ```bash
-npx clawcloud register
+npm install -g clawcloud
+clawcloud <command>
 ```
 
-### Install globally
+## 🎯 Features
 
+- ✅ Purchase VMs with USDC on Base
+- ✅ Ownership via ERC-721 NFTs
+- ✅ Automatic VM provisioning
+- ✅ SSH credential retrieval
+- ✅ Wallet management
+- ✅ Balance checking
+
+## 📋 Commands
+
+### Purchase & Manage
 ```bash
-npm install -g clawcloud
-clawcloud register
+clawcloud purchase              # Purchase a new VM
+clawcloud get <tokenId>         # Get VM credentials
+clawcloud list                  # List your VMs
 ```
 
-## Getting Started
+### Information
+```bash
+clawcloud tiers                 # Show available VM tiers
+clawcloud balance               # Check wallet balance
+clawcloud info                  # Show contract/API info
+```
 
-### 1. Register Your Agent
+### Wallet
+```bash
+clawcloud wallet                # View/setup wallet
+```
 
+### Help
 ```bash
-npx clawcloud register
+clawcloud help                  # Show all commands
 ```
 
-You'll get an Agent ID like `agent_1738445234_k9x2m`
+## 🛠️ Setup
 
-### 2. Get Your Wallet (Telegram)
+### First Time Setup
 
-Open Telegram and message [@clawcloud_devbot](https://t.me/clawcloud_devbot):
+1. **Run any command** and the CLI will guide you through wallet setup:
+   ```bash
+   npx clawcloud tiers
+   ```
 
-```
-/start agent_1738445234_k9x2m
-```
+2. **Choose wallet option:**
+   - Import existing private key
+   - Generate new wallet
+
+3. **Fund your wallet:**
+   - Get ETH on Base (for gas): https://bridge.base.org
+   - Get USDC (for purchases): https://app.uniswap.org/swap?chain=base
+
+### Configuration
+
+Config is stored in: `~/.clawcloud/config.json`
+
+**Security Note:** Never share your private key or config file!
 
-The bot will:
-- Verify your agent ID
-- Create a wallet
-- Send you the private key
-- Provide funding instructions
+## 💰 Pricing
 
-### 3. Configure CLI
+| Tier | Name | Per Day | Per Month |
+|------|------|---------|-----------|
+| 0 | CPU-Basic-1vCPU-1GB | $0.50 | $15.00 |
+| 1 | CPU-Standard-2vCPU-4GB | $1.00 | $30.00 |
+| 2 | CPU-Performance-4vCPU-8GB | $2.00 | $60.00 |
+| 3 | CPU-HighMem-8vCPU-16GB | $4.00 | $120.00 |
+| 4 | GPU-T4-4vCPU-16GB | $8.00 | $240.00 |
+| 5 | GPU-V100-8vCPU-32GB | $16.00 | $480.00 |
+| 6 | GPU-A100-16vCPU-64GB | $32.00 | $960.00 |
+| 7 | GPU-H100-32vCPU-128GB | $64.00 | $1,920.00 |
+
+*Prices in USDC. Minimum 3-day purchase required.*
+
+## 🔐 Security
+
+- **Private keys are stored locally** in `~/.clawcloud/config.json`
+- **Never share your private key** with anyone
+- **Use a dedicated wallet** for ClawCloud operations
+- **Backup your private key** securely
+
+## 📖 Examples
+
+### Purchase a VM
 
 ```bash
-npx clawcloud configure
+$ npx clawcloud purchase
+
+🦞 Wallet: 0x1234...5678
+📊 Available Tiers:
+
+0. CPU-Basic-1vCPU-1GB - $0.50/day ($15.00/month)
+1. CPU-Standard-2vCPU-4GB - $1.00/day ($30.00/month)
+...
+
+Choose tier (0-7): 4
+Duration in days (3+ recommended): 7
+
+💰 Total cost: $56.00 USDC
+Proceed with purchase? (y/n): y
+
+✅ USDC balance: $100.00 ✅
+⏳ Approving USDC...
+✅ USDC approved!
+⏳ Purchasing VM...
+✅ VM purchased successfully! 🎉
+
+Token ID: 42
+Tier: 4
+Duration: 7 days
+
+⏳ VM is provisioning... This takes 2-3 minutes.
+Get credentials: npx clawcloud get 42
 ```
 
-Enter your Agent ID and private key from Telegram.
+### Get VM Credentials
+
+```bash
+$ npx clawcloud get 42
+
+⏳ Fetching credentials for VM #42...
+✅ VM credentials retrieved!
+
+======================================================================
+🖥️  VM #42 - GPU-EXTERNAL
+======================================================================
+Tier:      4
+Host:      rentals-xxxxx.ssh.deployments.targon.com
+Username:  root
+Expires:   Feb 9, 2026, 12:00:00 PM
 
-### 4. Make Your Agent Autonomous
+📝 SSH Command:
+   ssh rentals-xxxxx.ssh.deployments.targon.com
+
+======================================================================
+```
+
+### List Your VMs
 
 ```bash
-npx clawcloud export
+$ npx clawcloud list
+
+⏳ Fetching VMs for 0x1234...5678...
+✅ Found 2 VM(s)
+
+==========================================================================================
+Your VMs:
+==========================================================================================
+
+✅ VM #42
+   Tier:      4
+   Type:      gpu-external
+   Host:      rentals-xxxxx.ssh.deployments.targon.com
+   Status:    running
+   Created:   Feb 2, 2026, 10:30:00 AM
+   Expires:   Feb 9, 2026, 10:30:00 AM
+   Access:    npx clawcloud get 42
+
+✅ VM #43
+   Tier:      1
+   Type:      gcp
+   Host:      35.123.45.67
+   Status:    running
+   Created:   Feb 2, 2026, 11:00:00 AM
+   Expires:   Feb 5, 2026, 11:00:00 AM
+   Access:    npx clawcloud get 43
+
+==========================================================================================
 ```
 
-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
+### Check Balance
 
-## Commands
+```bash
+$ npx clawcloud balance
 
-### Setup
-- `npx clawcloud` - Interactive menu
-- `npx clawcloud register` - Register new agent
-- `npx clawcloud configure` - Link wallet after Telegram
-- `npx clawcloud fund` - Show funding instructions
+⏳ Checking balances...
 
-### Autonomous Mode
-- `npx clawcloud export` - Export for autonomous agents
-- `npx clawcloud export --framework openclaw` - Install OpenClaw skill
+💰 Wallet Balances:
+   Address: 0x1234567890123456789012345678901234567890
+   ETH:     0.05 ETH (for gas)
+   USDC:    $100.00 USDC
+```
 
-### Wallet & Balance
-- `npx clawcloud balance` - Check USDC balance
+## 🌐 Network Details
 
-### 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
+**Network:** Base Mainnet  
+**Chain ID:** 8453  
+**RPC:** https://mainnet.base.org
 
-### Help
-- `npx clawcloud help` - Detailed help
-- `npx clawcloud docs` - Open documentation
+**Smart Contract:** `0xF708741D37C420518852c6A15aB658066951c852`  
+**USDC Token:** `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`  
+**API:** https://api.clawcloud.co
+
+**Explorer:** https://basescan.org/address/0xF708741D37C420518852c6A15aB658066951c852
 
-## Autonomous Agent Example
+## 🛠️ For Developers
 
-After running `npx clawcloud export`, your agent can:
+### Using in Your Application
 
 ```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');
-}
+const { exec } = require('child_process');
+const util = require('util');
+const execPromise = util.promisify(exec);
+
+// Purchase VM
+const { stdout } = await execPromise('npx clawcloud purchase');
+console.log(stdout);
+
+// Get credentials
+const { stdout: creds } = await execPromise('npx clawcloud get 42');
+console.log(creds);
 ```
 
-## NFTs
+### API Integration
 
-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
+For programmatic access, use the REST API directly:
 
-View your NFTs on [OpenSea](https://opensea.io) or [BaseScan](https://basescan.org).
+```bash
+# API Documentation
+https://api.clawcloud.co/docs
+
+# Get tiers
+curl https://api.clawcloud.co/tiers
 
-## Features
+# Get credentials (requires signature)
+curl -H "Authorization: Bearer $SIGNATURE" \
+  https://api.clawcloud.co/credentials/42
+```
 
-- 🤖 **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
+## 🐛 Troubleshooting
 
-## Requirements
+### "Insufficient USDC" Error
+- Buy USDC on Base: https://app.uniswap.org/swap?chain=base
+- Bridge USDC to Base: https://bridge.base.org
+
+### "Insufficient funds for gas" Error
+- Bridge ETH to Base: https://bridge.base.org
+- You need ~0.001 ETH for gas
+
+### "VM still provisioning" Message
+- Wait 2-3 minutes after purchase
+- Try getting credentials again: `npx clawcloud get <tokenId>`
+
+### "Invalid signature" Error
+- Make sure you own the NFT for the token ID
+- Check that you're using the correct wallet
+
+### CLI Config Issues
+```bash
+# Remove config and start fresh
+rm -rf ~/.clawcloud
+npx clawcloud wallet
+```
 
-- Node.js >= 18.0.0
-- USDC on Base blockchain
-- Telegram account (for wallet setup)
+## 🆘 Support
 
-## Configuration
+- **Documentation:** https://docs.clawcloud.co
+- **Discord:** discord.gg/clawcloud
+- **Twitter:** @ClawCloud
+- **GitHub Issues:** https://github.com/clawcloud/clawcloud-cli/issues
 
-Config stored in `~/.clawcloud/`:
-- `agents.json` - Registered agents
-- `wallet.json` - Wallet configuration (secure!)
-- `config.json` - API endpoints and settings
+## 📜 License
 
-## Links
+MIT License - see LICENSE file for details
 
-- **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
+## 🚀 Roadmap
 
-## Support
+- [ ] Web dashboard
+- [ ] VM management (restart, resize)
+- [ ] Custom images/templates
+- [ ] Team/organization accounts
+- [ ] Volume attachments
+- [ ] Networking configuration
+- [ ] Monitoring & alerts
 
-- 💬 Telegram: https://t.me/clawcloud
-- 🐛 Issues: https://github.com/clawcloud/clawcloud/issues
-- 📧 Email: support@clawcloud.co
+---
 
-## License
+**Built with ❤️ for autonomous AI agents**  
+Powered by Base, Railway, and Targon
 
-MIT © ClawCloud
+🦞 LFG!