TgWitness / ডকুমেন্টেশন

কি পরীক্ষা করা হয়েছে →

তথ্যসূত্র / প্রমাণ

Telegram · স্বতন্ত্র সাক্ষী

নিজের কী এবং বট সহ একটি উইটনেস চালান, চ্যানেলে স্বাক্ষরিত চেকপয়েন্ট প্রকাশ করুন এবং এর বিপরীতে এক্সপোর্টগুলো যাচাই করুন।

টিজিউইটনেস / ডকুমেন্টেশন · প্রমাণ এবং যাচাইকরণ

প্রমাণ ও যাচাইকরণ

রপ্তানি এবং যাচাই করুন · উচ্চ নিশ্চয়তা · প্যানেল গাইড

একজন সাক্ষী স্বাক্ষরিত চেকপয়েন্টগুলো সংগ্রহকারীর থেকে আলাদাভাবে সংরক্ষণ করে। এটি সংগ্রহকারীর স্বাক্ষর এবং জার্নাল ধারাবাহিকতা যাচাই করে, ফলাফলটি নিজের কী দিয়ে স্বাক্ষর করে এবং একটি টেলিগ্রাম চ্যানেলে প্রকাশ করে। এটিকে একটি পৃথক সার্ভারে চালান, যেখানে সংগ্রহকারীর সাক্ষী এন্ডপয়েন্টে শুধুমাত্র পড়ার (read-only) অ্যাক্সেস রয়েছে।

প্রযুক্তিগত ফলাফলে সংরক্ষিত জার্নাল প্রিফিক্স, চ্যালেঞ্জের উত্তর, স্বাক্ষর যাচাই, Merkle অন্তর্ভুক্তি/সামঞ্জস্য যাচাই এবং স্বাক্ষরিত ধারাবাহিকতার ফলাফল অন্তর্ভুক্ত। অন্য রক্ষক পরিচালিত সাক্ষীর ক্ষেত্রে, রক্ষকের তথ্য এবং কী-নিয়ন্ত্রণ রেকর্ড তার ফিঙ্গারপ্রিন্টসহ সংরক্ষণ করুন। আলাদা কী এবং আলাদা হেফাজত সেটআপের ভিন্ন ভিন্ন অংশ বর্ণনা করে। ভেরিফায়ার জানায় যে দ্বিতীয় একটি কী জার্নালের হেড কোন রেকর্ড পর্যন্ত সংরক্ষণ করেছে; রক্ষকের কী-নিয়ন্ত্রণ রেকর্ড দেখায় সেই কী কার কাছে আছে। সাক্ষীর জার্নাল একটি সহায়ক যাচাই; প্রমাণের জন্য ন্যূনতম শর্ত হলো তৃতীয় পক্ষের সময়। চ্যানেলের পোস্টগুলো বাহ্যিক সময় যোগ করে: Telegram প্রতিটি পাবলিক পোস্টে তারিখ দেয়, এবং ভেরিফায়ার নিজেই সেই তারিখগুলো পড়ে।

প্রবাহ চিত্রসংগ্রাহক → সাক্ষী (স্বাক্ষরিত চেকপয়েন্ট: রেকর্ড গণনা + হেড হ্যাশ); সাক্ষী → সাক্ষী জার্নাল, নিজস্ব কী; সাক্ষী → টেলিগ্রাম চ্যানেল (নিজের বটের মাধ্যমে স্বাক্ষরিত পোস্ট); প্রমাণ ZIP → verify.py; সাক্ষী জার্নাল, নিজস্ব কী → verify.py; টেলিগ্রাম চ্যানেল → verify.py (t.me/s পৃষ্ঠা সরাসরি পড়ুন, অথবা ডেস্কটপ এক্সপোর্ট)সংগ্রাহকসাক্ষীসাক্ষী জার্নাল, নিজস্ব কীটেলিগ্রাম চ্যানেলপ্রমাণ ZIPverify.pyস্বাক্ষরিত চেকপয়েন্ট:রেকর্ড গণনা + হেড হ্যাশনিজের বটের মাধ্যমেস্বাক্ষরিত পোস্টt.me/s পৃষ্ঠা সরাসরি পড়ুন,অথবা ডেস্কটপ এক্সপোর্ট
ডায়াগ্রাম টেক্সট হিসেবে
  1. সংগ্রাহক → সাক্ষী (স্বাক্ষরিত চেকপয়েন্ট: রেকর্ড গণনা + হেড হ্যাশ)
  2. সাক্ষী → সাক্ষী জার্নাল, নিজস্ব কী
  3. সাক্ষী → টেলিগ্রাম চ্যানেল (নিজের বটের মাধ্যমে স্বাক্ষরিত পোস্ট)
  4. প্রমাণ ZIP → verify.py
  5. সাক্ষী জার্নাল, নিজস্ব কী → verify.py
  6. টেলিগ্রাম চ্যানেল → verify.py (t.me/s পৃষ্ঠা সরাসরি পড়ুন, অথবা ডেস্কটপ এক্সপোর্ট)
