> ## 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.

# JavaScript / TypeScript SDK

Installieren Sie das öffentliche Paket:

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

Verwenden Sie Node.js 18 oder höher. Die Kernressourcen sind `issuers`, `keys`, `attestations`, `verify`, `audit` und `receipts`. Gehen Sie nicht davon aus, dass jede öffentliche API eine Komfortmethode in diesem Paket hat; verwenden Sie die Operationsreferenz und `client.request` wo angebracht.

## Authentifizierung konfigurieren

```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 },
});
```

Die API-Schlüssel-Strategie ist `service`, nicht `apiKey`. Für eine Benutzeroperation verwenden Sie `auth: { type: 'bearer', token }` mit einem gültigen Benutzer-Token. `tenantId` authentifiziert oder wechselt keine Arbeitsbereiche. Verwenden Sie keine reine Mandanten-Authentifizierung.

## Mint

Verwenden Sie einen vorhandenen Aussteller und einen Schlüssel, der für die serverseitige Signierung verfügbar ist. Verwenden Sie entweder kodierte Original-Bytes oder strukturierte `schema`- und `claims`-Eingaben.

```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);
```

Setzen Sie alle drei Umgebungsvariablen, bevor Sie das Snippet ausführen. Für strukturierte Eingaben ersetzen Sie `payload_b64url` durch `schema: "attestation"` und `claims: { subject: "demo-record" }`; senden Sie niemals beide Modi. Die Registrierung eines öffentlichen Schlüssels allein stellt keinen privaten Signaturschlüssel bereit.

## Wiederholungsversuche und Antwortverarbeitung

Der Client fügt POST- und PUT-Anfragen einen Idempotenz-Header hinzu. Ein neuer Methodenaufruf generiert einen neuen Schlüssel, daher ist es kein sicherer Wiederholungsversuch eines unsicheren früheren Schreibvorgangs, es sei denn, Sie behalten und übergeben denselben Schlüssel. `client.request` akzeptiert eine `idempotencyKey`-Option. Automatische Wiederholungen sind auf Lesevorgänge und unterstützte Bescheinigungs-/Empfangsschreibvorgänge mit einem expliziten Schlüssel beschränkt; beliebige Schreibvorgänge werden nicht einfach wiederholt, weil ein Schlüssel bereitgestellt wurde.

Überprüfen Sie die Verifizierung `verdict` und `reasons`. Ein aufgelöstes Promise oder HTTP 200 allein ist kein gültiges Verifizierungsergebnis. Stimmen Sie die installierte Paketversion mit ihren Typdeklarationen ab; neu korrigierter Quellcode ist kein Beweis dafür, dass eine ältere installierte Version die Korrekturen enthält.

Ein unabhängiges Integrationsbeispiel und die aktuelle Vertragsspezifikation finden Sie im [direkten HTTP-Beispiel](https://docs.truthlocks.com/de/guides/sdk-examples.md) und in der [API-Referenz](https://docs.truthlocks.com/de/api-reference/attestations/mint.md).


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