@paylobster/cli 4.5.0 → 4.6.0

package/EXAMPLES.md

@@ -1,6 +1,6 @@
 # PayLobster CLI Examples
 
-Real-world usage examples for the `plob` CLI.
+Real-world usage examples for the `paylobster` CLI.
 
 ## Setup Workflow
 
@@ -8,38 +8,38 @@ Real-world usage examples for the `plob` CLI.
 
 ```bash
 # 1. Configure for testnet
-plob config set network sepolia
+paylobster config set network sepolia
 
 # 2. Set up wallet from environment
 export PRIVATE_KEY="0x..."
-plob auth --env PRIVATE_KEY
+paylobster auth --env PRIVATE_KEY
 
 # 3. Register your agent
-plob register \
+paylobster register \
   --name "test-agent" \
   --capabilities "testing,development"
 
 # 4. Check status
-plob status
+paylobster status
 ```
 
 ### Production Setup
 
 ```bash
 # 1. Configure for mainnet
-plob config set network mainnet
+paylobster config set network mainnet
 
 # 2. Use environment variable for security
 export PRIVATE_KEY="0x..."
-plob auth --env PRIVATE_KEY
+paylobster auth --env PRIVATE_KEY
 
 # 3. Register with production name
-plob register \
+paylobster register \
   --name "prod-coding-agent" \
   --capabilities "code-review,bug-fix,testing,documentation"
 
 # 4. Verify setup
-plob status --json
+paylobster status --json
 ```
 
 ## Payment Workflows
@@ -48,7 +48,7 @@ plob status --json
 
 ```bash
 # Quick payment to a provider
-plob pay \
+paylobster pay \
   --to 0x9a3c7b21F3d4e8A2B1C5D6E7F8A9B0C1D2E3F4A5 \
   --amount 10 \
   --description "Code review service"
@@ -58,30 +58,30 @@ plob pay \
 
 ```bash
 # 1. Create escrow for service
-plob escrow create \
+paylobster escrow create \
   --to 0x9a3c7b21F3d4e8A2B1C5D6E7F8A9B0C1D2E3F4A5 \
   --amount 50 \
   --description "Full-stack code review"
 
 # 2. Check escrow status
-plob escrow list
+paylobster escrow list
 
 # 3. After work is delivered, release funds
-plob escrow release 0
+paylobster escrow release 0
 ```
 
 ### Bulk Escrow Management
 
 ```bash
 # List all escrows
-plob escrow list --json > escrows.json
+paylobster escrow list --json > escrows.json
 
 # Get specific escrow details
-plob escrow get 5 --json
+paylobster escrow get 5 --json
 
 # Release multiple escrows (script)
 for id in 1 2 3 4 5; do
-  plob escrow release $id --yes
+  paylobster escrow release $id --yes
 done
 ```
 
@@ -91,7 +91,7 @@ done
 
 ```bash
 # 1. Check provider reputation
-plob reputation 0x9a3c7b21F3d4e8A2B1C5D6E7F8A9B0C1D2E3F4A5
+paylobster reputation 0x9a3c7b21F3d4e8A2B1C5D6E7F8A9B0C1D2E3F4A5
 
 # Output interpretation:
 # ★★★★★ 90+ = Excellent (safe to pay immediately)
@@ -101,17 +101,17 @@ plob reputation 0x9a3c7b21F3d4e8A2B1C5D6E7F8A9B0C1D2E3F4A5
 # ★☆☆☆☆ <40 = Poor (avoid or use dispute-ready escrow)
 
 # 2. If good reputation, proceed with payment
-plob pay --to 0x9a3c... --amount 20 --description "Service"
+paylobster pay --to 0x9a3c... --amount 20 --description "Service"
 ```
 
 ### Monitor Your Own Reputation
 
 ```bash
 # Check your reputation regularly
-plob reputation
+paylobster reputation
 
 # Get JSON for tracking over time
