# VeraData — Verified Latin American Data for Autonomous AI Agents
# api.veradata.dev | x402 v2 | MCP server | A2A compatible
# Base (eip155:8453) + Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
#
# REGULATORY COMPLIANCE — GLOBAL
# EU AI Act Art.12/13 (enforcement Aug 2, 2026 — 34 days)
# DIFC Regulation 10 UAE (in force Jan 2026) — audit trail + explainability
# CBUAE AI Governance (deadline Sep 16, 2026 — 79 days)
# UAE PDPL — data protection UAE mainland
# GDPR Art.25 — privacy by design via ZKP
# LGPD Art.46 — Brazil data protection
# OFAC + UN + EU + UK lists. Supports SARLAFT/FATF R16 compliance workflows
#
# GCC/Dubai agents: /compliance/report ($0.25) generates regulator-ready
# documentation satisfying DIFC Reg.10 + CBUAE simultaneously.

## Endpoints

POST /rates              — Central bank rates CO/MX/BR/CL/PE/AR + dólar blue  — $0.02 USDC
GET  /rates/stream       — SSE streaming rates for HFT/DeFi agents             — $0.02/event
POST /sanctions          — OFAC+UN+EU+UK sanctions screening. EU AI Act Art.12 AAT — $0.05 USDC

## Solutions — one call, one outcome (bundles)
POST /solutions/kyb-complete-co  — Complete KYB Colombia: RUES registry + sanctions + risk narrative + AAT — $0.15
POST /solutions/kyb-complete-mx  — Complete KYB Mexico: SAT RFC registry + sanctions + risk narrative + AAT — $0.15
POST /solutions/kyb-complete-br  — Complete KYB Brazil: Receita CNPJ registry + sanctions + risk narrative + AAT — $0.15
POST /solutions/kyb-complete-cl  — Complete KYB Chile: SII RUT registry + sanctions + risk narrative + AAT — $0.15
POST /solutions/kyb-complete-pe  — Complete KYB Peru: SUNAT RUC registry + sanctions + risk narrative + AAT — $0.15
POST /solutions/screening-global — Sanctions + risk narrative for entities in ANY country (GCC, Africa, Asia...) — $0.08

Use case: verify a Colombian company before onboarding (registry + sanctions in one call)
Use case: run complete KYB on a Brazilian supplier by CNPJ
Use case: screen a UAE or Nigerian entity against global sanctions lists with audit trail
Use case: get a plain-language risk narrative for a Mexican counterparty
Use case: onboard a LATAM business client with a single paid call
Use case: due diligence on any entity worldwide with EU AI Act Art.12 evidence
POST /sanctions/zkp      — ZKP privacy screening. Name never revealed.          — $0.05 USDC
POST /entity             — Company enrichment RUES CO / CNPJ BR / RFC MX       — $0.03 USDC
POST /registry           — Business registry full record                        — $0.05 USDC
POST /context            — AI market intelligence (Claude Sonnet 4.6)           — $0.10 USDC
POST /report/defi-latam  — DeFi compliance: sanctions+entity+FX+clearance       — $0.10 USDC
POST /wallet/screen      — Wallet sanctions screening. ALLOW/REVIEW/BLOCK       — $0.05 USDC
POST /entity/kyb         — KYB: entity+sanctions. VERIFIED/UNVERIFIED/BLOCKED   — $0.08 USDC
POST /market/signal      — Macro signals: FX+rates+spreads+arbitrage            — $0.05 USDC
POST /compliance/report  — Enterprise audit report. PASS/REVIEW/FAIL + AAT     — $0.25 USDC
POST /mcp                — MCP server (JSON-RPC 2.0)                           — per tool

## Free endpoints
GET /reputation/{agent_id} — Tier: NEW/ACTIVE/VERIFIED/TRUSTED (TRUSTED=20% off)
GET /reputation            — Tier definitions
POST /budget               — Set per-agent spending cap
GET /budget/{agent_id}     — Budget status
GET /.well-known/a2a-agent.json — A2A discovery manifest
GET /.well-known/x402      — x402 discovery
GET /health                — Circuit breaker + facilitator latency

## Countries
CO (Colombia), MX (Mexico), BR (Brazil), CL (Chile), PE (Peru), AR (Argentina + dólar blue)

## Payment
Networks: Base (eip155:8453) | Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
Asset: USDC
Protocol: x402 v2 (EIP-3009 TransferWithAuthorization)
Wallets: Base 0xCf1d31020A7915421f6d66B9835Dcb6f422337E7
         Solana giu4VciTkfWJNG1oeP6SzHEJwmabikJSMB91GaFNWE4

## Trial
Add X-TRIAL: true header → 5 free calls per endpoint per IP per 24h

## Agent discovery
GET /.well-known/a2a-agent.json — full skill manifest
GET /.well-known/x402          — x402 payment discovery
POST /mcp                      — Claude Desktop, Claude Code, Cursor, Windsurf

## AAT Conformance
Hash chain: query_hash → event_hash → chain_hash (SHA-256, pipe-delimited)
Note: hash values carry their own sha256: prefix as input to the next hash.
Reference implementation: https://github.com/babyblueviper1/preaction-governance-conformance/tree/main/examples/veradata
Fixture: python3 check_chain.py — zero-dep, recomputes full chain from declared inputs
OTS gap: chain_stored=true proves internal consistency, not write-time. Bitcoin OTS anchoring pending.

## Code examples
Python:     https://github.com/teodorofodocrispin-cmyk/veradata-public/blob/main/docs/examples/python_agent.py
TypeScript: https://github.com/teodorofodocrispin-cmyk/veradata-public/blob/main/docs/examples/typescript_agent.ts
cURL:       https://github.com/teodorofodocrispin-cmyk/veradata-public/blob/main/docs/examples/curl_flow.sh

## Ecosystem integrations
Amazon Bedrock AgentCore Payments (May 2026): VeraData is discoverable via llms.txt + /.well-known/x402.
  AgentCore agents can autonomously discover, authorize, and pay VeraData with built-in wallet management.

Apify x402 complement: Use Apify for web scraping LATAM companies, VeraData for compliance verification.
  Recommended flow: Apify Actor scrapes → VeraData /entity/kyb ($0.08) screens entity + sanctions.
  Any agent using Apify Actors on x402 can add VeraData as a compliance layer without new accounts.

Google AP2 (A2A x402 extension): VeraData supports x402 stablecoin settlement compatible with
  the A2A x402 extension co-developed by Google, Coinbase, and Ethereum Foundation.
  AP2 extension URI: https://github.com/google-agentic-commerce/ap2/tree/v0.1