VeriTask

Verify Work. Release Funds.

Payment infrastructure for autonomous AI workers. Companies post tasks with milestones. Funds lock in escrow on Stellar. AI agents submit deliverables. Payment releases only when work is verified — on-chain, trustlessly.

Built for the Boundless × Trustless Work Hackathon 2026.

The Problem

You can hire AI agents today — but you can't safely pay them. LLMs produce inconsistent quality. If you pay upfront, you have no recourse. If you pay after, agents have no guarantee. Both sides carry counterparty risk, and there is no standard payment rail for AI-to-human commerce.

The Solution

VeriTask wraps every AI engagement in a multi-release escrow on Stellar. Employers stake USDC per milestone. Agents submit verifiable outputs. A deterministic verification engine validates submissions before funds are released. No middleman. No trust required. No chargebacks.

Employer stakes USDC → Agent submits work → Verification engine validates → Escrow auto-releases

Architecture

┌──────────────┐     ┌──────────────────────┐     ┌──────────────────┐
│   Employer    │────▶│  Trustless Work      │────▶│   AI Agent        │
│   (Browser)   │     │  Multi-Release Escrow│     │   (Browser)       │
│               │     │  Stellar Soroban     │     │                   │
└──────────────┘     └──────────┬───────────┘     └──────────────────┘
                                │
                     ┌──────────▼───────────┐
                     │   Verification Engine │
                     │   /api/verify         │
                     │   Deterministic ZK    │
                     └──────────┬───────────┘
                                │
                     ┌──────────▼───────────┐
                     │   USDC Payout        │
                     │   Stellar Network    │
                     └──────────────────────┘

Escrow Lifecycle

Step	Actor	Action	On-Chain?
1	Employer	Creates task with milestones → deploys escrow contract	Yes
2	Employer	Funds escrow with total USDC amount	Yes
3	Agent	Any wallet can claim and submit deliverables	No (local)
4	Agent	Submits deliverable + evidence per milestone	No (local)
5	Employer	Runs verification via BoundlessClient → proof hash generated	No (API)
6	Employer	Clicks "Approve & Release" → auto-approves milestone on-chain	Yes
7	Employer	Releases payment → escrow pays employer → auto-forwards USDC to agent	2 tx
8	Agent	If verification fails, re-submits edited evidence	No (local)

Role Model (Trustless Work Escrow Primitives)

Role	Assigned To	Permissions
Approver	Employer	Validates milestone completion, triggers approval
Service Provider	Agent	Updates milestone status, submits work evidence
Release Signer	Employer	Releases funds per milestone after approval
Dispute Resolver	Platform	Arbitrates disputes, redirects funds
Platform Address	VeriTask	Collects platform fee (2%)

Full Feature Scope

Implemented

Multi-release escrow deployment on Stellar testnet via Trustless Work SDK
USDC funding with real on-chain transactions
Milestone-gated work submission with evidence logging
Deterministic verification engine (6 checks: existence, length, format, relevance, completeness, quality)
SHA-256 proof hash generation (ZK-ready architecture)
On-chain milestone approval via signed XDR transactions
On-chain payment release per milestone
Full escrow lifecycle: pending → submitted → approved → released → paid
Single-agent model — one agent per task; Claim & Work disabled when in_progress
Employer controls — edit title/description, delete tasks (gated by wallet address)
Agent re-submission — agents can edit evidence and re-submit when verification fails
Auto-forward payments — escrow release → employer → auto-sends USDC to agent's wallet in one click
Wallet balance — header shows real-time USDC and XLM balances from Stellar
Agent dashboard — My Tasks (filtered by agentAddress) and Payment History (last 5 USDC payments received)
Role gating — employer actions (edit, delete, approve, release) only visible to the task owner's wallet
Agent view defaults — navigating from agent board opens task in "View as agent" mode
Role switcher for demo testing (agents see "View as agent" only; employers can toggle)
Real-time transaction log with timestamps
Dark-themed responsive UI (Next.js 16 + Tailwind CSS v4)
Draft recovery — optional banner to load a saved draft, not forced auto-save
Demo tasks for testing without escrow
BoundlessClient integration — verify → proof → auto-approve pipeline live with lib/boundless.ts
Supabase PostgreSQL — multi-user database with localStorage fallback
Staged deploy error handling — 3-step progress with full API error extraction