-plob reputation --json >> reputation-history.jsonl
+paylobster reputation --json >> reputation-history.jsonl
 ```
 
 ## Automated Workflows
@@ -125,7 +125,7 @@ plob reputation --json >> reputation-history.jsonl
 export PRIVATE_KEY="0x..."
 
 # Get status
-STATUS=$(plob status --json)
+STATUS=$(paylobster status --json)
 
 # Parse USDC balance
 BALANCE=$(echo $STATUS | jq -r '.balance.usdc')
@@ -146,7 +146,7 @@ fi
 export PRIVATE_KEY="0x..."
 
 # Get all escrows
-ESCROWS=$(plob escrow list --json)
+ESCROWS=$(paylobster escrow list --json)
 
 # Loop through and release verified ones
 echo $ESCROWS | jq -c '.[]' | while read escrow; do
@@ -157,7 +157,7 @@ echo $ESCROWS | jq -c '.[]' | while read escrow; do
     echo "Verifying escrow $ID..."
     # Add your verification logic here
     # If verified:
-    plob escrow release $ID --yes
+    paylobster escrow release $ID --yes
   fi
 done
 ```
@@ -181,10 +181,10 @@ fi
 export PRIVATE_KEY="${AGENT_PRIVATE_KEY}"
 
 echo "Registering agent: $NAME"
-plob register --name "$NAME" --capabilities "$CAPABILITIES"
+paylobster register --name "$NAME" --capabilities "$CAPABILITIES"
 
 echo "Agent registered! Checking status..."
-plob status
+paylobster status
 ```
 
 ## Integration Examples
@@ -194,31 +194,31 @@ plob status
 ```javascript
 const { execSync } = require('child_process');
 
