TgWitness / เอกสาร

สิ่งที่ได้รับการทดสอบแล้ว →

อ้างอิง / หลักฐาน

Telegram · พยานอิสระ

เรียกใช้ witness ด้วยกุญแจและบอทของตัวเอง เผยแพร่จุดตรวจสอบที่ลงนามแล้วไปยังช่อง และตรวจสอบการส่งออกข้อมูลกับจุดตรวจสอบดังกล่าว

TgWitness / เอกสารประกอบ · หลักฐานและการตรวจสอบ

หลักฐานและการตรวจสอบ

ส่งออกและตรวจสอบ · ความมั่นใจสูง · คู่มือการใช้งานแผงควบคุม

Witness เก็บจุดตรวจสอบที่ลงนามไว้แยกจาก collector มันตรวจสอบ ลายเซ็นของ collector และความต่อเนื่องของ journal ลงนามผลลัพธ์ด้วยกุญแจของตัวเอง และ เผยแพร่ไปยังช่อง Telegram ให้ทำงานบนเซิร์ฟเวอร์แยกต่างหากที่มีสิทธิ์เข้าถึงแบบอ่านอย่างเดียว ไปยังจุดปลายทาง witness ของ collector

ผลลัพธ์ทางเทคนิคประกอบด้วยส่วนต้นของบันทึกที่เก็บไว้ การตอบกลับคำท้า การตรวจลายเซ็น การตรวจการรวมอยู่/ความสอดคล้องของ Merkle และผลความต่อเนื่องที่ลงนาม สำหรับผู้สังเกตการณ์ที่ดำเนินการโดยผู้ดูแลรายอื่น ให้เก็บข้อมูลผู้ดูแลและบันทึกการควบคุมกุญแจพร้อมลายนิ้วมือของกุญแจไว้ กุญแจที่แยกกันและการดูแลที่แยกกันอธิบายส่วนต่างๆ ของการตั้งค่า ตัวตรวจสอบรายงานว่ากุญแจที่สองเก็บส่วนหัวของบันทึกไว้ถึงบันทึกรายการใด บันทึกการควบคุมกุญแจของผู้ดูแลแสดงว่าใครถือกุญแจนั้น บันทึกของผู้สังเกตการณ์เป็นการตรวจสอบเสริม ขั้นต่ำสำหรับหลักฐานคือเวลาจากบุคคลที่สาม โพสต์ในช่องเพิ่มเวลาภายนอก: Telegram ระบุวันที่ให้ทุกโพสต์สาธารณะ และตัวตรวจสอบอ่านวันที่เหล่านั้นเอง

แผนผังกระบวนการCollector → Witness (จุดตรวจสอบที่ลงนาม: จำนวนบันทึก + ค่าแฮชส่วนหัว); Witness → สมุดบันทึกพยาน, กุญแจส่วนตัว; Witness → ช่อง Telegram (โพสต์ที่ลงนามผ่านบอทของระบบเอง); ไฟล์ ZIP ของหลักฐาน → verify.py; สมุดบันทึกพยาน, กุญแจส่วนตัว → verify.py; ช่อง Telegram → verify.py (t.me/s: อ่านหน้าแบบสด หรือ ส่งออกสู่เดสก์ท็อป)CollectorWitnessสมุดบันทึกพยาน,กุญแจส่วนตัวช่อง Telegramไฟล์ ZIP ของหลักฐานverify.pyจุดตรวจสอบที่ลงนาม:จำนวนบันทึก + ค่าแฮชส่วนหัวโพสต์ที่ลงนามผ่านบอทของระบบเองt.me/s: อ่านหน้าแบบสด หรือส่งออกสู่เดสก์ท็อป
แผนภาพในรูปแบบข้อความ
  1. Collector → Witness (จุดตรวจสอบที่ลงนาม: จำนวนบันทึก + ค่าแฮชส่วนหัว)
  2. Witness → สมุดบันทึกพยาน, กุญแจส่วนตัว
  3. Witness → ช่อง Telegram (โพสต์ที่ลงนามผ่านบอทของระบบเอง)
  4. ไฟล์ ZIP ของหลักฐาน → verify.py
  5. สมุดบันทึกพยาน, กุญแจส่วนตัว → verify.py
  6. ช่อง Telegram → verify.py (t.me/s: อ่านหน้าแบบสด หรือ ส่งออกสู่เดสก์ท็อป)
