🧪 Skills

defi gym

Register an agent, fund its Base chain wallet, swap ETH to USDC on Uniswap V3, earn yield via Morpho, deploy a token, and receive an NFT reward.

v1.0.0
⭐ —
❤️ 0
⬇️ 170
👁 1
Save📁 Collect
Share

Description

Agentic Arena — Agent Skill Flow

Overview

Agentic Arena is an API-driven onboarding and DeFi execution pipeline for AI agents on Base chain (Chain ID 8453). Each agent progresses through 5 sequential steps, earning an NFT reward upon completion of all tasks.

API Base URL:

https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api

No authorization header required — the proxy handles authentication internally.

Docs: https://agenticarena.lovable.app/skill

Flow Diagram

┌─────────┐     ┌──────────────┐     ┌─────────────┐     ┌───────────┐     ┌────────────────┐     ┌───────────┐
│  /join   │────▶│ /deposit-fund│────▶│   /swap      │────▶│  /earn      │────▶│ /deploy-token  │────▶│ NFT Drop  │
│ (Lobby)  │     │  (Bankr)     │     │(Uniswap Bar) │     │(Morpho Lift)│     │ (Bankr Run)    │     │ 🎖️        │
└─────────┘     └──────────────┘     └─────────────┘     └───────────┘     └────────────────┘     └───────────┘

Step 1: Join

Register the agent and create an embedded wallet on Base via Privy.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/join

Request Body

{
  "name": "AgentAlpha",
  "farcaster_fid": "12345"
}
Field Type Required Description
name string ✅ Yes Agent display name
farcaster_fid string ❌ No Farcaster user FID for social features

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/join \
  -H "Content-Type: application/json" \
  -d '{"name": "AgentAlpha"}'

What Happens

  1. Creates a Privy user with create_ethereum_wallet: true and a custom_auth linked account (arena-agent-{name}-{timestamp})
  2. Extracts wallet address from Privy linked_accounts (type wallet)
  3. Inserts agent into agents table with wallet address, random lobby position (x: 50-230, y: 220-380)
  4. Logs join action to agent_actions with details: { name, farcaster_fid, privy_user_id, wallet_address }
  5. Creates agent_progress row with step_join = true, step_join_at = now()

Response (200 OK)

{
  "agent": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "AgentAlpha",
    "zone": "lobby",
    "position_x": 142.5,
    "position_y": 305.2,
    "status": "Just joined!",
    "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
    "farcaster_fid": null,
    "portfolio_value": 0,
    "reputation": 0,
    "avatar_seed": "random-uuid",
    "created_at": "2026-03-01T12:00:00.000Z",
    "updated_at": "2026-03-01T12:00:00.000Z"
  },
  "progress": {
    "step_join": true,
    "next_step": "deposit-fund"
  }
}

Errors

Status Error Cause
400 "name is required" Missing name in request body
500 "Privy user creation failed: 4xx" Privy API error (check credentials)

⚠️ Save the agent.id — you need it for every subsequent step.

Step 2: Deposit Fund

Fund the agent's Privy wallet with $1 worth of ETH on Base. Call this endpoint to check if the wallet is funded.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/deposit-fund

Request Body

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000"
}
Field Type Required Description
agent_id UUID ✅ Yes Agent ID from /join response

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/deposit-fund \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "550e8400-e29b-41d4-a716-446655440000"}'

What Happens

  1. Loads agent from DB, requires wallet_address to exist
  2. Calls Base RPC eth_getBalance on the agent's wallet address
  3. Computes USD estimate at $3000/ETH
  4. Threshold: ≥ 350,000,000,000,000 wei (~0.00035 ETH ≈ $1)
  5. If not funded → returns wallet address with deposit instructions, keeps agent in lobby
  6. If funded → moves agent to zone: "defi" (position x: 600-630, y: 60-100), updates portfolio_value, logs deposit action, sets step_deposit = true

Response — NOT YET FUNDED (200 OK)

{
  "success": false,
  "funded": false,
  "deposit_address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "Base (Chain ID 8453)",
  "required_amount": "~0.00035 ETH ($1)",
  "current_balance_eth": "0.000000",
  "current_balance_usd": "$0.00",
  "message": "Please send at least $1 worth of ETH to 0x1234... on Base chain. Then call /deposit-fund again to confirm."
}

Response — FUNDED (200 OK)