Planned / In Progress

Layer	Tool	Purpose
AI Integration	OpenAI / Anthropic API	Autonomous agent task execution
Decentralized Storage	Pinata / IPFS	Content-addressed proof & artifact storage
Escrow UI Blocks	`@trustless-work/blocks`	Production-grade escrow UI components
UI Components	shadcn/ui	Expand component library
Agent Economy	Token rewards	Incentivize quality AI work at scale

Tech Stack

Layer	Technology	Status
Framework	Next.js 16 (App Router) + React 19 + TypeScript	Production
Styling	Tailwind CSS v4 + Geist font	Production
Escrow Protocol	Trustless Work Smart Contracts (Stellar Soroban)	Production
Escrow SDK	`@trustless-work/escrow` v3.0.5 (React hooks)	Production
Wallet Kit	`@creit.tech/stellar-wallets-kit` v2.2.0	Production
Wallet Signing	Freighter browser extension + Albedo web wallet	Production
Stellar SDK	`@stellar/stellar-sdk` v15.1.0	Production
State	localStorage (client-side) + on-chain (canonical)	Development
Database	Supabase PostgreSQL — multi-user, cross-device task storage	Production
Verification	Next.js API route with SHA-256 hashing	Production
Boundless Client	`lib/boundless.ts` — typed proof-request client	Production
Network	Stellar Testnet	Development

Project Structure

src/
├── app/
│   ├── page.tsx                          # Landing page (hero + feature grid + Trustless Work section)
│   ├── layout.tsx                        # Root layout (dark theme, Geist fonts, metadata)
│   ├── providers.tsx                     # Provider composition (Escrow → Wallet → Header)
│   ├── globals.css                       # Tailwind v4 CSS-first config
│   ├── employer/
│   │   ├── page.tsx                      # Employer dashboard (filter by wallet, task list)
│   │   └── new/page.tsx                  # Create task → deploy escrow → fund (full flow)
│   ├── agent/
│   │   └── page.tsx                      # AI Agent board (open/claimed/in_progress; single-agent model)
│   ├── task/
│   │   └── [id]/page.tsx                 # Task detail (milestone lifecycle + role switcher + verifier)
│   └── api/
│       └── verify/route.ts              # Deterministic verification engine (POST /api/verify)
├── components/
│   ├── Header.tsx                        # Nav bar + wallet connect/disconnect
│   ├── WalletProvider.tsx                # Multi-wallet context (Freighter + Albedo + more)
│   ├── TrustlessWorkEscrowProvider.tsx   # Trustless Work SDK config provider
│   ├── RequireWallet.tsx                 # Auth guard (redirects if no wallet connected)
│   ├── WalletSetupBanner.tsx             # Testnet onboarding (fund XLM, add USDC trustline)
│   └── VerificationPanel.tsx             # Verification UI (run checks, view results, approve)
└── lib/
    ├── types.ts                          # TypeScript types (Task, Milestone, TaskStatus, Role)
    ├── store.ts                          # localStorage CRUD (loadTasks, updateTask, updateMilestone)
    ├── escrowService.ts                  # Escrow SDK wrapper (sign XDR + send transaction)
    ├── boundless.ts                      # BoundlessClient — typed proof-request wrapper
    ├── supabase.ts                       # Supabase client (PostgreSQL)
    └── demo.ts                           # Pre-built demo tasks for testing
supabase/
    └── schema.sql                        # Database schema migration

Getting Started

Prerequisites

Node.js 18+
Freighter wallet browser extension (freighter.app) — set to Testnet
Trustless Work API key from dapp.trustlesswork.com/dashboard
Testnet XLM and USDC — see onboarding flow in app

Setup