บนหน้านี้

สิ่งที่ผู้สังเกตการณ์เก็บรักษาไว้#

TgWitness มี พยานไม่เคย
โทเค็นพยานแบบอ่านอย่างเดียวสำหรับพื้นที่ทำงานหนึ่งแห่ง เซสชัน Telegram หรือข้อมูลรับรอง API ของผู้เก็บข้อมูล
กุญแจ Ed25519 และบันทึกของตัวเอง ห้องเก็บรักษาข้อมูลของระบบเก็บรวบรวม, กุญแจลงนาม หรือ โทเค็นแผงควบคุม
โทเค็นบอท Telegram ของตัวเอง เนื้อหาข้อความ: ส่วนหัวประกอบด้วยจำนวนบันทึกและค่าแฮช

โทเค็นถูกสร้างขึ้นใน More tools → Extras → Independent witness, แสดงขึ้นเพียงครั้งเดียวและเก็บไว้เพียงในรูปแบบ SHA256 เท่านั้น มันเปิดจุดปลายทางเพียงหนึ่งจุดเท่านั้น คือ GET /api/witness/head ซึ่งคืนค่าจุดตรวจสอบที่เพิ่ง ลงนามใหม่ พร้อมทั้งตัวนับการเก็บรวบรวมที่ลงนามแล้วแต่ไม่มีเนื้อหา และสถานะความพร้อมในการทำงาน มันไม่สามารถเปิดแผงควบคุม อ่านเนื้อหาข้อความ หรือเปลี่ยนการตั้งค่าได้ และ โทเค็นของแผงควบคุมไม่ได้รับการยอมรับที่นั่น สามารถเพิกถอนโทเค็นได้บนหน้าเดียวกัน ผู้รวบรวมจะบันทึก เมื่อกุญแจพยานใหม่เริ่มตรวจสอบ (witness.seen) และแสดงการตรวจสอบครั้งสุดท้ายต่อโทเค็น; พยานที่ยังไม่ตรวจสอบภายในช่วงเวลา2.5 จะถูกทำเครื่องหมายว่าเกินกำหนด

พยานใหม่จะส่งคำท้าแบบสุ่มใน การโหวตแต่ละครั้ง; คำสั่งบันทึกจะสะท้อนคำท้าดังกล่าวภายใต้ลายเซ็นของผู้รวบรวม ตัวนับ ถูกผูกกับจุดตรวจสอบที่แม่นยำและถูกรวมไว้ในโพสต์ของพยานที่ลงนามแล้ว พยานรุ่นเก่า ยังคงได้รับการยอมรับจากพยานแบบสแตนด์อโลน การเพิ่มขนาดของบันทึกเพียงอย่างเดียวจะไม่ถูกนับเป็นข้อความใหม่

สิ่งที่ระบบตรวจสอบและบันทึก#

ทุกช่วงเวลา (ค่าเริ่มต้นคือ 10 นาที) TgWitness จะ:

  1. ดึงส่วนหัวมาเอง (ผู้รวบรวมข้อมูลไม่สามารถส่งหรือข้ามส่วนหัวนี้ได้);
  2. ตรวจสอบลายมือของผู้เก็บข้อมูล, กุญแจผู้เก็บข้อมูลที่ถูกตรึง (--collector-fingerprint, หรือกุญแจแรกที่พบ), จำนวนที่ไม่ลดลง และส่วนหัวที่ไม่เปลี่ยนแปลงที่จำนวนที่ไม่เปลี่ยนแปลง การพิสูจน์การรวมและการสอดคล้องของ Merkle ตรวจสอบว่าบันทึกที่เพิ่มขึ้นขยาย จุดตรวจสอบที่เก็บไว้ เมื่อการพิสูจน์ความต่อเนื่องถูกใช้แล้ว การลบมันจะถูกปฏิเสธ;
  3. เพิ่มบันทึกที่ลงนามแล้วลงในบันทึกของตนเอง: witness.anchor ด้วยสถานะ ok, key_changed, rollback (จำนวนบันทึกน้อยกว่าเดิม), fork (ความยาวเท่ากัน แต่ส่วนหัวต่างกัน ) หรือ invalid (คำตอบไม่ผ่านการตรวจสอบ), หรือ witness.no_response เมื่อ ผู้รวบรวมข้อมูลไม่ตอบกลับ;
  4. ส่งผลลัพธ์ไปยังช่อง (channel) พร้อมลายเซ็น รวมถึงข้อความ "no answer" ในขณะที่ TgWitness กำลังทำงานและสามารถเข้าถึง Bot API ได้ ID ของการโพสต์ถูกบันทึกไว้ (witness.posted), รวมถึงการโพสต์ที่ล้มเหลวด้วย (witness.post_failed).

