# تحقّق بنفسك

تتحقق أداة `azoth-verify` من ملف أو إيصال دون Azoth: بلا تبعيات، وبلا أي اتصال بالشبكة، وبلا شيفرة مشتركة مع الجهة المُنتِجة — فلا يقوم حكمها على الثقة بنا.

## من سطر الأوامر

نزّل أداة التحقق من **الإثباتات › التحقق** — أرشيف ZIP، وبجانبه بصمة SHA-256 الخاصة به — ثم فك ضغطه وشغّله بالإصدار 18 من Node.js أو أحدث:

```
shasum -a 256 -c azoth-verify.zip.sha256
unzip azoth-verify.zip -d azoth-verify && cd azoth-verify

node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json                          # PASS / FAIL per check, exit 0 / 1
node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json --json                   # machine-readable
node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json --tsa-root tsa-root.pem  # pin the time-stamping root too
node bin/azoth-verify.mjs receipt receipt.txt --dossier dossier.zip --keys keys.jwks.json
```

## في متصفح، دون اتصال

الملف `/azoth-verify.html` صفحة واحدة مكتفية بذاتها تُجري الفحوص نفسها في المتصفح، دون أي وصول إلى الشبكة على الإطلاق. ويفتحها زر **تحقّق بنفسك** في الإثباتات › الملفات والإثباتات › التحقق؛ أما في الصفحة الرئيسية فيفتح آخر قرار جرى التحقق منه، ويُنزّل زرّه **تصدير هذا القرار والتحقق منه** ملفه ويفتح الصفحة بجانبه. احتفظ بنسخة منها: فهي تعمل دون Azoth.

[/azoth-verify.html](https://www.azothos.ai/azoth-verify.html)

## جرّبه على مثال

ملف تجريبي يضم خمسة قرارات اصطناعية، والمفاتيح العامة لمساحة العمل التجريبية، وإيصال إحدى استدعاءاتها — أنتجتها شيفرة التصدير الخاصة بـ Azoth نفسها، ووُقّعت بمفتاح تجريبي لم يُكتب نصفه الخاص قط. نزّل الملفات الثلاثة، ثم شغّل:

[demo-dossier.zip](https://www.azothos.ai/verify-examples/demo-dossier.zip) · [demo-keys.jwks.json](https://www.azothos.ai/verify-examples/demo-keys.jwks.json) · [receipt.txt](https://www.azothos.ai/verify-examples/receipt.txt)

```
node bin/azoth-verify.mjs demo-dossier.zip --keys demo-keys.jwks.json
node bin/azoth-verify.mjs receipt receipt.txt --dossier demo-dossier.zip --keys demo-keys.jwks.json
```

في صفحة المتصفح، اختر `demo-dossier.zip`، و`demo-keys.jwks.json` لتثبيت مفاتيحه. غيّر بايتًا واحدًا من الملف ثم تحقّق من جديد: يفشل التحقق.

## مفتوح المصدر

تُنشر أداة التحقق بموجب ترخيص Apache-2.0: يمكن لأي شخص قراءتها وتشغيلها وتعديلها. وشيفرتها هي نفسها الموجودة في أرشيف ZIP وفي صفحة المتصفح.

[github.com/azothos/azoth-verifier](https://github.com/azothos/azoth-verifier)

يُنشر كل إصدار أيضًا في مستودعه العام الخاص وعلى npm — مع Node.js، لا حاجة إلى تنزيل أي شيء مسبقًا:

```
npx -y @azothos/verifier demo-dossier.zip --keys demo-keys.jwks.json
npx -y @azothos/verifier receipt receipt.txt --dossier demo-dossier.zip --keys demo-keys.jwks.json
```

## ما الذي تفحصه

- كل ملف مقابل البيان، والبصمة الجذرية؛
- سلسلة التجزئة للقرارات المختومة؛
- الختم الزمني وفق RFC 3161، مقابل شهادة جذرية تثبّتها بالخيار `--tsa-root`؛
- كل نوع من الملفات: القرار، والحادث، والامتثال، والنزاع، واستنزاف التكاليف، وبصمة الذكاء الاصطناعي؛
- الإيصال: صيغته، ومفتاحه، وتوقيعه، والقرار الذي يشير إليه؛
- القانون المطبَّق على كل قرار، يُبتّ فيه من جديد انطلاقًا من ختمه؛
- توقيع الملف — وهو إلزامي منذ الإصدار 2.0.0 — مقابل مفاتيح تثبّتها بالخيار `--keys`، وما يغطيه: رأس السجل عند التصدير، والإدخالات المدرجة، والمرشّحات؛
- منذ الإصدار 2.1.0، وقت كل إدخال ونوع فاعله وأثره، مقابل ما يقوله ختمه؛
- كل تكلفة مختومة، تُحسب من جديد من سعرها المختوم ومن كتالوج النماذج الموقّع.

> تأتي الثقة مما تثبّته أنت: المفاتيح المنشورة على `/api/proof/keys/<workspaceId>`، والشهادة الجذرية لجهة الختم الزمني. ودون المفاتيح، لا يُتحقَّق من الملف: فالمفاتيح التي يتضمنها لا تضمن إلا نفسها، والملف غير الموقَّع لا يربط محتواه بشيء. ودون الشهادة الجذرية للجهة، يُبلَّغ عن الختم الزمني بتنبيه.

كل فحص موصوف في `packages/verifier/SPEC.md`، وهو كافٍ لكتابة أداة تحقق أخرى من الصفر.

الفحص الناجح يثبت أن الملفات هي تلك التي ختمها Azoth ووقّعها، بهذا الترتيب، في ذلك الوقت. ولا يثبت أن القرار كان صائبًا: إنه دليل تقني، لا حكم.
