TgWitness / دستاویزات

کیا جانچا گیا ہے ←

حوالہ / شواہد

Telegram · آزاد شاہد

اپنی مخصوص کلید اور بوٹ کے ساتھ ایک ویٹنس چلائیں، دستخط شدہ چیک پوائنٹس کو ایک چینل پر شائع کریں اور ان کے خلاف ایکسپورٹس کی تصدیق کریں۔

ٹی جی وٹنس / دستاویزات · شواہد اور تصدیق

شواہد اور تصدیق

ایکسپورٹ اور تصدیق کریں · اعلیٰ یقین دہانی · پینل گائیڈ

گواہ دستخط شدہ چیک پوائنٹس کو کلیکٹر سے الگ طور پر محفوظ رکھتا ہے۔ یہ کلیکٹر کے دستخط اور جرنل کی تسلسل کی تصدیق کرتا ہے، نتیجے پر اپنی کلید سے دستخط کرتا ہے، اور اسے ٹیلیگرام چینل پر شائع کرتا ہے۔ اسے ایک الگ سرور پر چلائیں جسے کلیکٹر کے گواہ اینڈ پوائنٹ تک صرف پڑھنے کی اجازت حاصل ہو۔

تکنیکی نتیجے میں محفوظ شدہ جرنل پری فکسز، چیلنج کے جوابات، دستخط کی جانچ، Merkle شمولیت/مطابقت کی جانچ اور دستخط شدہ تسلسل کے نتائج شامل ہیں۔ کسی دوسرے نگہبان کے چلائے گئے گواہ کے لیے، نگہبان اور کلید کنٹرول ریکارڈ کو اس کے فنگر پرنٹ کے ساتھ محفوظ رکھیں۔ الگ کلیدیں اور الگ تحویل سیٹ اپ کے مختلف حصوں کو بیان کرتی ہیں۔ ویریفائر بتاتا ہے کہ دوسری کلید نے جرنل ہیڈ کو کس ریکارڈ تک محفوظ رکھا؛ نگہبان کا کلید کنٹرول ریکارڈ دکھاتا ہے کہ وہ کلید کس کے پاس ہے۔ گواہ کا جرنل ایک معاون جانچ ہے؛ ثبوت کے لیے کم از کم تیسرے فریق کا وقت ہے۔ چینل پوسٹس بیرونی وقت شامل کرتی ہیں: ٹیلیگرام ہر عوامی پوسٹ پر تاریخ لگاتا ہے، اور ویریفائر یہ تاریخیں خود پڑھتا ہے۔

دھارے کا خاکہجمع کنندہ → گواہ (مصنوعی چیک پوائنٹ: ریکارڈز کی تعداد + ہیڈ ہیش); گواہ → گواہ جرنل، اپنی کلید; گواہ → ٹیلیگرام چینل (اپنے بوٹ کے ذریعے دستخط شدہ پوسٹ); شواہد کا زپ → verify.py; گواہ جرنل، اپنی کلید → verify.py; ٹیلیگرام چینل → verify.py (t.me/s صفحہ براہِ راست پڑھیں، یا ڈیسک ٹاپ پر برآمد کریں)جمع کنندہگواہگواہ جرنل، اپنی کلیدٹیلیگرام چینلشواہد کا زپverify.pyمصنوعی چیک پوائنٹ: ریکارڈزکی تعداد + ہیڈ ہیشاپنے بوٹ کے ذریعے دستخط شدہپوسٹt.me/s صفحہ براہِ راستپڑھیں، یا ڈیسک ٹاپ پر برآمدکریں
ڈایاگرام بطور متن
  1. جمع کنندہ → گواہ (مصنوعی چیک پوائنٹ: ریکارڈز کی تعداد + ہیڈ ہیش)
  2. گواہ → گواہ جرنل، اپنی کلید
  3. گواہ → ٹیلیگرام چینل (اپنے بوٹ کے ذریعے دستخط شدہ پوسٹ)
  4. شواہد کا زپ → verify.py
  5. گواہ جرنل، اپنی کلید → verify.py
  6. ٹیلیگرام چینل → verify.py (t.me/s صفحہ براہِ راست پڑھیں، یا ڈیسک ٹاپ پر برآمد کریں)
اس صفحے پر

گواہ کے پاس کیا محفوظ رہتا ہے#

گواہ کے پاس ہے گواہ نے کبھی نہیں
ایک ورک اسپیس کے لیے صرف پڑھنے کے قابل وِٹنس ٹوکن جمع کرنے والے کا ٹیلیگرام سیشن یا API کی شناختی تفصیلات
اپنی Ed25519 کلید اور جرنل جمع کنندہ کا خزانہ، دستخطی کلید یا پینل ٹوکن
اس کا اپنا ٹیلیگرام بوٹ ٹوکن پیغام کا مواد: سر میں ریکارڈز کی تعداد اور ہیش شامل ہے

