Referensi / Bukti
Telegram · Saksi independen
Jalankan TgWitness dengan kunci dan botnya sendiri, publikasikan titik pemeriksaan yang ditandatangani ke saluran, dan periksa ekspor data berdasarkan titik pemeriksaan tersebut.
TgWitness / Dokumentasi · Bukti dan verifikasi
Ekspor dan verifikasi · Jaminan tinggi · Panduan panel
Seorang saksi menyimpan titik pemeriksaan yang telah ditandatangani secara terpisah dari pengumpul. Ia memeriksa tanda tangan pengumpul dan kesinambungan jurnal, menandatangani hasilnya dengan kuncinya sendiri, dan mempublikasikannya ke saluran Telegram. Jalankan alat ini di server terpisah dengan akses baca-saja ke titik akhir saksi pengumpul.
Hasil teknis mencakup prefiks jurnal yang disimpan, respons tantangan, pemeriksaan tanda tangan, pemeriksaan inklusi/konsistensi Merkle, dan hasil kontinuitas yang ditandatangani. Untuk saksi yang dioperasikan oleh kustodian lain, simpan identitas kustodian dan catatan kontrol kunci beserta sidik jarinya. Kunci terpisah dan kustodi terpisah menggambarkan bagian yang berbeda dari penyiapan. Verifikator melaporkan bahwa kunci kedua menyimpan head jurnal dan sampai catatan mana; catatan kontrol kunci milik kustodian menunjukkan siapa yang memegang kunci itu. Jurnal saksi adalah pemeriksaan pendukung; syarat minimum untuk bukti adalah waktu pihak ketiga. Postingan kanal menambahkan waktu eksternal: Telegram memberi tanggal pada setiap postingan publik, dan verifikator membaca tanggal tersebut sendiri.
Diagram dalam bentuk teks
- Pengumpul → Saksi (titik pemeriksaan yang ditandatangani: jumlah catatan + hash header)
- Saksi → Jurnal saksi, kunci sendiri
- Saksi → Saluran Telegram (postingan yang ditandatangani melalui botnya sendiri)
- Berkas ZIP Bukti → verify.py
- Jurnal saksi, kunci sendiri → verify.py
- Saluran Telegram → verify.py (t.me/s halaman dibaca secara langsung, atau ekspor ke Desktop)
Di halaman ini
Apa yang disimpan saksi#
| Saksi tersebut memiliki | Saksi tersebut tidak pernah memiliki |
|---|---|
| Token saksi yang hanya dapat dibaca untuk satu ruang kerja | Sesi Telegram atau kredensial API pengumpul |
| Kunci Ed25519 dan jurnal miliknya sendiri | Brankas pengumpul, kunci penandatanganan, atau token panel |
| Token bot Telegram miliknya sendiri | Isi pesan: bagian awal berisi jumlah catatan dan hash |
Token ini dibuat di More tools → Extras → Independent witness, ditampilkan sekali, dan disimpan hanya sebagai
SHA-256. Token ini membuka tepat satu titik akhir, GET /api/witness/head, yang mengembalikan
titik pemeriksaan yang baru ditandatangani beserta penghitung koleksi tanpa konten yang ditandatangani dan status kesehatan operasional.
Token ini tidak dapat membuka panel, membaca isi pesan, atau mengubah pengaturan, dan
token panel tidak diterima di sana. Cabut token di halaman yang sama. Pengumpul mencatat
saat kunci saksi baru mulai melakukan pemeriksaan (witness.seen) dan menampilkan pemeriksaan terakhir per token;
seorang saksi yang belum melakukan pemeriksaan dalam interval 2.5 ditandai sebagai terlambat.
Saksi baru mengirimkan tantangan acak pada setiap jajak pendapat; pernyataan penangkapan mengulanginya di bawah tanda tangan pengumpul. Penghitung terikat pada titik pemeriksaan yang tepat dan disertakan dalam posting saksi yang ditandatangani. Kepala warisan tetap diterima oleh saksi mandiri. Pertumbuhan jurnal saja tidak pernah dihitung sebagai pesan baru.
Apa yang diperiksa dan dicatat#
Setiap interval (secara default 10 menit), TgWitness:
- mengambil header itu sendiri (pengumpul tidak dapat memaksa atau melewatkannya);
- memverifikasi tanda tangan pengumpul, kunci pengumpul yang disematkan (
--collector-fingerprint, atau kunci pertama yang terlihat), hitungan yang tidak berkurang, dan kepala yang tidak berubah pada hitungan yang tidak berubah. Bukti inklusi dan konsistensi Merkle memverifikasi bahwa jurnal yang terus bertambah memperluas titik pemeriksaan yang disimpan. Setelah bukti kontinuitas digunakan, upaya untuk menghapusnya akan ditolak; - menambahkan catatan yang ditandatangani ke jurnalnya sendiri:
witness.anchordengan statusok,key_changed,rollback(jumlah catatan lebih sedikit daripada sebelumnya),fork(panjangnya sama, head-nya berbeda) atauinvalid(jawaban gagal verifikasi), atauwitness.no_responseketika pengumpul tidak menjawab; - mengunggah hasilnya ke saluran, yang telah ditandatangani, termasuk "tidak ada jawaban" selama TgWitness
sedang berjalan dan dapat mengakses Bot API. ID unggahan dicatat (
witness.posted), begitu pula unggahan yang gagal (witness.post_failed).
Sebuah posting terlihat seperti ini; baris terakhir berisi pernyataan yang telah ditandatangani:
TgWitness witness #42 · journal head
Collector 3fa9c2d1e0b4a7f6: 18234 records
Head 9b1f…c07e
2026-10-28T19:40:00.123+00:00
TGW1.eyJhdCI6…<statement>.<signature>
Jalankan TgWitness#
Anda memerlukan bot Telegram (buatlah dengan @BotFather), sebuah saluran di mana bot tersebut menjadi administrator, serta alamat pengumpul yang dapat diakses oleh saksi — melalui HTTPS di luar jaringan pribadi (lihat profil HTTPS pada bagian penerapan).
Buka Lebih banyak alat → Ekstra → Saksi independen → Konfigurasi
di panel. Tiga langkah mencakup
akses baca-saja, saluran Anda, dan interval, lalu meluncurkan saksi. Kebijakan
publikasi, proxy HTTP/SOCKS5 opsional, dan alamat Bot API khusus terdapat di pengaturan Lanjutan
. Formulir
mengunduh witness.json
dengan kunci pengumpul ruang kerja ini yang disematkan. Unduh
token baca-saja yang baru dibuat dengan Simpan berkas akses
sebagai witness-token.txt
; letakkan berkas tersebut beserta bot-token.txt
yang dibuat di host saksi di samping berkas JSON tersebut. Pengumpul tidak pernah menerima token bot.
Pengunduhan tidak memulai layanan atau mempublikasikan pesan. Tidak ada saksi proyek yang dihosting yang
secara implisit terdaftar.
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
Perintah pertama memeriksa berkas konfigurasi dan berkas rahasia tanpa permintaan jaringan atau pembuatan kunci. Jalur dalam JSON bersifat relatif terhadap berkas tersebut; jalur CLI/lingkungan bersifat relatif terhadap direktori kerja. Simpan sidik jari saksi di luar hostnya. Indikator "last-poll" pengumpul hanya mengonfirmasi permintaan; publikasi dilaporkan oleh Proof atau diperiksa di jurnal saksi dan saluran.
Jika panel berada di balik terowongan SSH, tampilkan hanya titik akhir saksi yang dibatasi pada
nama host HTTPS terpisah dengan contoh Caddy ini.
Ruang kerja default kemudian menggunakan https://witness.example.org, sedangkan ruang kerja lainnya menggunakan
https://witness.example.org/profiles/ID. Token tetap diperlukan; panel dan
rute API lainnya tidak diteruskan oleh host virtual tersebut.
Pilih all untuk titik pemeriksaan yang diterbitkan secara teratur. Interval lima menit berarti sekitar 288
posting per ruang kerja per hari. changes/problems sengaja tidak mempublikasikan beberapa pemeriksaan.
MTProxy diperuntukkan bagi klien Telegram pengumpul data. Pemantauan HTTP dan API Bot HTTPS
Telegram menggunakan rute langsung/HTTP/SOCKS5 (API Bot) masing-masing.
Di samping pengumpul, dengan Docker (host yang sama — proses dan kunci independen, tetapi
operator yang sama): masukkan nilai-nilai ke dalam .env dan jalankan profil tersebut.
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
Jika menggunakan gambar yang telah dipublikasikan, gunakan kode docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d.
Di server pihak lain (penyimpanan terpisah): salin repositori ke sana, atur
TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org ditambah tiga nilai di atas
di .env, lalu
docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d
atau tanpa 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
Publikasikan ke Discord#
Seorang saksi dapat memposting ke saluran Discord alih-alih ke Telegram. Di Discord, buka
Edit Channel → Integrations → Webhooks, buat webhook, dan salin URL-nya. Di
panel tersebut, pilih Discord webhook · saluran Anda pada langkah 2. Di server saksi,
simpan URL tersebut sebagai discord-webhook.txt di samping witness.json; URL tersebut tidak akan pernah sampai ke
pengumpul.
python -m tgwitness.witness run --collector https://your-collector.example.org \
--token-file witness-token.txt --discord-webhook-file discord-webhook.txt
Seorang saksi memiliki satu penerbit: saluran Telegram atau webhook Discord, bukan keduanya. Postingan
membawa pernyataan yang ditandatangani yang sama dan tidak dapat mengirim ping kepada siapa pun. Postingan yang lebih panjang dari batas
2,000
karakter Discord diganti dengan baris pendek yang dilengkapi dengan pemeriksaan lengkap yang dilampirkan sebagai
witness-check.txt
. Setiap ID postingan dicatat sebagai witness.posted
. verify.py --channel
hanya membaca saluran Telegram, jadi untuk Discord simpan jurnal saksi: jurnal tersebut menyimpan setiap
pemeriksaan. Postingan Discord tidak memberikan waktu eksternal kepada verifikator.
Opsi#
| Opsi | Lingkungan | Default | Arti |
|---|---|---|---|
--interval |
TGWITNESS_WITNESS_INTERVAL |
10 | Interval waktu antara pemeriksaan, 1–1.440 |
--timeout |
_TIMEOUT |
30 | Waktu tunggu untuk pengumpul data dan Bot API, 5–600 detik |
--post |
_POST |
all |
all: setiap pemeriksaan; changes: masalah baru; problems: hanya masalah dan jawaban yang hilang |
--title |
_TITLE |
TgWitness witness |
Kata-kata pertama dari setiap postingan saluran |
--collector-fingerprint |
_COLLECTOR_FINGERPRINT |
– | Simpan kunci pengumpul alih-alih mempercayai jawaban pertama |
--proxy |
_PROXY |
langsung | socks5://host:port atau http://host:port |
--bot-api |
_BOT_API |
https://api.telegram.org |
Alamat API Bot, misalnya server API Bot lokal |
--data-dir |
_DATA |
witness-data |
Kunci saksi dan jurnal |
--config |
_CONFIG |
– | Berkas JSON dengan salah satu opsi di atas |
Alamat pengumpul, token, dan saluran berasal dari --collector, --token atau
--token-file, --bot-token atau --bot-token-file, --discord-webhook-file dan --channel,
atau _COLLECTOR, _TOKEN, _TOKEN_FILE, _BOT_TOKEN, _BOT_TOKEN_FILE,
_DISCORD_WEBHOOK_FILE dan _CHANNEL, yang mencegah rahasia masuk ke dalam daftar proses.
Sebuah berkas konfigurasi menggunakan nama opsi dengan garis bawah, ditambah texts, yang menggantikan kata-kata
dalam postingan saluran:
{"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"}}
Kunci texts: ok, key_changed, rollback, fork, invalid, no_response, collector,
records, head. Baris perintah memiliki prioritas lebih tinggi daripada lingkungan, dan lingkungan memiliki prioritas lebih tinggi daripada berkas.
Opsi atau kunci teks yang tidak dikenal akan menghentikan saksi dengan pesan, bukan diabaikan.
Rumusan kata tidak pernah memengaruhi verifikasi: `verify.py` memeriksa token yang ditandatangani di akhir setiap
posting. Dengan --post changes atau problems, pemeriksaan yang tidak diposting tetap ada di
jurnal saksi dan verify.py mencantumkannya sebagai tidak pernah diposting; catatan awal menyebutkan
kebijakan. Setiap pemeriksaan tetap muncul di jurnal, sehingga lebih sedikit posting berarti lebih sedikit kali diberi tanggal
oleh Telegram, bukan lebih sedikit pemeriksaan.
Tanpa saluran, TgWitness tetap menyimpan jurnalnya. Simpan sidik jari kunci TgWitness
(python -m tgwitness.witness fingerprint) di tempat lain.
Halaman bukti publik untuk beberapa ruang kerja#
python -m tgwitness.proof TgWitness dapat menangani hingga 32 ruang kerja sekaligus dan menampilkan halaman
hanya-baca yang berisi pemeriksaan terbaru yang telah ditandatangani untuk masing-masing ruang kerja. Setiap ruang kerja memiliki kunci saksi dan
jurnal tersendiri di dalam folder data serta kunci pengumpul yang disematkan; pengiriman ke saluran Telegram
bersifat opsional untuk setiap ruang kerja. Mulailah dari
proof.config.example:
| Bidang | Arti |
|---|---|
title |
Judul halaman, 1–100 karakter |
data_dir |
Kunci dan jurnal saksi, terkait dengan berkas; default proof-data |
interval, timeout |
Jeda antara pemeriksaan (1–1440, default 5); waktu tunggu dalam detik (5–600, default 20) |
workspaces[].id, label |
Alias singkat huruf kecil dan nama yang ditampilkan |
workspaces[].collector |
Alamat Collector; ruang kerja lainnya berakhir dengan /profiles/<workspace ID> |
workspaces[].collector_fingerprint |
Diperlukan, berbeda untuk setiap ruang kerja |
workspaces[].token_file |
File yang berisi token saksi read-only dari ruang kerja tersebut |
workspaces[].channel, bot_token_file |
Opsional, secara bersamaan: posting setiap pemeriksaan ke saluran |
workspaces[].proxy, bot_api |
Rute opsional dan alamat API Bot |
python -m tgwitness.proof --config proof.json --check-config
python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790
Perintah pertama memvalidasi berkas dan berkas token tanpa membuka koneksi. Halaman ini hanya merespons permintaan GET dan HEAD:
/menampilkan setiap ruang kerja; ruang kerja yang tidak diperiksa selama 2,5 interval akan ditandai sebagai usang./api/proofmengembalikan hasil yang sama dengan JSON./api/proof/<id>mengunduh pernyataan terbaru yang telah ditandatangani (tgwitness-public-proof-v1): nomor dan hash catatan saksi, status, kunci pengumpul yang disematkan, titik pemeriksaan, penghitung pengumpulan, serta apakah posting saluran berhasil, yang ditandatangani oleh kunci saksi ruang kerja tersebut./healthzMenampilkan kode kesalahan 503 ketika monitor ruang kerja telah berhenti beroperasi.
Beri halaman tersebut nama hostnya sendiri, seperti
Caddyfile.proof.example. Untuk verifikasi, ekspor
jurnal saksi ruang kerja dengan
python -m tgwitness.witness export --data-dir proof-data/<id> --out witness.zip dan gunakan
sebagaimana dijelaskan di bawah ini.
Verifikasi#
Dari sisi saksi, ekspor jurnalnya:
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 .
Kemudian, di mana saja, dengan ZIP yang ditandatangani oleh pengumpul dan alamat saluran publik:
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 juga menerima ekspor dari Telegram Desktop (Ekspor riwayat obrolan → JSON menghasilkan
result.json) atau salinan halaman yang disimpan; keduanya memeriksa isi postingan tetapi tidak memberikan
waktu eksternal.
verify.py memeriksa jurnal saksi (rantai dan tanda tangan), kemudian memastikan bahwa setiap head yang
dilihat saksi merupakan bagian dari jurnal yang diekspor: catatan pada hitungan tersebut harus memiliki
hash yang persis sama. Sebuah head yang tidak cocok akan gagal verifikasi — jurnal telah diubah setelah
saksi melihatnya. Alat ini juga melaporkan head yang terlihat setelah ekspor, anomali yang
dicatat oleh saksi, jawaban yang gagal, periode di mana checkpoint yang cocok terdapat dalam
ekspor ini ("Disaksikan dari X hingga Y"), dan celah. Checkpoint yang lebih baru tidak memperpanjang periode tersebut.
Hasilnya mencakup nomor catatan terakhir yang cocok dan jumlah catatan berikutnya
tanpa checkpoint yang cocok. Hanya jawaban yang ditandatangani oleh kunci ekspor itu sendiri yang dihitung: ekspor yang ditandatangani
oleh kunci yang tidak pernah dilihat saksi dilaporkan sebagai tidak disaksikan, dan tanpa --fingerprint,
penandatanganannya tetap tidak terikat. Dengan --channel, setiap posting yang ditandatangani harus cocok dengan jurnal saksi
catatan demi catatan: posting yang diubah gagal verifikasi, posting yang hilang dicantumkan. Kesesuaian
token mengautentikasi konten; tanggal berada di luar token yang ditandatangani.
Dengan alamat langsung https://t.me/s/… atau https://telegram.me/s/…, verifikator membaca
tanggal setiap posting dari halaman pada saat verifikasi. Telegram yang menetapkan tanggal tersebut; tanggal
postingan yang telah diedit tidak digunakan. Tanggal paling awal dari sebuah postingan pada titik awal ekspor adalah waktu eksternal
untuk catatan terakhir, yang memenuhi syarat minimum sebagai bukti. Tanggal
dari sumber lain apa pun, seperti result.json yang disediakan, halaman yang disimpan, atau alamat web
lainnya, merupakan metadata yang disediakan, bukan waktu independen; hasil tersebut menyebutkan dari mana tanggal postingannya
berasal (post_date_verification).
Memerlukan batas ekspor yang disaksikan#
Untuk serah terima yang harus menyertakan catatan akhir yang disaksikan, tambahkan --require-witness:
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
--witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness
Hal ini memerlukan sidik jari saksi yang disimpan secara independen, kunci selain
kunci pengumpul, dan titik pemeriksaan yang cocok tepat di akhir ekspor ini. Titik pemeriksaan
yang hanya mencakup awalan sebelumnya tidak memadai. Hentikan sementara pengumpulan, biarkan saksi
mengamati keadaan akhir, dan ekspor sebelum penulisan jurnal lebih lanjut; jika jurnal berubah, simpan titik pemeriksaan lain dan
ekspor keadaan tersebut. Titik pemeriksaan yang lebih baru saja tidak dapat memverifikasi hash akhir dari ekspor yang lebih pendek.
Ketika --channeljuga disertakan, posting yang diklaim hilang atau himpunan pencocokan yang kosong akan gagal dalam
pemeriksaan ketat ini. Tanpa bendera tersebut, pemeriksaan integritas biasa tetap melaporkan catatan yang tidak disaksikan
tanpa menolak arsip yang sebaliknya utuh.
Simpan jurnal saksi dan kuncinya yang disematkan secara terpisah. Pemeriksaan daring memverifikasi kontinuitas antara titik pemeriksaan; verifikasi luring membandingkan setiap titik pemeriksaan yang disimpan dengan ekspor. Kepala lama tanpa bukti kontinuitas tetap mempertahankan perbandingan luring dan dilaporkan tanpa verifikasi kontinuitas daring. Laporan tersebut mencantumkan waktu henti saksi dan publikasi yang gagal berdasarkan interval.
Segel harian dan kalender cap waktu yang tidak tersedia#
Saksi tersebut menyegel batas jurnal hari UTC sebelumnya dan mengirimkan hash dari segel yang telah ditandatangani tersebut ke OpenTimestamps. Pengiriman kalender merupakan bukti yang masih tertunda; hanya komitmen Bitcoin yang telah diverifikasi secara independen yang menerima konfirmasi di verifikator.
Jika semua kalender gagal, segel yang ditandatangani dan upaya yang tidak berhasil tetap ada di jurnal. Proses pemeliharaan setiap jam akan mencoba kembali catatan asli tersebut, termasuk setelah restart atau perubahan tanggal. Proses ini memindai paling banyak 32 segel, mengirimkan paling banyak dua pengiriman yang terlewat, dan menghabiskan paling banyak 60 detik untuk upaya ulang per siklus. Sebuah kursor persisten bergilir melalui segel-segel yang lebih lama. Pengiriman yang disimpan mengikuti jalur peningkatan bukti yang ada.
Upaya ulang tidak akan menulis ulang segel, mengubah tanggal aslinya, atau menyatakan bahwa
kalender telah menerimanya lebih awal. Komitmen Bitcoin yang lebih baru tetap menjadi konfirmasi eksternal
yang lebih baru. Bukti yang hilang tetap berstatus none; bukti yang tertunda tetap berstatus pending hingga
verifikator memeriksanya secara independen.