> ## 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 JavaScript / TypeScript

Instale o pacote público:

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

Use Node.js 18 ou posterior. Os recursos principais são `issuers`, `keys`, `attestations`, `verify`, `audit` e `receipts`. Não assuma que toda API pública tem um método de conveniência neste pacote; use a referência de operação e `client.request` quando apropriado.

## Configurar autenticação

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

A estratégia de chave de API é `service`, não `apiKey`. Para uma operação de usuário, use `auth: { type: 'bearer', token }` com um token de usuário válido. `tenantId` não autentica ou troca de espaços de trabalho. Não use autenticação somente de locatário.

## Mint

Use um emissor existente e uma chave disponível para assinatura no lado do servidor. Use bytes originais codificados ou entrada estruturada `schema` e `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);
```

Defina todas as três variáveis de ambiente antes de executar o snippet. Para entrada estruturada, substitua `payload_b64url` por `schema: "attestation"` e `claims: { subject: "demo-record" }`; nunca envie ambos os modos. O registro de chave pública por si só não provisiona uma chave privada de assinatura.

## Tentativas e tratamento de resposta

O cliente adiciona um cabeçalho de idempotência às requisições POST e PUT. Uma nova chamada de método gera uma nova chave, portanto, não é uma nova tentativa segura de uma escrita anterior incerta, a menos que você mantenha e passe a mesma chave. `client.request` aceita uma opção `idempotencyKey`. As novas tentativas automáticas são limitadas a leituras e escritas de atestado/recibo suportadas com uma chave explícita; escritas arbitrárias não são repetidas simplesmente porque uma chave foi fornecida.

Inspecione a verificação `verdict` e `reasons`. Uma promessa resolvida ou um HTTP 200 por si só não é um resultado de verificação válido. Faça corresponder a versão do pacote instalado com as suas declarações de tipo; o código-fonte recém-corrigido não é prova de que uma versão mais antiga instalada contenha as correções.

Consulte o [exemplo HTTP direto](https://docs.truthlocks.com/pt/guides/sdk-examples.md) para uma integração independente de dependências e a [referência da API](https://docs.truthlocks.com/pt/api-reference/attestations/mint.md) para o contrato atual.


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