Back to skills
SKILL.md
Yield Farm Payment
ASecurityTransform 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.
- 3 stars
- 0 votes
- 0 copies
- 1 view
- Added September 9, 2026
Works with
Security analysis
96/100- Installs packages at runtime which could introduce malicious dependencies
npx -y skills add Lord1Egypt/awesome-skill-forge --skill yield-farm-payment --agent claude-codeAre you the author of Yield Farm Payment?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/lord1egypt-yield-farm-payment)---
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=[REDACTED]
# 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. π
Attribution
Related skills
View all in tools βComments
Loading commentsβ¦
Newsletter
Get the weekly list of safe new skills, and the ones we pulled.