Verity

---
title: "VERITY"
description: "Agente de IA autônomo com 10 serviços protegidos por L402. Ganha sats, paga em sats."
---

# VERITY

VERITY é um agente de IA autônomo construído sobre l402-kit. Ela vende 10 serviços via protocolo L402, acumula um tesouro em Bitcoin e ajusta seus próprios preços com base na demanda — sem intervenção humana.

**Endpoint de descoberta:** `GET https://l402kit.com/api/verity`

---

## Os 10 Serviços

| Serviço | Endpoint | Preço | Requer |
|---|---|---|---|
| Busca Web | `/api/verity/search` | 100 sats | — |
| Raspagem Web | `/api/verity/scrape` | 200 sats | — |
| Preço do BTC | `/api/verity/btc-price` | 10 sats | — |
| Resumo | `/api/verity/summarize` | 50 sats | — |
| Sentimento | `/api/verity/sentiment` | 30 sats | — |
| Intel de Domínio | `/api/verity/domain-intel` | 500 sats | — |
| Integração l402-kit | `/api/verity/integration` | 10.000 sats | — |
| Estado do Mundo | `/api/verity/worldstate` | 80 sats | — |
| Tradução | `/api/verity/translate` | 50 sats | — |
| Pesquisa | `/api/verity/research` | 300 sats | — |

Os preços são dinâmicos — VERITY os ajusta a cada 30 minutos com base na demanda.

---

## Como Pagar

Todos os serviços seguem o padrão L402:

```bash
# Passo 1 — solicitar o serviço (obter fatura)
curl -i https://l402kit.com/api/verity/btc-price

# HTTP/1.1 402 Payment Required
# WWW-Authenticate: L402 macaroon="...", invoice="lnbc..."

# Passo 2 — pague a fatura com qualquer carteira Lightning
# Passo 3 — tente novamente com a prova
curl -H "Authorization: L402 <macaroon>:<preimage>" \
  https://l402kit.com/api/verity/btc-price

---

Pagamento automatizado com L402Client

import { L402Client } from "l402-kit/agent";
import { BlinkWallet } from "l402-kit/wallets";

const client = new L402Client({
  wallet: new BlinkWallet(process.env.BLINK_API_KEY!),
  budget: { maxSats: 500 },
});

// Preço do BTC — 10 sats
const price = await client.fetch("https://l402kit.com/api/verity/btc-price");
const data = await price.json();
console.log(data.bitcoin.usd);

// Estado do mundo — 80 sats
const world = await client.fetch("https://l402kit.com/api/verity/worldstate");
const state = await world.json();
console.log(state.time.utc, state.location.city, state.weather.temperature_c);

---

Referência de Serviços

Busca — 100 sats

Busca web retornando os 10 principais resultados orgânicos.

# GET
curl -H "Authorization: L402 <token>" \
  "https://l402kit.com/api/verity/search?q=bitcoin+lightning"

# POST
curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"q":"bitcoin lightning"}' \
  https://l402kit.com/api/verity/search

Resposta:

{
  "agent": "VERITY",
  "service": "search",
  "query": "bitcoin lightning",
  "results": [
    { "title": "...", "link": "...", "snippet": "..." }
  ],
  "paid_with": "⚡ Lightning L402"
}

---

Raspagem Web — 200 sats

Retorna o conteúdo completo da página em markdown.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}' \
  https://l402kit.com/api/verity/scrape

---

Preço do BTC — 10 sats

Preço do Bitcoin em tempo real em USD, EUR e BRL.

curl -H "Authorization: L402 <token>" \
  https://l402kit.com/api/verity/btc-price

Resposta:

{
  "bitcoin": { "usd": 98000, "eur": 90000, "brl": 550000 },
  "timestamp": "2026-05-10T12:00:00.000Z"
}

---

Resumo — 50 sats

Resumo por IA de até 50.000 caracteres.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text":"...texto longo...", "language":"portuguese"}' \
  https://l402kit.com/api/verity/summarize

---

Sentimento — 30 sats

Análise de sentimento com pontuação, confiança e palavras-chave.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Bitcoin is the future of money"}' \
  https://l402kit.com/api/verity/sentiment

Resposta:

{
  "analysis": {
    "sentiment": "positive",
    "score": 0.92,
    "confidence": 0.88,
    "keywords": ["bitcoin", "future", "money"]
  }
}

---

Intel de Domínio — 500 sats

WHOIS, registros DNS e certificados SSL. Sem chave de API — utiliza RDAP público e crt.sh.

curl -H "Authorization: L402 <token>" \
  "https://l402kit.com/api/verity/domain-intel?domain=example.com"

Resposta:

{
  "domain": "example.com",
  "whois": { "registrar": "...", "registered": "...", "expires": "..." },
  "dns": { "a_records": ["93.184.216.34"] },
  "certificates": [{ "issued": "...", "expires": "...", "issuer": "..." }]
}

---

Integração l402-kit — 10.000 sats

Envie a URL de um repositório GitHub público. VERITY analisa o código-fonte e retorna o código completo de integração com l402-kit.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"repoUrl":"https://github.com/owner/repo"}' \
  https://l402kit.com/api/verity/integration

Resposta:

{
  "repo": "owner/repo",
  "integration": "## Detected: Express.js\n\n```typescript\nimport { l402 } from 'l402-kit';\n...",
  "next_steps": ["Apply integration code", "Set env vars", "Deploy and test"]
}

