🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Yield Farm Payment

by @altoninelli

Transform your outgoing payments into a yield-generating asset. Auto recover of all paid amounts through yield farming on Aave V3. This skill automates on-ch...

Versionv1.0.18
Downloads945
Stars⭐ 1
TERMINAL
clawhub install yield-farm-payment

πŸ“– About This Skill


name: yield-farm-payment version: 1.0.14 author: altoninelli

Please donate if you find this skill useful! (Base Mainnet).

donation: "0x1C7f7c428dE42B8402F8331612131cc8bC126369" description: "Free usage! Transform your outgoing payments into a yield-generating asset. Auto recover of all paid amounts through yield farming on Aave V3. This skill automates on-chain payments on the Base Network while simultaneously supplying collateral to Aave to optimize your capital efficiency." tags: ["DeFi", "Net Zero Cost", "Savings", "Payment", "Base network", "Automation", "Aave"] price_per_call: 0 USDC requires: - viem metadata: openclaw: emoji: "🌾" category: "DeFi Payments" reputation_required: "medium" security_level: "high-privilege" warning: "Requires raw PRIVATE_KEY of a dedicated, low-balance wallet. Use only with a wallet containing limited funds."

YieldFarmPayment Skill v1.0

Important Security Notice

This skill requires the user to provide a raw PRIVATE_KEY in the .env file. This grants full control of the wallet to the skill.

Strongly recommended:

  • Use a dedicated wallet created only for this skill
  • Fund it with only the necessary amount + small buffer for gas
  • Never use your main wallet or a wallet containing significant funds
  • Environment variables required:

  • PRIVATE_KEY: Private key of dedicated wallet
  • BASE_RPC_URL: Base Mainnet RPC URL

  • DeFi Immediate Payment System with Capital Recovery via Aave V3

    Pay recipients immediately on Base network, then recover your capital over time through Aave V3 yield farming.

    ⚠️ v1.0 β€” Upfront Mode Only

    v1.0 supports only Upfront Mode (immediate payment to recipient). Standard Mode (yield streaming) and Smart Mode (deadline optimization) are planned for v2.0 with x402 protocol integration.

    🎯 Features

  • Upfront Mode: Immediate USDC payment to recipient + capital recovery via yield
  • Flexible Collateral: 3x to 20x multiplier with configurable buffer (default: 20x)
  • Aave V3 Integration: Deposit collateral to earn yield on Base network
  • Robust Transaction Handling: Automatic retry, gas optimization, error recovery
  • Professional CLI: Full-featured command line interface
  • πŸ’° Monetization & Usage

  • Model: Free.
  • Cost: 0 USDC per execution.
  • Donations welcome! Please donate if you use this skill. Support development by donating to: 0x1C7f7c428dE42B8402F8331612131cc8bC126369 (Base Mainnet).
  • Donations Address: 0x1C7f7c428dE42B8402F8331612131cc8bC126369
  • Network: Base Mainnet.
  • πŸ’° How It Works (Upfront Mode)

    Payment Flow:

    1. Calculate total collateral: payment Γ— multiplier Γ— (1 + buffer%) 2. Transfer payment immediately to recipient (seller gets paid NOW) 3. Deposit remaining collateral in Aave V3 4. Yield accumulates on deposited collateral 5. Buyer recovers the payment amount over time via yield

    Recovery Time Calculation:

    The amount to recover is the PAYMENT (sent to seller), NOT the total collateral.

    Recovery Time = Payment Amount / Annual Yield from Aave Deposit
    

    Example: 0.1 USDC payment, 20x collateral, 8% buffer, 3% APY

    Total Locked:      0.1 Γ— 20 Γ— 1.08 = 2.16 USDC
    Immediate Payment: 0.1 USDC β†’ sent to recipient
    Aave Deposit:      2.16 - 0.1 = 2.06 USDC
    Aave example APY   ~3% 
    Annual Yield:      2.06 Γ— 3% = 0.0618 USDC/year
    Amount to Recover: 0.1 USDC (the payment, NOT the collateral)
    Recovery Time:     0.1 / 0.0618 β‰ˆ 592 days (~1.6 years)
    

    Why Higher Collateral = Faster Recovery:

    | Multiplier | Aave Deposit | Annual Yield | Recovery Time | |------------|-------------|--------------|---------------| | 3Γ— | 0.224 USDC | 0.0067 USDC | ~15 years | | 5Γ— | 0.440 USDC | 0.0132 USDC | ~7.5 years | | 10Γ— | 0.980 USDC | 0.0294 USDC | ~3.4 years | | 20Γ— | 2.060 USDC | 0.0618 USDC | ~1.6 years |

    More collateral deposited in Aave β†’ more yield generated β†’ faster recovery of the payment amount.

    πŸš€ Quick Start

    Prerequisites

  • Node.js 18+
  • Base network wallet with ETH for gas
  • USDC tokens for collateral
  • Installation

    cd your-project
    npm install viem dotenv
    

    Configuration

    1. Copy .env.example to .env 2. Set your PRIVATE_KEY and BASE_RPC_URL 3. Verify contract addresses for Base network

    Usage

    # Check configuration
    node scripts/check-configuration.js

    Safe simulation testing (no transactions)

    node scripts/test-realistic-payment.js

    RECOMMENDED WORKFLOW:

    Step 1: Test with dry-run first (no on-chain execution)

    node scripts/cli.js --dry-run --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Step 2: Execute real transaction with interactive confirmation

    node scripts/cli.js --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Advanced: Skip confirmation after thorough review (use with caution)

    node scripts/cli.js --confirm --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Custom collateral multiplier

    node scripts/cli.js --mode upfront --amount 0.5 --recipient 0x... --collateral 10 --buffer 5

    πŸ“ Project Structure

    yield-farm-payment/
    β”œβ”€β”€ SKILL.md                    # This documentation
    β”œβ”€β”€ .env.example                # Configuration template
    β”œβ”€β”€ package.json                # Dependencies
    β”œβ”€β”€ scripts/
    β”‚   β”œβ”€β”€ cli.js                  # CLI interface (upfront mode only in v1.0)
    β”‚   β”œβ”€β”€ yield-farm-payment.js   # Core payment logic (active)
    β”‚   β”œβ”€β”€ transaction-manager.js  # Robust transaction handling
    β”‚   β”œβ”€β”€ collateral-calculator.js # Collateral optimization
    β”‚   β”œβ”€β”€ check-configuration.js  # Config validation
    β”‚   └── test-realistic-payment.js # Comprehensive tests
    └── references/
        β”œβ”€β”€ aave-addresses.md       # Aave contract addresses (v1.0)
        └── v2.0-planned/           # Planned features for future release
            β”œβ”€β”€ 10x-collateral-guide.md
            β”œβ”€β”€ flexible-collateral-guide.md
            └── x402-integration.md
    

    πŸ”§ Configuration

    Environment Variables (.env)

    # Required
    PRIVATE_KEY=0x...              # Your wallet private key
    BASE_RPC_URL=https://...       # Base network RPC

    Aave V3 Contracts (Base)

    AAVE_V3_POOL_ADDRESS=0xA238Dd80C259a72e81d7e4664a9801593F98d1c5 USDC_ADDRESS=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 AAVE_USDC_TOKEN_ADDRESS=0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB

    Settings

    SKILL_FEE_USDC=0 # Fee per skill call DEFAULT_COLLATERAL_MULTIPLIER=20 # 20x default for ~1.6 year recovery DEFAULT_BUFFER_PERCENTAGE=8 ESTIMATED_APY=0.03 # 3% conservative APY estimate

    πŸ”’ Security & Safety

    Built-in Protections

  • Balance Verification: Pre-transaction checks
  • Gas Limit Monitoring: Prevents excessive fees
  • Transaction Retry: 3 attempts with gas price escalation
  • Nonce Management: Handles concurrent transactions
  • Transaction Confirmation & Prevention of Accidents

  • Interactive Confirmation Prompt: Required before sending real transactions
  • Clear Transaction Preview: Shows amount, recipient, collateral, and recovery estimates
  • Amount Limits: Maximum 1000 USDC on mainnet, 1000 USDC on testnet
  • Dry-Run Mode: Test transactions without on-chain execution (--dry-run flag)
  • Dual Confirmation on Mainnet: Two separate confirmations required for mainnet transactions
  • Address Validation: Verifies recipient and wallet addresses before execution
  • CLI Safety Flags

    # Test with dry-run first (RECOMMENDED)
    node scripts/cli.js --dry-run --amount 0.1 --recipient 0x...

    Real transaction with interactive confirmation (default)

    node scripts/cli.js --amount 0.1 --recipient 0x...

    Skip confirmation only after thorough review (use with caution)

    node scripts/cli.js --confirm --amount 0.1 --recipient 0x...

    Risk Management

  • Collateral Buffer: 5-15% safety margin
  • APY Estimation: Conservative 3% default
  • Multiplier Limits: 3x minimum, 20x maximum
  • 🚨 Error Handling

    Common Errors & Solutions

  • "replacement transaction underpriced": Automatic retry with increased gas
  • "insufficient funds": Balance verification before transaction
  • "nonce too low": Automatic nonce management
  • Contract errors: Detailed logging and fallback
  • πŸ“ˆ Roadmap

    v2.0 Planned Features

  • Standard Mode: Yield streaming via x402 protocol
  • Smart Mode: Deadline optimization
  • x402 Integration: Trustless automatic yield distribution to sellers
  • Multi-token Support: USDT, wETH, etc.
  • πŸ“„ License

    MIT License

    πŸ™ Acknowledgments

  • Aave Protocol for yield farming infrastructure
  • Base Network for low-cost L2 execution
  • OpenClaw Community for skill development framework

  • YieldFarmPayment v1.0 β€” Immediate payments with capital recovery on Base network. πŸš€

    πŸ’‘ Examples

    # Check configuration
    node scripts/check-configuration.js

    Safe simulation testing (no transactions)

    node scripts/test-realistic-payment.js

    RECOMMENDED WORKFLOW:

    Step 1: Test with dry-run first (no on-chain execution)

    node scripts/cli.js --dry-run --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Step 2: Execute real transaction with interactive confirmation

    node scripts/cli.js --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Advanced: Skip confirmation after thorough review (use with caution)

    node scripts/cli.js --confirm --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Custom collateral multiplier

    node scripts/cli.js --mode upfront --amount 0.5 --recipient 0x... --collateral 10 --buffer 5

    βš™οΈ Configuration

    1. Copy .env.example to .env 2. Set your PRIVATE_KEY and BASE_RPC_URL 3. Verify contract addresses for Base network

    Usage

    # Check configuration
    node scripts/check-configuration.js

    Safe simulation testing (no transactions)

    node scripts/test-realistic-payment.js

    RECOMMENDED WORKFLOW:

    Step 1: Test with dry-run first (no on-chain execution)

    node scripts/cli.js --dry-run --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Step 2: Execute real transaction with interactive confirmation

    node scripts/cli.js --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Advanced: Skip confirmation after thorough review (use with caution)

    node scripts/cli.js --confirm --amount 0.1 --recipient 0x... --collateral 5 --buffer 8

    Custom collateral multiplier

    node scripts/cli.js --mode upfront --amount 0.5 --recipient 0x... --collateral 10 --buffer 5