@paylobster/cli 4.0.0 → 4.0.2

package/README.md

@@ -1,93 +1,33 @@
 # 🦞 PayLobster CLI (`plob`)
 
-Command-line interface for PayLobster - Payment infrastructure for AI agents.
-
-## Features
-
-- 🔐 **Wallet Management** - Secure keystore or environment variable authentication
-- 🆔 **Agent Registration** - Register your agent identity on-chain
-- 💰 **Payments & Escrow** - Create, list, and release escrow payments
-- ⭐ **Reputation** - Check agent reputation scores
-- 📊 **Status Dashboard** - View balances, credit, and account status
-- 🛠️ **Network Support** - Base Mainnet and Sepolia testnet
+Command-line interface for PayLobster — agent payment infrastructure on Base.
 
 ## Installation
 
-### From npm (when published)
-
 ```bash
 npm install -g @paylobster/cli
 ```
 
-### From source
-
-```bash
-git clone https://github.com/itsGustav/Pay-Lobster.git
-cd Pay-Lobster/cli
-npm install
-npm run build
-npm link
-```
-
 ## Quick Start
 
-### 1. Configure Network
-
 ```bash
-# Use Sepolia testnet (default)
-plob config set network sepolia
-
-# Or use mainnet
-plob config set network mainnet
-```
-
-### 2. Set Up Wallet
-
-```bash
-# Option 1: Use environment variable (recommended for production)
+# 1. Set up your wallet
+plob auth --private-key 0x...
+# Or use environment variable
 export PRIVATE_KEY="0x..."
 plob auth --env PRIVATE_KEY
 
-# Option 2: Save to encrypted keystore (development)
-plob auth --private-key 0x...
-```
+# 2. Configure network
+plob config set network mainnet    # Base Mainnet
+plob config set network sepolia    # Base Sepolia (testnet)
 
-### 3. Register Your Agent
+# 3. Register your agent
+plob register --name "my-agent" --capabilities "code-review,analysis"
 
-```bash
-plob register --name "my-coding-agent" --capabilities "code-review,bug-fix"
-```
-
-### 4. Check Status
-
-```bash
+# 4. Check status
 plob status
 ```
 
-Output:
-```
-🦞 PayLobster Agent Status
-────────────────────────────
-Name:     my-coding-agent
-Address:  0x742d...3f8a
-────────────────────────────
-Network:      Base Sepolia
-Registered:   ✅
-Agent ID:     42
-
-💰 Balances
-   USDC:      125.50 USDC
-   ETH:       0.05 ETH
-
-💳 Credit
-   Limit:     1000 USDC
-   Available: 750 USDC
-   In Use:    250 USDC
-
-⭐ Reputation: ★★★★☆ 85
-📦 Escrows:    3 total
-```
-
 ## Commands
 
 ### `plob auth`
@@ -95,95 +35,49 @@ Agent ID:     42
 Configure wallet authentication.
 
 ```bash
-# Use private key (saved to keystore)
-plob auth --private-key 0x...
-
-# Use environment variable
-plob auth --env PRIVATE_KEY
-
-# Check current wallet
-plob auth
+plob auth --private-key 0x...      # Save to keystore
+plob auth --env PRIVATE_KEY        # Use env variable
+plob auth                          # Show current wallet
 ```
 
 ### `plob config`
 
-Manage CLI configuration.
+Manage configuration.
 
 ```bash
-# Show current config
-plob config show
-
-# Set network
-plob config set network sepolia
-plob config set network mainnet
-
-# Set custom RPC
-plob config set rpcUrl https://your-rpc.com
-
-# Reset to defaults
-plob config reset
+plob config show                   # Show current config
+plob config set network mainnet    # Set network
+plob config set rpcUrl https://base-rpc.publicnode.com
+plob config reset                  # Reset to defaults
 ```
 
 ### `plob register`
 
-Register your agent identity on-chain.
+Register agent identity on-chain.
 
 ```bash
-plob register \
-  --name "my-agent" \
-  --capabilities "code-review,bug-fix,testing"
+plob register --name "my-agent" --capabilities "code-review,testing"
 ```
 
 ### `plob status`
 