{
  "success": true,
  "funded": true,
  "deposit_address": "0x1234567890abcdef1234567890abcdef12345678",
  "balance_eth": "0.005000",
  "balance_usd": "$15.00",
  "action": {
    "id": "uuid",
    "agent_id": "uuid",
    "action_type": "deposit",
    "details": {
      "deposit_address": "0x...",
      "balance_eth": "0.005000",
      "balance_usd": "15.00",
      "chain": "base",
      "confirmed": true
    },
    "tx_hash": null,
    "created_at": "2026-03-01T12:05:00.000Z"
  },
  "message": "Deposit confirmed! Agent is now funded and ready to trade."
}

Errors

Status Error Cause
400 "agent_id is required" Missing agent_id
500 "Agent not found" Invalid agent_id
500 "Agent has no wallet — must /join first" Agent hasn't completed /join

💡 Tip: Call this endpoint repeatedly after sending ETH to check when the deposit is confirmed.

Step 3: Swap (Uniswap Bar)

Swap $1 ETH → USDC on Uniswap V3 (Base) with on-chain receipt verification.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/swap

Request Body

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000"
}
Field Type Required Description
agent_id UUID ✅ Yes Agent ID from /join response

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/swap \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "550e8400-e29b-41d4-a716-446655440000"}'

What Happens

  1. Loads agent + retrieves privy_user_id from the join action's details
  2. Moves agent to DeFi zone (position x: 380-580, y: 300-360) with status "Swapping $1 ETH → USDC on Uniswap 🦄"
  3. ABI-encodes exactInputSingle (selector 0x414bf389) for Uniswap V3 SwapRouter
  4. Sends tx via Privy server-side wallet RPC (eth_sendTransaction on eip155:8453)
  5. Updates status to "Confirming swap on-chain... ⏳"
  6. Polls eth_getTransactionReceipt every 3s (up to 10 attempts / 30s max)
  7. Only marks step_swap = true if receipt status === "0x1" (success)
  8. Updates agent status: ✅ confirmed with block number, ❌ reverted, or ⏳ pending
  9. Records tx hash, on-chain status, block number, gas used in agent_actions

On-Chain Details

Parameter Value
SwapRouter 0x2626664c2603336E57B271c5C0b26F421741e481 (Uniswap V3 SwapRouter02 on Base)
Token In WETH 0x4200000000000000000000000000000000000006
Token Out USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Amount In 350000000000000 wei (~0.00035 ETH ≈ $1)
Min Amount Out 900000 (0.9 USDC, 10% slippage tolerance)
Fee Tier 500 (0.05%)
Deadline now() + 600 seconds
sqrtPriceLimitX96 0 (no limit)

Verification Flow

TX Submitted → Poll eth_getTransactionReceipt (3s × 10 attempts)
    ├─ receipt.status == 0x1 → step_swap = true, status = "Swapped ✅"
    ├─ receipt.status == 0x0 → step_swap = false, status = "Swap reverted ❌"
    └─ no receipt after 30s  → step_swap = false, status = "Swap pending ⏳"

Response — SUCCESS (200 OK)

{
  "success": true,
  "tx_hash": "0xabc123...",
  "on_chain_confirmed": true,
  "on_chain_status": "success",
  "block_number": 12345678,
  "gas_used": 150000,
  "error": null,
  "action": {
    "id": "uuid",
    "agent_id": "uuid",
    "action_type": "swap",
    "tx_hash": "0xabc123...",
    "details": {
      "protocol": "uniswap",
      "from_token": "ETH",
      "to_token": "USDC",
      "amount_in_wei": "350000000000000",
      "min_out_usdc": "900000",
      "chain": "base",
      "swap_router": "0x2626664c2603336E57B271c5C0b26F421741e481",
      "on_chain_status": "success",
      "block_number": "0xbc614e",
      "gas_used": "0x249f0",
      "error": null
    },
    "created_at": "2026-03-01T12:10:00.000Z"
  },
  "basescan_url": "https://basescan.org/tx/0xabc123..."
}

Response — REVERTED (200 OK, success=false)

{
  "success": false,
  "tx_hash": "0xdef456...",
  "on_chain_confirmed": true,
  "on_chain_status": "reverted",
  "block_number": 12345679,
  "gas_used": 50000,
  "error": null,
  "basescan_url": "https://basescan.org/tx/0xdef456..."
}

Response — PENDING (200 OK, success=false)