ٹوکن مزید ٹولز → اضافی → آزاد گواہ میں بنایا جاتا ہے، ایک بار دکھایا جاتا ہے اور صرف ایک SHA-256 کے طور پر محفوظ کیا جاتا ہے۔ یہ بالکل ایک ہی اینڈ پوائنٹ، GET /api/witness/head، کھولتا ہے، جو تازہ دستخط شدہ چیک پوائنٹ کے ساتھ دستخط شدہ مواد سے پاک کلیکشن کاؤنٹرز اور آپریشنل ہیلتھ واپس کرتا ہے۔ یہ پینل نہیں کھول سکتا، پیغام کا مواد نہیں پڑھ سکتا یا ترتیبات تبدیل نہیں کر سکتا، اور وہاں پینل ٹوکن قبول نہیں کیا جاتا۔ ایک ٹوکن کو اسی صفحے پر منسوخ کریں۔ کلیکٹر ریکارڈ کرتا ہے کہ ایک نئی ویٹنس کی چیک کرنا کب شروع کرتی ہے (witness.seen) اور ہر ٹوکن کے لیے آخری چیک دکھاتا ہے؛ ایک ویٹنس جو 2.5 وقفوں کے اندر چیک نہیں کرتی اسے مقررہ وقت سے تجاوز شدہ (overdue) قرار دیا جاتا ہے۔

نئے گواہ ہر پول پر ایک بے ترتیب چیلنج بھیجتے ہیں؛ کیپچر بیان اسے کلیکٹر کے دستخط کے نیچے دہراتا ہے۔ کاؤنٹر بالکل درست چیک پوائنٹ سے منسلک ہوتے ہیں اور دستخط شدہ گواہ پوسٹس میں شامل کیے جاتے ہیں۔ لیگیسی ہیڈز خود مختار گواہ کے ذریعے قبول کیے جاتے رہتے ہیں۔ صرف جرنل کی ترقی کو کبھی نئے پیغام کے طور پر نہیں گنا جاتا۔

یہ کیا چیک اور ریکارڈ کرتا ہے#

