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...
---
name: yield-farm-payment
version: 1.0.18
author: altoninelli
description: "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", "Payment amount recovery", "Savings", "Payment", "Base network", "Automation", "Aave"]
price_per_call: 0.2 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
## ๐ฐ Fee Structure & Monetization
- **Model:** Pay-per-successful-execution.
- **Cost:** Fixed 0.20 USDC fee per successful payment.
- **Payment timing:** Fee is collected ONLY after both recipient payment and Aave collateral deposit succeed.
- **Developer Address:** 0x785cF69cEd4E20A7e975A3391d51321b1528Fdfe (Base Mainnet)
- **Risk-free for users:** If payment or collateral deposit fails, no fee is charged.
- **Network:** Base Mainnet.
## ๐ฐ How It Works (Upfront Mode)
### Payment Flow:
1. **Calculate total required**: `payment + 0.2 USDC fee + (payment ร multiplier ร (1 + buffer%))`
2. **Transfer payment immediately** to recipient (seller gets paid NOW)
3. **Deposit remaining collateral** in Aave V3
4. **If steps 2+3 succeed**: Transfer 0.2 USDC fee to developer
5. **Yield accumulates** on deposited collateral
6. **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
```
Collateral Only: 0.1 ร 20 ร 1.08 = 2.16 USDC
Developer Fee: 0.2 USDC (fixed, paid only after success)
Immediate Payment: 0.1 USDC โ sent to recipient
Total Required: 0.1 + 0.2 + 2.16 = 2.46 USDC
Aave Deposit: 2.46 - 0.1 - 0.2 = 2.16 USDC
Aave example APY ~3%
Annual Yield: 2.16 ร 3% = 0.0648 USDC/year
Amount to Recover: 0.1 USDC (the payment, NOT the collateral)
Recovery Time: 0.1 / 0.0648 โ 565 days (~1.55 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
```bash
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
```bash
# 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 (ALWAYS REQUIRED)
node scripts/cli.js --amount 0.1 --recipient 0x... --collateral 5 --buffer 8
# Custom collateral multiplier
node scripts/cli.js --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)
```bash
# 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.2 # Fixed 0.2 USDC fee to developer
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
- **Mandatory Interactive Confirmation**: User MUST explicitly confirm every transaction (no option to skip)
- **Clear Transaction Preview**: Shows amount, recipient, collateral, fee, 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)
- **Address Validation**: Verifies recipient and wallet addresses before execution
### CLI Safety Flags
```bash
# Test with dry-run first (RECOMMENDED)
node scripts/cli.js --dry-run --amount 0.1 --recipient 0x...
# Real transaction with interactive confirmation (ALWAYS REQUIRED)
node scripts/cli.js --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. ๐
don't have the plugin yet? install it then click "run inline in claude" again.