clawtrade-bnb

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

2. 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

3. 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

clawtrade-bnb/
├── defi-strategy-engine.js          # 3 strategies (compound, rebalance, harvest)
├── on-chain-logger.js                # Event logging with TX hashes
├── strategy-scheduler.js              # Main loop (60s cycles)
├── network-switcher.js                # Testnet ↔ mainnet toggle
├── performance-analytics.js           # Real APR & metrics
├── reinforced-learning.js             # Self-improving parameters
├── agent-cli.js                       # Control panel
├── dashboard/                         # React frontend (real-time)
├── contracts/                         # Vault smart contracts
├── config.deployed.json               # Contract addresses & ABIs
├── config.scheduler.json              # Strategy thresholds
├── execution-log.jsonl                # Action history (generated)
├── performance-metrics.json           # Metrics (generated)
├── learning-state.json                # Learning progress (generated)
├── README.md                          # User guide
├── README_STRATEGY.md                 # Strategy details
├── README_ADVANCED.md                 # Network switching & learning
├── SKILL.md                           # This file
└── package.json                       # Dependencies

Integration with Other Skills

This is a standalone, complete skill. It can also integrate with:

• Telegram Notifications - Send alerts to OpenClaw users
• Email Reports - Daily performance summaries
• Database Logging - Store metrics in persistent DB
• Webhook Integrations - Trigger external services

Documentation

File	Purpose
README.md	Complete user guide
README_STRATEGY.md	Strategy details & examples
README_ADVANCED.md	Network switching & reinforced learning
SKILL.md	This installation & architecture guide

What You Get

✅ Production-ready code (tested, documented, error-handling) ✅ 3 profitable strategies (auto-optimizing, self-learning) ✅ Real-time dashboard (React, live updates) ✅ CLI control panel (manage from terminal) ✅ On-chain logging (auditable, transparent) ✅ Network switching (testnet → mainnet in seconds) ✅ Self-improvement (learns from failures automatically) ✅ Complete documentation (guides, examples, FAQ)

Replicating This Skill

For someone else to replicate:

1. Install

   clawhub install clawtrade-bnb
   npm install
   

2. Configure

   # Edit config files with your contracts & RPC
   nano config.deployed.json
   

3. Deploy Contracts (if using new vaults)

   cd contracts && npm run deploy:testnet
   

4. Run

   node strategy-scheduler.js      # Main engine
   npm run dev:dashboard           # Dashboard
   node agent-cli.js               # Control panel
   

5. Monitor

   • Dashboard: http://localhost:5173
   • Logs: execution-log.jsonl
   • Analytics: node agent-cli.js perf report

Total setup time: ~15 minutes

Support & Community

• GitHub Issues: https://github.com/open-web-academy/clawtrade-bnb-bnb
• ClawHub: https://clawhub.com (search: clawtrade-bnb)
• Discord: https://discord.com/invite/clawd

Version History

• v1.1.0 (2026-02-18) - Network switcher, analytics, reinforced learning, CLI
• v1.0.0 (2026-02-17) - Initial release, 3 strategies, on-chain logging

License

MIT - Free to use, modify, and distribute