โพสต์มีลักษณะดังนี้; บรรทัดสุดท้ายมีข้อความที่ลงนาม:

TgWitness witness #42 · journal head
Collector 3fa9c2d1e0b4a7f6: 18234 records
Head 9b1f…c07e
2026-10-28T19:40:00.123+00:00
TGW1.eyJhdCI6…<statement>.<signature>

เรียกใช้พยาน#

คุณจำเป็นต้องมีบอต Telegram (สร้างบอตด้วย @BotFather), ช่องที่บอตดังกล่าวเป็น ผู้ดูแลระบบ และที่อยู่ของผู้เก็บข้อมูลที่สามารถเข้าถึงได้จากผู้ให้คำพยาน — ผ่าน HTTPS นอก เครือข่ายส่วนตัว (ดูโปรไฟล์ HTTPS ในส่วนการติดตั้ง)

เปิด More tools → Extras → Independent witness → Configure ในแผงควบคุม ขั้นตอนสามขั้น ได้แก่ การเข้าถึงแบบอ่านอย่างเดียว ช่องของคุณ และช่วงเวลา จากนั้นจึงเริ่มทำงานของพยาน นโยบายการเผยแพร่ พร็อกซี HTTP/SOCKS5 (เลือกได้) และที่อยู่ Bot API ที่กำหนดเอง อยู่ในส่วน Advanced settings แบบฟอร์ม จะดาวน์โหลดไฟล์ witness.json พร้อมด้วยคีย์ผู้รวบรวม (collector key) ของพื้นที่ทำงานนี้ที่ถูกตรึงไว้ ดาวน์โหลดโทเค็นอ่านอย่างเดียวที่ สร้างขึ้นใหม่โดยใช้ตัวเลือก "บันทึกไฟล์การเข้าถึง เป็น" witness-token.txt ; วางไฟล์นี้และไฟล์ bot-token.txt ที่สร้างขึ้นบนโฮสต์ของพยานไว้ข้างไฟล์ JSON ดังกล่าว คอลเลกเตอร์จะไม่ได้รับโทเค็นบอต การดาวน์โหลดจะไม่เริ่มบริการหรือเผยแพร่ข้อความ ไม่มีพยานโครงการที่โฮสต์อยู่ ถูกลงทะเบียนโดยอัตโนมัติ

python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json
python -m tgwitness.witness fingerprint --config witness.json

คำสั่งแรกตรวจสอบไฟล์การตั้งค่าและไฟล์ลับโดยไม่มีการส่งคำขอผ่านเครือข่ายหรือการสร้าง กุญแจ เส้นทางใน JSON เป็นเส้นทางสัมพัทธ์กับไฟล์นั้น ส่วนเส้นทาง CLI/สภาพแวดล้อมเป็นเส้นทางสัมพัทธ์กับ ไดเรกทอรีทำงาน เก็บลายนิ้วมือของพยานไว้ภายนอกโฮสต์ของมัน ตัวบ่งชี้ การสำรวจครั้งสุดท้ายของตัวเก็บข้อมูลยืนยันเพียงการร้องขอเท่านั้น; การเผยแพร่จะถูกรายงานโดย Proof หรือตรวจสอบ ในบันทึกพยานและช่องสื่อสาร

