🤖 Autonomous Agent Payment System

Coinbase Hackathon 2025 - Track: Agentic Commerce via CDP Wallets + x402-Driven Tool Chaining

A complete autonomous agent economy that spins up specialist teams, registers them on x402 bazaar networks, hires external agents, executes work, and processes real USDC payments through Locus wallet integration.

🏆 Hackathon Demo

Quick Start:

git clone https://github.com/your-username/autonomous-agent-payments.git
cd autonomous-agent-payments
pip install -r requirements.txt
cp .env.example .env  # Add your credentials
python working_complete_workflow.py

Expected Output:

• ✅ Real wallet connection to your funded Base address
• ✅ Complete 8-step autonomous workflow
• ✅ Balance changes: $10.00 → $8.00 USDC
• ✅ Real blockchain transactions on Base Mainnet

💰 Key Features

🔄 Complete Autonomous Workflow

1. Team Spinning - Creates specialist AI agents for specific tasks
2. Bazaar Registration - Registers teams to x402 marketplace for external hiring
3. Service Discovery - Finds and connects to paid API services via x402 protocol
4. External Hiring - Hires specialist agents from bazaar networks
5. Work Execution - Autonomous collaboration on complex tasks
6. Work Verification - Quality assessment and deliverable validation
7. Payment Processing - Real USDC transactions via Locus MCP
8. Balance Tracking - Real-time balance verification and audit trails

🌐 Real Integrations

• Locus Wallet - Real USDC payments with your funded wallet
• Base Mainnet - Actual blockchain transactions and gas fees
• x402 Protocol - Micropayments for API services
• Coinbase CDP - Wallet integration and management
• Composio - External tool connections (CRM, email, etc.)

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Autonomous COO                           │
│  - Orchestrates specialist teams                           │
│  - Manages budgets and payments                            │
│  - Connects to external services                           │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                Payment Systems                              │
│  - Locus MCP Client (Real USDC)                           │
│  - x402 Protocol Integration                              │
│  - Blockchain Transactions (Base)                         │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                 x402 Bazaar Network                           │
│  - Agent Discovery                                         │
│  - Service Marketplace                                      │
│  - External Hiring                                        │
└─────────────────────────────────────────────────────────────┘

📋 Files Overview

Core System

• autonomous_coo_mvp.py - Main COO orchestrator with Locus integration
• locus_mcp_client.py - Real MCP client for Locus payments
• agent_payment_system.py - Payment infrastructure and contracts
• working_complete_workflow.py - Complete end-to-end demo

Integrations

• custom_pipedrive_integration.py - CRM integration
• function_mapping_adapter.py - Tool compatibility layer

Demo

Run the complete working workflow:

python working_complete_workflow.py

This demonstrates:

• Real wallet connection: 0x2c82D71214ae663bb09245370001bd7bec29ac02
• Balance tracking: $10.00 → $8.00 USDC
• Complete autonomous agent economy

🔧 Setup Instructions

1. Environment Setup

# Clone repository
git clone https://github.com/your-username/autonomous-agent-payments.git
cd autonomous-agent-payments

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. Configuration

Copy .env.example to .env and add your credentials:

cp .env.example .env

Required for Locus Payments:

LOCUS_CLIENT_ID=your_locus_client_id_here
LOCUS_CLIENT_SECRET=your_locus_client_secret_here

Optional for LLM:

GOOGLE_GEMINI_API_KEY=your_google_gemini_api_key_here
# or
OPENAI_API_KEY=your_openai_api_key_here

3. Run Demo

python working_complete_workflow.py

💡 Use Cases

1. Autonomous Development Teams

• Spin up specialist developers for smart contract projects
• Pay upon successful delivery and verification
• Real blockchain transactions for complete transparency

2. API Service Integration

• Discover and pay for external API services via x402
• Micropayments for data processing and analysis
• Automatic budget management and cost tracking

3. Multi-Agent Workflows

• Coordinate teams of specialized AI agents
• External specialist hiring from bazaar networks
• Automated payment processing and quality control

🔍 Technical Details

Payment Flow

1. Work Assignment - COO assigns task to specialist team
2. External Hiring - Additional specialists hired from x402 bazaar
3. Work Execution - Autonomous collaboration and development
4. Verification - Quality assessment of deliverables
5. Payment Processing - Real USDC transfers via Locus MCP
6. Balance Confirmation - On-chain verification of transactions

Blockchain Integration

• Network: Base Mainnet (Chain ID: 8453)
• Currency: USDC (USD Coin)
• Wallet: Your Locus-managed wallet
• Transaction Type: Email escrow and direct wallet transfers

x402 Protocol

• Discovery: Real-time service marketplace access
• Pricing: Micropayment per API call (typically $0.01-$0.10)
• Payment: Automatic USDC deduction per service use
• Verification: On-chain transaction proofs

🏅 Hackathon Submission

Track: Agentic Commerce via CDP Wallets + x402-Driven Tool Chaining

Prize: $2,500 USDC

What We've Built:

✅ CDP Wallet Integration - Real Locus wallet with $10 USDC balance ✅ x402 Protocol - Complete micropayment system for API services ✅ Autonomous Agents - Team spinning and management system ✅ Real Payments - Actual USDC transactions on Base Mainnet ✅ Tool Chaining - External service integration and automation ✅ Complete Workflow - End-to-end autonomous economy demonstration

Demo Highlights:

• Real wallet address with funded balance
• Actual balance changes ($10.00 → $8.00 USDC)
• Blockchain transaction verification
• Complete autonomous agent lifecycle
• Working x402 bazaar integration

📞 Contact

Built for Coinbase Hackathon 2025

• Demonstrates real autonomous agent economy
• Production-ready payment infrastructure
• Complete x402 protocol implementation

Repository: https://github.com/your-username/autonomous-agent-payments

---

This project demonstrates the future of autonomous work - where AI agents can form teams, hire specialists, execute complex projects, and process real payments autonomously on blockchain infrastructure.