@paylobster/cli 4.0.1 → 4.1.0

package/README.md

@@ -1,15 +1,6 @@
 # 🦞 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
 
@@ -19,63 +10,24 @@ npm install -g @paylobster/cli
 
 ## 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...
-```
-
-### 3. Register Your Agent
-
-```bash
-plob register --name "my-coding-agent" --capabilities "code-review,bug-fix"
-```
+# 2. Configure network
+plob config set network mainnet    # Base Mainnet
+plob config set network sepolia    # Base Sepolia (testnet)
 
-### 4. Check Status
+# 3. Register your agent
+plob register --name "my-agent" --capabilities "code-review,analysis"
 
-```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`
@@ -83,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.
+View agent status, balances, and reputation.
 
 ```bash
-# Pretty output
-plob status
-
-# JSON output
-plob status --json
-```
-
-### `plob escrow create`
-
-Create a new escrow payment.
-
-```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`
@@ -179,179 +85,102 @@ 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
+### All Commands
 
-Configuration is stored in `~/.plob/config.json`.
+| 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 |
 
-Default configuration:
-```json
-{
-  "network": "sepolia",
-  "indexerUrl": "https://api.thegraph.com/subgraphs/name/paylobster/registry"
-}
-```
+All commands support `--json` for automation.
 
-## 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).
-
-⚠️ **Warning**: The current keystore implementation is **not encrypted**. For production use:
-- Use environment variables
-- Use hardware wallets
-- Implement proper key encryption
-
-## Networks
+## Contract Addresses
 
 ### Base Mainnet
-- Chain ID: 8453
-- RPC: https://base-rpc.publicnode.com
-- Block Explorer: https://basescan.org
-
-### Base Sepolia (Testnet)
-- Chain ID: 84532
-- RPC: https://base-sepolia-rpc.publicnode.com
-- Block Explorer: https://sepolia.basescan.org
 
-## Error Handling
+| Contract | Address |
+|----------|---------|
+| Identity | `0xA174ee274F870631B3c330a85EBCad74120BE662` |
+| Reputation | `0x02bb4132a86134684976E2a52E43D59D89E64b29` |
+| Credit | `0xD9241Ce8a721Ef5fcCAc5A11983addC526eC80E1` |
+| Escrow V3 | `0x49EdEe04c78B7FeD5248A20706c7a6c540748806` |
+| USDC | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
 
-The CLI provides clean error messages and proper exit codes:
-
-- Exit code `0`: Success
-- Exit code `1`: Error
+### Base Sepolia
 
-### Common Issues
+| Contract | Address |
+|----------|---------|
+| Identity | `0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c` |
+| Reputation | `0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697` |
+| Credit | `0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d` |
+| Escrow V3 | `0x78D1f50a1965dE34f6b5a3D3546C94FE1809Cd82` |
+| USDC | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |
 
-**"No wallet configured"**
-```bash
-# Solution: Set up authentication
-plob auth --private-key 0x...
-```
-
-**"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: `0xA174ee274F870631B3c330a85EBCad74120BE662`
-- Reputation: `0x02bb4132a86134684976E2a52E43D59D89E64b29`
-- Credit: `0xD9241Ce8a721Ef5fcCAc5A11983addC526eC80E1`
-- Escrow V3: `0x49EdEe04c78B7FeD5248A20706c7a6c540748806`
-- USDC: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+## Wallet Security
 
-### Base Sepolia
-- Identity: `0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c`
-- Reputation: `0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697`
-- Credit: `0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d`
-- Escrow V3: `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**: [paylobster.com](https://paylobster.com)
 - **Docs**: [paylobster.com/docs](https://paylobster.com/docs)
 - **Discord**: [discord.gg/ntWQB6g2jt](https://discord.gg/ntWQB6g2jt)
-- **npm**: [npmjs.com/package/@paylobster/cli](https://www.npmjs.com/package/@paylobster/cli)
+- **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
+MIT © PayLobster
 
 ---
 

package/dist/src/commands/cascade.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCascadeCommand(): Command;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/src/commands/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../../src/commands/cascade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,IAAI,OAAO,CAmR9C"}

package/dist/src/commands/cascade.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCascadeCommand = createCascadeCommand;
+const commander_1 = require("commander");
+const display_1 = require("../lib/display");
+function createCascadeCommand() {
+    const cmd = new commander_1.Command('cascade')
+        .description('Manage cascading payments');
+    // plob cascade create
+    cmd
+        .command('create')
+        .description('Create a cascading payment')
+        .requiredOption('--stages <number>', 'Number of stages')
+        .requiredOption('--amount <amount>', 'Total amount in USDC')
+        .requiredOption('--recipients <addresses>', 'Comma-separated recipient addresses')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            const stages = parseInt(options.stages);
+            if (isNaN(stages) || stages < 2) {
+                (0, display_1.error)('Invalid stages. Must be at least 2');
+                process.exit(1);
+            }
+            const amount = parseFloat(options.amount);
+            if (isNaN(amount) || amount <= 0) {
+                (0, display_1.error)('Invalid amount. Must be a positive number');
+                process.exit(1);
+            }
+            const recipients = options.recipients.split(',').map(r => r.trim());
+            // Validate all addresses
+            for (const recipient of recipients) {
+                if (!recipient.startsWith('0x') || recipient.length !== 42) {
+                    (0, display_1.error)(`Invalid recipient address: ${recipient}`);
+                    process.exit(1);
+                }
+            }
+            if (recipients.length !== stages) {
+                (0, display_1.error)(`Number of recipients (${recipients.length}) must match stages (${stages})`);
+                process.exit(1);
+            }
+            (0, display_1.info)(`Creating ${stages}-stage cascade`);
+            (0, display_1.info)(`Total amount: ${options.amount} USDC`);
+            (0, display_1.info)(`Recipients: ${recipients.map(display_1.formatAddress).join(' → ')}`);
+            const cascadeId = Math.floor(Math.random() * 1000000);
+            const txHash = await (0, display_1.withSpinner)('Creating cascade payment...', async () => {
+                // Placeholder - implement actual contract call
+                await new Promise(resolve => setTimeout(resolve, 2000));
+                return '0x' + Math.random().toString(16).substring(2, 66);
+            });
+            if ((0, display_1.outputJSON)({
+                cascadeId,
+                stages,
+                amount: options.amount,
+                recipients,
+                txHash,
+            }, options)) {
+                return;
+            }
+            (0, display_1.success)('Cascade payment created!');
+            (0, display_1.info)(`Cascade ID: ${cascadeId}`);
+            (0, display_1.info)(`Transaction: ${txHash}`);
+        }
+        catch (err) {
+            (0, display_1.error)(`Failed to create cascade: ${err}`);
+            process.exit(1);
+        }
+    });
+    // plob cascade release
+    cmd
+        .command('release')
+        .description('Release a specific cascade level')
+        .argument('<cascadeId>', 'Cascade ID')
+        .requiredOption('--level <level>', 'Level to release (1-based)')
+        .option('--yes', 'Skip confirmation')
+        .option('--json', 'Output as JSON')
+        .action(async (cascadeId, options) => {
+        try {
+            const level = parseInt(options.level);
+            if (isNaN(level) || level < 1) {
+                (0, display_1.error)('Invalid level. Must be at least 1');
+                process.exit(1);
+            }
+            if (!options.yes) {
+                const confirmed = await (0, display_1.confirm)(`Release level ${level} of cascade ${cascadeId}?`);
+                if (!confirmed) {
+                    (0, display_1.info)('Cancelled');
+                    process.exit(0);
+                }
+            }
+            const txHash = await (0, display_1.withSpinner)(`Releasing cascade level ${level}...`, async () => {
+                // Placeholder - implement actual contract call
+                await new Promise(resolve => setTimeout(resolve, 1500));
+                return '0x' + Math.random().toString(16).substring(2, 66);
+            });
+            if ((0, display_1.outputJSON)({
+                cascadeId,
+                level,
+                txHash,
+            }, options)) {
+                return;
+            }
+            (0, display_1.success)(`Cascade level ${level} released!`);
+            (0, display_1.info)(`Cascade ID: ${cascadeId}`);
+            (0, display_1.info)(`Transaction: ${txHash}`);
+        }
+        catch (err) {
+            (0, display_1.error)(`Failed to release cascade: ${err}`);
+            process.exit(1);
+        }
+    });
+    // plob cascade release-all
+    cmd
+        .command('release-all')
+        .description('Release all remaining cascade levels')
+        .argument('<cascadeId>', 'Cascade ID')
+        .option('--yes', 'Skip confirmation')
+        .option('--json', 'Output as JSON')
+        .action(async (cascadeId, options) => {
+        try {
+            if (!options.yes) {
+                const confirmed = await (0, display_1.confirm)(`Release ALL levels of cascade ${cascadeId}?`);
+                if (!confirmed) {
+                    (0, display_1.info)('Cancelled');
+                    process.exit(0);
+                }
+            }
+            const txHash = await (0, display_1.withSpinner)('Releasing all cascade levels...', async () => {
+                // Placeholder - implement actual contract call
+                await new Promise(resolve => setTimeout(resolve, 2000));
+                return '0x' + Math.random().toString(16).substring(2, 66);
+            });
+            if ((0, display_1.outputJSON)({
+                cascadeId,
+                txHash,
+            }, options)) {
+                return;
+            }
+            (0, display_1.success)('All cascade levels released!');
+            (0, display_1.info)(`Cascade ID: ${cascadeId}`);
+            (0, display_1.info)(`Transaction: ${txHash}`);
+        }
+        catch (err) {
+            (0, display_1.error)(`Failed to release cascade: ${err}`);
+            process.exit(1);
+        }
+    });
+    // plob cascade get
+    cmd
+        .command('get')
+        .description('Get cascade details')
+        .argument('<cascadeId>', 'Cascade ID')
+        .option('--json', 'Output as JSON')
+        .action(async (cascadeId, options) => {
+        try {
+            // Placeholder data
+            const cascade = {
+                id: cascadeId,
+                creator: '0x1234567890123456789012345678901234567890',
+                totalAmount: '1000 USDC',
+                stages: 3,
+                currentStage: 1,
+                recipients: [
+                    { address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb', released: true },
+                    { address: '0x8626f6940E2eb28930eFb4CeF49B2d1F2C9C1199', released: false },
+                    { address: '0x1111111111111111111111111111111111111111', released: false },
+                ],
+            };
+            if ((0, display_1.outputJSON)(cascade, options)) {
+                return;
+            }
+            console.log();
+            console.log('Cascade ID:    ', cascade.id);
+            console.log('Creator:       ', cascade.creator);
+            console.log('Total Amount:  ', cascade.totalAmount);
+            console.log('Stages:        ', cascade.stages);
+            console.log('Current Stage: ', cascade.currentStage);
+            console.log();
+            console.log('Recipients:');
+            cascade.recipients.forEach((r, i) => {
+                const status = r.released ? '✅ Released' : '⏳ Pending';
+                console.log(`  ${i + 1}. ${(0, display_1.formatAddress)(r.address)} - ${status}`);
+            });
+            console.log();
+        }
+        catch (err) {
+            (0, display_1.error)(`Failed to get cascade: ${err}`);
+            process.exit(1);
+        }
+    });
+    // plob cascade list
+    cmd
+        .command('list')
+        .description('List your cascades')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        try {
+            // Placeholder data
+            const cascades = [
+                {
+                    id: 1,
+                    amount: '1000 USDC',
+                    stages: 3,
+                    currentStage: 1,
+                    status: 'active',
+                },
+                {
+                    id: 2,
+                    amount: '500 USDC',
+                    stages: 2,
+                    currentStage: 2,
+                    status: 'completed',
+                },
+            ];
+            if ((0, display_1.outputJSON)(cascades, options)) {
+                return;
+            }
+            if (cascades.length === 0) {
+                (0, display_1.info)('No cascades found');
+                return;
+            }
+            const table = (0, display_1.createTable)({
+                head: ['ID', 'Amount', 'Stages', 'Current', 'Status'],
+            });
+            for (const cascade of cascades) {
+                table.push([
+                    cascade.id,
+                    cascade.amount,
+                    cascade.stages,
+                    cascade.currentStage,
+                    cascade.status,
+                ]);
+            }
+            console.log(table.toString());
+        }
+        catch (err) {
+            (0, display_1.error)(`Failed to list cascades: ${err}`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=cascade.js.map