หากแผงควบคุมอยู่เบื้องหลังอุโมงค์ SSH ให้เปิดเผยเฉพาะจุดสิ้นสุดของ witness ที่กำหนดขอบเขตไว้บน ชื่อโฮสต์ HTTPS แยกต่างหาก โดยใช้ตัวอย่าง Caddy นี้ พื้นที่ทำงานเริ่มต้นจะใช้ https://witness.example.org ส่วนพื้นที่ทำงานอื่น ๆ จะใช้ https://witness.example.org/profiles/ID โทเค็นยังคงจำเป็น; แผงควบคุมและ เส้นทาง API อื่น ๆ ของมันจะไม่ถูกส่งต่อโดยโฮสต์เสมือนนั้น

เลือก all สำหรับจุดตรวจสอบที่เผยแพร่เป็นประจำ ช่วงเวลา 5 นาที หมายถึงประมาณ 288 โพสต์ต่อพื้นที่ทำงานต่อวัน changes/problems ปล่อยให้จุดตรวจสอบบางส่วนไม่เผยแพร่โดยเจตนา MTProxy ใช้สำหรับไคลเอนต์ Telegram ของผู้รวบรวมข้อมูล การตรวจสอบ HTTP ของ Witness และ HTTPS Bot API ของ Telegram ใช้เส้นทางตรง/HTTP/SOCKS5 ของตนเอง (Bot API)

ข้างๆ ตัวเก็บข้อมูล (collector) โดยใช้ Docker (บนโฮสต์เดียวกัน — กระบวนการและกุญแจอิสระ แต่ ผู้ดำเนินการเดียวกัน): ใส่ค่าลงใน .env และเริ่มโปรไฟล์

TGWITNESS_WITNESS_TOKEN=tgww_...
TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC...
TGWITNESS_WITNESS_CHANNEL=@your_witness_channel
# another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/<workspace ID>

docker compose --profile witness up -d
docker compose logs witness     # prints the witness key fingerprint

หากใช้ภาพที่เผยแพร่แล้ว ให้ใช้docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d

บนเซิร์ฟเวอร์ของผู้อื่น (การเก็บรักษาแบบแยกต่างหาก): คัดลอกรีโพสิตอรีไปยังที่นั่น ตั้งค่า TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org พร้อมทั้งค่าสามค่าข้างต้น ใน .env แล้ว

docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d

หรือโดยไม่ต้องใช้ Docker:

python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel

เผยแพร่ไปยัง Discord#

ผู้เป็นพยานสามารถโพสต์ไปยังช่อง Discord แทน Telegram ได้ ใน Discord ให้เปิด Edit Channel → Integrations → Webhooks สร้าง webhook และคัดลอก URL ของมัน ใน แผงควบคุม ให้เลือก Discord webhook · ช่องของคุณ ในขั้นตอนที่ 2 บนเซิร์ฟเวอร์ของผู้เป็นพยาน ให้บันทึก URL ไว้เป็น discord-webhook.txt ข้างๆ witness.json; มันจะไม่ถึง collector เลย

python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --discord-webhook-file discord-webhook.txt

พยานมีผู้เผยแพร่เพียงหนึ่งราย: ช่อง Telegram หรือ webhook ของ Discord (ไม่ใช่ทั้งสองอย่าง) โพสต์ มีข้อความที่ลงนามเดียวกันและไม่สามารถ ping ผู้ใช้ใดได้ โพสต์ที่ยาวกว่า 2,000 ตัวอักษรของ Discord จะถูกแทนที่ด้วยบรรทัดสั้นๆ พร้อมแนบการตรวจสอบเต็มรูปแบบเป็น witness-check.txt ID ของแต่ละโพสต์จะถูกบันทึกเป็น witness.posted verify.py --channel อ่านเฉพาะช่อง Telegram เท่านั้น ดังนั้นสำหรับ Discord ให้เก็บสมุดบันทึกของพยานไว้: มันเก็บการตรวจสอบทุกครั้ง ไว้ โพสต์ของ Discord ไม่ให้เวลาภายนอกแก่ผู้ตรวจสอบ