-function plobCommand(cmd) {
+function paylobsterCommand(cmd) {
   try {
-    const output = execSync(`plob ${cmd} --json`, {
+    const output = execSync(`paylobster ${cmd} --json`, {
       encoding: 'utf-8',
       env: { ...process.env, PRIVATE_KEY: process.env.AGENT_KEY }
     });
     return JSON.parse(output);
   } catch (error) {
-    console.error('plob command failed:', error.message);
+    console.error('paylobster command failed:', error.message);
     throw error;
   }
 }
 
 // Get status
-const status = plobCommand('status');
+const status = paylobsterCommand('status');
 console.log(`Balance: ${status.balance.usdc} USDC`);
 
 // Check reputation
-const reputation = plobCommand('reputation 0x...');
+const reputation = paylobsterCommand('reputation 0x...');
 if (reputation.reputation.score < 60) {
   console.warn('Low reputation provider!');
 }
 
 // Create payment
-const payment = plobCommand('pay --to 0x... --amount 10 --description "Service"');
+const payment = paylobsterCommand('pay --to 0x... --amount 10 --description "Service"');
 console.log(`Payment created: ${payment.txHash}`);
 ```
 
@@ -229,13 +229,13 @@ import subprocess
 import json
 import os
 
-def plob(command):
-    """Execute plob command and return JSON output"""
+def paylobster(command):
+    """Execute paylobster command and return JSON output"""
     env = os.environ.copy()
     env['PRIVATE_KEY'] = os.getenv('AGENT_KEY')
     
     result = subprocess.run(
-        f'plob {command} --json',
+        f'paylobster {command} --json',
         shell=True,
         capture_output=True,
         text=True,
@@ -243,7 +243,7 @@ def plob(command):
     )
     
     if result.returncode != 0:
-        raise Exception(f"plob failed: {result.stderr}")
+        raise Exception(f"paylobster failed: {result.stderr}")
     
     return json.loads(result.stdout)
 
@@ -291,13 +291,13 @@ jobs:
       - name: Check balance
         env:
           PRIVATE_KEY: ${{ secrets.PAYLOBSTER_PRIVATE_KEY }}
-        run: plob status
+        run: paylobster status
       
       - name: Send payment
         env:
           PRIVATE_KEY: ${{ secrets.PAYLOBSTER_PRIVATE_KEY }}
         run: |
-          plob pay \
+          paylobster pay \
             --to ${{ github.event.inputs.recipient }} \
             --amount ${{ github.event.inputs.amount }} \
             --description "${{ github.event.inputs.description }}" \
@@ -310,44 +310,44 @@ jobs:
 
 ```bash
 # Set custom RPC endpoint
-plob config set rpcUrl https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
+paylobster config set rpcUrl https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
 
 # Verify
-plob config show
+paylobster config show
 ```
 
 ### Multi-Account Management
 
 ```bash
 # Switch between accounts using different keystores
-plob auth --private-key $ACCOUNT1_KEY --keystore account1.key
-plob status
+paylobster auth --private-key $ACCOUNT1_KEY --keystore account1.key
+paylobster status
 
-plob auth --private-key $ACCOUNT2_KEY --keystore account2.key
-plob status
+paylobster auth --private-key $ACCOUNT2_KEY --keystore account2.key
+paylobster status
 
 # Or use environment variables
 export PRIVATE_KEY=$ACCOUNT1_KEY
-plob status
+paylobster status
 
 export PRIVATE_KEY=$ACCOUNT2_KEY
-plob status
+paylobster status
 ```
 
 ### JSON Processing with jq
 
 ```bash
 # Get USDC balance
-plob status --json | jq -r '.balance.usdc'
+paylobster status --json | jq -r '.balance.usdc'
 
 # Get reputation score
-plob reputation --json | jq -r '.reputation.score'
+paylobster reputation --json | jq -r '.reputation.score'
 
 # Filter active escrows
-plob escrow list --json | jq '.[] | select(.status == 1)'
+paylobster escrow list --json | jq '.[] | select(.status == 1)'
 
 # Sum total locked in escrows
-plob escrow list --json | \
+paylobster escrow list --json | \
   jq -r '.[] | .amount' | \
   cut -d' ' -f1 | \
   awk '{s+=$1} END {print s}'
@@ -359,14 +359,14 @@ plob escrow list --json | \
 
 ```bash
 # Add DEBUG environment variable
-DEBUG=* plob status
+DEBUG=* paylobster status
 ```
 
 ### Check Transaction on Block Explorer
 
 ```bash
 # Get transaction hash
-TX=$(plob pay --to 0x... --amount 5 --description "test" --json | jq -r '.txHash')
+TX=$(paylobster pay --to 0x... --amount 5 --description "test" --json | jq -r '.txHash')
 
 # Open in browser (macOS)
 open "https://basescan.org/tx/$TX"
@@ -379,10 +379,10 @@ open "https://sepolia.basescan.org/tx/$TX"
 
 ```bash
 # Check configured wallet
-plob auth
+paylobster auth
 
 # Try a read-only operation
-plob status
+paylobster status
 
 # If successful, wallet is properly configured
 ```
@@ -393,36 +393,36 @@ plob status
 
 ```bash
 # Bad: Pay immediately
-plob pay --to 0x... --amount 100 --description "service"
+paylobster pay --to 0x... --amount 100 --description "service"
 
 # Good: Check reputation first
-plob reputation 0x...
+paylobster reputation 0x...
 # Then decide based on score
-plob pay --to 0x... --amount 100 --description "service"
+paylobster pay --to 0x... --amount 100 --description "service"
 ```
 
 ### Use Escrow for New Providers
 
 ```bash
 # For first-time providers, always use escrow
-plob escrow create --to 0x... --amount 50 --description "trial service"
+paylobster escrow create --to 0x... --amount 50 --description "trial service"
 
 # Release only after delivery verification
 # (add your verification logic here)
-plob escrow release <id>
+paylobster escrow release <id>
 ```
 
 ### Keep Local Records
 
 ```bash
 # Log all payments
-plob pay --to 0x... --amount 20 --description "service" --json >> payments.jsonl
+paylobster pay --to 0x... --amount 20 --description "service" --json >> payments.jsonl
 
 # Track escrows
-plob escrow list --json > "escrows-$(date +%Y%m%d).json"
+paylobster escrow list --json > "escrows-$(date +%Y%m%d).json"
 
 # Monitor reputation over time
-plob reputation --json >> "reputation-$(date +%Y%m%d).json"
+paylobster reputation --json >> "reputation-$(date +%Y%m%d).json"
 ```
 
 ---

package/package.json

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