Developer Docs

// Get your API key from www.proofgate.xyz/dashboard/keys
// Free: 100/mo | Pro ($49): 10K/mo | Enterprise: Unlimited
// On-chain proofs: Buy credit packs OR Enterprise gets unlimited

const API_KEY = 'pg_live_xxx';

// Submit transaction for validation
const response = await fetch('https://www.proofgate.xyz/api/validate', {
  method: 'POST',
  headers: { 
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + API_KEY
  },
  body: JSON.stringify({
    from: '0xYourAgentWallet',
    to: '0xContractAddress',
    data: '0xa9059cbb...', // calldata
    value: '0',
    chainId: 8453, // Base
    guardrailId: 'optional-guardrail-id'
  })
});

const result = await response.json();
console.log('Validation:', result.validationId);

// Check result and execute
if (result.safe) {
  // ✅ Transaction passed all checks
  console.log('Approved:', result.reason);
  await wallet.sendTransaction({ to, data, value });
} else {
  // 🚫 Transaction blocked by guardrail
  console.error('Blocked:', result.reason);
  console.error('Failed checks:', result.checks.filter(c => !c.passed));
}

// Response includes credits remaining
console.log('Credits left:', result.creditsRemaining);

# Method 1: Authorization header (recommended)
curl -X POST https://www.proofgate.xyz/api/validate \
  -H "Authorization: Bearer pg_live_xxx..." \
  -H "Content-Type: application/json"

# Method 2: X-API-Key header
curl -X POST https://www.proofgate.xyz/api/validate \
  -H "X-API-Key: pg_live_xxx..." \
  -H "Content-Type: application/json"

# Method 3: Query parameter (for testing only)
curl "https://www.proofgate.xyz/api/validate?api_key=pg_live_xxx..."

// 401 - Missing or invalid API key
{ "error": "API key required", "code": "AUTHENTICATION_REQUIRED" }

// 402 - No credits remaining
{ "error": "No credits remaining. Please upgrade your plan", "code": "PAYMENT_REQUIRED" }

// Successful responses include remaining credits
{ "validationId": "val_...", "result": "PASS", "creditsRemaining": 95, "tier": "free" }

curl -X POST https://www.proofgate.xyz/api/validate \
  -H "Authorization: Bearer pg_live_xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "0xAgentWallet",
    "to": "0xContractAddress",
    "data": "0xcalldata...",
    "value": "0",
    "chainId": 8453,
    "guardrailId": "guardrail_xxx",
    "guardrailIds": ["guardrail_1", "guardrail_2"]
  }'

{
  "validationId": "val_xxx",
  "result": "PASS",
  "safe": true,
  "reason": "All 5 checks passed",
  "checks": [
    {
      "check": "chain_support",
      "passed": true,
      "message": "Chain 8453 (Base) is supported",
      "severity": "info"
    },
    {
      "check": "blocked_address",
      "passed": true,
      "message": "Address not in blacklist",
      "severity": "info"
    },
    {
      "check": "contract_risk",
      "passed": true,
      "message": "Contract scanned - no suspicious patterns",
      "severity": "info"
    },
    {
      "check": "mev_vulnerable",
      "passed": true,
      "message": "MEV risk advisory (low)",
      "severity": "warning"
    }
  ],
  "creditsRemaining": 95
}

curl -X POST https://www.proofgate.xyz/evidence \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "req_123",
    "payload": {
      "transaction": {...},
      "validationResult": "PASS",
      "timestamp": "2026-02-01T15:00:00.000Z"
    }
  }'

# Response:
# {
#   "evidenceURI": "https://www.proofgate.xyz/evidence/abc123",
#   "contentHash": "0x5678...",
#   "id": "abc123"
# }

curl https://www.proofgate.xyz/evidence/abc123

# Response:
# {
#   "id": "abc123",
#   "requestId": "req_123",
#   "payload": {...},
#   "contentHash": "0x5678...",
#   "createdAt": "2026-02-01T15:00:00.000Z",
#   "evidenceURI": "https://www.proofgate.xyz/evidence/abc123"
# }

curl -X POST https://www.proofgate.xyz/evidence \
  -H "Content-Type: application/json" \
  -d '{
    "requestHash": "0x1234...",
    "checks": [
      {"name": "balance_check", "passed": true, "details": "..."},
      {"name": "whitelist_check", "passed": true, "details": "..."}
    ],
    "verdict": "PASS",
    "timestamp": "2026-02-03T12:00:00Z"
  }'

# Response:
{
  "id": "ev_abc123",
  "uri": "https://www.proofgate.xyz/evidence/ev_abc123"
}

curl https://www.proofgate.xyz/evidence/ev_abc123

# Response:
{
  "id": "ev_abc123",
  "requestHash": "0x1234...",
  "checks": [...],
  "verdict": "PASS",
  "timestamp": "2026-02-03T12:00:00Z",
  "onChainTx": "0xabcd..."  // Base transaction hash
}

// Available validation checks:

chain_support      // Verify chain is supported (19 chains)
blocked_address    // Check against 3,800+ malicious address blacklist
contract_risk      // Bytecode scanning for suspicious patterns
mev_vulnerable     // MEV/sandwich attack vulnerability detection
excessive_slippage // Zero slippage and configurable max protection
infinite_approval  // Block unlimited token approvals
balance_check      // Verify sufficient balance for tx
allowed_contracts  // Verify contract is whitelisted
max_value          // Check against daily/tx limits
max_approval       // Check approval amount limits