এই পৃষ্ঠায়

সাক্ষী যা সংরক্ষণ করে#

সাক্ষীর আছে সাক্ষী কখনোই করেনি।
একটি ওয়ার্কস্পেসের জন্য শুধুমাত্র-পঠনযোগ্য সাক্ষী টোকেন সংগ্রাহকের টেলিগ্রাম সেশন বা API ক্রেডেনশিয়ালস
এর নিজস্ব Ed25519 কী এবং জার্নাল সংগ্রাহকের ভল্ট, স্বাক্ষর কী বা প্যানেল টোকেন
এর নিজস্ব টেলিগ্রাম বট টোকেন বার্তার বিষয়বস্তু: হেড হল একটি রেকর্ড গণনা এবং একটি হ্যাশ

টোকেনটি More tools → Extras → Independent witness-এ তৈরি হয়, একবার দেখানো হয় এবং শুধুমাত্র SHA-256 হিসেবে সংরক্ষণ করা হয়। এটি ঠিক একটি এন্ডপয়েন্ট, GET /api/witness/head, খুলে, যা একটি সদ্য স্বাক্ষরিত চেকপয়েন্ট এবং স্বাক্ষরিত কন্টেন্ট-ফ্রি কালেকশন কাউন্টার ও অপারেশনাল হেলথ ফেরত দেয়। এটি প্যানেল খুলতে, বার্তা বিষয়বস্তু পড়তে বা সেটিংস পরিবর্তন করতে পারে না, এবং সেখানে প্যানেল টোকেন গ্রহণ করা হয় না। একই পৃষ্ঠায় একটি টোকেন বাতিল করুন। কালেক্টর রেকর্ড করে কখন একটি নতুন উইটনেস কী চেকিং শুরু করে (witness.seen) এবং প্রতিটি টোকেনের শেষ চেক দেখায়; একটি উইটনেস যা 2.5 ইন্টারভালের মধ্যে চেক করেনি তা 'অভারডু' (overdue) হিসেবে চিহ্নিত হয়।

নতুন সাক্ষীরা প্রতিটি পোল-এ একটি এলোমেলো চ্যালেঞ্জ পাঠায়; capture বিবৃতিটি এটিকে কালেক্টর স্বাক্ষরের নিচে প্রতিধ্বনিত করে। কাউন্টারগুলো নির্দিষ্ট চেকপয়েন্টের সাথে আবদ্ধ এবং স্বাক্ষরিত সাক্ষী পোস্টে অন্তর্ভুক্ত থাকে। লিগ্যাসি হেডগুলো স্বতন্ত্র সাক্ষীর দ্বারা গ্রহণযোগ্য থাকে। শুধুমাত্র জার্নাল বৃদ্ধি কখনোই নতুন বার্তা হিসেবে গণ্য হয় না।

এটি যা যাচাই করে এবং রেকর্ড করে#

প্রতিটি ব্যবধান (ডিফল্ট ১০ মিনিট) সাক্ষী:

  1. এটি হেডটিকে নিজেই আনয়ন করে (কলেক্টর এটিকে পুশ বা স্কিপ করতে পারে না);
  2. সংগ্রাহকের স্বাক্ষর, পিন করা সংগ্রাহক কী (--collector-fingerprint বা প্রথম দেখা কী), একটি অ-হ্রাসমান গণনা এবং অপরিবর্তিত গণনায় অপরিবর্তিত হেড যাচাই করে। মার্কল অন্তর্ভুক্তি এবং সামঞ্জস্য প্রমাণগুলি যাচাই করে যে একটি বর্ধিত জার্নাল সংরক্ষিত চেকপয়েন্টকে প্রসারিত করে। একবার ধারাবাহিকতা প্রমাণগুলি ব্যবহার হয়ে গেলে, সেগুলি অপসারণ প্রত্যাখ্যাত হয়;
  3. নিজের জার্নালে একটি স্বাক্ষরিত রেকর্ড সংযুক্ত করে: witness.anchor, স্ট্যাটাস ok, key_changed, rollback (আগের তুলনায় কম রেকর্ড), fork (একই দৈর্ঘ্য, ভিন্ন হেড) অথবা invalid (উত্তর যাচাইকরণে ব্যর্থ), অথবা witness.no_response যখন কালেক্টর উত্তর দেয়নি;
  4. চ্যানেলে ফলাফলটি স্বাক্ষরিত অবস্থায় পোস্ট করা হয়, যার মধ্যে "no answer" অন্তর্ভুক্ত, যখন সাক্ষী চলছে এবং 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/পরিবেশের পথগুলো কর্ম ডিরেক্টরির সাপেক্ষে। সাক্ষীর ফিঙ্গারপ্রিন্ট হোস্টের বাইরে সংরক্ষণ করুন। কালেক্টরের last-poll সূচক শুধুমাত্র অনুরোধ নিশ্চিত করে; প্রকাশ Proof দ্বারা রিপোর্ট করা হয় অথবা সাক্ষীর জার্নাল এবং চ্যানেলে যাচাই করা হয়।

