# El diario, los recibos, los sellos de tiempo

Cada decisión, servida o rechazada, se sella en un diario por espacio de trabajo, encadenado por hash y de solo anexión, y el cliente conserva su propio recibo firmado de cada una. Cualquiera puede comprobar ambos sin Azoth.

## El diario sellado

- Cada entrada incluye el hash de la anterior: `entry_hash = sha256(prev_hash || core_canonical)`. Modificar o eliminar una entrada rompe la cadena a partir de ese punto.
- Los rechazos también se sellan: Azoth prueba lo que bloqueó. Un sello contiene hechos no personales — ids, códigos, hashes, el conjunto de reglas, el derecho, el precio, el momento de la decisión, el tipo de actor y la traza —, nunca el prompt ni la respuesta.
- Los datos personales están en un sobre aparte que puede borrarse en virtud del RGPD sin romper la cadena.
- La cadena se verifica cada hora a medida que crece —las entradas nuevas, y que la última entrada verificada sigue ahí, sin cambios— y por completo, cada entrada recalculada desde la primera conservada, una vez por semana y con **Verificar ahora**; una ruptura se muestra en **Pruebas** y se notifica como alerta.
- Consúltalo en **Pruebas › Decisiones** — cada resultado con su detalle: las reglas, los veredictos de seguridad, la comprobación de anclaje, el enrutamiento, el derecho — o con `GET /api/v1/journal`.

## Recibos

Cada respuesta de la pasarela que no se transmite en flujo lleva `X-Azoth-Receipt`: un JWS compacto firmado con la clave Ed25519 del espacio de trabajo. Aunque Azoth desaparezca, prueba que Azoth tomó esa decisión — y permite a un auditor encontrarla en la cadena. Una respuesta en flujo no lleva ninguno: sus cabeceras salen antes de que su decisión se selle, al terminar el flujo (un flujo que termina en error es una llamada fallida, nunca sellada).

```
header { "alg": "EdDSA", "typ": "azoth-receipt+jws", "kid": "<RFC 7638 thumbprint>" }
claims { "v": 1, "ws": "…", "trace": "…", "core": "<sha256>", "out": "allowed", "iat": 1793750400 }
```

### Lo que dice un recibo

- `ws` — el espacio de trabajo
- `trace` — el id de traza de la llamada, tal como aparece en Pruebas › Decisiones
- `core` — el sha256 del núcleo sellado de la decisión
- `out` — `allowed`, `blocked`, `rerouted`, `held` o `failed`
- `ref` — el hash de la referencia de la decisión de negocio, cuando la llamada envió una
- `iat` — cuándo se firmó

- Nunca ningún contenido. Una respuesta en streaming aún no lleva recibo; lleva `X-Azoth-Trace-Id`.
- Una respuesta servida tiene recibo mientras el diario de decisiones está activado; un rechazo siempre lo tiene. Un recibo nunca hace fallar una llamada.
- Las claves públicas son un JWKS en `GET /api/proof/keys/<workspaceId>`, claves retiradas incluidas. Las claves rotan cada 90 días.

```
import { receiptOf, verifyReceipt } from '@azothos/sdk';

const jwks = await fetch(`https://www.azothos.ai/api/proof/keys/${workspaceId}`).then(r => r.json());
const claims = await verifyReceipt(receiptOf(response), jwks);   // null when it does not verify
```

## Una decisión de negocio, muchas llamadas

Envía `X-Azoth-Decision-Ref` — un id que tu sistema ya tiene, como un número de expediente de crédito, nunca datos personales — en cada llamada que sirve a una misma decisión. Azoth solo conserva un hash con una sal propia de cada espacio de trabajo, y reúne esas llamadas en un [expediente de decisión](https://www.azothos.ai/es/docs/dossiers#decision).

```
await openai.chat.completions.create(body, {
  headers: azothGatewayHeaders({ decisionRef: 'CREDIT-2026-000123' }),   // an opaque id
});
```

## Sellos de tiempo de confianza

- Una autoridad de sellado de tiempo RFC 3161 firma el hash raíz de cada expediente exportado y, cada 5 a 60 minutos, la cabeza de la cadena de cada espacio de trabajo. Solo sale de Azoth un resumen SHA-256.
- Tres niveles por espacio de trabajo: estándar (la autoridad del despliegue), cualificado (una autoridad que el espacio de trabajo designa, probada antes de guardarla) y local (la del propio operador, fuera del SaaS).

## Bóveda del cliente

Para un sistema en modo bóveda, la pasarela no conserva ningún contenido de sus llamadas — ni sobre en el diario, ni caché semántica — y responde `X-Azoth-Vault: on`. El SDK cifra el contenido con tu clave en tu propio almacenamiento y envía un recibo; Azoth solo sella sus hashes.

## Comprobación de anclaje

Envía los pasajes en los que debe basarse una respuesta, y Azoth estima la proporción de sus afirmaciones que esos pasajes respaldan, según lo que está en juego en el sistema: por muestreo tras la respuesta, devuelta con ella o comprobada antes de que salga. La puntuación es siempre una estimación, mostrada con la concordancia medida de su juez con personas. Los pasajes nunca se almacenan.
