Verity

Verity

Proof-of-Value infrastructure for the global consultation market.
Don't just consult. Verify with Verity.
Verity replaces blind trust with Verifiable Outcomes. It ensures experts are paid for their impact and attendees only pay for what they actually gain.

Links
Full documentation: docs.hetairoi.xyz
Live Application: https://verity.hetairoi.xyz

Overview
Verity is a decentralized knowledge exchange platform that connects hosts and attendees for sessions with fair, AI-powered evaluation and on-chain settlement:

1. Host creates listing — Offer to teach a topic for a set price in USDC
2. Attendee books session — Pays upfront into escrow
3. Session occurs off-chain — Video call with Recall.ai recording
4. AI evaluates quality — Gemini scores transcript against weighted goals
5. Smart contracts settle — Quadratic payout formula distributes funds
6. Host and attendee claim — Based on merit
   Key innovation: AI evaluation runs via Chainlink DON, not a centralized server — trustless and verifiable.

Core Features

• Smart Escrow — USDC locked before sessions; no payment risk
• Autonomous Witness — Recall.ai bots join and record sessions
• Merit-Based Settlement — Quadratic scoring; transparent payouts
• Chainlink CRE — Two workflows: initiation and settlement

Tech Stack
Contracts: Solidity, KXManager, KXSessionRegistry
Workflows: Chainlink CRE, TypeScript, Recall.ai, Gemini, IPFS
Web: React 19, TanStack Router, Hono, Bun, Drizzle, Privy

Sepolia Deployment
USDC: 0xb243a36d2cb3937b40043050bf4f7d36795322db
KXManager: 0x42c105b36825778ca323bf850df6e007b0407dca
KXSessionRegistry: 0xB9f475C996A61c8BC9b2E72B7Df3de3017Dd3C76

How is it built?
Verity is built as a layered system: smart contracts on-chain, Chainlink CRE workflows off-chain, and a web app for users.

Smart contracts (EVM Sepolia)

• KXManager — Listings, session initiation, and USDC escrow. Hosts create listings; attendees call requestSessionRegistration to book and lock USDC.
• KXSessionRegistry — Session lifecycle, escrow, and settlement. Receives CRE reports, stores AI scores, and handles host/attendee claims.
• USDC — Payment token for session fees and refunds.

Chainlink CRE workflows

• Initiation workflow — Triggered by SessionRegistrationRequested. Fetches listing metadata from IPFS, creates a Recall.ai bot, stores session data on IPFS, and registers the session on-chain.
• Settlement workflow — Triggered by EvaluationRequested. Fetches transcript from Recall.ai, sends it to Gemini for scoring, stores the evaluation on IPFS, and submits the signed report to the registry for settlement.
  Both workflows use EVM log triggers and CRE reports to keep on-chain and off-chain steps in sync.

Server (Bun + Hono)

• Frontend — React 19, TanStack Router, shadcn/ui, Privy (auth/wallet), wagmi.
• API — Hono on Bun, PostgreSQL with Drizzle ORM.
• Responsibilities — Session CRUD, Google Calendar for Meet URLs, on-chain data caching. No AI or settlement logic; that stays in CRE workflows.

External services

• Recall.ai — Meeting recording and transcript.
• Gemini — AI evaluation against weighted learning goals.
• Pinata — IPFS storage for metadata and evaluation reports.

Data flow
Hosts create listings via the web app; metadata is stored in the DB and on IPFS. Attendees book and pay USDC on-chain. The initiation workflow registers the session and sets up recording. After the meeting, the host requests evaluation; the settlement workflow scores the transcript and settles on-chain. Hosts and attendees claim payouts via the web UI.