--- name: clawtrade-bnb version: 1.1.0 description: Autonomous DeFi trading agent for BNB Chain with multi-strategy engine, network switching, and reinforced learning. keywords: trading, defi, autonomous-agent, multi-strategy, reinforced-learning, bnb-chain ---

CawTrade BNB - Autonomous DeFi Trading Agent v1.1.0

Production-ready autonomous trading agent for BNB Chain testnet & mainnet. Features 3 intelligent strategies, real-time performance analytics, on-chain event logging, and self-improving reinforced learning.

Core Features

🤖 Three Autonomous Strategies

1. Compound Yield - Auto-reinvest harvested rewards for exponential growth
2. Rebalance - Move capital from low-APR to high-APR vaults automatically
3. Dynamic Harvest - Intelligent harvesting based on gas cost optimization

🌐 Network Switching

• Instant testnet ↔ mainnet toggle (no restart)
• Separate configs per network (gas, thresholds, RPCs)
• Contract address mapping per chain
• Persistent network preferences

📊 Real-Time Analytics

• Realized APR (actual, based on historical yields)
• Per-vault performance breakdown
• Strategy effectiveness scoring
• Success rate tracking (target: >90%)
• Failure pattern detection

🧠 Reinforced Learning

• Auto-learns from past failures
• Dynamically optimizes strategy parameters
• Adjusts thresholds based on success rates
• Confidence scoring per strategy
• Self-improving over time

⛓️ On-Chain Event Logging

• All actions logged with TX hashes
• Auditable blockchain trail
• BNB Testnet Scanner links
• Complete execution history

🎮 Control Panel CLI

• Interactive command-line interface
• Network management commands
• Performance metrics dashboard
• Learning progress tracking
• Real-time optimization

Installation & Setup

1. Install Skill

clawhub install clawtrade-bnb
cd ~/.openclaw/workspace/skills/clawtrade-bnb
npm install

2. Configure Environment

# Copy example config
cp config.deployed.json config.live.json

# Edit with your settings
nano config.live.json
# Set RPC endpoint, contract addresses, wallet

3. Set Private Key (Secure)

# Option A: Environment variable (recommended)
export PRIVATE_KEY="your_testnet_private_key"

# Option B: .env file (git-ignored)
echo "PRIVATE_KEY=your_key" >> .env

# NOTE: Never commit private keys!

4. Verify Setup

# Test connection and contracts
node agent-cli.js network status

# Check wallet balance
npm run verify

Quick Start - 3 Commands

# Terminal 1: Run strategy engine (60-second cycles)
node strategy-scheduler.js

# Terminal 2: Real-time dashboard
npm run dev:dashboard
# → Open http://localhost:5173

# Terminal 3: Control panel
node agent-cli.js

# Example commands:
node agent-cli.js network testnet        # Switch network
node agent-cli.js perf summary           # See performance
node agent-cli.js learn now              # Optimize strategies

Architecture

DeFi Strategy Engine
├─ Compound Yield Strategy
│  └─ Harvest when pending > $25 → Re-deposit
├─ Rebalance Strategy
│  └─ Move 20% from low-APR to high-APR vault
└─ Dynamic Harvest Strategy
   └─ Harvest only if pending > 2x gas cost

         ↓ (runs every 60 seconds)

Strategy Scheduler
├─ Read vault APRs & pending rewards
├─ Execute all 3 strategies
└─ Log actions + TX hashes

         ↓ (logs to blockchain)

On-Chain Logger
├─ execution-log.jsonl (append-only)
├─ performance-metrics.json (cumulative)
└─ learning-state.json (optimization history)

         ↓ (analyzes continuously)

Reinforced Learning System
├─ Tracks success rates per strategy
├─ Detects failure patterns
├─ Auto-adjusts thresholds
└─ Generates improvement reports

         ↓ (displays real-time)

Dashboard + Control Panel
├─ React dashboard (http://localhost:5173)
├─ Agent CLI (network, perf, learn commands)
└─ Performance API (/api/logs, /api/health)

Configuration Files

config.deployed.json - Contract addresses & ABIs

{
  "chainId": 97,
  "network": "BNB Testnet",
  "contracts": [
    {
      "vaultId": "vault_eth_staking_001",
      "address": "0x588eD88A145144F1E368D624EeFC336577a4276b",
      "strategy": "Ethereum 2.0 Staking",
      "risk_score": 0.3
    }
  ]
}

config.scheduler.json - Strategy thresholds

{
  "scheduler": {
    "execution_interval_seconds": 60,
    "enabled": true
  },
  "agent": {
    "harvest_threshold_usd": 25,
    "rebalance_apr_delta": 2.0,
    "max_allocation_percent": 0.35,
    "min_confidence": 0.6
  }
}

Strategy Decision Logic

Each 60-second cycle:

1. COMPOUND YIELD

- Check pending rewards per vault - If pending ≥ $25 → Harvest + Re-deposit - Log action with TX hash

1. REBALANCE

- Compare APRs across all vaults - If top APR > bottom APR by ≥ 2% → Rebalance - Move 20% from worst to best vault - Log action with TX hash

1. DYNAMIC HARVEST

- Estimate gas cost per harvest - Only harvest if pending > 2x gas cost - Maximize profitability per action - Log action with TX hash

Example Output:

Cycle #42 @ 2026-02-18T18:00:00Z
✓ vault_eth_staking_001: COMPOUND ($45.50 harvested)
✓ vault_high_risk_001: REBALANCE (2.1% APR delta)
✓ vault_link_oracle_001: HARVEST ($12.30 pending)
✅ Total Rewards: $57.80 | Compounded: $45.50

CLI Commands

Network Management

node agent-cli.js network status      # Current network config
node agent-cli.js network testnet     # Switch to testnet
node agent-cli.js network mainnet     # Switch to mainnet (⚠️ production)

Performance Monitoring

node agent-cli.js perf summary        # Quick stats
node agent-cli.js perf report         # Detailed analysis
node agent-cli.js perf vaults         # Per-vault breakdown
node agent-cli.js perf strategies     # Strategy effectiveness

Reinforced Learning

node agent-cli.js learn now           # Analyze & optimize
node agent-cli.js learn report        # View improvements
node agent-cli.js learn reset         # Reset learning state

Supported Networks

| Network | Chain ID | Use Case | Harvest Min | Gas Multiplier | |---------|----------|----------|-------------|----------------| | BNB Testnet | 97 | Development | $25 | 1.2x | | BNB Mainnet | 56 | Production | $100 | 1.5x |

Network Switching

Switch instantly without restarting:

# Current config
node agent-cli.js network status
# → BNB Testnet

# Switch to production
node agent-cli.js network mainnet
# → Updated RPC, contract addresses, and thresholds

# All settings updated automatically

Security & Safety

On-Chain Auditing

• ✅ Every action logged with transaction hash
• ✅ Blockchain verification via BNB Testnet/Mainnet Scanner
• ✅ Append-only execution log (execution-log.jsonl)
• ✅ Complete audit trail for compliance

Risk Management

• ✅ Deterministic decision logic (reproducible, auditable)
• ✅ Success rate monitoring (>90% target)
• ✅ Confidence thresholds per strategy
• ✅ Graceful error handling & recovery
• ✅ Automatic parameter optimization via learning

Private Key Security

• ✅ Never hardcoded - use environment variables only
• ✅ .env file git-ignored
• ✅ Testnet for development, mainnet when ready
• ✅ For production: use hardware wallet support (future)

File Structure

...