যদি প্যানেলটি একটি SSH টানেলের পিছনে থাকে, তাহলে এই Caddy উদাহরণ ব্যবহার করে শুধুমাত্র স্কোপড উইটনেস এন্ডপয়েন্টটিকে একটি আলাদা HTTPS হোস্টনেমে প্রকাশ করুন। ডিফল্ট ওয়ার্কস্পেস তখন https://witness.example.org ব্যবহার করে, অন্য ওয়ার্কস্পেসগুলো https://witness.example.org/profiles/ID ব্যবহার করে। টোকেন এখনও প্রয়োজন; প্যানেল এবং এর অন্যান্য API রুটগুলো সেই ভার্চুয়াল হোস্ট দ্বারা ফরওয়ার্ড করা হয় না।

all-কে বেছে নিন নিয়মিত প্রকাশিত চেকপয়েন্টের জন্য। পাঁচ মিনিটের ব্যবধান মানে প্রতিদিন প্রতিটি ওয়ার্কস্পেসে প্রায় ২৮৮টি পোস্ট। changes/problems ইচ্ছাকৃতভাবে কিছু চেক প্রকাশ করে না। MTProxy হল কালেক্টরের টেলিগ্রাম ক্লায়েন্টের জন্য। উইটনেস 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 কপি করুন। প্যানেলে, ধাপ ২-এ Discord webhook · আপনার চ্যানেল নির্বাচন করুন। সাক্ষী হোস্টে 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 চেকের মধ্যবর্তী মিনিট, ১–১৪৪০
--timeout _TIMEOUT 30 কলেক্টর এবং বট এপিআইয়ের জন্য অপেক্ষার সেকেন্ড, ৫–৬০০
--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 বট এপিআই ঠিকানা, যেমন একটি স্থানীয় বট এপিআই সার্ভার
--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 একই সাথে সর্বোচ্চ ৩২টি ওয়ার্কস্পেস পর্যবেক্ষণ করে এবং প্রতিটি স্পেসের সর্বশেষ স্বাক্ষরিত চেকসহ একটি শুধুমাত্র-পঠনযোগ্য পৃষ্ঠা পরিবেশন করে। প্রতিটি ওয়ার্কস্পেসের জন্য ডেটা ফোল্ডারের অধীনে একটি নিজস্ব উইটনেস কী এবং জার্নাল এবং একটি পিন করা কালেক্টর কী থাকে; টেলিগ্রাম চ্যানেলে পোস্ট করা প্রতিটি ওয়ার্কস্পেসের জন্য ঐচ্ছিক। proof.config.example থেকে শুরু করুন:

ক্ষেত্র অর্থ
title পৃষ্ঠার শিরোনাম, 1–100 অক্ষর
data_dir ফাইলের সাপেক্ষে উইটনেস কী এবং জার্নাল; ডিফল্ট proof-data
interval, timeout চেকের মধ্যবর্তী মিনিট (1–1440, ডিফল্ট 5); অপেক্ষার সেকেন্ড (5–600, ডিফল্ট 20)
workspaces[].id, label ছোটcase অ্যালিয়াস এবং প্রদর্শিত নাম
workspaces[].collector সংগ্রাহকের ঠিকানা; অন্যান্য ওয়ার্কস্পেসগুলি শেষ হয় /profiles/<workspace ID>
workspaces[].collector_fingerprint প্রয়োজনীয়, প্রতিটি ওয়ার্কস্পেসের জন্য ভিন্ন
workspaces[].token_file সেই ওয়ার্কস্পেসের শুধুমাত্র-পঠনযোগ্য উইটনেস টোকেন সহ ফাইল
workspaces[].channel, bot_token_file ঐচ্ছিক, একসঙ্গে: প্রতিটি চেক একটি চ্যানেলে পোস্ট করুন
workspaces[].proxy, bot_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 অনুরোধের উত্তর দেয়:

  • / প্রতিটি ওয়ার্কস্পেস দেখায়; ২.৫ ইন্টারভাল চেক না করা কোনো ওয়ার্কস্পেসকে stale হিসেবে চিহ্নিত করা হয়।
  • /api/proof JSON-এর মতো একই মান ফেরত দেয়।
  • /api/proof/<id> সর্বশেষ স্বাক্ষরিত বিবৃতি ডাউনলোড করে (tgwitness-public-proof-v1): witness রেকর্ড নম্বর এবং হ্যাশ, অবস্থা, পিন করা কালেক্টর কী, চেকপয়েন্ট, সংগ্রহ কাউন্টার এবং চ্যানেল পোস্ট সফল হয়েছে কিনা, সেই ওয়ার্কস্পেসের উইটনেস কী দ্বারা স্বাক্ষরিত।
  • /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 Telegram Desktop এক্সপোর্ট (চ্যাট ইতিহাস রপ্তানি → JSON থেকে result.json) অথবা পৃষ্ঠার সংরক্ষিত কপি গ্রহণ করে; এগুলো পোস্টের বিষয়বস্তু যাচাই করে কিন্তু কোনো বাহ্যিক সময় দেয় না।