-View your agent status, balances, and reputation.
-
-```bash
-# Pretty output
-plob status
-
-# JSON output
-plob status --json
-```
-
-### `plob escrow create`
-
-Create a new escrow payment.
+View agent status, balances, and reputation.
 
 ```bash
-plob escrow create \
-  --to 0x9a3c...7b21 \
-  --amount 50 \
-  --description "Code review for PR #123"
+plob status          # Pretty output
+plob status --json   # Machine-readable
 ```
 
-### `plob escrow list`
+### `plob escrow`
 
-List your escrows.
+Create and manage escrow payments.
 
 ```bash
+plob escrow create --to 0x... --amount 50
 plob escrow list
-plob escrow list --json
-```
-
-### `plob escrow get`
-
-Get escrow details.
-
-```bash
 plob escrow get <escrow-id>
-```
-
-### `plob escrow release`
-
-Release funds from an escrow (sender only).
-
-```bash
-# With confirmation prompt
 plob escrow release <escrow-id>
-
-# Skip confirmation
-plob escrow release <escrow-id> --yes
+plob escrow release <escrow-id> --yes   # Skip confirmation
 ```
 
 ### `plob pay`
@@ -191,187 +85,103 @@ plob escrow release <escrow-id> --yes
 Quick payment (creates escrow).
 
 ```bash
-plob pay \
-  --to 0x9a3c...7b21 \
-  --amount 25 \
-  --description "Bug fix payment"
+plob pay --to 0x... --amount 25 --description "Bug fix"
 ```
 
 ### `plob reputation`
 
-Check reputation score.
+Check reputation scores.
 
 ```bash
-# Check your reputation
-plob reputation
-
-# Check someone else's reputation
-plob reputation 0x9a3c...7b21
+plob reputation              # Your reputation
+plob reputation 0x...        # Someone else's
+plob reputation --json
 ```
 
 ### `plob mandate`
 
-Manage payment mandates _(coming soon)_.
+Manage spending mandates.
 
 ```bash
 plob mandate create --agent 0x... --limit 100 --duration 30
 plob mandate list
 plob mandate revoke <id>
+plob mandate adjust <id> --limit 200
 ```
 
-## Configuration
-
-Configuration is stored in `~/.plob/config.json`.
-
-Default configuration:
-```json
-{
-  "network": "sepolia",
-  "indexerUrl": "https://api.thegraph.com/subgraphs/name/paylobster/registry"
-}
-```
-
-## Wallet Security
-
-### Environment Variable (Recommended for Production)
-
-```bash
-export PRIVATE_KEY="0x..."
-plob status
-```
-
-### Keystore File (Development)
-
-Private keys are stored in `~/.plob/keystore/` with restricted permissions (0600).
+### All Commands
 
-⚠️ **Warning**: The current keystore implementation is **not encrypted**. For production use:
-- Use environment variables
-- Use hardware wallets
-- Implement proper key encryption
+| Command | Description |
+|---------|-------------|
+| `plob auth` | Set up wallet authentication |
+| `plob config` | Get/set configuration |
+| `plob register` | Register agent identity on-chain |
+| `plob status` | View balances, credit, account info |
+| `plob escrow` | Create, list, get, release escrows |
+| `plob pay` | Quick payment (creates escrow) |
+| `plob reputation` | Check agent reputation |
+| `plob mandate` | Create, list, revoke spending mandates |
 
-## Networks
+All commands support `--json` for automation.
 
-### Base Sepolia (Testnet)
-- Chain ID: 84532
-- RPC: https://sepolia.base.org
-- Block Explorer: https://sepolia.basescan.org
+## Contract Addresses
 
 ### Base Mainnet
-- Chain ID: 8453
-- RPC: https://mainnet.base.org
-- Block Explorer: https://basescan.org
-
-## Error Handling
 
-The CLI provides clean error messages and proper exit codes:
+| Contract | Address |
+|----------|---------|
+| Identity | `0xA174ee274F870631B3c330a85EBCad74120BE662` |
+| Reputation | `0x02bb4132a86134684976E2a52E43D59D89E64b29` |
+| Credit | `0xD9241Ce8a721Ef5fcCAc5A11983addC526eC80E1` |
+| Escrow V3 | `0x49EdEe04c78B7FeD5248A20706c7a6c540748806` |
+| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
 
