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

# حماية تأليف الكود

> أثبت أنك كتبت الرمز بشهادات تشفيرية.

أثبت أنك كتبت الرمز. تنشئ Truthlocks شهادات تشفيرية للرمز المصدري، وواجهات برمجة التطبيقات، والوثائق، والأصول الرقمية الأخرى. احمِ ملكيتك الفكرية باستخدام تجزئة SHA-256 وإثبات مختوم بالوقت — كل ذلك دون أن يغادر رمزك المصدري جهازك أبدًا.

## لماذا تعتبر تأليف الكود مهمًا

* **نزاعات الملكية الفكرية:** أثبت أنك كتبت الكود قبل أن يدعي شخص آخر ذلك. الدليل المشفر الموقّع زمنيًا مقبول كدليل.
* **حماية المصدر المفتوح:** احمِ مساهماتك قبل النشر. إذا قام شخص ما بنسخ عملك وادعى ملكيته، فلديك دليل.
* **العمل التعاقدي:** إثبات تواريخ التسليم والتأليف للعملاء بإشهادات يمكن التحقق منها بشكل مستقل.
* **التحقق من المحفظة:** يمكن لأصحاب العمل أو العملاء المحتملين التحقق من أن عملك المزعوم هو ملكك حقًا.

## كيف يعمل

**1. تجزئة التعليمات البرمجية محليًا**

احسب SHA-256 لملفك المصدر، أو أرشيف المستودع، أو أي قطعة أثرية.
محتوى الملف لا يغادر جهازك أبدًا.

**2. إرسال الهاش**

أرسل الهاش والعنوان والبيانات الوصفية إلى Truthlocks API. التصديق هو
تم إنشاؤها باستخدام مفتاح التوقيع الشخصي الخاص بك.

**3. ربط بسجل الشفافية**

يتم ربط التصديق بسجل إلحاقي متوافق مع RFC 6962،
سجل شفافية مع طابع زمني غير قابل للتغيير.

**4. مشاركة الإثبات**

احصل على عنوان URL لإثبات قابل للمشاركة، أو شارة قابلة للتضمين، أو شهادة قابلة للتنزيل.

## حماية ملف واحد (CLI / API)

تجزئة ملف مصدر وتقديم الإشهاد:

```bash theme={null}
# Hash a file locally (macOS/Linux)
HASH=$(sha256sum main.go | awk '{print $1}')

# Submit to Truthlocks API
curl -X POST https://api.truthlocks.com/v1/consumer/mint \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content_hash": "'$HASH'",
    "title": "main.go — Core Engine v2.1",
    "description": "Primary application entry point and engine logic",
    "file_name": "main.go",
    "content_type": "code",
    "category": "source_code",
    "visibility": "public"
  }'
```

## حماية مستودع كامل

أنشئ أرشيفًا حتميًا لمستودعك وقم بتجزئته:

```bash theme={null}
# Create a deterministic git archive
git archive --format=tar HEAD | sha256sum | awk '{print $1}'

# Or hash a specific commit
git archive --format=tar <commit-sha> | sha256sum | awk '{print $1}'
```

> [!TIP]
>
> استخدم `git archive` بدلاً من ضغط الدليل — ينتج عنه حتمية
> الإخراج بغض النظر عن بيانات تعريف نظام الملفات، مما يجعل التجزئة قابلة للتكرار.

## أمثلة

```javascript Node.js theme={null}
import { createHash } from 'crypto';
import { readFileSync } from 'fs';

// Hash a source file
const content = readFileSync('src/index.ts');
const hash = createHash('sha256').update(content).digest('hex');

// Submit to Truthlocks
const response = await fetch('https://api.truthlocks.com/v1/consumer/mint', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + token,
'Content-Type': 'application/json',
},
body: JSON.stringify({
content_hash: hash,
title: 'src/index.ts — API Server',
description: 'Main API server entry point',
content_type: 'code',
category: 'source_code',
}),
});

const { attestation_id, content_hash, protected_at, verify_url } = await response.json();
console.log('Proof URL:', verify_url);
console.log('Hash:', content_hash, 'Protected at:', protected_at);

```

```go Go theme={null}
package main

import (
    "crypto/sha256"
    "encoding/hex"
    "fmt"
    "os"
)

func hashFile(path string) (string, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return "", err
    }
    h := sha256.Sum256(data)
    return hex.EncodeToString(h[:]), nil
}

func main() {
    hash, err := hashFile("main.go")
    if err != nil {
        panic(err)
    }
    fmt.Printf("SHA-256: %s\n", hash)
    // Submit hash to POST /v1/consumer/mint
}
```

```python Python theme={null}
import hashlib
import requests

def hash_file(path: str) -> str:
    with open(path, "rb") as f:
        return hashlib.sha256(f.read()).hexdigest()

file_hash = hash_file("app.py")

response = requests.post(
    "https://api.truthlocks.com/v1/consumer/mint",
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
    },
    json={
        "content_hash": file_hash,
        "title": "app.py — Flask Application",
        "content_type": "code",
        "category": "source_code",
    },
)

data = response.json()
print(f"Proof: {data['verify_url']}")
print(f"Hash: {data['content_hash']}  Protected at: {data['protected_at']}")
```

## تكامل CI/CD

أتمتة حماية التعليمات البرمجية في مسار CI الخاص بك. حماية كل إصدار:

```yaml GitHub Actions theme={null}
- name: Protect release artifact
  run: |
    HASH=$(sha256sum dist/app.tar.gz | awk '{print $1}')
    curl -X POST https://api.truthlocks.com/v1/consumer/mint \
      -H "Authorization: Bearer $TRUTHLOCKS_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "content_hash": "'$HASH'",
        "title": "Release build",
        "description": "Production release artifact",
        "content_type": "code",
        "category": "release"
      }'
```

## أضف شارة إلى ملف README الخاص بك

اعرض حالة التحقق مباشرة في مستودعك:

```md Markdown theme={null}
[![Protected by Truthlocks](https://verify.truthlocks.com/badge/ATTESTATION_ID)](https://verify.truthlocks.com/proof/ATTESTATION_ID)
```

تعرض الشارة حالة التحقق ديناميكيًا ويتم تخزينها مؤقتًا لتحسين الأداء. استبدل `ATTESTATION_ID` بالمعرف الذي تم إرجاعه من نقطة نهاية السك.

## التحقق

يمكن لأي شخص التحقق بشكل مستقل من تأليف الكود الخاص بك:

1. قم بتجزئة الملف الأصلي باستخدام SHA-256 (نفس الخوارزمية المستخدمة أثناء الحماية).
2. قم بزيارة عنوان URL للإثبات أو اتصل بـ `POST /v1/verify` باستخدام معرف الشهادة.
3. يؤكد النظام تطابق التجزئة، ويتحقق من التوقيع التشفيري، ويفحص مرساة سجل الشفافية.

```bash theme={null}
# Verify an attestation
curl -X POST https://api.truthlocks.com/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"attestation_id": "b2c3d4e5-..."}'
```

## خصائص وقيود الأمان

يمكن أن يؤدي تجزئة ملف محليًا إلى تجنب تحميل وحدات البايت المصدر الخاصة به، ولكنه ليس إثباتًا للمعرفة الصفرية. افحص العميل المختار والطلب لتأكيد البيانات الوصفية التي يرسلها.

يمكن أن يربط الإشهاد تجزئة مقدمة بمفتاح توقيع ونقطة تحقق سجل. هذا دليل على التقديم المسجل؛ ولا يثبت من كتب الكود الأصلي، أو التأليف الحصري، أو الملكية، أو أن شخصًا واحدًا فقط يمكنه تقديمه. يعتمد التحقق على المفاتيح الموثوقة وتوفر مادة الإثبات.


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