The World Library — السجل (Registry)

المخطط v3 شبكة CDN ثابتة تحقق لا يعتمد على وسيط

جذر الثقة لتطبيقات عميل The World Library. ينشر عناوين العقود الذكية المنشورة، وبصمات سلامة واجهات ABI، ومؤشرات Arweave القابلة للتحقق الخاصة بالمجموعة النصية (Corpus). يُقدَّم عبر registry.worldbibliotech.com.

نقاط الوصول (Endpoints)

ملفات ABI · /abis/evm/{ContractName}.json — تحقّق من كل ملف مقابل قيمة abiHash الخاصة به قبل الاستخدام

عند فشل الجلب يتوقف تطبيق العميل فورًا برسالة خطأ واضحة. حافظ على سلامة هذا المضيف. يتم تخزين ملف البيان (Manifest) مؤقتًا عبر CDN لمدة ساعة واحدة (Cache-Control: public, max-age=3600, must-revalidate).

مخطط ملف البيان (Manifest Schema) — v3

ملفات البيان المولَّدة هي مصدر الحقيقة الوحيد. قيمة schemaVersion الحالية هي 3؛ اتبع روابط ملفات البيان الخام أعلاه بدلاً من نسخ القيم من هذه الصفحة.

الحقول العليا

الحقل	النوع	الوصف
`generatedAt`	`string`	طابع زمني بصيغة ISO 8601 لوقت توليد البيان.
`environment`	`"production" \| "staging"`	يطابق مسار المجلد (`/production/` أو `/staging/`).
`schemaVersion`	`number`	رقم إصدار مخطط هذا المستند.
`networks`	`object`	عناوين العقود لكل شبكة بلوكتشين. انظر أدناه.
`collections`	`object`	المجموعات المنشورة، وتضم كلٌّ منها مؤشرات المجموعة النصية وبيانات المكتبة الوصفية وإثبات المصدر.

networks

يحتوي على مفتاح واحد لكل طبقة نقل. حاليًا يتم تعريف evm فقط. يربط كل إدخال شبكة أسماء العقود بعنوانها المنشور وبصمة سلامة ABI الخاصة بها.

manifest.json → networks

"networks": {
  "evm": {
    "<chainId>": {
      "shortName": "<networkKey>",
      "contracts": {
        "<ContractName>": {
          "address": "0x…",           // العنوان المنشور على هذه الشبكة
          "abiHash": "<sha256 hex>"    // بصمة SHA-256 لملف /abis/evm/{ContractName}.json
        }
      }
    }
  }
}

العقد الذكي	الوصف
`AddressRegistry`	يثبّت بصمات المجموعة النصية (Corpus) على الشبكة.
`Factory`	ينشئ سجلات مشاريع المستخدمين.
`BouncerStorage`	تخزين التحكم في الوصول — بوابات العضوية والمستويات.
`ScientistStorage`	تخزين بيانات دور الباحث العلمي (Scientist).
`BackupStorage`	تخزين النسخ الاحتياطي والاسترداد.
`ProjectManagerStorage`	تخزين البيانات الوصفية للمشاريع.

collections

تضم كل مجموعة مؤشرات Arweave الجانبية المستقلة عن الشبكة وإثبات المصدر على الشبكة الذي يوثقها. قيم المستويات عبارة عن مصفوفات بحيث يمكن تجزئة المجموعة النصية دون تغيير شكل ملف البيان.

manifest.json → collections

"collections": {
  "<collectionKey>": {
    "corpus": {
      "layoutVersion": <number>,
      "objects": {
        "<objectTypeId>": {
          "<langCode>": {
            "slim": ["<arweaveTxId>"],
            "extended": ["<arweaveTxId>"],
            "prov": ["<arweaveTxId>"],
            "ai-for-D-safe": ["<arweaveTxId>"]
          }
        }
      }
    },
    "provenance": { /* تثبيت المجموعة النصية على الشبكة */ },
    "library": { /* البيانات الوصفية للمكتبة العامة */ }
  }
}

معرّف نوع الكائن	النموذج	الوصف
`"0"`	كتاب (Book)	السجلات الببليوجرافية للكتب.
`"1"`	شخص (Person)	سجلات المؤلفين والمساهمين.
`"2"`	وسم (Tag)	وسوم الموضوعات والتصنيف.

مفتاح المستوى	الغرض	وقت التحميل
`slim`	حقول مختصرة لعروض القوائم والبحث.	عند بدء التشغيل، بالتوازي مع ملف البيان.
`extended`	حقول السجل الكاملة.	عند الطلب أو في الخلفية.
`prov`	بيانات التأليف، ونَسب المصدر، وسجل التعديلات.	عند الطلب.
`ai-for-D-safe`	نتائج تقييم D-SAFE المدعوم بالذكاء الاصطناعي.	عند الطلب.

لتكوين رابط ملف جانبي (Sidecar): https://arweave.net/{collections[key].corpus.objects[typeId][lang][tier][0]}

provenance

يثبت أن كتلة corpus هي نفس البيانات المثبّتة على الشبكة بواسطة المسؤول. لا تثق بالمجموعة النصية دون التحقق من هذه الكتلة مقابل عقد AddressRegistry.

manifest.json → provenance

"provenance": {
  "anchorChainId":    <canonicalChainId>,
  "contractAddress":  "0x…",         // عنوان AddressRegistry على شبكة anchorChainId
  "key":              "COLLECTION_CORPUS::<collectionKey>",
  "arweaveTxId":      "<txid>",       // معرّف معاملة Arweave لكتلة المجموعة النصية المثبتة
  "sha256Hash":       "0x…",          // بصمة SHA-256 المسبوقة بـ 0x لكتلة Arweave
  "blockNumber":      <blockNumber>  // رقم الكتلة عند تعدين التثبيت
}

مصدر الحقيقة على الشبكة (On-Chain)

عقد AddressRegistry هو نقطة التثبيت غير القابلة للتغيير على الشبكة لجميع بصمات المجموعات النصية والعناوين المنشورة. وهو مصدر الحقيقة المعتمد المدمج في D-Open Code Sovereign Licence، المنشور بواسطة Pond Enterprise والمعتمد وفق معايير D-SAFE. استعلم منه مباشرة للتحقق من أي ملف بيان دون الحاجة للثقة في شبكة CDN هذه.

الشبكات والسجلات النشطة

العقود النشطة المنشورة

جميع الشبكات المنشورة

قد يعلن ملف البيان عن عمليات نشر إضافية. تحدد شارة نشط الشبكة المعتمدة التي يختارها إعداد التطبيق المشترك.

البيئة	الشبكة	معرّف السلسلة	الحالة	العقود	السجل

الاستعلام عن تثبيت المجموعة النصية

استدعِ الدالة getLatestBlobRef(key) على السجل النشط. تستخدم الأوامر المولَّدة أدناه مفتاح إثبات المصدر الحقيقي ونقطة اتصال RPC المعتمدة لكل مجموعة.

القيمة المُرجعة	النوع	يجب أن تطابق
`arweaveTxId`	`string`	`manifest.collections[key].provenance.arweaveTxId`
`sha256Hash`	`bytes32`	`manifest.collections[key].provenance.sha256Hash`

ما الذي يثبته هذا: البصمة المُرجعة من الشبكة هي ما ثبّتته Pond Enterprise. إذا طابقت إثبات مصدر المجموعة، فهذا يعني أن CDN لم يتلاعب بأي مؤشر في المجموعة النصية. ويوفر رقم كتلة الإثبات طابعًا زمنيًا محميًا من التلاعب.