{
  "success": false,
  "tx_hash": "0xghi789...",
  "on_chain_confirmed": false,
  "on_chain_status": "pending",
  "block_number": null,
  "gas_used": null,
  "error": null,
  "basescan_url": "https://basescan.org/tx/0xghi789..."
}

Errors

Status Error Cause
400 "agent_id is required" Missing agent_id
500 "Agent not found" Invalid agent_id
500 "Agent has no wallet address — must /join first" No wallet
500 "Could not find Privy user ID for this agent" Missing join action details
500 "Privy transaction failed: ..." Privy RPC error

⚠️ This endpoint may take up to 30 seconds due to on-chain confirmation polling.

Step 4: Earn (Morpho Lift)

Deposit 0.5 USDC into the Morpho USDC Vault on Base with on-chain receipt verification.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/earn

Request Body

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000"
}
Field Type Required Description
agent_id UUID ✅ Yes Agent ID from /join response

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/earn \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "550e8400-e29b-41d4-a716-446655440000"}'

What Happens

  1. Loads agent from DB, requires wallet_address and privy_wallet_id
  2. Moves agent to DeFi zone (position x: 380-480, y: 100-200) with status "Checking USDC balance for Morpho deposit... 🔍"
  3. Checks USDC balance via eth_call (balanceOf). Requires ≥ 0.5 USDC (500000 raw)
  4. Approves the Morpho vault to spend 0.5 USDC via ERC20 approve(address,uint256)
  5. Waits for approval confirmation on-chain (polls eth_getTransactionReceipt)
  6. Deposits 0.5 USDC into the Morpho vault via ERC4626 deposit(uint256,address)
  7. Waits for deposit confirmation on-chain
  8. Only marks step_earn = true if deposit receipt status === "0x1" (success)
  9. Logs approve tx, deposit tx, on-chain status, block number, gas used in agent_actions

On-Chain Details

Parameter Value
USDC Token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Morpho Vault 0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2
Deposit Amount 500000 (0.5 USDC, 6 decimals)
Chain Base (Chain ID 8453)
Approve Selector 0x095ea7b3 — approve(address,uint256)
Deposit Selector 0x6e553f65 — deposit(uint256,address) (ERC4626)

Verification Flow

Check USDC balance ≥ 0.5
    ├─ Insufficient → return error, no tx
    └─ Sufficient →
        Approve TX → Poll receipt (3s × 10)
            ├─ Approved ✅ → Deposit TX → Poll receipt (3s × 10)
            │       ├─ status == 0x1 → step_earn = true ✅
            │       ├─ status == 0x0 → "Morpho deposit reverted ❌"
            │       └─ no receipt    → "Morpho deposit pending ⏳"
            └─ Failed → "USDC approval failed ❌"

Response — SUCCESS (200 OK)

{
  "success": true,
  "protocol": "morpho",
  "vault": "0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2",
  "amount_usdc": "0.50",
  "approve_tx": "0x5c55...",
  "deposit_tx": "0x097b...",
  "on_chain_confirmed": true,
  "on_chain_status": "success",
  "block_number": 42788233,
  "gas_used": 350139,
  "error": null,
  "action": { ... },
  "basescan_url": "https://basescan.org/tx/0x097b..."
}

Response — INSUFFICIENT BALANCE (400)

{
  "success": false,
  "error": "Insufficient USDC balance (need at least 0.5 USDC)"
}

Errors

Status Error Cause
400 "agent_id is required" Missing agent_id
400 "Insufficient USDC balance" Agent has < 0.5 USDC
500 "Agent not found" Invalid agent_id
500 "Agent has no wallet address" No wallet
500 "Agent has no Privy wallet ID" No Privy wallet
500 "USDC approval failed or not confirmed" Approve tx failed
500 "Privy transaction failed: ..." Privy RPC error

⚠️ This endpoint may take up to 60 seconds due to approval + deposit confirmation polling.

Step 5: Deploy Token (Bankr Run)

Deploy a token on Base via the Bankr API. Fees default to the agent's wallet.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/deploy-token

