pqs-verify

Verify x402 API endpoints before payment. Trust primitive for the agent economy.

PQS (Protocol Quality Standard) is a Certificate Authority for AI agents. Before your agent pays for an API endpoint via x402 micropayments, check if the endpoint is PQS-verified — trusted, attested on-chain, and meeting quality standards.

Think of it as Let's Encrypt for AI Agents.

Install

npm install pqs-verify

Quick Start

const { verifyEndpoint, shouldPay } = require('pqs-verify');

// Check if an endpoint is trusted
const result = await verifyEndpoint('https://api.example.com/data');
console.log(result.trusted); // true or false

// One-liner: should my agent pay this endpoint?
const safe = await shouldPay('https://api.example.com/data');

Integration Examples

Basic Verification

const { verifyEndpoint } = require('pqs-verify');

const check = await verifyEndpoint('https://api.example.com/signal');

if (check.trusted) {
  console.log('Endpoint is PQS-verified');
  console.log('On-chain attestation:', check.eas_uid);
  // proceed with request/payment
} else {
  console.log('NOT verified — do not pay');
}

x402 Payment Flow

Check PQS trust before sending x402 payment:

const { verifyEndpoint } = require('pqs-verify');

async function payIfTrusted(endpointUrl) {
  const check = await verifyEndpoint(endpointUrl);

  if (!check.trusted) {
    console.log('Blocked: endpoint not PQS-verified');
    return;
  }

  // Safe to pay via x402
  const response = await fetch(endpointUrl, {
    headers: { 'X-PAYMENT': x402PaymentToken }
  });

  return response.json();
}

Agent Middleware

Auto-check every endpoint before payment — drop into any agent framework:

const { shouldPay } = require('pqs-verify');

async function agentRequest(url, paymentFn) {
  if (!await shouldPay(url)) {
    throw new Error(`PQS: ${url} not verified`);
  }
  return paymentFn(url);
}

Python (CrewAI / LangChain)

Equivalent pattern using requests:

import requests

def pqs_verify(endpoint_url):
    r = requests.get(
        'https://api.smartflowproai.com/pqs/verify',
        params={'endpoint': endpoint_url},
        timeout=5
    )
    data = r.json()
    return data.get('valid', False)

# Use in your agent's tool
if pqs_verify('https://api.example.com/data'):
    # safe to pay
    pass

API Reference

verifyEndpoint(url, options?)

Verify a single endpoint against PQS CA.

Returns: { trusted, cert, score, tier, eas_uid, raw }

| Field | Type | Description | |-------|------|-------------| | trusted | boolean | Whether the endpoint is PQS-verified | | cert | object\|null | Certificate details if verified | | score | number\|null | PQS quality score | | tier | string\|null | PQS tier (e.g. "standard", "premium") | | eas_uid | string\|null | On-chain EAS attestation UID | | raw | object | Full API response |

shouldPay(url, options?)

Quick boolean: should an agent pay this endpoint?

Returns false on network errors (fail-safe).

Options: { baseUrl, timeout, minScore }

listVerified(options?)

Get all verified endpoints from PQS CA.

Returns: { total, ca_public_key, certs: [...] }

health(options?)

Check PQS CA health status.

stats(options?)

Get PQS CA statistics.

Options (all functions)

| Option | Default | Description | |--------|---------|-------------| | baseUrl | https://api.smartflowproai.com/pqs | PQS CA server URL | | timeout | 5000 | Request timeout in ms | | minScore | 0 | Minimum PQS score (shouldPay only) |

PQS Leaderboard

See verified endpoints and their scores: pqs-leaderboard.pages.dev

License

MIT