ہر وقفے (ڈیفالٹ کے طور پر 10 منٹ) پر گواہ:

  1. خود ہی ہیڈ کو حاصل کرتا ہے (جمع کرنے والا اسے دھکیل یا چھوڑ نہیں سکتا)؛
  2. جمع کرنے والے کے دستخط، پن کی ہوئی جمع کرنے والی کلید (--collector-fingerprint، یا پہلی دیکھے جانے والی کلید)، ایک غیر گھٹنے والی گنتی اور ایک غیر تبدیل شدہ ہیڈ کو ایک غیر تبدیل شدہ گنتی پر تصدیق کرتا ہے۔ مرکل شمولیت اور مطابقت کے ثبوت اس بات کی تصدیق کرتے ہیں کہ ایک بڑھتا ہوا جرنل محفوظ شدہ چیک پوائنٹ کو بڑھاتا ہے۔ ایک بار جب تسلسل کے ثبوت استعمال ہو جائیں، تو انہیں ہٹانے کی درخواست مسترد کر دی جاتی ہے؛
  3. اپنے جرنل میں ایک دستخط شدہ ریکارڈ منسلک کرتا ہے: witness.anchor جس کی حیثیت ok، key_changed، rollback (پہلے سے کم ریکارڈز)، fork (لمبائی ایک جیسی، مختلف ہیڈر) یا invalid (جواب توثیق میں ناکام رہا)، یا witness.no_response جب جمع کرنے والے نے جواب نہیں دیا؛
  4. نتیجہ چینل پر پوسٹ کیا جاتا ہے، دستخط شدہ، بشمول "کوئی جواب نہیں" جب تک گواہ چل رہا ہو اور Bot API تک پہنچ سکے۔ پوسٹ آئی ڈی ریکارڈ کی جاتی ہے (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>

ویٹنس چلائیں#

آپ کو ایک ٹیلیگرام بوٹ (@BotFather کے ذریعے ایک بنائیں)، ایک چینل جہاں وہ بوٹ منتظم ہو، اور گواہ کی جانب سے قابلِ رسائی کلیکٹر کا پتہ — نجی نیٹ ورک کے باہر HTTPS کے ذریعے (تینفذ میں HTTPS پروفائل دیکھیں)۔

مزید ٹولز → اضافی → آزاد گواہ → پینل میں تشکیل دیں۔ تین مراحل میں صرف پڑھنے کی اجازت، آپ کے چینل اور وقفے کا احاطہ کیا گیا ہے، پھر گواہ کو شروع کرنا۔ اشاعت کی پالیسی، اختیاری HTTP/SOCKS5 پروکسی اور کسٹم بوٹ API پتہ ایڈوانسڈ سیٹنگز کے تحت ہیں۔ فارم اس ورک اسپیس کی کلیکٹر کلید کو پن کرکے witness.json ڈاؤن لوڈ کرتا ہے۔ نیا بنایا گیا ریڈ-اوْنلی ٹوکن، 'Save access file as' کے تحت 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 ٹنل کے پیچھے رہے، تو صرف اسکوپڈ وِٹنس اینڈ پوائنٹ کو ایک الگ HTTPS ہوسٹ نیم پر اس Caddy مثال کے ساتھ ظاہر کریں۔ ڈیفالٹ ورک اسپیس پھر https://witness.example.org استعمال کرتا ہے، دیگر ورک اسپیس https://witness.example.org/profiles/ID استعمال کرتے ہیں۔ ٹوکنز کی ضرورت اب بھی ہوتی ہے؛ پینل اور اس کے دیگر API روٹس اس ورچوئل ہوسٹ کے ذریعے فارورڈ نہیں کیے جاتے۔

all کو باقاعدگی سے شائع ہونے والے چیک پوائنٹس کے لیے منتخب کریں۔ پانچ منٹ کے وقفے کا مطلب ہے کہ روزانہ فی ورک اسپیس تقریباً 288 پوسٹس۔ changes/problems جان بوجھ کر کچھ چیکس غیر شائع شدہ چھوڑ دیتے ہیں۔ MTProxy کلیکٹر کے ٹیلیگرام کلائنٹ کے لیے ہے۔ Witness HTTP پولنگ اور ٹیلیگرام کا HTTPS Bot API اپنا براہِ راست/HTTP/SOCKS5 راستہ (Bot API) استعمال کرتے ہیں۔

کلیکٹر کے ساتھ، ڈوکر کے ذریعے (ایک ہی ہوسٹ — آزاد عمل اور کلید، لیکن ایک ہی آپریٹر): .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

یا ڈاکر کے بغیر:

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 پر شائع کریں#

ایک گواہ ٹیلیگرام کے بجائے ڈسکارڈ چینل پر پوسٹ کر سکتا ہے۔ ڈسکارڈ میں، Edit Channel → Integrations → Webhooks کھولیں، ایک ویب ہوک بنائیں اور اس کا URL کاپی کریں۔ پینل میں، مرحلے 2 میں Discord ویب ہوک · اپنا چینل منتخب کریں۔ گواہ ہوسٹ پر، URL کو بطور محفوظ کریں discord-webhook.txt کے ساتھ witness.json؛ یہ کبھی کلیکٹر تک نہیں پہنچتا۔

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

ایک گواہ کا ایک ہی پبلشر ہوتا ہے: ایک ٹیلیگرام چینل یا ایک ڈسکارڈ ویب ہُک، دونوں نہیں۔ پوسٹس ایک ہی دستخط شدہ بیان لے کر چلتی ہیں اور کسی کو بھی پنگ نہیں کر سکتیں۔ ڈسکارڈ کے 2,000 حروف سے طویل پوسٹ کو ایک مختصر لائن سے تبدیل کر دیا جاتا ہے جس کے ساتھ مکمل چیک witness-check.txt کے طور پر منسلک ہوتا ہے۔ ہر پوسٹ آئی ڈی کو witness.posted کے طور پر ریکارڈ کیا جاتا ہے۔ verify.py --channel صرف ٹیلیگرام چینلز کو پڑھتا ہے، لہٰذا ڈسکارڈ کے لیے گواہ جرنل کو برقرار رکھیں: اس میں ہر چیک موجود ہوتا ہے۔ ڈسکارڈ پوسٹس ویریفائر کو کوئی بیرونی وقت نہیں دیتی ہیں۔

اختیارات#

اختیار ماحول ڈیفالٹ معنی
--interval TGWITNESS_WITNESS_INTERVAL 10 چیکس کے درمیان منٹ، 1–1440
--timeout _TIMEOUT 30 کلیکٹر اور بوٹ API کے لیے انتظار کے سیکنڈز، 5–600
--post _POST all all: ہر چیک؛ changes: ایک نیا سربراہ یا ایک مسئلہ؛ problems: صرف مسائل اور غائب جوابات
--title _TITLE TgWitness witness ہر چینل پوسٹ کے پہلے الفاظ
--collector-fingerprint _COLLECTOR_FINGERPRINT – پہلے جواب پر بھروسہ کرنے کے بجائے کلیکٹر کلید کو پن کریں۔
--proxy _PROXY براہِ راست socks5://host:port یا http://host:port
--bot-api _BOT_API https://api.telegram.org بوٹ API کا پتہ، مثلاً ایک مقامی بوٹ API سرور
--data-dir _DATA witness-data ویٹنس کی اور جرنل
--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، جو عمل کی فہرست سے رازوں کو پوشیدہ رکھتا ہے۔

ایک کنفیگ فائل آپشن کے ناموں کے لیے انڈر اسکورز استعمال کرتی ہے، اور 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 انہیں کبھی پوسٹ نہ کیے جانے کے طور پر درج کرتا ہے؛ آغاز کا ریکارڈ پالیسی کا نام بتاتا ہے۔ ہر چیک اب بھی جرنل میں ظاہر ہوتا ہے، لہٰذا کم پوسٹس کا مطلب ہے کہ ٹیلیگرام کی جانب سے تاریخ دینے کے کم مواقع، نہ کہ کم چیکس۔

چینل کے بغیر بھی ویٹنس اپنا جرنل برقرار رکھتا ہے۔ ویٹنس کی کلید کے فنگر پرنٹ (python -m tgwitness.witness fingerprint) کو کہیں اور محفوظ رکھیں۔

کئی ورک اسپیسز کے لیے عوامی ثبوت صفحہ#

python -m tgwitness.proof ایک ہی وقت میں 32 ورک اسپیسز کو وِٹنس کرتا ہے اور ہر ایک کے تازہ ترین دستخط شدہ چیک کے ساتھ ایک ریڈ-اونلی صفحہ فراہم کرتا ہے۔ ہر ورک اسپیس کو ڈیٹا فولڈر کے تحت اپنی وِٹنس کی اور جرنل اور ایک پن کیا ہوا کلیکٹر کی ملتا ہے؛ ٹیلیگرام چینل پر پوسٹ کرنا ہر ورک اسپیس کے لیے اختیاری ہے۔ proof.config.example سے شروع کریں:

میدان معنی
title صفحے کا عنوان، 1–100 حروف
data_dir گواہی کی چابیاں اور جرنلز، فائل کے حوالے سے؛ ڈیفالٹ proof-data
interval, timeout چیکس کے درمیان منٹ (1–1440، ڈیفالٹ 5)؛ انتظار کے سیکنڈ (5–600، ڈیفالٹ 20)
workspaces[].id, label چھوٹا چھوٹے حروف پر مشتمل عرفی نام اور دکھایا گیا نام
workspaces[].collector کلیکٹر کا پتہ؛ دیگر ورک اسپیسز ختم ہوتے ہیں /profiles/<workspace ID>
workspaces[].collector_fingerprint ضروری، ہر ورک اسپیس کے لیے مختلف
workspaces[].token_file اس ورک اسپیس کے ریڈ-اونلی وِٹنس ٹوکن کے ساتھ فائل
workspaces[].channel, bot_token_file اختیاری، ایک ساتھ: ہر چیک کو ایک چینل پر پوسٹ کریں
workspaces[].proxy, bot_api اختیاری راستہ اور بوٹ API پتہ
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 وقفوں کے لیے چیک نہ کیا گیا ہو تو اسے پرانا (stale) نشان زد کیا جاتا ہے۔
  • /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 اور اسے نیچے بیان کردہ طریقے کے مطابق استعمال کریں۔

تصدیق کریں#

گواہ کی جانب سے، اپنا جریدہ برآمد کریں:

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 اور عوامی چینل کے پتے کے ساتھ:

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 ٹیلیگرام ڈیسک ٹاپ ایکسپورٹ (Export chat history → JSON سے result.json) یا صفحے کی محفوظ شدہ کاپی بھی قبول کرتا ہے؛ یہ پوسٹ کے مواد کی جانچ کرتے ہیں لیکن کوئی بیرونی وقت فراہم نہیں کرتے۔

verify.py گواہ کے جرنل (چین اور دستخط) کی جانچ کرتا ہے، پھر یہ کہ گواہ نے جو بھی ہیڈ دیکھا وہ برآمد شدہ جرنل کا حصہ ہے: اس گنتی پر ریکارڈ میں بالکل وہی ہیش ہونا چاہیے۔ جو ہیڈ میل نہیں کھاتا وہ توثیق میں ناکام ہو جاتا ہے — جرنل میں تبدیلی اس کے بعد کی گئی جب گواہ نے اسے دیکھا تھا۔ یہ ان ہیڈز کی بھی رپورٹ کرتا ہے جو ایکسپورٹ کے بعد دیکھے گئے، وہ بے ضابطگیاں جو گواہ نے ریکارڈ کیں، وہ جوابات جو ناکام ہوئے، وہ دورانیے جن کے میل کھانے والے چیک پوائنٹس اس ایکسپورٹ میں موجود ہیں ("X سے Y تک گواہی دی گئی") اور خلا۔ بعد کے چیک پوائنٹس ان دورانیوں کو بڑھاتے نہیں ہیں۔ نتیجے میں آخری میل کھانے والے ریکارڈ نمبر اور بغیر میل کھانے والے چیک پوائنٹ کے پیچھے آنے والے ریکارڈز کی تعداد شامل ہوتی ہے۔ صرف وہی جوابات شمار کیے جاتے ہیں جن پر خود ایکسپورٹ کی کلید نے دستخط کیے ہوں: ایک ایسا ایکسپورٹ جس پر کسی ایسی کلید سے دستخط کیے گئے ہوں جو گواہ نے کبھی نہیں دیکھی، اسے غیر گواہی شدہ رپورٹ کیا جاتا ہے، اور --fingerprint کے بغیر اس کے دستخط کنندہ کی پننگ مکمل نہیں ہوتی۔ --channel کے ساتھ ہر دستخط شدہ پوسٹ کو گواہ کے جرنل سے ریکارڈ بہ ریکارڈ مطابقت رکھنی چاہیے: تبدیل شدہ پوسٹس توثیق میں ناکام ہو جاتی ہیں، اور غائب پوسٹس کی فہرست بنائی جاتی ہے۔ ٹوکن کے ساتھ مطابقت مواد کی تصدیق کرتی ہے؛ تاریخ دستخط شدہ ٹوکن سے باہر ہوتی ہے۔

براہ راست https://t.me/s/… یا https://telegram.me/s/… پتے کے ساتھ، تصدیق کنندہ ہر پوسٹ کی تاریخ کو تصدیق کے وقت صفحے سے پڑھتا ہے۔ ٹیلیگرام وہ تاریخ مقرر کرتا ہے؛ ترمیم شدہ پوسٹس کی تاریخیں استعمال نہیں کی جاتی ہیں۔ ایکسپورٹ ہیڈ پر کسی پوسٹ کی ایسی ابتدائی ترین تاریخ بیرونی وقت ہوتی ہے جو آخری ریکارڈ کے لیے کم از کم ثبوت کی اس شرط کو پورا کرتی ہے۔ کسی بھی دوسرے ذریعہ سے حاصل ہونے والی تاریخیں، جیسے فراہم کردہ 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 کو جمع کرواتا ہے۔ ایک کیلنڈر جمع کرایا گیا ثبوت زیر التوا ہے؛ صرف آزادانہ طور پر تصدیق شدہ بٹ کوائن کمٹمنٹس کو ویریفائر میں تصدیق ملتی ہے۔

اگر تمام کیلنڈرز ناکام ہو جائیں، تو دستخط شدہ مہر اور ناکام کوشش جرنل میں رہتی ہے۔ ہر گھنٹے کی مینٹیننس پاس اس اصل ریکارڈ کو دوبارہ کوشش کرتا ہے، بشمول ری اسٹارٹ یا تاریخ کی تبدیلی کے بعد بھی۔ یہ زیادہ سے زیادہ 32 مہریں اسکین کرتا ہے، زیادہ سے زیادہ دو غائب جمع شدہ دستاویزات جمع کرواتا ہے اور ہر پاس میں دوبارہ کوششوں پر زیادہ سے زیادہ 60 سیکنڈز صرف کرتا ہے۔ ایک مستقل کرسر پرانی مہروں میں گردش کرتا رہتا ہے۔ محفوظ شدہ جمع شدہ دستاویزات موجودہ ثبوت اپ گریڈ کے راستے کی پیروی کرتی ہیں۔

دوبارہ کوشش سیل کو دوبارہ نہیں لکھتی، اس کی اصل تاریخ کو تبدیل نہیں کرتی یا یہ دعویٰ نہیں کرتی کہ کیلنڈر نے اسے پہلے موصول کیا تھا۔ بعد کی بٹ کوائن وابستگی ایک بعد کی بیرونی تصدیق ہی رہتی ہے۔ غائب ثبوت none ہی رہتے ہیں؛ زیر التوا ثبوت pending ہی رہتے ہیں جب تک کہ مصدق انہیں آزادانہ طور پر چیک نہ کر لے۔