@clawdvault/cli 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,147 @@
+# @clawdvault/cli
+
+Command-line interface for [ClawdVault](https://clawdvault.com) - a pump.fun-style token launchpad on Solana.
+
+## Installation
+
+```bash
+npm install -g @clawdvault/cli
+```
+
+Or use without installing:
+
+```bash
+npx @clawdvault/cli tokens list
+```
+
+## Quick Start
+
+### Setup Wallet
+
+```bash
+# Generate a new wallet
+clawdvault wallet init
+
+# Or use an existing Solana CLI wallet
+export CLAWDVAULT_WALLET=~/.config/solana/id.json
+```
+
+### Read Operations (No Wallet Required)
+
+```bash
+# List featured tokens
+clawdvault tokens list
+
+# Get token details
+clawdvault token get TOKEN_MINT_ADDRESS
+
+# Get price quote
+clawdvault trade quote -m TOKEN_MINT_ADDRESS -t buy -a 0.1
+
+# Check SOL price
+clawdvault wallet sol-price
+```
+
+### Write Operations (Wallet Required)
+
+```bash
+# Create a new token
+clawdvault token create --name "My Token" --symbol "MYTOK" --image ./image.png
+
+# Buy tokens
+clawdvault trade buy --mint TOKEN_MINT_ADDRESS --sol 0.1
+
+# Sell tokens (by amount)
+clawdvault trade sell --mint TOKEN_MINT_ADDRESS --amount 1000000
+
+# Sell by percentage
+clawdvault trade sell --mint TOKEN_MINT_ADDRESS --percent 50
+
+# Native SOL transfer
+clawdvault wallet transfer --to RECIPIENT_ADDRESS --sol 0.5
+```
+
+### Wallet Operations
+
+```bash
+# Show wallet info
+clawdvault wallet info
+
+# Check SOL balance
+clawdvault wallet sol-balance
+
+# Check token balance
+clawdvault wallet balance -m TOKEN_MINT_ADDRESS
+
+# Get deposit address
+clawdvault wallet address
+
+# Request devnet SOL (devnet only)
+clawdvault wallet airdrop --sol 1
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Wallet path
+export CLAWDVAULT_WALLET=~/.config/solana/id.json
+
+# Custom API endpoint
+export CLAWDVAULT_API_URL=https://clawdvault.com/api
+
+# Solana RPC (default: mainnet)
+export SOLANA_RPC_URL=https://api.devnet.solana.com
+```
+
+### Global Options
+
+All commands support:
+
+```bash
+-w, --wallet <path>    # Specify wallet file
+--rpc <url>            # Specify RPC endpoint
+--json                 # Output as JSON
+```
+
+## Examples
+
+### Create and Launch a Token
+
+```bash
+# 1. Generate wallet (first time only)
+clawdvault wallet init
+
+# 2. Check your address
+clawdvault wallet address
+
+# 3. Fund with SOL (or use airdrop on devnet)
+clawdvault wallet airdrop --sol 2
+
+# 4. Create token
+clawdvault token create \
+  --name "Moon Shot" \
+  --symbol "MOON" \
+  --description "To the moon!" \
+  --image ./moon.png \
+  --twitter @moonshot \
+  --website https://moonshot.io
+
+# 5. Check your token
+clawdvault token get YOUR_TOKEN_MINT
+
+# 6. Buy more (optional)
+clawdvault trade buy --mint YOUR_TOKEN_MINT --sol 0.5
+```
+
+## Network Support
+
+- **Mainnet**: Production trading with real SOL
+- **Devnet**: Free testing with faucet SOL
+
+Use `--rpc https://api.devnet.solana.com` or set `SOLANA_RPC_URL` for devnet.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdvault/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for ClawdVault - Solana token launchpad",
   "main": "dist/index.js",
   "bin": {
@@ -15,7 +15,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@clawdvault/sdk": "^0.1.0",
+    "@clawdvault/sdk": "^0.1.1",
     "@solana/spl-token": "^0.4.0",
     "@solana/web3.js": "^1.91.0",
     "bs58": "^5.0.0",