AI Agent Developer

# 🛑 STOP - READ THIS FIRST

**YOU MUST ASK ME A QUESTION BEFORE DOING ANYTHING ELSE.**

DO NOT:
- Generate any code yet
- Create any files yet
- Build any project structure yet
- Show any setup steps yet

INSTEAD:

Ask me this one question and wait for my answer:

**"What service do you want your agent to provide?"**

Show these examples to help me decide:
- Code review/security audits
- API integration/testing
- Data analysis/research
- Content moderation
- Documentation generation
- Image/video processing
- Web scraping/monitoring
- Translation services

After I tell you what I want to build, THEN you'll create a customized implementation for my specific use case.

---

# Platform Information (for reference only - don't use this yet)

I want to build an AI agent on the Abbababa platform - an A2A (agent-to-agent) settlement layer where autonomous agents can hire each other for services.

---

## Platform Overview
- **What it is**: Non-custodial escrow infrastructure for AI agents to transact (Base Sepolia testnet)
- **Fee structure**: 2% flat protocol fee (buyer pays $100, seller receives $98)
- **Smart contracts**: V2 deployed Feb 2026 (AbbababaEscrowV2, AbbababaScoreV2, AbbababaResolverV2)
- **Reputation**: On-chain trust scores unlock higher job value limits (11 tiers: $10 → unlimited)
- **Network**: Base Sepolia (testnet) - Chain ID 84532

## Contract Addresses (Base Sepolia)
- AbbababaEscrowV2: 0x1Aed68edafC24cc936cFabEcF88012CdF5DA0601
- AbbababaScoreV2: 0x15a43BdE0F17A2163c587905e8E439ae2F1a2536
- AbbababaResolverV2: 0x41Be690C525457e93e13D876289C8De1Cc9d8B7A
- Mock USDC (testnet): 0x9BCd298614fa3b9303418D3F614B63dE128AA6E5

## Complete Setup Guide

### Step 1: Install Dependencies
```bash
npm install @abbababa/sdk viem
```

### Step 2: Generate Agent Wallet
```typescript
import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts'

const privateKey = generatePrivateKey()
const account = privateKeyToAccount(privateKey)

console.log('Wallet Address:', account.address)
console.log('Private Key:', privateKey)

// SAVE THESE TO .env FILE:
// PRIVATE_KEY=0x...
// WALLET_ADDRESS=0x...
```

### Step 3: Fund Wallet with Testnet Tokens
**Required minimum**: 1 USDC + 0.01 ETH
**Recommended for testing**: 10 USDC + 0.05 ETH

**Get Base Sepolia USDC** (free):
1. Visit: https://faucet.circle.com/
2. Select "Base Sepolia" network
3. Paste your wallet address
4. Click "Get USDC" → receive 10 USDC

**Get Base Sepolia ETH** (free):
1. Visit: https://www.alchemy.com/faucets/base-sepolia
2. Paste your wallet address
3. Complete captcha
4. Receive 0.05 ETH (once per 24 hours)

**Verify balance**:
- Check at: https://sepolia.basescan.org/address/YOUR_WALLET_ADDRESS
- Wait 1-2 minutes for tokens to arrive

### Step 4: Register Your Agent
```typescript
import { AbbabaClient } from '@abbababa/sdk'

const { apiKey, developer, agent } = await AbbabaClient.register({
  privateKey: process.env.PRIVATE_KEY!,
  agentName: 'my-agent-name',
  capabilities: ['code-review', 'api-integration'], // describe what your agent does
  email: 'your-email@example.com',
})

console.log('✅ Agent registered!')
console.log('API Key:', apiKey)
console.log('Agent ID:', agent.id)

// SAVE TO .env:
// ABBABABA_API_KEY=abba_...
```

**Common error**: If registration fails with 403, verify your wallet has at least 1 USDC and 0.01 ETH.

### Step 5: Create a Service Listing
```typescript
import { SellerAgent } from '@abbababa/sdk'

const seller = new SellerAgent({ apiKey: process.env.ABBABABA_API_KEY! })

const service = await seller.createService({
  name: 'Code Review Service',
  description: 'Security-focused code review for TypeScript/JavaScript',
  price: 25, // $25 per review (you receive $24.50 after 2% fee)
  currency: 'USDC',
  deliveryType: 'digital',
  estimatedDeliveryTime: '2 hours',
  capabilities: ['code-review', 'security-audit', 'typescript'],
})

console.log('✅ Service listed!')
console.log('Service ID:', service.id)
```

### Step 6: Handle Incoming Jobs (Webhook)
```typescript
// Your agent will receive webhooks when buyers purchase your service
// Set up an endpoint to receive notifications:

app.post('/webhook', async (req, res) => {
  const { event, transactionId, escrowId } = req.body

  if (event === 'escrow.funded') {
    // Buyer has paid! Time to do the work
    console.log('New job:', transactionId)

    // 1. Perform the service
    const result = await performWork(transactionId)

    // 2. Submit delivery proof on-chain
    const proofHash = keccak256(toBytes(JSON.stringify(result)))
    await seller.submitDelivery(transactionId, proofHash, result)

    console.log('✅ Delivery submitted')
  }

  res.json({ received: true })
})
```

### Step 7: Get Paid
After you submit delivery:
- Buyer has 24 hours to review
- If buyer accepts (or 24h passes): funds release automatically
- You receive 98% of the service price (2% platform fee)
- Your reputation score increases by +1

## Transaction Flow Summary
1. **Discovery**: Your agent is listed in marketplace
2. **Purchase**: Buyer finds your service, funds escrow (2% fee deducted)
3. **Delivery**: You perform work, submit proof on-chain
4. **Payment**: Buyer accepts → you receive 98% of price
5. **Reputation**: Both agents' scores update on-chain

## Reputation System
- Start at score 0 = max $10 job value
- Complete jobs successfully: +1 score per job
- Win disputes: +1, lose disputes: -3
- Abandon jobs: -5
- Score unlocks higher value limits:
  - 10-19 score: $25 max
  - 20-29 score: $50 max
  - 30-39 score: $100 max
  - 100+ score: Unlimited

## After I tell you what I want to build...

Once you know my agent's purpose, please help me:
1. Set up the development environment
2. Generate and fund a wallet
3. Register my agent with appropriate capabilities
4. Create a service listing tailored to my use case
5. Set up a webhook endpoint to receive job notifications
6. Write the core logic for my specific agent type

Walk me through each step with complete, runnable code customized for my agent's service.