เดอะ เวิลด์ ไลบรารี

สกีมา v3 CDN แบบคงที่ ไร้ความไว้วางใจ (Trustless)

จุดเริ่มต้นแห่งความไว้วางใจสำหรับแอปพลิเคชันไคลเอนต์ เดอะ เวิลด์ ไลบรารี เผยแพร่ที่อยู่สัญญาอัจฉริยะที่ปรับใช้ แฮชความสมบูรณ์ของ ABI และตัวชี้ Arweave ที่สามารถตรวจสอบได้ไปยังคลังข้อมูล ให้บริการที่ registry.worldbibliotech.com.

เอนด์พอยต์ (Endpoints)

ไฟล์ ABI · /abis/evm/{ContractName}.json — ตรวจสอบแต่ละไฟล์เทียบกับ abiHash ก่อนใช้งาน

หากการดึงข้อมูลล้มเหลว แอปไคลเอนต์จะหยุดทำงานทันทีพร้อมข้อผิดพลาดที่ชัดเจน โปรดดูแลให้โฮสต์นี้ทำงานได้อย่างสมบูรณ์เสมอ แมนิเฟสต์จะถูกแคชโดย CDN เป็นเวลา 1 ชั่วโมง (Cache-Control: public, max-age=3600, must-revalidate).

สกีมาแมนิเฟสต์ — v3

แมนิเฟสต์ที่สร้างขึ้นคือแหล่งข้อมูลความจริงที่แท้จริง schemaVersion ปัจจุบันคือ 3; โปรดไปที่ลิงก์แมนิเฟสต์ดิบด้านบนแทนที่จะคัดลอกค่าจากหน้านี้

ฟิลด์ระดับบนสุด

ฟิลด์	ชนิด	คำอธิบาย
`generatedAt`	`string`	การประทับเวลา ISO 8601 ของการสร้างแมนิเฟสต์
`environment`	`"production" \| "staging"`	ตรงกับเส้นทางไดเรกทอรี (`/production/` หรือ `/staging/`).
`schemaVersion`	`number`	เวอร์ชันของสกีมาเอกสารนี้
`networks`	`object`	ที่อยู่สัญญาต่อเชน ดูด้านล่าง
`collections`	`object`	คอลเลกชันที่เผยแพร่ แต่ละรายการประกอบด้วยตัวชี้คลังข้อมูล ข้อมูลเมตาของห้องสมุด และแหล่งกำเนิด (provenance)

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`	ยึดเหนี่ยวแฮชคลังข้อมูลไว้บนเชน
`Factory`	สร้างรายการโครงการของผู้ใช้
`BouncerStorage`	ที่จัดเก็บการควบคุมการเข้าถึง — ประตูสมาชิกและระดับชั้น
`ScientistStorage`	ที่จัดเก็บข้อมูลบทบาทนักวิทยาศาสตร์
`BackupStorage`	ที่จัดเก็บข้อมูลการสำรองและกู้คืน
`ProjectManagerStorage`	ที่จัดเก็บข้อมูลเมตาของโครงการ

collections

แต่ละคอลเลกชันประกอบด้วยตัวชี้ไซด์คาร์ Arweave ที่ไม่ขึ้นกับเชน และแหล่งกำเนิดบนเชนที่รับรองความถูกต้อง ค่าระดับชั้น (Tier) เป็นอาร์เรย์เพื่อให้สามารถแบ่งส่วนคลังข้อมูลได้โดยไม่ต้องเปลี่ยนรูปแบบแมนิเฟสต์อีก

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 ที่มี AI ช่วยเหลือ	ตามความต้องการ

การค้นหาและแก้ไข URL ของไซด์คาร์: 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 TX ของบล็อบคลังข้อมูลที่ยึดไว้
  "sha256Hash":       "0x…",          // SHA-256 ขึ้นต้นด้วย 0x ของบล็อบ Arweave
  "blockNumber":      <blockNumber>  // หมายเลขบล็อกเมื่อจุดยึดได้รับการบันทึก
}

แหล่งความจริงบนบล็อกเชน

สัญญา AddressRegistry เป็นจุดยึดบนเชนที่ไม่สามารถเปลี่ยนแปลงได้สำหรับแฮชคลังข้อมูลและที่อยู่ที่ปรับใช้ทั้งหมด เป็นแหล่งข้อมูลความจริงตามรูปแบบมาตรฐานที่รวมอยู่ใน D-Open Code Sovereign Licence, เผยแพร่โดย Pond Enterprise และได้รับการรับรองตาม มาตรฐาน D-SAFE. คิวรีโดยตรงเพื่อตรวจสอบแมนิเฟสต์ใดๆ โดยไม่ต้องเชื่อถือ CDN นี้

เครือข่ายและรีจิสทรีที่ใช้งานอยู่

การปรับใช้สัญญาที่ใช้งานอยู่

เครือข่ายที่ปรับใช้ทั้งหมด

แมนิเฟสต์อาจแสดงการปรับใช้เพิ่มเติม ป้ายสัญลักษณ์ ใช้งานอยู่ (active) ระบุเครือข่ายมาตรฐานที่เลือกโดยการกำหนดค่าแอปพลิเคชันที่ใช้ร่วมกัน

สภาพแวดล้อม	เครือข่าย	เชน	สถานะ	สัญญา	รีจิสทรี

คิวรีจุดยึดคลังข้อมูล

เรียกคำสั่ง getLatestBlobRef(key) บนรีจิสทรีที่ใช้งานอยู่ คำสั่งที่สร้างขึ้นด้านล่างใช้คีย์แหล่งกำเนิดจริงและ RPC มาตรฐานของแต่ละคอลเลกชัน

ค่าที่ส่งกลับ	ชนิด	ต้องตรงกับ
`arweaveTxId`	`string`	`manifest.collections[key].provenance.arweaveTxId`
`sha256Hash`	`bytes32`	`manifest.collections[key].provenance.sha256Hash`

สิ่งนี้พิสูจน์อะไร: แฮชที่ส่งกลับบนเชนคือสิ่งที่ Pond Enterprise ยึดเหนี่ยวไว้ หากตรงกับแหล่งกำเนิดของคอลเลกชัน แสดงว่า CDN ไม่ได้แก้ไขเปลี่ยนแปลงตัวชี้คลังข้อมูลใดๆ หมายเลขบล็อกของแหล่งกำเนิดให้การประทับเวลาที่ตรวจสอบการปลอมแปลงได้