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

ثبّت الحزمة العامة:

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

استخدم Node.js 18 أو أحدث. الموارد الأساسية هي `issuers` و`keys` و`attestations` و`verify` و`audit` و`receipts`. لا تفترض أن كل واجهة برمجة تطبيقات عامة لديها طريقة ملائمة في هذه الحزمة؛ استخدم مرجع العملية و`client.request` عند الاقتضاء.

## تكوين المصادقة

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

استراتيجية مفتاح API هي `service`، وليست `apiKey`. لعملية المستخدم، استخدم `auth: { type: 'bearer', token }` مع رمز مستخدم صالح. `tenantId` لا يقوم بالمصادقة أو تبديل مساحات العمل. لا تستخدم المصادقة الخاصة بالمستأجر فقط.

## سك العملة

استخدم مُصدرًا موجودًا ومفتاحًا متاحًا للتوقيع من جانب الخادم. استخدم إما البايتات الأصلية المشفرة أو إدخال `schema` و `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);
```

عيّن جميع متغيرات البيئة الثلاثة قبل تشغيل المقتطف. للإدخال المنظم، استبدل `payload_b64url` بـ `schema: "attestation"` و `claims: { subject: "demo-record" }`؛ لا ترسل كلا الوضعين أبدًا. لا يوفر تسجيل المفتاح العام وحده مفتاح توقيع خاص.

## إعادة المحاولات ومعالجة الاستجابة

يضيف العميل رأسًا لعدم التكرار إلى طلبات POST و PUT. يؤدي استدعاء طريقة جديدة إلى إنشاء مفتاح جديد، لذا فهو ليس إعادة محاولة آمنة لكتابة سابقة غير مؤكدة ما لم تحتفظ بنفس المفتاح وتمرره. يقبل `client.request` خيار `idempotencyKey`. تقتصر عمليات إعادة المحاولة التلقائية على القراءات وكتابات التصديق/الإيصال المدعومة بمفتاح صريح؛ لا يتم إعادة تشغيل الكتابات العشوائية لمجرد توفير مفتاح.

افحص التحقق `verdict` و`reasons`. لا يُعد الوعد المحلول أو HTTP 200 وحده نتيجة تحقق صالحة. طابق إصدار الحزمة المثبتة مع إعلانات نوعها؛ المصدر المصحح حديثًا ليس دليلاً على أن إصدارًا أقدم مثبتًا يحتوي على الإصلاحات.

راجع [مثال HTTP المباشر](https://docs.truthlocks.com/ar/guides/sdk-examples.md) لتكامل مستقل عن التبعيات و [مرجع API](https://docs.truthlocks.com/ar/api-reference/attestations/mint.md) للعقد الحالي.


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