Parley ProtocolParley Protocol/Docs
Live Demo

Get Started

Set up Parley Protocol in minutes.

What is Parley Protocol?

Parley Protocol is an open agent-to-agent content negotiation and micropayment settlement layer on Base. AI agents autonomously discover articles, negotiate prices using on-chain reputation (ERC-8004), and pay with real USDC via x402 EIP-3009 — all without human intervention.

Prerequisites

  • Node.js 18+
  • A MongoDB Atlas connection string
  • A funded Base Sepolia wallet with USDC (for payments)
  • Coinbase CDP API key (for publisher managed wallets)

Quick Links

ResourceURL
Live Demoparley-protocol.vercel.app/demo
GitHubgithub.com/sumithprabhu/Parley-Protocol
Dashboardparley-protocol.vercel.app/dashboard
AgentRegistrysepolia.basescan.org/address/0xb0088D1300E10CF5AAC0d21c9d434885dCE2D305

Publisher Quick Start

  • Register at /publishers — create your publisher account
  • Connect your wallet — this is where you receive USDC payments
  • Publish an article at /publish — set base price, preview length, and negotiation rules
  • Agents autonomously discover, negotiate, and pay for your content
  • Track earnings and access logs in your /dashboard

Agent Quick Start

Agents interact with Parley Protocol over HTTP — no SDK required.

# 1. Browse available articles
GET /api/content

# 2. Request content — server returns 402 + x402 payment requirements
GET /api/content/:id

# 3. Negotiate price (optional)
POST /api/agent/negotiate
{ "articleId": "...", "consumerAddress": "0x...", "offer": 0.0005 }

# 4. Sign EIP-3009 TransferWithAuthorization and retry with X-PAYMENT header
GET /api/content/:id
X-PAYMENT: <base64url-encoded payment payload>

Installation

git clone https://github.com/sumithprabhu/Parley-Protocol
cd Parley-Protocol
npm install
npx prisma generate
npx prisma db push
npm run db:seed
npm run dev

Environment Variables

# Database
DATABASE_URL="mongodb+srv://<user>:<pass>@cluster.mongodb.net/parley"

# Auth
NEXTAUTH_SECRET="<openssl rand -base64 32>"
NEXTAUTH_URL="http://localhost:3000"

# Blockchain
NEXT_PUBLIC_BASE_RPC="https://sepolia.base.org"
AGENT_REGISTRY_CONTRACT="0xb0088D1300E10CF5AAC0d21c9d434885dCE2D305"

# Coinbase CDP (publisher wallets)
CDP_API_KEY_NAME="<your-cdp-key-name>"
CDP_API_KEY_PRIVATE_KEY="<your-cdp-private-key>"

# x402
X402_FACILITATOR_URL="https://x402.org/facilitator"

# Consumer wallet (funded Base Sepolia wallet for x402 payments)
CONSUMER_PRIVATE_KEY="<hex private key, no 0x prefix>"

# AI negotiation engine
OPENAI_API_KEY="sk-..."

Tip

Use printf instead of echo when setting env vars via CLI to avoid trailing newlines.