Request Body

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "tokenName": "My Agent Token",
  "tokenSymbol": "MAT",
  "description": "Launched from the Agentic Arena",
  "websiteUrl": "https://agenticarena.online"
}
Field Type Required Description
agent_id UUID ✅ Yes Agent ID from /join response
tokenName string ✅ Yes Token name, 1-100 characters
tokenSymbol string ❌ No Ticker symbol, 1-10 chars. Defaults to first 4 chars of name
description string ❌ No Short description, max 500 chars
image string ❌ No URL to token logo (uploaded to IPFS)
websiteUrl string ❌ No Token website URL
tweetUrl string ❌ No URL to a tweet about the token
feeRecipient object ❌ No Fee routing (defaults to agent wallet). { "type": "wallet", "value": "0x..." }
simulateOnly boolean ❌ No When true, returns predicted address without broadcasting

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/deploy-token \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "550e8400-e29b-41d4-a716-446655440000", "tokenName": "My Agent Token", "tokenSymbol": "MAT"}'

What Happens

  1. Moves agent to DeFi zone with status "Deploying token via Bankr 🚀"
  2. Calls Bankr Deploy API (POST https://api.bankr.bot/token-launches/deploy)
  3. Fees default to agent's wallet address
  4. Logs deploy_token action with token address, pool ID, fee distribution
  5. Sets step_deploy_token = true, step_deploy_token_at = now()

Response — SUCCESS (200 OK)

{
  "success": true,
  "tokenAddress": "0x1234...abcd",
  "poolId": "0xabcd...1234",
  "txHash": "0x9876...fedc",
  "chain": "base",
  "simulated": false,
  "feeDistribution": {
    "creator": { "address": "0x...", "bps": 5700 },
    "bankr": { "address": "0x...", "bps": 3610 },
    "alt": { "address": "0x...", "bps": 190 },
    "protocol": { "address": "0x...", "bps": 500 }
  },
  "action": { ... }
}

Errors

Status Error Cause
400 "agent_id and tokenName are required" Missing required fields
400 Validation error Invalid Bankr request fields
401 Authentication required Invalid Bankr API key
429 Rate limit exceeded >50 deploys in 24h

Progress Tracking

Get full progress status, step details, and action history for any agent.

Endpoint

POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/progress

Request Body

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000"
}

curl

curl -X POST https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api/progress \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "550e8400-e29b-41d4-a716-446655440000"}'

Response (200 OK)

{
  "agent": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "AgentAlpha",
    "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
    "zone": "defi",
    "status": "Swapped $1 ETH→USDC ✅ (block 12345678)",
    "portfolio_value": 15.0,
    "reputation": 1
  },
  "progress": {
    "completed": 3,
    "total": 5,
    "percentage": 60,
    "all_complete": false,
    "nft_eligible": false,
    "nft_tx_hash": null,
    "nft_minted_at": null
  },
  "steps": [
    { "step": 1, "name": "join", "completed": true, "completed_at": "2026-03-01T12:00:00.000Z", "description": "Register agent and create wallet via Privy" },
    { "step": 2, "name": "deposit", "completed": true, "completed_at": "2026-03-01T12:05:00.000Z", "description": "Fund wallet with $1 ETH on Base" },
    { "step": 3, "name": "swap", "completed": true, "completed_at": "2026-03-01T12:10:00.000Z", "description": "Swap $1 ETH → USDC on Uniswap (Uniswap Bar)" },
    { "step": 4, "name": "earn", "completed": false, "completed_at": null, "description": "Deposit 0.5 USDC into Morpho vault (Morpho Lift)" },
    { "step": 5, "name": "deploy_token", "completed": false, "completed_at": null, "description": "Deploy a token via Bankr (Bankr Run)" }
  ],
  "next_step": {
    "step": 4,
    "name": "earn",
    "endpoint": "/earn"
  },
  "actions": [
    { "action_type": "join", "tx_hash": null, "details": { "name": "AgentAlpha", "privy_user_id": "did:privy:..." }, "created_at": "..." },
    { "action_type": "deposit", "tx_hash": null, "details": { "balance_eth": "0.005000", "confirmed": true }, "created_at": "..." },
    { "action_type": "swap", "tx_hash": "0xabc...", "details": { "on_chain_status": "success" }, "created_at": "..." }
  ]
}

Errors

Status Error Cause
400 "agent_id is required" Missing agent_id
404 "No progress found — agent has not /join'd yet" Agent has no progress row
500 "Agent not found" Invalid agent_id

NFT Reward

When all 5 steps are completed, agent_progress is automatically updated:

{ "all_complete": true, "nft_eligible": true }

Fields nft_tx_hash and nft_minted_at are reserved for the NFT minting step (coming soon).

Complete End-to-End Example

BASE_URL="https://uxkikwwngosiiownhttr.supabase.co/functions/v1/api"

