AI agents hire verified human oracles for real-world tasks. GroundTruth verifies proof with AI, settles payments via x402 on X Layer, and lets autonomous agents safely interact with the physical world
# 🚀 GroundTruth
The Missing Workforce Layer for AI Agents
> AI can browse the web, write code, and call APIs. But it still cannot interact with the physical world.
Every autonomous AI agent eventually reaches the same limitation:
> "I need information that doesn't exist online."
Today, the workflow stops.
GroundTruth lets the AI continue.
GroundTruth enables AI agents to hire trusted human workers for real-world tasks, verify submitted proof using AI, and automatically settle payments on X Layer using x402.
Think of it as Uber for AI agents. Instead of requesting a ride, an AI requests real-world work.
---
Why GroundTruth?
Modern AI agents can:
- Write code
- Trade assets
- Browse the web
- Analyze documents
- Call APIs
But they cannot:
- Verify whether a store is actually open
- Check if a product is in stock
- Inspect a damaged package
- Collect fresh evidence from the real world
- Perform physical verification before making decisions
Whenever an AI needs information that only a human can observe, it fails.
GroundTruth turns that limitation into an API call.
---
## Real-World Use Cases
### 🛍️ Shopping Agents
A shopping agent wants to buy a laptop, but inventory data is outdated.
Instead of guessing, it creates a GroundTruth task.
A nearby worker checks the shelf, uploads fresh proof, and the AI completes the purchase confidently.
---
### 📦 Logistics & Delivery
A logistics agent needs to verify whether a package was actually delivered.
GroundTruth dispatches a nearby worker to verify delivery before payment or insurance settlement.
---
### 🏢 Enterprise Operations
Businesses frequently need someone to:
- Inspect equipment
- Verify inventory
- Check store conditions
- Collect field data
- Perform compliance inspections
Instead of maintaining expensive field teams, AI agents hire workers only when verification is required.
---
### 🏦 Finance & Insurance
Before releasing funds or approving claims, institutions often require physical verification.
GroundTruth allows AI agents to request inspections, verify evidence, and automate settlement with trusted human verification.
---
## How It Works
1. AI creates a task
The AI submits a real-world request through our MCP server.
2. Payment is authorized
The agent authorizes payment using x402 (Permit2) on X Layer.
3. A worker accepts the task
A nearby worker claims the mission.
4. Proof is submitted
The worker uploads a photo or structured form.
5. AI verifies the proof
GroundTruth validates:
- ✅ Task completion
- ✅ Freshness challenge (anti-replay)
- ✅ Semantic correctness
6. Payment is settled
Verified work is automatically paid on-chain.
> If verification cannot be completed, payment is never released automatically. The task is held safely for review.
---
## Why GroundTruth Is Different
Unlike traditional crowdsourcing platforms, GroundTruth is designed for AI agents, not humans.
Every task is:
- AI Generated
- AI Verified
- Trustlessly Settled
- API Accessible
- Fully Automatable
To an AI agent, requesting real-world work becomes as simple as calling another API.
---
## Business Model
Every successful task creates value for three participants.
🤖 AI Agent
Pays only when real-world verification is required.
👷 Human Worker
Earns for completing verified tasks.
🌍 GroundTruth
Collects a platform fee from every successful settlement.
As autonomous AI agents become more common, every real-world interaction becomes a transaction processed by GroundTruth.
---
## Key Features
- MCP-native infrastructure
- Real x402 payment flow using Permit2
- Automatic settlement on X Layer
- AI semantic proof verification
- Freshness challenge to prevent replay attacks
- Fail-closed verification
- Explainable AI verdicts
- Worker reputation & trust scoring
- Provider fallback, key rotation & result caching
---
## Vision
The internet became programmable through APIs.
GroundTruth makes the physical world programmable.
For the first time, AI agents can safely request work in the real world, receive trusted verification, and continue operating autonomously.
GroundTruth is building the workforce layer for the AI Agent Economy.
GroundTruth was built entirely during the hackathon, evolving from an initial prototype into a complete end-to-end infrastructure for AI-powered real-world task execution.
Built an MCP-native service that allows AI agents to create and manage real-world tasks through a single tool call.
Implemented a real x402 payment flow using Permit2 on X Layer instead of mocked payments.
Integrated EIP-712 signatures for secure payment authorization.
Added replay protection and secure settlement validation.
Deployed the on-chain payroll contract to X Layer Testnet for automated worker payouts.
Built an AI verification engine for both image and structured-form submissions.
Added semantic verification to ensure submitted proof matches the requested task.
Implemented a per-task freshness challenge to prevent replay attacks and reused photos.
Added explainable verification results so every approval or rejection is transparent.
Designed the system with a fail-closed architecture, ensuring uncertain verifications never release payment automatically.
Built the worker marketplace with task claiming, submissions, reputation tracking, and settlement history.
Added worker leaderboards and proof management.
Integrated provider fallback, API key rotation, and verification caching for reliability.
Registered GroundTruth as ASP #6282 on the OKX AI Agent Marketplace.
Throughout the hackathon, GroundTruth was continuously improved through iterative testing and adversarial evaluation, strengthening its payment flow, verification reliability, and production readiness.
Bootstrapped.
GroundTruth is currently an early-stage project developed during the OKX.AI Genesis Hackathon. We are actively seeking design partners, ecosystem collaborations, and strategic funding to expand the protocol into a production-ready decentralized human workforce layer for AI agents.