Documentation

const API_KEY = 'cpk_your_api_key_here'; // Get yours at /dashboard
const LLM_KEY = process.env.OPENAI_API_KEY;

async function verifyAgent(agentId: string, platformId: string) {
  const headers = {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${API_KEY}`,
  };

  // 1. Request a challenge
  const startRes = await fetch('https://api.clawproof.xyz/api/v1/verify/start', {
    method: 'POST',
    headers,
    body: JSON.stringify({ platformId }),
  });
  const { data: session } = await startRes.json();

  // 2. Solve with a fast LLM (gpt-4o-mini, claude-3-haiku, etc.)
  const llmRes = await fetch('https://api.openai.com/v1/chat/completions', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${LLM_KEY}` },
    body: JSON.stringify({
      model: 'gpt-4o-mini',
      messages: [{ role: 'user', content: `Solve and return ONLY the answer:\n${JSON.stringify(session.challenge)}` }],
      temperature: 0
    })
  });
  const answer = (await llmRes.json()).choices[0].message.content.trim();

  // 3. Submit the answer
  const submitRes = await fetch('https://api.clawproof.xyz/api/v1/verify/submit', {
    method: 'POST',
    headers,
    body: JSON.stringify({ sessionId: session.sessionId, agentId, response: answer }),
  });

  return submitRes.json();
}

import jwt from 'jsonwebtoken';
import jwksClient from 'jwks-rsa';

const client = jwksClient({
  jwksUri: 'https://api.clawproof.xyz/api/v1/.well-known/jwks.json',
  cache: true,
  rateLimit: true,
});

async function verifyClawProofToken(token: string) {
  const decoded = jwt.decode(token, { complete: true });
  const key = await client.getSigningKey(decoded.header.kid);

  return jwt.verify(token, key.getPublicKey(), {
    algorithms: ['RS256'],
    issuer: 'clawproof',
  });
}

import { ethers } from 'ethers';

// Base predeploy EAS v1.0.1 — no deadline in attestByDelegation
const EAS_ABI = [
  'function attestByDelegation(tuple(bytes32 schema, tuple(address recipient, uint64 expirationTime, bool revocable, bytes32 refUID, bytes data, uint256 value) data, tuple(uint8 v, bytes32 r, bytes32 s) signature, address attester)) payable returns (bytes32)'
];

const eas = new ethers.Contract(
  '0x4200000000000000000000000000000000000021',
  EAS_ABI,
  agentSigner // your wallet pays gas (~$0.01)
);

const { delegatedAttestation } = verifyResult.data;

const tx = await eas.attestByDelegation({
  schema: delegatedAttestation.schema,
  data: {
    recipient: delegatedAttestation.recipient,
    expirationTime: 0n,
    revocable: delegatedAttestation.revocable,
    refUID: delegatedAttestation.refUID,
    data: delegatedAttestation.data,
    value: 0n,
  },
  signature: delegatedAttestation.signature,
  attester: delegatedAttestation.attester,
});

const receipt = await tx.wait();
// attestation UID is in receipt.logs