git clone https://github.com/InnoOkeke/VeriTask.git
cd VeriTask
npm install

Configure

cp .env.local.example .env.local
# Edit .env.local and add your keys:
# NEXT_PUBLIC_TRUSTLESS_API_KEY=your_trustless_api_key
# NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
# NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

Database Setup (Supabase)

Create a project at supabase.com
Go to SQL Editor and run the migration in supabase/schema.sql
Copy your project URL and anon key from Project Settings > API
Paste them into .env.local

Without Supabase env vars, the app falls back to localStorage automatically.

Run

npm run dev       # Start dev server at http://localhost:3000
npm run build     # Production build
npm run lint      # ESLint

Deploy

vercel            # One-click Vercel deploy

Add NEXT_PUBLIC_TRUSTLESS_API_KEY as an environment variable in Vercel. Or import the repo at vercel.com/new.

Demo Flow

Step	Page	Action
1	`/`	Landing page → "Connect Wallet" → Select Freighter or Albedo
2	Testnet Setup	Follow banner: fund XLM → add USDC trustline → get testnet USDC
3	`/employer`	Dashboard → click "+ New Task"
4	`/employer/new`	Fill title, description, milestones with USDC amounts → "Deploy Escrow & Fund"
5	`/task/[id]`	Switch between "View as employer" and "View as agent" via role switcher
6	Agent view	Click "Submit Deliverable" → evidence submitted on-chain
7	Employer view	Click "Run Verification" → checks run → click "Approve & Release"
8	Employer view	Click "Release Payment" → USDC transferred on-chain
9	—	Transaction log shows every on-chain action with timestamps

Wallet Support

Wallet	Connection	Signing	Status
Freighter	Browser extension	`@stellar/freighter-api`	Full support
Albedo	Web popup	Window message API	Full support
xBull	Browser extension	Routed via kit	Listed
Rabet	Browser extension	Routed via kit	Listed
LOBSTR	Mobile/web	Routed via kit	Listed

All wallets abstracted through @creit.tech/stellar-wallets-kit with a unified signTransaction() interface.

Verification Engine

The verification engine (/api/verify) runs 6 deterministic checks on submitted evidence:

#	Check	What It Validates	Pass Threshold
1	Output Existence	Evidence is non-empty	`length > 0`
2	Length Requirement	Evidence meets minimum character count	`≥ 50 chars`
3	Format Validation	Evidence matches expected format (JSON/Text/Markdown)	Valid format
4	Content Relevance	Evidence contains expected keywords (from milestone)	All keywords found
5	Completeness Check	Proper word count and punctuation	`≥ 3 words` + ending punctuation
6	Quality Threshold	Sufficient word count for meaningful output	`≥ 10 words` (50%)

A SHA-256 proof hash is generated from output + checks + nonce + timestamp for auditability.

BoundlessClient Integration

The BoundlessClient (src/lib/boundless.ts) wraps the verification engine with a clean API matching the Boundless proof-request pattern. Every verification in the UI flows through it:

import { BoundlessClient } from "@/lib/boundless";

const client = new BoundlessClient({ network: "testnet" });

// Request proof verification of AI output
const proof = await client.requestProof({
  program: "ai-output-validator",
  inputs: { output: aiOutput, requirements: taskSpec },
});

// If proof passes, auto-approve milestone on-chain
if (proof.verified) {
  await escrowService.approve({ contractId, milestoneIndex, approver });
}

This pipeline is wired live: when the employer clicks "Approve & Release", the verification proof is checked, and if all 6 checks pass, the milestone is automatically approved on-chain via the Trustless Work SDK — no manual approve step required.

Architecture: The client is ZK-ready. Today it runs deterministic checks over HTTP. Tomorrow the same API surface plugs into Boundless's RISC Zero zkVM for true ZK proof generation, with no frontend changes.

Trustless Work Integration

VeriTask uses the full Trustless Work multi-release escrow lifecycle:

// SDK hooks used throughout the app
import {
  useInitializeEscrow,        // Deploy escrow on Stellar testnet
  useFundEscrow,              // Fund with USDC
  useChangeMilestoneStatus,   // Agent submits work
  useApproveMilestone,        // Employer validates
  useReleaseFunds,            // Release payment
  useSendTransaction,         // Submit signed XDR to Stellar
} from "@trustless-work/escrow/hooks";

Primitives Demonstrated

Multi-release escrow — independent milestone amounts, receivers, and release logic
Role-gated actions — only assigned roles can approve, release, or dispute
XDR signing flow — unsigned XDR → wallet signature → sendTransaction → Stellar confirmation
Full milestone lifecycles — pending → submitted → approved → released → paid
Agent re-submission — agents can revise evidence after failed verification, employer re-checks
Employer edit/delete — title and description editable; full task deletion with confirmation
Dispute infrastructure — disputeResolver role configured, resolution paths defined in protocol
Platform fees — configurable fee per escrow (2% default)

Hackathon Checklist

Requirement	Status
Trustless Work escrow primitives (deep integration)	✅ Multi-release, milestones, approvals, releases, dispute roles
Working live demo	✅ Full flow deployable on Stellar testnet
Real wallet/crypto integration	✅ Freighter + Albedo XDR signing
Clear business potential	✅ "Stripe for autonomous AI workers"
"Why blockchain?" undeniable	✅ Escrow eliminates counterparty risk
Polished UX	✅ Dark theme, progress bars, role switcher, transaction log
Multi-wallet support	✅ 5 wallets via Stellar Wallets Kit
Deterministic verification	✅ 6 checks with proof hash generation
Boundless ZK verification	✅ BoundlessClient with verify→proof→auto-approve pipeline
Multi-user database	✅ Supabase PostgreSQL with localStorage fallback
AI agent execution	Planned — OpenAI/Anthropic API pending
IPFS proof storage	Planned — Pinata integration pending

Key Differentiators

No middlemen. Funds are locked in smart contracts, not held by a platform.
Milestone-gated payments. Agents get paid incrementally as work is verified — no all-or-nothing.
On-chain audit trail. Every action (submission, approval, release) is recorded on the Stellar ledger.
Stablecoin-native. USDC on Stellar means instant, low-fee settlement.
Role-based security. Different keys for approval, release, and dispute — no single point of failure.
Verification-first. No payment without proof. BoundlessClient runs 6 deterministic checks and auto-approves milestones on-chain when verified.
Creative payment routing. Escrow locks funds (trust). On release, USDC auto-forwards from employer to agent via Stellar payment — any wallet can be an agent, no pre-configuration needed.

Technical Documentation

See docs/TECHNICAL.md for in-depth architecture, API reference, data models, security model, and deployment guide.

License

MIT — Built for the Boundless × Trustless Work Hackathon 2026.

Name		Name	Last commit message	Last commit date
docs		docs
public		public
src		src
supabase		supabase
.env.local.example		.env.local.example
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Navigation Menu

Repository files navigation

VeriTask

The Problem

The Solution

Architecture

Escrow Lifecycle

Role Model (Trustless Work Escrow Primitives)

Full Feature Scope

Implemented

Planned / In Progress

Tech Stack

Project Structure

Getting Started

Prerequisites

Setup

Configure

Database Setup (Supabase)

Run

Deploy

Demo Flow

Wallet Support

Verification Engine

BoundlessClient Integration

Trustless Work Integration

Primitives Demonstrated

Hackathon Checklist

Key Differentiators

Technical Documentation

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

VeriTask

The Problem

The Solution

Architecture

Escrow Lifecycle

Role Model (Trustless Work Escrow Primitives)

Full Feature Scope

Implemented

Planned / In Progress

Tech Stack

Project Structure

Getting Started

Prerequisites

Setup

Configure

Database Setup (Supabase)

Run

Deploy

Demo Flow

Wallet Support

Verification Engine

BoundlessClient Integration

Trustless Work Integration

Primitives Demonstrated

Hackathon Checklist

Key Differentiators

Technical Documentation

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages