DEV Community

Prema Ananda
Prema Ananda Subscriber

Posted on

🚀 AgentBounty User Guide

#cryptocurrency #tutorial #ai #web3

Main article: Building a Pay-Per-Use AI Agent Marketplace with Auth0 + Web3

Complete Guide to Using the AI Agent Platform with Cryptocurrency Payments

📖 Table of Contents

  1. What is AgentBounty
  2. Quick Start: Demo Mode
  3. Registration and Login
  4. Wallet Connection
  5. Working with AI Agents
  6. Payment and Receiving Results
  7. Task History
  8. Frequently Asked Questions
  9. Troubleshooting

What is AgentBounty

AgentBounty is a decentralized AI agent marketplace where you only pay for completed tasks. The platform uses USDC cryptocurrency on the Base Sepolia network to pay for artificial intelligence services.

Key Features:

✅ Pay-per-use model — pay only for results
✅ Multiple AI agents — fact-checking, travel planning, and more
✅ Cryptocurrency payments — fast and secure with USDC
✅ Transparency — you know the cost before task execution begins
✅ Security — payment only occurs after receiving results

Available AI Agents:

  1. 🔍 FactCheck Agent — verifying information accuracy
  2. ✈️ Travel Planner Agent — trip planning and hotel selection

Quick Start: Demo Mode

Want to try the platform without registration and setup?

Demo mode allows you to:

  • Explore the platform interface
  • See examples of AI agents in action
  • Familiarize yourself with the payment process

How to launch demo mode:

  1. Open your browser
  2. Go to: https://agentbounty.premananda.site/?demo=true
  3. The platform will automatically log in with a demo user
  4. 2 examples of completed tasks are available

Demo Mode

💡 Tip: Demo mode is perfect for getting familiar with the platform. When you're ready to work with real agents, register.

Exiting demo mode:

Click the "Exit Demo" button in the yellow banner at the top of the page.

Registration and Login

Step 1: Open the platform

Go to the main page: https://agentbounty.premananda.site/

Login

Step 2: Choose login method

Click the "Login" button in the upper right corner.

You'll have several login options available:

  1. Email/Password — classic registration
  2. GitHub — login through GitHub account
  3. Google — login through Google account (in development)

Step 3: Create an account (for new users)

If it's your first time on the platform:

  1. Select "Sign Up" on the login page
  2. Enter your email and create a password
  3. Confirm email (check your inbox)
  4. Log in with the created credentials

Step 4: Successful login

After logging in, you'll see:

  • Your name in the upper right corner
  • "Connect Wallet" button to connect your wallet
  • Area for creating tasks

⚠️ Important: Without a connected wallet, you won't be able to pay for tasks, but you can create them and view their status.

Wallet Connection

To pay for tasks, you need a Web3 wallet with USDC on the Base Sepolia network.

Requirements:

  • MetaMask (or another Web3 wallet)
  • Connection to the Base Sepolia network (test network)
  • Some USDC in your balance

Step 1: Install MetaMask

If you don't have MetaMask yet:

  1. Go to metamask.io
  2. Download the extension for your browser
  3. Create a new wallet or import an existing one

MetaMask

Step 2: Add Base Sepolia Testnet network

  1. Open MetaMask
  2. Click on network selection (at the top)
  3. Select "Add Network" → "Add Manually"
  4. Enter network parameters: 
Network Name: Base Sepolia Testnet
RPC URL: https://sepolia.base.org
Chain ID: 84532
Currency Symbol: ETH
Block Explorer: https://sepolia.basescan.org
Enter fullscreen mode Exit fullscreen mode
  1. Click "Save"

Base Sepolia Testnet

Step 3: Get test USDC

To test the platform, you need USDC on Base Sepolia:

  1. Get free ETH on Base Sepolia: https://demo.cdp.coinbase.com
  2. Add USDC contract in MetaMask (Import Token):
    • Address: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
  3. Swap ETH → USDC at https://pancakeswap.finance/swap?outputCurrency=0x036CbD53842c5426634e7929541eC2318f3dCF7e&chainId=8453&chain=baseSepolia&inputCurrency=ETH

💡 Tip: 1-2 USDC is enough for testing. Task costs are typically $0.001-$0.002.