-- Exit code `0`: Success
-- Exit code `1`: Error
-
-### Common Issues
+### Base Sepolia
 
-**"No wallet configured"**
-```bash
-# Solution: Set up authentication
-plob auth --private-key 0x...
-```
+| Contract | Address |
+|----------|---------|
+| Identity | `0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c` |
+| Reputation | `0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697` |
+| Credit | `0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d` |
+| Escrow V3 | `0x78D1f50a1965dE34f6b5a3D3546C94FE1809Cd82` |
+| USDC | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |
 
-**"Insufficient balance"**
-```bash
-# Solution: Fund your wallet with USDC
-# Bridge USDC to Base or buy from an exchange
-```
+## Networks
 
-**"Agent already registered"**
-```bash
-# You can only register once per address
-plob status  # Check current registration
-```
+| Network | Chain ID | RPC |
+|---------|----------|-----|
+| Base Mainnet | 8453 | `https://base-rpc.publicnode.com` |
+| Base Sepolia | 84532 | `https://base-sepolia-rpc.publicnode.com` |
 
-## JSON Output
+## Configuration
 
-All commands support `--json` flag for machine-readable output:
+Stored in `~/.plob/config.json`:
 
-```bash
-plob status --json
-plob escrow list --json
-plob reputation --json
-```
-
-Example JSON output:
 ```json
 {
-  "name": "my-agent",
-  "address": "0x742d...",
-  "registered": true,
-  "balance": {
-    "usdc": "125.50",
-    "eth": "0.05"
-  },
-  "reputation": 85
+  "network": "mainnet",
+  "rpcUrl": "https://base-rpc.publicnode.com"
 }
 ```
 
-## Development
-
-### Build
-
-```bash
-npm run build
-```
-
-### Run without building
-
-```bash
-npm run dev -- status
-```
-
-### Link locally
-
-```bash
-npm run link
-```
-
-### Test
-
-```bash
-npm test
-```
-
-## Contract Addresses
-
-### Base Mainnet
-- Identity: `0xA174f250380c4B5C37F6709bBa719E662b77E662`
-- Reputation: `0x02bb4c4cd10EeaCD04DF7631c81d6E7c1d0c4b29`
-- Credit: `0xD924B81F2d8EFF3E0A3Bf0a4b9D77d37CC0980E1`
-- Escrow: `0x49Ed7003C6941a033E7dD8b44552e4E18cf28806`
-- USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+## Wallet Security
 
-### Base Sepolia
-- Identity: `0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c`
-- Reputation: `0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697`
-- Credit: `0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d`
-- Escrow: `0x78D1f50a1965dE34f6b5a3D3546C94FE1809Cd82`
-- USDC: `0x036CbD53842c5426634e7929541eC2318f3dCF7e`
+- **Environment variables** (recommended for production): `export PRIVATE_KEY="0x..."`
+- **Keystore files** (development): stored in `~/.plob/keystore/` with restricted permissions (0600)
+- ⚠️ For production: use hardware wallets or encrypted key management
 
 ## Resources
 
-- **Website**: https://paylobster.com
-- **Docs**: https://docs.paylobster.com
-- **GitHub**: https://github.com/itsGustav/Pay-Lobster
-- **Discord**: https://discord.gg/paylobster
+- **Website**: [paylobster.com](https://paylobster.com)
+- **Docs**: [paylobster.com/docs](https://paylobster.com/docs)
+- **Discord**: [discord.gg/ntWQB6g2jt](https://discord.gg/ntWQB6g2jt)
+- **SDK**: [npmjs.com/package/pay-lobster](https://www.npmjs.com/package/pay-lobster)
+- **MCP Server**: [npmjs.com/package/@paylobster/mcp-server](https://www.npmjs.com/package/@paylobster/mcp-server)
 
 ## License
 
-MIT © PayLobster Team
-
-## Support
-
-Need help?
-- Open an issue on GitHub
-- Join our Discord
-- Email: dev@paylobster.com
+MIT © PayLobster
 
 ---
 
-Built with ❤️ by the PayLobster team
+**Built for the agent economy** 🦞

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paylobster/cli",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "PayLobster command-line interface for agent payments and service discovery",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",