verify.py সাক্ষীর জার্নাল (চেইন এবং স্বাক্ষর) পরীক্ষা করে, তারপর যাচাই করে যে সাক্ষী যে প্রতিটি হেড দেখেছিল তা রপ্তানি করা জার্নালের অংশ: সেই গণনায় থাকা রেকর্ডের হ্যাশটি অবশ্যই ঠিক সেই হ্যাশটি হবে। মিল না খাওয়া কোনো হেড যাচাইকরণে ব্যর্থ হয় — সাক্ষী এটি দেখার পর জার্নালটি পরিবর্তিত হয়েছে। এটি রপ্তানির পর দেখা হেড, সাক্ষী যে অস্বাভাবিকতাগুলি রেকর্ড করেছেন, ব্যর্থ উত্তর, সেই সময়কালগুলি যার মিলিত চেকপয়েন্টগুলি এই রপ্তানিতে উপস্থিত ("X থেকে Y পর্যন্ত সাক্ষী-নিদর্শিত") এবং ফাঁকগুলিও রিপোর্ট করে। পরবর্তী চেকপয়েন্টগুলি সেই সময়কালগুলিকে প্রসারিত করে না। ফলাফলের মধ্যে শেষ মিলিত রেকর্ড নম্বর এবং মিলিত চেকপয়েন্ট ছাড়া থাকা পরবর্তী রেকর্ডগুলির সংখ্যা অন্তর্ভুক্ত থাকে। শুধুমাত্র সেই উত্তরগুলোই গণনা করা হয় যেগুলো এক্সপোর্টের নিজস্ব কী দিয়ে স্বাক্ষরিত: যদি কোনো কী দিয়ে স্বাক্ষরিত হয় যা সাক্ষী কখনো দেখেনি, তবে তা 'সাক্ষীবিহীন' (not witnessed) হিসেবে রিপোর্ট করা হয়, এবং --fingerprint ছাড়া এর স্বাক্ষরকারী আনপিনড (unpinned) থাকে। --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-এ জমা দেয়। ক্যালেন্ডার জমা প্রমাণের জন্য অপেক্ষমাণ; শুধুমাত্র স্বতন্ত্রভাবে যাচাইকৃত বিটকয়েন কমitmenই ভেরিফায়ারে নিশ্চিতকরণ পায়।

যদি সব ক্যালেন্ডার ব্যর্থ হয়, স্বাক্ষরিত সীল এবং ব্যর্থ প্রচেষ্টা জার্নালে থেকে যায়। ঘণ্টাভিত্তিক রক্ষণাবেক্ষণ পাস সেই মূল রেকর্ডটি পুনরায় চেষ্টা করে, রিস্টার্ট বা তারিখ পরিবর্তনের পরও। এটি সর্বোচ্চ 32টি সীল স্ক্যান করে, সর্বোচ্চ দুইটি অনুপস্থিত জমা জমা দেয় এবং প্রতি পাসে পুনঃচেষ্টায় সর্বোচ্চ 60 সেকেন্ড সময় ব্যয় করে। একটি স্থায়ী কার্সর পুরনো সীলগুলোর মধ্য দিয়ে ঘুরে। সংরক্ষিত জমাগুলি বিদ্যমান প্রুফ-আপগ্রেড পথ অনুসরণ করে।

পুনরায় চেষ্টা সীল পুনঃলিখন করে না, এর মূল তারিখ পরিবর্তন করে না বা দাবি করে না যে ক্যালেন্ডার এটি আগে পেয়েছিল। পরবর্তী বিটকয়েন কমিটমেন্ট একটি পরবর্তী বাহ্যিক নিশ্চিতকরণ হিসেবেই থাকে। অনুপস্থিত প্রমাণসমূহ none হিসেবেই থাকে; অপেক্ষমান প্রমাণসমূহ pending হিসেবে থাকে যতক্ষণ না যাচাইকারী সেগুলো স্বতন্ত্রভাবে পরীক্ষা করে।