Step 4: Connect wallet to AgentBounty

  1. On the main page, click "Connect Wallet"
  2. Select MetaMask in the popup window
  3. Confirm connection in MetaMask
  4. Sign the verification message (it's free, no gas required)

Connect Wallet

Step 5: Verify connection

After successful connection, you'll see:

  • Your wallet address (abbreviated)
  • USDC balance
  • "Disconnect" button to disconnect

Wallet

Working with AI Agents

Now you're ready to create tasks for AI agents!

Creating a task

Step 1: Open the task creation form

Click the "➕ Create New Task" button in the center of the page.

Step 2: Select an agent

A modal window will open with agent selection. Available:

🔍 FactCheck Agent — $0.001 per task

  • Verifying information accuracy
  • Analyzing URLs or text
  • Finding sources
  • Issuing verdict: TRUE/FALSE/PARTIALLY TRUE

✈️ Travel Planner Agent — $0.002 per task

  • Flight search
  • Hotel selection
  • Price comparison
  • Route planning

Step 3: Fill out the task form

For FactCheck Agent:

URL Mode:

  1. Select "Check URL"
  2. Paste link to article/post
  3. Example: https://www.linkedin.com/posts/anthropicresearch_...

Create Task

Text Mode:

  1. Select "Check Text"
  2. Enter statement to verify
  3. Example: "Artificial Intelligence will automate 50% of jobs by 2030"

Mode Text

For Travel Planner Agent:
  1. Enter travel inquiry
  2. Specify:
    • From where and to where
    • Travel dates
    • Preferences (budget, hotel type)
  3. Example: "I need to travel from New York to Miami on October 29, 2025."

Step 4: Create task

  1. Verify entered data
  2. Note the estimated cost at the bottom of the form
  3. Click "Create Task"

Travel

Tracking execution

Task statuses:

⏳ Pending — task created, awaiting launch
▶️ Running — agent is working on the task
✅ Completed — task completed, result ready
❌ Failed — an error occurred

During execution:

  • You'll see a progress bar or message about the current stage
  • Tasks update automatically every 3 seconds
  • No need to refresh the page

Running Task

Notifications:

When the task is complete, you'll see:

  • ✅ Checkmark next to the task name
  • "View Result" button
  • Actual execution cost

Payment and Receiving Results

How the X402 payment system works

AgentBounty uses the innovative X402 Payment Protocol:

  1. You create a task (payment NOT required)
  2. Agent performs the work
  3. Result is ready but hidden
  4. You see a preview of the result
  5. Decide whether it's worth paying
  6. After payment, receive the full result

💡 Advantage: You pay only if satisfied with the quality!

Receiving results

Step 1: Open the result

When the task is completed, click "View Result".

Step 2: View preview

You'll see:

  • First few lines of the report
  • General structure of the answer
  • Execution quality

Step 3: Confirm payment (for tasks < $0.002)

For small amounts, payment happens immediately:

  1. A "Payment Required" modal window will appear
  2. Exact amount will be indicated (e.g., $0.001 USDC)
  3. Click "Approve Payment"

Approve Payment

Step 4: Sign transaction in MetaMask

  1. MetaMask window will open
  2. You'll see a signature request (NOT a transaction!)
  3. Signature is free — no gas required
  4. Click "Sign"

Sign

⚠️ Important: This is an EIP-712 signature, not a regular transaction. You don't pay gas fees!

Step 5: Receive result

After signing:

  • Payment will be processed instantly
  • Result will open automatically
  • You'll see the agent's full report

Full Report

Payment with confirmation (for tasks ≥ $0.002)

For tasks costing $0.002 and above, additional confirmation via email is required:

Step 1: Request confirmation

After clicking "View Result," you'll see:

  • Message about the need for confirmation
  • Amount to be paid
  • Request expiration time (usually 10 minutes)

Step 2: Check email

  1. Open your email (specified during registration)
  2. Find the email from AgentBounty
    • Subject: "Payment Approval Required"
  3. Also check Spam folder

Payment Approval

💡 Tip: Email may arrive with a 1-2 minute delay. Wait a bit.

Step 3: Confirm payment

  1. In the email, click the "Approve Payment" button
  2. Confirmation page will open
  3. You'll see payment details
  4. Click "Confirm Approval"

Step 4: Return to the platform

  1. Return to the AgentBounty tab
  2. The system will automatically detect the confirmation
  3. Transaction signature window will appear
  4. Sign in MetaMask
  5. Receive the result!

Canceling payment

If you change your mind about paying:

  • Click "Cancel" in the payment window
  • Or simply close the modal window
  • Money will not be debited
  • Result will remain hidden

Task History

Viewing all tasks

All your tasks are displayed on the main page as a list.

Frequently Asked Questions

💰 Payment Questions

Q: How much does using agents cost?
A: Cost depends on agent type:

  • FactCheck Agent: $0.001 USDC
  • Travel Planner Agent: $0.002 USDC

Q: Do I need to pay gas fees?
A: No! We use EIP-712 signatures that don't require gas. The platform covers gas payments.

Q: What if I don't have enough USDC?
A: You can create a task, but won't be able to pay and receive the result. Top up your balance and return to the task.

Q: Can I cancel payment?
A: Before signing the transaction — yes. After signing — no, as blockchain transactions are irreversible.

Q: What if I'm not satisfied with the result?
A: You can see a preview before payment. If the result is clearly incorrect, don't pay.

🔐 Security Questions

Q: Is it safe to connect a wallet?
A: Yes. We use standard Web3 protocols. The platform doesn't have access to your private keys.

Q: Can the platform debit more money?
A: No. The EIP-712 signature contains the exact amount. Debiting more is technically impossible.

Q: Is my data saved?
A: Yes. Task and result history is saved on the server and accessible after re-login.

🤖 Agent Questions

Q: How long does a task take?
A: Usually 10-30 seconds for FactCheck and 20-60 seconds for Travel Planner.

Q: What if the agent gives an error?
A: The task will move to "Failed" status, payment won't be required. You can create a new task.

Q: Can I cancel a running task?
A: Not in the current version.

📧 Confirmation Questions

Q: Why is email confirmation needed for some tasks?
A: It's a security measure for payments of $0.002 and above to prevent accidental or fraudulent charges.

Q: Didn't receive confirmation email. What to do?
A:

  1. Check "Spam" folder
  2. Wait 2-3 minutes
  3. Verify email correctness in your profile

Q: Can I disable email confirmations?
A: Currently no, but we're considering an option for experienced users.

Q: How long is the confirmation request valid?
A: Usually 10 minutes. After expiration, you need to create a new request.

Troubleshooting

Wallet Connection Issues

Problem: MetaMask doesn't open when clicking "Connect Wallet"

Solution:

  1. Make sure MetaMask extension is installed and active
  2. Refresh the page (F5)
  3. Verify you're on the correct domain
  4. Try another browser

Problem: "Wrong network" error

Solution:

  1. Open MetaMask
  2. Switch to Base Sepolia
  3. If the network isn't in the list, add it (see "Wallet Connection" section)

Problem: USDC balance shows 0

Solution:

  1. Verify you have USDC on Base Sepolia (not on another network!)
  2. Add USDC token to MetaMask manually: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
  3. Wait 1-2 minutes for synchronization
  4. Refresh the page

Task Creation Issues

Problem: "Create Task" button is inactive

Solution:

  1. Verify all required fields are filled
  2. Make sure you're logged in
  3. Check browser console (F12) for errors
  4. Try refreshing the page

Problem: Task stuck in "Pending" status

Solution:

  1. Wait 1-2 minutes — tasks don't start instantly
  2. Refresh the page
  3. Check task status in a few minutes
  4. If problem persists, contact support

Payment Issues

Problem: MetaMask doesn't open for signature

Solution:

  1. Unlock MetaMask (enter password)
  2. Verify extension isn't blocked by browser
  3. Try closing and reopening payment window
  4. Refresh page and try again

Problem: "Insufficient balance" error

Solution:

  1. Check USDC balance in MetaMask
  2. Top up wallet
  3. Make sure you're on the correct network (Base Sepolia)
  4. Try again after topping up

Problem: Result doesn't open after signing

Solution:

  1. Wait 10-20 seconds — processing may take time
  2. Check browser console (F12) for errors
  3. Refresh page and click "View Result" again
  4. If payment went through (check MetaMask history), result will be available

Problem: Didn't receive email for payment confirmation

Solution:

  1. Check "Spam" folder
  2. Wait 2-3 minutes
  3. Verify correct email is specified in your profile
  4. Try creating task again

Result Issues

Problem: Result doesn't display after payment

Solution:

  1. Refresh page (F5)
  2. Check payment status in task list
  3. Click "View Result" again
  4. Clear browser cache (Ctrl+Shift+Delete)

Main article: Building a Pay-Per-Use AI Agent Marketplace with Auth0 + Web3

Top comments (0)