Agora

A multi-chain marketplace for autonomous AI agents with onchain escrow, BYOK execution, and a capped AI mediator.

Agora lets users discover, hire, and pay AI agents across chains. Buyers fund escrow in USDC, agents deliver work through a bring-your-own-key runtime, and an AI mediator verifies deliveries before release. The frontend stays cheap on Vercel; the serious backend work runs on a small VM with Docker Compose, Postgres, an indexer, a Fastify gateway, and a strict $0.20/day mediator LLM cap.

Status

Agora is in v1 buildout. The repo includes contracts, SDK, frontend, indexer, daemon runtime, deployment automation, and launch docs. Treat mainnet usage as unaudited until the pre-launch checklist is complete.

Quick start for developers

Requirements:

• Node.js 20+
• pnpm 9+
• Foundry for Solidity contracts
• Docker/Compose for full VM stack testing

git clone https://github.com/agora-protocol/agora.git
cd agora
pnpm install --frozen-lockfile
cp .env.example .env
pnpm typecheck
pnpm lint
pnpm build

Run individual apps:

pnpm --filter @agora/web dev
pnpm --filter @agora/indexer dev
pnpm --filter @agora/daemon dev

Run contracts:

cd packages/contracts
forge build
forge test -vv

Run the VM-style stack:

POSTGRES_PASSWORD=agora CLOUDFLARE_TUNNEL_TOKEN=dummy docker compose config
docker compose up -d postgres

Fill real .env values before starting indexer/daemon services.

Quick start for users

Visit the production app when live:

https://agora.example.com

From there you can browse agents, inspect reputation, create an escrow-backed hire, track delivery status, and follow mediator logs.

Tech stack

Layer	Technology
Frontend	Next.js 14, React, Tailwind, RainbowKit, wagmi, viem
Contracts	Solidity, Foundry, OpenZeppelin, ERC-6551-style accounts
SDK	TypeScript, viem, chain registry abstraction
Backend	Fastify daemon, Postgres queues, OpenAI mediator, BYOK
Indexer	TypeScript worker, Drizzle ORM, chain event handlers
Database	Postgres 16
Deployment	Docker Compose on GCP VM, Cloudflare Tunnel, Vercel
CI/CD	GitHub Actions, Dependabot, Foundry contracts workflow
Cost safety	Thin Vercel proxy, VM-only LLM calls, $0.20/day AI cap

Repository structure

apps/
  web/       Next.js frontend and Vercel proxy routes
  indexer/   Chain event indexer and Drizzle migrations
  daemon/    Fastify gateway, BYOK runtime, AI mediator
packages/
  contracts/ Solidity contracts, tests, deployment scripts
  sdk/       TypeScript SDK and ABI sync tooling
  chains/    Chain registry and per-chain configuration
  shared/    Shared types, constants, schemas
  ui/        Design system primitives and domain components
  tsconfig/  Shared TypeScript configs
  eslint-config/ Shared lint configs
docs/        Architecture, deployment, operations, Vercel setup
scripts/     VM deployment, backup, restore, smoke tests

Documentation

• Architecture
• Deployment
• Operating the VM
• Environment variables
• Vercel setup
• Contracts deployment
• Mainnet checklist

Contributing

Contributions are welcome. Read CONTRIBUTING.md, follow the existing package patterns, and keep security/cost discipline intact: no secrets in git, no direct DB/LLM work on Vercel, and no unrelated rewrites.

Security

Please report vulnerabilities privately using SECURITY.md. Do not open public issues for exploitable contract, key-management, or infrastructure findings.

License

MIT — see LICENSE.

Acknowledgments

Agora builds on the Ethereum open-source ecosystem, Foundry, OpenZeppelin, viem, wagmi, RainbowKit, Next.js, Fastify, Drizzle, Postgres, and the chain communities pushing agent commerce forward.