ตัวเลือก#

ตัวเลือก สภาพแวดล้อม ค่าเริ่มต้น ความหมาย
--interval TGWITNESS_WITNESS_INTERVAL 10 ระยะเวลาระหว่างการตรวจสอบ: 1–1440 นาที
--timeout _TIMEOUT 30 เวลาที่ต้องรอตัวเก็บข้อมูลและ API ของ Bot: 5–600 วินาที
--post _POST all all: ทุกการตรวจสอบ; changes: ปัญหาใหม่หรือหัวข้อใหม่; problems: มีแต่ปัญหาและคำตอบที่ขาดหายไป
--title _TITLE TgWitness witness คำแรกๆ ของทุกโพสต์ในช่อง
--collector-fingerprint _COLLECTOR_FINGERPRINT – ให้ปักคีย์ผู้เก็บข้อมูลไว้แทนที่จะเชื่อถือคำตอบแรก
--proxy _PROXY direct socks5://host:port หรือ http://host:port
--bot-api _BOT_API https://api.telegram.org ที่อยู่ API ของบอท เช่น เซิร์ฟเวอร์ API ของบอทในท้องถิ่น
--data-dir _DATA witness-data กุญแจ Witness และบันทึก
--config _CONFIG – ไฟล์ JSON พร้อมตัวเลือกใดก็ตามข้างต้น

ที่อยู่ของตัวเก็บข้อมูล โทเค็น และช่องมาจาก --collector, --token หรือ --token-file, --bot-token หรือ --bot-token-file, --discord-webhook-file และ --channel, หรือ _COLLECTOR, _TOKEN, _TOKEN_FILE, _BOT_TOKEN, _BOT_TOKEN_FILE, _DISCORD_WEBHOOK_FILE และ _CHANNEL, ซึ่งช่วยไม่ให้ข้อมูลลับปรากฏในรายการกระบวนการ

ไฟล์การตั้งค่าใช้ชื่อตัวเลือกที่มีขีดล่าง (underscore) พร้อมด้วย texts ซึ่งใช้แทนคำ ในโพสต์ของช่อง:

{"collector": "https://your-collector.example.org", "token_file": "witness-token.txt",
 "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel",
 "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness",
 "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}}

texts: ok, key_changed, rollback, fork, invalid, no_response, collector, records, head, คำที่ใช้ไม่เคยส่งผลต่อการตรวจสอบ: verify.py ตรวจสอบโทเค็นที่ลงนามไว้ที่ท้ายของทุก โพสต์ ด้วย --post changes หรือ problems การตรวจสอบที่ยังไม่ถูกโพสต์ยังคงอยู่ใน วารสารพยาน และ verify.py จะแสดงรายการเหล่านั้นว่ายังไม่เคยถูกโพสต์; บันทึกเริ่มต้นจะระบุ นโยบาย ทุกการตรวจสอบยังคงปรากฏในวารสาร ดังนั้นการโพสต์น้อยลงหมายถึงจำนวนครั้งที่ Telegram กำหนดวันที่ น้อยลง ไม่ใช่การตรวจสอบน้อยลง

แม้ไม่มีช่อง (channel) TgWitness ก็ยังคงเก็บบันทึกไว้ได้ เก็บลายนิ้วมือของกุญแจ TgWitness (python -m tgwitness.witness fingerprint) ไว้ที่อื่น

หน้าหลักฐานสาธารณะสำหรับพื้นที่ทำงานหลายแห่ง#

python -m tgwitness.proof witnesses สามารถจัดการพื้นที่ทำงานได้สูงสุด 32 พื้นที่พร้อมกัน และให้บริการหน้าแบบอ่านอย่างเดียว ที่มีผลการตรวจสอบล่าสุดที่ลงนามแล้วของแต่ละพื้นที่ทำงาน ทุกพื้นที่ทำงานจะได้รับกุญแจ witness และ journal ของตัวเองในโฟลเดอร์ data พร้อมด้วยกุญแจ collector ที่ถูกตรึงไว้; การโพสต์ไปยังช่อง Telegram เป็นตัวเลือกที่แต่ละพื้นที่ทำงานสามารถกำหนดได้เอง เริ่มจาก proof.config.example:

Field ความหมาย
title ชื่อหน้า, 1–100 ตัวอักษร
data_dir กุญแจและบันทึกของ Witness ที่เกี่ยวข้องกับไฟล์; ค่าเริ่มต้น proof-data
interval, timeout จำนวนนาทีระหว่างการตรวจสอบ (1–1440, ค่าเริ่มต้น 5); จำนวนวินาทีที่ต้องรอ (5–600, ค่าเริ่มต้น 20)
workspaces[].id, label ชื่อย่อตัวพิมพ์เล็กสั้นๆ และชื่อที่แสดง
workspaces[].collector ที่อยู่ Collector; พื้นที่ทำงานอื่น ๆ จะลงท้ายด้วย /profiles/<workspace ID>
workspaces[].collector_fingerprint จำเป็น, แตกต่างกันสำหรับแต่ละพื้นที่ทำงาน
workspaces[].token_file ไฟล์ที่มีโทเค็นพยานแบบอ่านอย่างเดียวของพื้นที่ทำงานนั้น
workspaces[].channel, bot_token_file ตัวเลือกเพิ่มเติม: โพสต์การตรวจสอบแต่ละครั้งไปยังช่อง
workspaces[].proxy, bot_api ที่อยู่ API ของ Bot และเส้นทาง (Optional route)
python -m tgwitness.proof --config proof.json --check-config
python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790

คำสั่งแรกจะตรวจสอบความถูกต้องของไฟล์และไฟล์โทเค็นโดยไม่เปิดการเชื่อมต่อ หน้านี้รับเฉพาะคำขอ GET และ HEAD:

  • / แสดงทุกพื้นที่ทำงาน; พื้นที่ทำงานที่ยังไม่ได้รับการตรวจสอบเป็นเวลา 2.5 ช่วงจะได้รับการทำเครื่องหมายว่าล้าสมัย
  • /api/proof ให้ผลลัพธ์เหมือนกับ JSON.
  • /api/proof/<id> ดาวน์โหลดคำแถลงที่ลงนามล่าสุด (tgwitness-public-proof-v1): หมายเลขบันทึกพยานและแฮช, สถานะ, กุญแจผู้เก็บข้อมูลที่ตรึงไว้, จุดตรวจสอบ, ตัวนับการเก็บข้อมูล และว่าโพสต์ในช่องสำเร็จหรือไม่, ลงนามด้วยกุญแจพยานของพื้นที่ทำงานนั้น
  • /healthz แสดงรหัสข้อผิดพลาด 503 เมื่อตัวติดตามของพื้นที่ทำงานหยุดทำงาน

ตั้งชื่อโฮสต์เฉพาะสำหรับหน้าดังกล่าว เช่น Caddyfile.proof.example เพื่อตรวจสอบ ให้ส่งออก หนังสือบันทึกพยานของพื้นที่ทำงานด้วย python -m tgwitness.witness export --data-dir proof-data/<id> --out witness.zip และใช้มัน ตามคำอธิบายด้านล่าง

ตรวจสอบ#

สำหรับผู้ใช้ TgWitness สามารถส่งออกบันทึกได้ดังนี้:

python -m tgwitness.witness export --out witness.zip
# Docker (add -f deploy/compose/compose.witness.yaml on a witness server):
docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip
docker compose cp witness:/witness/witness.zip .

จากนั้น ที่ใดก็ได้ ด้วยไฟล์ ZIP ที่ลงนามโดยผู้รวบรวม (collector) และที่อยู่ของช่องสาธารณะ:

python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel

--channel ยังรับไฟล์ส่งออกจาก Telegram Desktop (ส่งออกประวัติการสนทนา → JSON จะให้ result.json) หรือสำเนาที่บันทึกไว้ของหน้าเว็บ; สิ่งเหล่านี้ตรวจสอบเนื้อหาของโพสต์แต่ไม่ให้ เวลาภายนอก

verify.py ตรวจสอบบันทึกของพยาน (โซ่และลายเซ็น) จากนั้นตรวจสอบว่าทุกหัวบันทึกที่ พยานเห็นเป็นส่วนหนึ่งของบันทึกที่ส่งออก: บันทึกที่ตำแหน่งนับนั้นต้องมี แฮชที่ตรงกันพอดี หัวบันทึกที่ไม่ตรงกันจะล้มเหลวในการตรวจสอบ — บันทึกถูกเปลี่ยนแปลงหลังจาก ผู้เป็นพยานได้เห็นมันแล้ว นอกจากนี้ยังรายงานหัวบันทึกที่เห็นหลังการส่งออก ความผิดปกติที่ผู้เป็นพยาน บันทึกไว้ คำตอบที่ล้มเหลว ช่วงเวลามีจุดตรวจสอบที่ตรงกันอยู่ใน การส่งออกนี้ ("Witnessed from X to Y") และช่องว่าง จุดตรวจสอบที่ตามมาไม่ขยายช่วงเวลานั้น ผลลัพธ์รวมถึงหมายเลขบันทึกที่ตรงกันล่าสุดและจำนวนบันทึกที่ตามมา ที่ไม่มีจุดตรวจสอบที่ตรงกัน มีเพียงคำตอบที่ลงนามด้วยกุญแจของไฟล์ส่งออกเองเท่านั้นที่นับ: ไฟล์ส่งออกที่ลงนาม ด้วยกุญแจที่ผู้เป็นพยานไม่เคยเห็นจะถูกรายงานว่าไม่ได้รับการเป็นพยาน และหากไม่มี --fingerprint ผู้ ลงนามจะยังคงไม่ถูกตรึงไว้ ด้วย --channel ทุกโพสต์ที่ลงนามต้องตรงกับบันทึกในสมุดบันทึกของผู้เป็นพยาน บันทึกต่อบันทึก: โพสต์ที่ถูกเปลี่ยนแปลงจะล้มเหลวในการตรวจสอบ โพสต์ที่ขาดหายไปจะถูกรายการไว้ การตรงกันของ โทเค็นจะยืนยันความถูกต้องของเนื้อหา; วันที่อยู่นอกโทเค็นที่ลงนาม

ด้วยที่อยู่แบบสด https://t.me/s/… หรือ https://telegram.me/s/… ผู้ตรวจสอบจะอ่าน วันที่ของแต่ละโพสต์จากหน้าเว็บ ณ เวลาตรวจสอบ Telegram กำหนดวันที่นั้น; วันที่ของ โพสต์ที่แก้ไขแล้วไม่ถูกใช้ วันที่ที่เก่าที่สุดของโพสต์ที่ส่วนหัวการส่งออกคือเวลา ภายนอกสำหรับบันทึกสุดท้าย ซึ่งตรงกับเงื่อนไขขั้นต่ำของหลักฐาน วันที่ จากแหล่งอื่นใด เช่น result.json ที่ถูกส่งมา หน้าเว็บที่บันทึกไว้ หรือที่อยู่เว็บ อื่น ๆ เป็นข้อมูลเมตาดาต้าที่ส่งมา ไม่ใช่เวลาอิสระ; ผลลัพธ์จะระบุแหล่งที่มาของวันที่ โพสต์ (post_date_verification)

จำเป็นต้องมีขอบเขตการส่งออกที่มีผู้เป็นพยาน#

สำหรับการส่งต่อข้อมูลที่ต้องรวมถึงบันทึกสุดท้ายที่มีพยานรับรอง ให้เพิ่ม --require-witness:

python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness

สิ่งนี้ต้องการลายนิ้วมือของผู้เป็นพยานที่เก็บรักษาอย่างอิสระ, กุญแจอื่นนอกเหนือจาก กุญแจผู้เก็บรวบรวม, และจุดตรวจสอบที่ตรงกับจุดสิ้นสุดที่แม่นยำของการส่งออกนี้ จุดตรวจสอบ ที่ครอบคลุมเพียงส่วนนำหน้าก่อนหน้านี้เท่านั้นไม่เพียงพอ ให้หยุดการเก็บรวบรวมชั่วคราว, ให้ผู้เป็นพยาน สังเกตสถานะสุดท้าย, และส่งออกก่อนที่จะมีการเขียนลงในบันทึกเพิ่มเติม; หากบันทึกมีการเปลี่ยนแปลง ให้เก็บรักษาจุดตรวจสอบอีกจุดหนึ่งและ ส่งออกสถานะนั้น จุดตรวจสอบที่สร้างขึ้นภายหลังเพียงอย่างเดียวไม่สามารถตรวจสอบค่าแฮชสุดท้ายของการส่งออกที่สั้นกว่าได้ เมื่อระบุ --channel ด้วย โพสต์ที่อ้างสิทธิ์แต่ขาดหายไปหรือชุดการจับคู่ที่ว่างเปล่าจะทำให้การตรวจสอบ อย่างเคร่งครัดนี้ล้มเหลว หากไม่ใช้แฟล็กนี้ การตรวจสอบความสมบูรณ์แบบปกติจะยังคงรายงาน บันทึกที่ไม่มีพยาน โดยไม่ปฏิเสธอาร์ไคฟ์ที่สมบูรณ์ในส่วนอื่น

เก็บสมุดบันทึกพยานและกุญแจที่ตรึงไว้แยกกัน การตรวจสอบออนไลน์จะยืนยันความต่อเนื่อง ระหว่างจุดตรวจสอบ; การตรวจสอบออฟไลน์จะเปรียบเทียบทุกจุดตรวจสอบที่เก็บไว้กับ ไฟล์ที่ส่งออก พยานรุ่นเก่าที่ไม่มีหลักฐานความต่อเนื่องจะเก็บการเปรียบเทียบออฟไลน์ไว้และ ถูกรายงานโดยไม่ผ่านการตรวจสอบความต่อเนื่องออนไลน์ รายงานจะแสดงช่วงเวลาที่พยานหยุดทำงานและ การเผยแพร่ที่ล้มเหลวตามช่วงเวลา

ตราประทับรายวันและปฏิทินเวลาประทับที่ไม่สามารถใช้งานได้#

ผู้เป็นพยานจะปิดผนึกขอบเขตบันทึกของวัน UTC ก่อนหน้า และส่งค่าแฮชของ ผนึกที่ลงนามนั้นไปยัง OpenTimestamps การส่งข้อมูลปฏิทินถือเป็นหลักฐานที่รอการยืนยัน; เพียงคำมั่นสัญญา Bitcoin ที่ได้รับการตรวจสอบอย่างอิสระเท่านั้นที่จะได้รับการยืนยันในตัวตรวจสอบ

หากปฏิทินทั้งหมดล้มเหลว ตราประทับที่ลงนามแล้วและความพยายามที่ไม่สำเร็จจะยังคงอยู่ใน บันทึกประจำวัน การตรวจสอบบำรุงรักษาทุกชั่วโมงจะลองบันทึกเดิมอีกครั้ง รวมถึง หลังจากรีสตาร์ทหรือเปลี่ยนวันที่ มันจะสแกนตราประทับสูงสุด32 ตรา ส่งข้อมูลที่ขาดหายไปสูงสุด สองรายการ และใช้เวลาสูงสุด60 วินาทีในการลองใหม่ต่อรอบ คอร์เซอร์ แบบคงที่จะหมุนผ่านตราประทับที่เก่ากว่า ข้อมูลที่เก็บไว้จะปฏิบัติตาม เส้นทางการอัปเกรดหลักฐานที่มีอยู่

การลองใหม่จะไม่เขียนทับตราประทับใหม่ ไม่เปลี่ยนวันที่เดิม หรืออ้างว่า ปฏิทินได้รับมันมาก่อน การยืนยัน Bitcoin ที่เกิดขึ้นภายหลังยังคงเป็นการยืนยันจากภายนอก ที่เกิดขึ้นภายหลัง หลักฐานที่ขาดหายไปยังคงเป็น none; หลักฐานที่รอการยืนยันยังคงเป็น pending จนกว่า ผู้ตรวจสอบจะตรวจสอบมันอย่างอิสระ