> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK de JavaScript / TypeScript

Instale el paquete público:

```bash theme={null}
npm install @truthlocks/sdk@^2.1.0
```

Use Node.js 18 o posterior. Los recursos principales son `issuers`, `keys`, `attestations`, `verify`, `audit` y `receipts`. No asuma que cada API pública tiene un método de conveniencia en este paquete; use la referencia de operación y `client.request` cuando sea apropiado.

## Configurar autenticación

```typescript theme={null}
import { TruthlockClient } from '@truthlocks/sdk';

const apiKey = process.env.TRUTHLOCKS_API_KEY;
if (!apiKey) throw new Error('Set TRUTHLOCKS_API_KEY');
const client = new TruthlockClient({
  baseUrl: 'https://sandbox-api.truthlocks.com',
  auth: { type: 'service', apiKey },
});
```

La estrategia de clave API es `service`, no `apiKey`. Para una operación de usuario, use `auth: { type: 'bearer', token }` con un token de usuario válido. `tenantId` no autentica ni cambia de espacio de trabajo. No use autenticación solo de inquilino.

## Acuñar

Utilice un emisor existente y una clave disponible para la firma del lado del servidor. Utilice bytes originales codificados o entrada estructurada `schema` y `claims`.

```typescript theme={null}
const payload = Buffer.from(JSON.stringify({ subject: 'demo-record' }), 'utf8');
const record = await client.attestations.mint({
  issuer_id: process.env.TRUTHLOCKS_ISSUER_ID!,
  kid: process.env.TRUTHLOCKS_KEY_ID!,
  alg: process.env.TRUTHLOCKS_ALGORITHM!,
  payload_b64url: payload.toString('base64url'),
});
console.log(record.attestation_id);
```

Establezca las tres variables de entorno antes de ejecutar el fragmento. Para entrada estructurada, reemplace `payload_b64url` con `schema: "attestation"` y `claims: { subject: "demo-record" }`; nunca envíe ambos modos. El registro de clave pública por sí solo no aprovisiona una clave privada de firma.

## Reintentos y manejo de respuestas

El cliente agrega un encabezado de idempotencia a las solicitudes POST y PUT. Una nueva llamada de método genera una nueva clave, por lo que no es un reintento seguro de una escritura anterior incierta a menos que conserve y pase la misma clave. `client.request` acepta una opción `idempotencyKey`. Los reintentos automáticos se limitan a lecturas y escrituras de atestación/recibo compatibles con una clave explícita; las escrituras arbitrarias no se reproducen simplemente porque se proporcionó una clave.

Inspeccione la verificación `verdict` y `reasons`. Una promesa resuelta o un HTTP 200 por sí solos no son un resultado de verificación válido. Haga coincidir la versión del paquete instalado con sus declaraciones de tipo; el código fuente recién corregido no es evidencia de que una versión instalada anterior contenga las correcciones.

Consulte el [ejemplo HTTP directo](https://docs.truthlocks.com/es/guides/sdk-examples.md) para una integración independiente de dependencias y la [referencia de API](https://docs.truthlocks.com/es/api-reference/attestations/mint.md) para el contrato actual.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.