---

Estado do Mundo — 80 sats

Hora UTC + geolocalização do solicitante + clima local em uma única chamada. Custo externo de API zero.

curl -H "Authorization: L402 <token>" \
  https://l402kit.com/api/verity/worldstate

Resposta:

{
  "time": {
    "utc": "2026-05-10T14:32:00.000Z",
    "unix": 1778421120,
    "hour": 14, "minute": 32, "weekday": "Sun"
  },
  "location": {
    "city": "São Paulo", "country": "BR", "timezone": "America/Sao_Paulo"
  },
  "weather": {
    "temperature_c": 23.4,
    "feels_like_c": 22.1,
    "humidity_pct": 68,
    "condition": "partly cloudy"
  }
}

---

Pesquisa — 300 sats

Pacote de pesquisa aprofundada: busca + raspagem + resumo por IA em uma única chamada. Economiza 3 pagamentos separados e 3x a latência de ida e volta.

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin lightning network adoption 2026"}' \
  https://l402kit.com/api/verity/research

Resposta:

{
  "agent": "VERITY",
  "service": "research",
  "query": "bitcoin lightning network adoption 2026",
  "summary": "Lightning Network adoption has accelerated significantly in 2026...",
  "scraped_url": "https://example.com/article",
  "sources": [
    { "title": "...", "link": "...", "snippet": "..." }
  ],
  "provider": "serper",
  "paid_with": "⚡ Lightning L402"
}

vs. chamar os serviços separadamente: Busca (100 sats) + Raspagem (200 sats) + Resumo (50 sats) = 350 sats no total. Pesquisa custa 300 sats — mais barato e com um único pagamento.

---

Tradução — 50 sats

Traduz texto ou documentação MDX para qualquer um dos 11 idiomas suportados. Quando format é mdx, blocos de código, componentes MDX, URLs e termos técnicos são preservados exatamente — apenas o texto corrido é traduzido.

Locais suportados: pt, es, zh, ar, hi, fr, de, ru, ja, it, en

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Pay once, access forever.", "locale": "pt", "format": "plain"}' \
  https://l402kit.com/api/verity/translate

Formato MDX (preserva blocos de código e componentes):

curl -X POST -H "Authorization: L402 <token>" \
  -H "Content-Type: application/json" \
  -d '{"text": "---\ntitle: Quickstart\n---\n\nPay with Lightning.", "locale": "ja", "format": "mdx"}' \
  https://l402kit.com/api/verity/translate

Resposta:

{
  "agent": "VERITY",
  "service": "translate",
  "locale": "pt",
  "language": "Brazilian Portuguese",
  "format": "plain",
  "translated": "Pague uma vez, acesse para sempre.",
  "source_length": 26,
  "paid_with": "⚡ Lightning L402"
}

Entrada máxima: 100.000 caracteres por chamada.

---

Precificação Dinâmica

VERITY ajusta os preços a cada 30 minutos:

Alta demanda (> limite de chamadas/hora) → preço × 1,1
Demanda zero (2 horas consecutivas)      → preço × 0,9
Proteção de piso                         → preço nunca abaixo do mínimo

Verifique os preços atuais a qualquer momento:

curl https://l402kit.com/api/verity | jq '.services[].priceSats'

---

---

Endpoints Públicos de Descoberta

Esses dois endpoints não exigem pagamento L402 — expõem o catálogo e as finanças da VERITY para auditoria e descoberta.

GET /api/verity/services

Catálogo machine-readable de todos os serviços ativos com preços ao vivo, floors e limiares de surge.

curl https://l402kit.com/api/verity/services

{
  "services": [
    {
      "id": "search",
      "endpoint": "https://l402kit.com/api/verity/search",
      "price_sats": 500,
      "floor_sats": 500,
      "cogs_sats": 50,
      "surge_threshold": 50
    }
  ],
  "count": 10,
  "updated": "2026-05-12T14:32:00.000Z"
}

GET /api/verity/fiscal

Relatório fiscal diário da VERITY — receita, custos, margem e detalhamento por serviço. Gerado às 00:00 UTC.

curl https://l402kit.com/api/verity/fiscal

{
  "date": "2026-05-12",
  "agent": "VERITY",
  "revenue_sats": 8450,
  "consumer_spent_sats": 340,
  "net_sats": 8110,
  "margin_pct": "95.98",
  "usd_equivalent": "10.00",
  "btc_usd_rate": 95000,
  "breakdown": {
    "search": { "calls": 21, "price": 500, "revenue": 10500, "success_rate": 98 }
  },
  "generated_at": "2026-05-12T00:00:01.000Z"
}

Os relatórios são armazenados por 7 dias. Retorna 404 se o relatório do dia ainda não foi gerado.

API do Operador

Se você fizer um fork de VERITY para executar seu próprio agente, estes endpoints permitem alterar preços e orçamentos em tempo de execução — sem necessidade de novo deploy.

Todas as rotas administrativas exigem o cabeçalho DASHBOARD_SECRET:

Authorization: Bearer <DASHBOARD_SECRET>

GET /api/verity/admin/config

Retorna a configuração atual de preços e os gastos dos consumidores para todos os serviços.

curl -H "Authorization: Bearer <secret>" \
  https://l402kit.com/api/verity/admin/config

Resposta:

{
  "configs": {
    "search":  { "base": 100, "floor": 50, "surgeThreshold": 50, "cogs": 2 },
    "translate": { "base": 50, "floor": 50, "surgeThreshold": 30, "cogs": 1 }
  },
  "prices": { "search": 100, "translate": 50 },
  "consumer": { "spent_today": 340, "budget": 10000 }
}

POST /api/verity/admin/config

Atualiza os parâmetros de precificação de um serviço específico. Apenas os campos fornecidos são alterados.

curl -X POST -H "Authorization: Bearer <secret>" \
  -H "Content-Type: application/json" \
  -d '{"service": "search", "base": 150, "floor": 80}' \
  https://l402kit.com/api/verity/admin/config

Campo	Descrição
service	Nome do serviço (obrigatório)
base	Preço base em sats
floor	Preço mínimo (a precificação dinâmica nunca fica abaixo disso)
surgeThreshold	Chamadas/hora que disparam um aumento de +10%
cogs	Custo dos bens em sats (usado pelo agente fiscal)

POST /api/verity/admin/budget

Define o limite de gasto diário do consumidor.

curl -X POST -H "Authorization: Bearer <secret>" \
  -H "Content-Type: application/json" \
  -d '{"sats": 5000}' \
  https://l402kit.com/api/verity/admin/budget

Mínimo: 100 sats. As alterações entram em vigor imediatamente.

---

Arquitetura

VERITY (agent:shinydapps.verity)
  ├── 10 serviços protegidos por L402
  ├── Tesouro: [e-mail]
  ├── Heartbeat: a cada 30min (ajuste de preços + varredura do mercado Satring)
  ├── Cache de consultas: baseado em KV, TTL por serviço (5min–24h)
  ├── Agente Fiscal: relatório diário às 00:00 UTC → GET /api/verity/fiscal
  ├── Catálogo de serviços: machine-readable → GET /api/verity/services
  ├── Contrato do agente: GET /.well-known/agent.json → bloco verity
  └── LAW-N: eventos comportamentais emitidos por transação

VERITY é open-source — a mesma arquitetura pode ser copiada para criar seu próprio agente autônomo.