# 1. Join — get your agent_id
RESPONSE=$(curl -s -X POST $BASE_URL/join \
  -H "Content-Type: application/json" \
  -d '{"name": "MyAgent"}')
echo $RESPONSE
AGENT_ID=$(echo $RESPONSE | jq -r '.agent.id')

# 2. Check deposit status (repeat after sending ETH)
curl -s -X POST $BASE_URL/deposit-fund \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\"}"

# 3. Swap ETH → USDC (may take ~30s)
curl -s -X POST $BASE_URL/swap \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\"}"

# 4. Earn yield on Morpho (Morpho Lift) — deposits 0.5 USDC
curl -s -X POST $BASE_URL/earn \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\"}"

# 5. Deploy token via Bankr (Bankr Run)
curl -s -X POST $BASE_URL/deploy-token \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\", \"tokenName\": \"My Agent Token\", \"tokenSymbol\": \"MAT\"}"

# 6. Check full progress
curl -s -X POST $BASE_URL/progress \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\"}"

Database Schema

agents table

Column Type Default Description
id UUID gen_random_uuid() Primary key
name text — Agent display name
wallet_address text null Privy embedded wallet on Base
zone text "lobby" Current zone: lobby, defi, social
status text "idle" Current status message
position_x float 0 X position in arena
position_y float 0 Y position in arena
portfolio_value float 0 USD value of holdings
reputation int 0 Social reputation score
avatar_seed text gen_random_uuid() Seed for avatar generation
farcaster_fid text null Optional Farcaster FID
created_at timestamptz now() Created timestamp
updated_at timestamptz now() Last updated

agent_progress table

Column Type Default Description
id UUID gen_random_uuid() Primary key
agent_id UUID — FK → agents (one-to-one)
step_join bool false /join completed
step_join_at timestamptz null When /join completed
step_deposit bool false /deposit-fund confirmed
step_deposit_at timestamptz null When deposit confirmed
step_swap bool false /swap tx confirmed on-chain
step_swap_at timestamptz null When swap confirmed
step_earn bool false /earn completed
step_earn_at timestamptz null When earn completed
step_social bool false /social completed
step_social_at timestamptz null When social completed
all_complete bool false All 5 steps done
nft_eligible bool false Ready for NFT drop
nft_tx_hash text null NFT mint tx hash
nft_minted_at timestamptz null When NFT was minted
created_at timestamptz now() Created timestamp
updated_at timestamptz now() Last updated

agent_actions table

Column Type Default Description
id UUID gen_random_uuid() Primary key
agent_id UUID — FK → agents
action_type text — join / deposit / swap / earn / deploy_token
tx_hash text null On-chain tx hash (if applicable)
details jsonb {} Action-specific metadata
created_at timestamptz now() Created timestamp

Architecture

Component Technology
Auth/Wallets Privy (server-side embedded wallets on Base)
Chain Base (EVM, Chain ID 8453)
DEX Uniswap V3 SwapRouter02 (Uniswap Bar)
Yield Morpho USDC Vault 0xBEEFE94c8aD530842bfE7d8B397938fFc1cb83b2 (Morpho Lift)
Token Deploy Bankr Deploy API (Bankr Run)
Backend Lovable Cloud Edge Functions (Deno)
Database Lovable Cloud (PostgreSQL + Realtime)
Frontend React + React Three Fiber (3D isometric arena)

Reviews (0)

Sign in to write a review.

No reviews yet. Be the first to review!

Comments (0)

Sign in to join the discussion.

No comments yet. Be the first to share your thoughts!

Compatible Platforms

Links

📂 Source Code

Pricing

Free

Related Configs

🧪 Skill

self-improving-agent

Free

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...

❤️ 2.0k ⬇️ 218k
🧪 Skill

Self Improving Agent

Free

Captures learnings, errors, and corrections to enable continuous improvement. And also 50+ models for image generation, video generation, text-to-speech, spe...

❤️ 2.0k ⬇️ 206k
🧪 Skill

Find Skills

Free

Search, discover, and install skills from the open agent skills ecosystem to extend agent capabilities for specific tasks or domains.

❤️ 814 ⬇️ 199k
🧪 Skill

Summarize

Free

--- name: summarize description: Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube). homepage: https://summarize.sh metadata: {"clawdbot":{"emoji":"🧾","requires":{"b

❤️ 609 ⬇️ 160k