hashcash - Online di Cloud

PROGRAM:

NAMA

hashcash - hashcash anti-spam / penolakan alat pengukur layanan

RINGKASAN

Permen (membuat) perangko:

uang tunai -m [[ Pilihan ] [ sumber ...] ...]

Memeriksa perangko:

uang tunai -c [[ Pilihan ] -r sumber ... ] [ cap ... ]

Kecepatan perkiraan:

uang tunai -s [ Pilihan ] [ -b bit ]

pembersihan basis data:

uang tunai -p sekarang [ -j sumber ] [ -k ] [ -t waktu ] [ -u ]

Menghitung tabrakan bit:

uang tunai -w [ Pilihan ] [ cap ... ]

Dapatkan sumber Nama:

uang tunai -n [ Pilihan ] [ cap ... ]

Dapatkan waktu yang tersisa sampai kadaluwarsa

uang tunai -l [ Pilihan ] -e periode [ cap ... ]

DESKRIPSI

Hashcash adalah alat pengukur penghitung penolakan layanan. Penggunaan utamanya saat ini adalah untuk membantu
pengguna hashcash menghindari kehilangan email karena anti-spam berbasis konten dan daftar hitam
sistem.

Alat hashcash memungkinkan Anda membuat cap hashcash untuk dilampirkan ke email yang Anda kirim, dan
untuk memverifikasi prangko hashcash yang dilampirkan ke email yang Anda terima. Pengirim email melampirkan hashcash
perangko dengan X-Hashcash: header. Vendor dan penulis alat anti-spam dianjurkan
untuk mengecualikan email yang dikirim dengan hashcash dari daftar hitam dan aturan penyaringan berbasis konten.

Stempel hashcash merupakan bukti kerja yang membutuhkan jumlah pekerjaan yang dapat diparameterisasi
untuk menghitung pengirim. Penerima dapat memverifikasi prangko yang diterima secara efisien.

Fungsi hashcash proof-of-work adalah untuk menghitung tabrakan hash parsial (hash SHA1
fungsi yang digunakan). Dengan memilih jumlah bit tumbukan, kerja yang diperlukan untuk
menghitung tabrakan dapat dibuat mahal secara sewenang-wenang -- mulai dari sepersekian detik hingga
menit atau jam. Verifikasinya efisien membutuhkan biaya kecil yang sama apa pun
ukuran tumbukan.

Untuk diskusi lebih rinci tentang aplikasi lain hashcash telah digunakan untuk melihat
http://www.hashcash.org/

PENGGUNAAN CATATAN

Di halaman manual ini, nama sumber daya adalah nama layanan atau alamat stempelnya
dibuat untuk. Dalam hal email, nama sumber daya adalah alamat email penerima di
formulir [email dilindungi].

Mencetak perangko

Grafik -m bendera harus diberikan kepada mint cap.

Nama sumber daya (alamat email penerima) untuk mencetak cap dapat diteruskan sebagai
argumen, atau jika dihilangkan dibaca dari stdin. Jika stdin adalah tty, pengguna akan diminta, jika
stdin adalah pipa nama sumber daya hanya diam-diam dibaca. Ukuran tumbukan yang diinginkan dapat
ditentukan dengan opsi -b. Jika tidak ada ukuran tabrakan yang ditentukan, defaultnya adalah 20
bit. Lihat juga -b kegagalan .

Memeriksa perangko

Grafik -c bendera harus diberikan untuk memeriksa kedaluwarsa perangko. Cap untuk memeriksa dapat diberikan sebagai
argumen untuk "hashcash". Jika tidak ada cap yang diberikan, cap dibaca dari stdin. Jika stdin adalah
tty pengguna akan diminta, jika stdin adalah pipa, stempel hanya dibaca secara diam-diam. A
nama sumber daya (alamat email penerima) dapat diberikan dengan -r pilihan. Jika sebuah
nama sumber daya diberikan nama sumber daya dibandingkan dengan nama sumber daya di cap, jika
mereka tidak cocok, cap ditolak.

Catatan: jika tidak ada nama sumber daya yang diberikan, stempel tetap diperiksa untuk melihat apakah sebaliknya
valid, tetapi dapat dicetak untuk sumber daya yang berbeda, yang memungkinkan prangko menjadi
digunakan kembali di berbagai sumber daya, jadi hashcash akan mengembalikan kode keluar yang tidak dicentang saat keluar.

Perangko secara default dianggap berlaku selama 28 hari. Masa berlakunya bisa
diubah menggunakan -e bendera.

Jika stempel telah kedaluwarsa atau memiliki tanggal di masa depan, stempel ditolak dan program
keluar segera.

Jika ukuran tumbukan yang diperlukan diberikan dengan -b bendera, nilai prangko dihitung dan
dibandingkan, jika cap memiliki nilai yang tidak mencukupi, itu ditolak, dan program keluar
langsung. jika -b bendera tidak diberikan, cap diperiksa untuk melihat apakah sebaliknya
valid, tetapi hashcash akan mengembalikan kode keluar yang tidak dicentang saat keluar.

Jika perangko habis dua kali, perangko ditolak. Perlindungan pengeluaran ganda adalah
dibahas secara lebih rinci di bawah ini dalam "Perlindungan Pengeluaran Ganda". Jika pengeluaran ganda
perlindungan tidak diaktifkan, cap bisa dibelanjakan dua kali lipat, jadi hashcash akan kembali
kode keluar tidak dicentang (kode keluar 2) saat keluar.

Grafik -w flag dapat digunakan untuk meminta jumlah bit tabrakan dihitung
dan ditampilkan. NS -n bendera dapat digunakan untuk meminta agar nama sumber daya di cap adalah
diuraikan dan ditampilkan. NS -l flag dapat digunakan untuk meminta jumlah detik hingga
kadaluwarsa cap adalah output.

Program hanya akan mengembalikan kode keluar yang valid atau tidak valid jika: -c bendera yang digunakan, -b
bendera digunakan, -d, -r sumber digunakan. Ini adalah serangkaian opsi minimum yang diperlukan untuk
memeriksa sepenuhnya keabsahan prangko. Jika kriteria ini tidak terpenuhi, program akan
kembalikan kode keluar tidak dicentang (kode keluar 2) saat keluar. (Lihat juga -y bendera.)

Dua kali lipat Pengeluaran Proteksi

Jika -d bendera digunakan saat memeriksa prangko, database perangko bekas disimpan.

Secara default, prangko kedaluwarsa setelah 28 hari, tanpa kedaluwarsa, basis data akan bertambah
tanpa batas waktu. Anda dapat menentukan periode kedaluwarsa alternatif dengan -e bendera. NS
direkomendasikan (dan default) periode kedaluwarsa untuk email adalah 28 hari. Setelah masa kadaluwarsa
jangka waktu tertentu, stempel tetap dianggap kedaluwarsa dan dapat dihapus dari database
untuk menghemat ruang. (Lihat "Membersihkan Secara Berkala vs Akses Berikutnya" untuk cara membersihkan prangko.)

Untuk alasan efisiensi stempel diverifikasi sebelum diperiksa di database; jika memang
jika tidak, tidak ada aktivitas database yang akan terjadi.

Catatan: Keputusan tentang berapa lama stempel dianggap sah tergantung pada
pemeriksa. Jika terlalu pendek, mungkin untuk beberapa aplikasi stempel akan
kedaluwarsa sebelum tiba di penerima (misalnya dengan email.) Nilai yang disarankan 28 hari
harus aman untuk keterlambatan pengiriman email normal. Pilihannya adalah trade-off antara
ukuran database dan risiko kedaluwarsa sebelum kedatangan, dan tergantung pada aplikasi.

Catatan: Perangko yang berbeda dalam database yang sama dapat memiliki masa berlaku yang berbeda, jadi untuk
contoh perangko untuk sumber daya yang berbeda dengan masa berlaku yang berbeda dapat disimpan di
database yang sama, atau penerima dapat mengubah masa berlaku prangko di masa mendatang
tanpa mempengaruhi keabsahan perangko lama.

Membersihkan Secara berkala vs on Selanjutnya Mengakses

Untuk membersihkan prangko lama secara berkala sambil memeriksa prangko gunakan -p periode pilihan untuk membersihkan
tidak lebih cepat dari periode waktu yang ditentukan sejak pembersihan terakhir. Pembersihan dapat digunakan dengan
-k opsi untuk membersihkan prangko yang belum kedaluwarsa juga, dan dengan -j sumber bendera untuk dibersihkan saja
perangko untuk sumber daya yang diberikan.

Ada keadaan di mana mungkin tidak nyaman untuk menghapus perangko pada akses berikutnya,
misalnya jika ada database pembelanjaan ganda besar yang membutuhkan waktu untuk dibersihkan, dan
waktu respons pemeriksa hashcash adalah penting. Untuk menghindari masalah ini, bersihkan
dapat dilakukan secara terpisah hanya dengan menggunakan -p sekarang opsi untuk meminta hanya operasi pembersihan.
Di unix misalnya, Anda dapat memanggil "hashcash -p now" dalam pekerjaan cron sekali sehari, atau aktif
permintaan saat disk hampir habis.

Kecepatan Perkiraan

Grafik -s flag meminta pengukuran berapa banyak tabrakan yang dapat diuji per detik. Tidak
cap dicetak, atau diverifikasi.

Jika -b flag digunakan dengan opsi ini, sebagai gantinya perkiraan berapa detik itu akan
ambil untuk mencetak cap dengan ukuran yang diberikan dalam bit dihitung. Untuk mengetahui berapa banyak waktu itu
akan membutuhkan penggunaan prangko berukuran default -s -b kegagalan.

Catatan

Semua keluaran informasi dicetak pada stderr. Prangko yang dicetak, dan hasil stempel
verifikasi dan waktu dicetak di stdout. Bendera yang tenang -q menekan semua
keluaran informasi. NS -v flag meminta lebih banyak keluaran informasional. Yang diminta
output, yang merupakan satu-satunya informasi yang dikeluarkan dalam mode senyap (ketika -q ditentukan)
dicetak pada keluaran standar. Jika stdout adalah pipa, atau saat mode senyap berlaku,
output dicetak tanpa deskripsi (yaitu hanya bit, hanya detik, hanya sumber daya).

PILIHAN

-c Periksa informasi kedaluwarsa perangko yang diberikan sebagai argumen atau di stdin. (Gunakan dengan
-b, -d dan -r sumber untuk memeriksa perangko sepenuhnya).

-m Stempel mint dengan sumber daya yang diberikan sebagai argumen atau di stdin.

-b bit
Saat mencetak prangko, buat tabrakan setidaknya sebanyak ini. Saat memverifikasi
cap mengharuskannya memiliki tabrakan minimal sebanyak ini, jika tidak, tolak
dia. Jika dihilangkan default digunakan.

Saat memeriksa prangko, minta prangko memiliki banyak bit ini.

Jumlah bit default dapat ditentukan dengan -b kegagalan. Bit relatif terhadap
default juga dapat ditentukan dengan -b +n untuk n bit lebih dari default dan -b -n
untuk n bit kurang dari default.

-b kegagalan, -b +0 dan -b -0 semua setara.

Saat melakukan tes kecepatan -s, bisa untuk mengukur kecepatan token default dengan -s -b
kegagalan.

-r sumber
Saat mencetak prangko, nama sumber daya (alamat email penerima) untuk mencetak prangko
terhadap dapat diberikan baik dengan -r sumber atau sebagai argumen untuk "hashcash".

Saat memeriksa prangko, nama sumber daya (alamat email Anda sendiri) diberikan dengan -r
pilihan. Jika nama sumber daya diberikan, itu dicentang dengan nama sumber daya di
stempel, dan jika tidak sesuai stempel ditolak. Perhatikan jika nama sumber dayanya adalah
tidak diberikan, perangko untuk sumber lain akan diterima, dan karena itu hashcash
mengembalikan kode keluar tidak dicentang (kode keluar 2) saat keluar.

-o Saat memverifikasi prangko, banyak sumber daya dapat diberikan. Secara default, sumber dayanya adalah
hanya memeriksa satu per satu hingga sumber daya valid yang cocok ditemukan. Namun ketika Anda
gunakan wildcard atau ekspresi reguler (lihat -E), berguna untuk dapat menentukan bahwa
satu sumber mengesampingkan yang lain. Misalnya ini: -b15 -r [email dilindungi] -o -b10
*@dev.null menyatakan bahwa surat ke alamat [email dilindungi] membutuhkan 15 bit, tetapi email ke
*@dev.null hanya membutuhkan 10 bit. Jika kita menghilangkan -o mengesampingkan hubungan antara
dua sumber daya, cap 10 bit akan diterima untuk alamat [email dilindungi]
karena sementara itu akan ditolak karena memiliki bit yang tidak mencukupi di bawah aturan pertama,
itu akan diterima di bawah aturan ke-2. NS -o pilihan memungkinkan Anda menghindari masalah ini.

-e waktu
Masa kedaluwarsa untuk perangko bekas. Saat memeriksa prangko (menggunakan -c bendera), jika
stempel dicetak lebih dari jumlah waktu yang ditentukan sebelumnya, itu dianggap kedaluwarsa.
Jika opsi ini tidak digunakan, prangko secara default akan kedaluwarsa setelah 28 hari. Masa kedaluwarsa
diberikan dalam hitungan detik secara default (argumen 0 berarti selamanya). Satu karakter
akhiran dapat digunakan untuk menentukan satuan alternatif (m = menit, h = jam, d = hari, M =
bulan, y = Y = tahun, dan s = detik).

Jika digunakan dengan -d opsi, stempel bekas dan masa kedaluwarsanya dicatat dalam
basis data. Lihat -p opsi untuk deskripsi tentang cara membersihkan prangko dari database.

Saat mencetak prangko, -e bendera dapat berpengaruh pada resolusi waktu yang dibuat
di stempel. Tanpa -e opsi, resolusi default adalah hari (format waktu:
YYMMDD). Format alternatif berdasarkan rentang periode kedaluwarsa adalah sebagai berikut:

Saat mencetak, Anda juga dapat memberikan lebar waktu eksplisit dengan -z pilihan sebagai gantinya.
(-z menimpa -e jika keduanya diberikan. Jika keduanya tidak diberikan, defaultnya adalah 6 karakter (waktu
format: YYMMDD)).

Aturan untuk secara otomatis menentukan lebar waktu yang sesuai dari -e jika tidak -z Option
diberikan adalah:

* periode >= 2 tahun maka format waktu yang digunakan YY dibulatkan ke bawah ke tahun terdekat
Mulailah;
* 2 tahun < periode <= 2 bulan maka format waktu yang digunakan YYMM dibulatkan ke bawah ke
awal bulan terdekat;
* 2 bulan < periode <= 2 hari maka format waktu yang digunakan YYMMDD dibulatkan ke bawah menjadi
awal hari terdekat;
* 2 hari < periode <= 2 menit maka format waktu yang digunakan YYMMDDhhmm dibulatkan ke bawah ke
awal menit terdekat;
* titik < 2 menit maka format waktu yang digunakan YYMMDDhhmmss dalam detik.

Perhatikan pembulatan ke bawah didasarkan pada waktu UTC, bukan waktu setempat. Hal ini dapat menyebabkan
hasil awalnya mengejutkan ketika membulatkan ke bawah misalnya hari di zona waktu selain GMT
(UTC = GMT). Mungkin lebih jelas untuk dipahami jika Anda menggunakan -u .

-z lebar
Grafik -z opsi untuk digunakan selama pencetakan dan memungkinkan pengguna memilih lebar waktu lebar
bidang. Lihat juga -e pilihan yang diberikan dalam kombinasi dengan -m untuk menentukan implisit
lebar bidang waktu di bawah deskripsi -e bendera. Lebar yang valid adalah 6,10 atau 12
karakter masing-masing sesuai dengan: YYMMDD, YYMMDDhhmm, dan YYMMDDhhmmss dibulatkan ke bawah
ke hari terdekat, atau menit masing-masing.

Perhatikan pembulatan ke bawah didasarkan pada waktu UTC, bukan waktu setempat. Hal ini dapat menyebabkan
hasil awalnya mengejutkan ketika membulatkan ke bawah misalnya hari di zona waktu selain GMT
(UTC = GMT). Mungkin lebih jelas untuk dipahami jika Anda menggunakan -u .

-g periode
Grafik -g opsi ini untuk digunakan saat memeriksa stempel hashcash dengan -c pilihan dan
menentukan masa tenggang untuk clock skew, yaitu jika cap hashcash datang dengan tanggal di
masa depan atau di masa lalu tidak akan ditolak karena memiliki tanggal futuristik (atau sebagai
kedaluwarsa) kecuali lebih futuristik (atau telah kedaluwarsa lebih lama) dari ini
Titik. Standarnya adalah 2 hari, yang berarti selama jam sistem pengiriman adalah
tidak lebih dari 2 hari ke depan (atau 2 hari di belakang) dari jam sistem penerima, the
cap hashcash akan tetap diterima.

Unit default untuk masa tenggang adalah detik. Akhiran karakter tunggal dapat digunakan
untuk menentukan satuan alternatif (m = menit, h = jam, d = hari, M = bulan, y = Y =
tahun, dan s = detik).

-d Simpan perangko dalam database pengeluaran ganda. Jika cap telah terlihat sebelumnya, itu akan menjadi
ditolak meskipun dinyatakan sah. File database default adalah database.sdb in
direktori saat ini. Hanya prangko yang valid yang akan disimpan dalam database.
Hanya prangko yang sepenuhnya divalidasi yang akan disimpan dalam database, kecuali jika: -y pilihannya adalah
diberikan.

-f nama db
penggunaan nama db alih-alih nama file default untuk basis data pengeluaran ganda.

-p periode
Membersihkan basis data perangko yang kedaluwarsa jika periode waktu yang ditentukan telah berlalu sejak
terakhir kali dibersihkan. Sebagai kemudahan -p sekarang adalah setara dengan -p 0 keduanya
berarti pembersihan sekarang, terlepas dari kapan database terakhir kali dibersihkan.

Jika digunakan dalam kombinasi dengan -j sumber hanya prangko yang dicetak untuk sumber daya yang diberikan
dibersihkan.

Jika digunakan dalam kombinasi dengan -k semua prangko bahkan prangko yang belum kedaluwarsa akan dihapus. Dapat
digunakan dalam kombinasi dengan -t waktu kedaluwarsa seolah-olah waktu saat ini adalah waktu yang diberikan.

-k Gunakan dengan opsi -p untuk meminta semua prangko dibersihkan daripada hanya yang kedaluwarsa.

-j sumber
Gunakan dengan opsi -p untuk meminta agar hanya stempel yang cocok dengan nama sumber daya yang diberikan adalah untuk
dibersihkan, bukan default yang membersihkan semua prangko kadaluarsa. jika
nama sumber daya adalah string kosong, semua perangko cocok (ini setara dengan
menghilangkan -j pilihan).

Perhatikan -E, -M dan -S jenis bendera kecocokan juga berlaku untuk sumber daya yang diberikan dengan -j
sumber bendera.

-s Cetak informasi waktu saja, dan jangan lanjutkan membuat prangko. Jika digabungkan dengan
-b bit bendera cetak perkiraan berapa lama ukuran tabrakan yang diminta akan terjadi
menghitung, jika -s diberikan dengan sendirinya, hanya mencetak kecepatan pencari tabrakan. Untuk mencetak
perkiraan berapa lama jumlah bit default akan digunakan -b kegagalan.

-h Cetak informasi penggunaan singkat.

-v Cetak lebih banyak keluaran informasi verbose tentang pencetakan stempel atau verifikasi. (Jika
-v adalah satu-satunya argumen, mencetak nomor versi alat.)

-V Mencetak nomor versi alat.

-q Modus batch. Tidak mencetak informasi selain keluaran. Opsi ini mengesampingkan -v
.

-X Saat mencetak, cetak header X email hashcash 'X-Hashcash: ' sebelum cap.
Tanpa opsi ini, hanya stempel kosong yang dicetak.

Saat memeriksa, setelah memindai perangko yang diberikan sebagai argumen, pindai stdin untuk garis
dimulai dengan string 'X-Hashcash:', dan menggunakan sisa baris yang cocok sebagai
stempel. Hanya baris hingga dan berakhir pada baris kosong pertama yang dipindai (lihat juga
-i bendera yang dapat digunakan untuk menimpa ini). Garis kosong adalah pemisah yang digunakan untuk
pisahkan header dari badan pesan email atau artikel USENET. Ini dimaksudkan
untuk memudahkan pengiriman pesan email atau artikel USENET ke hashcash di stdin.

-x perpanjangan
String ekstensi yang terdiri dari kumpulan nilai nama. Format ekstensi dijelaskan
di bawah ini di bagian format stempel hashcash. Hal ini memungkinkan pengguna untuk menentukan
ekstensi prangko sendiri yang di-hash ke dalam prangko, diverifikasi oleh penerima bahwa
mendukung mereka, dan diabaikan oleh penerima yang tidak mendukung mereka. Perhatikan ekstensi
mekanisme kait belum diterapkan. Ini akan datang dalam rilis berikutnya.

-i Saat memeriksa dan menggunakan -X bendera, abaikan batas baris kosong antara header
dan isi pesan, dan periksa tabrakan di badan juga jika tidak ditemukan
di header.

-t waktu
Berpura-pura waktu saat ini adalah waktu yang diberikan untuk keperluan pencetakan prangko, verifikasi
perangko dan membersihkan perangko lama dari database. Waktu diberikan dalam format berdasarkan
Format UTCTIME YYMMDD[hhmm[ss]].

Waktu dinyatakan dalam waktu lokal secara default. Gunakan dengan -u bendera untuk memberi waktu di UTC
(WAKTU GREENWICH).

Anda juga dapat memberikan waktu relatif terhadap waktu saat ini dengan mengawali argumen dengan +
atau -. Satuan default untuk waktu relatif adalah detik. Sufiks karakter tunggal dapat
digunakan untuk menentukan satuan alternatif (m = menit, h = jam, d = hari, M = bulan, y =
Y = tahun, dan s = detik).

Catatan: saat waktu dinyatakan dalam waktu lokal, jika ada musim panas di
zona waktu, ada satu atau dua jam ambigu per tahun pada saat perubahan dari
waktu musim panas ke waktu normal.

-u Input dan output waktu absolut dalam UTC (GMT) bukan waktu lokal.

-a periode
Tambahkan (atau kurangi jika angkanya negatif) nilai acak dari waktu saat ini sebelumnya
pencetakan prangko. Ini menyembunyikan waktu pembuatan stempel, yang mungkin berguna untuk
pengguna anonim. Catatan menambahkan (daripada mengurangi) waktu acak mungkin berisiko jika
prangko membutuhkan waktu kurang dari waktu tambahan untuk tiba karena penerima akan menolak prangko
dengan cap waktu di masa depan.

-n Nama sumber daya cetak diuraikan dari cap yang diverifikasi. Mengembalikan kode keluar tidak dicentang pada
keluar.

-l Cetak jumlah detik yang tersisa sebelum prangko kedaluwarsa. Mengembalikan kode keluar tidak dicentang pada
keluar.

Catatan: perhitungan sudah termasuk masa tenggang, jadi bisa sampai 2 kali masa tenggang
lebih lama dari yang mungkin Anda harapkan (jam cepat tetapi sistem harus menganggapnya bisa
menjadi lambat). Jika Anda ingin mengecualikan masa tenggang, tambahkan -g0 untuk mengatur masa tenggang ke 0
untuk perhitungan.

-w Cetak jumlah bit tumbukan cap. Mengembalikan kode keluar yang tidak dicentang saat keluar.

-y Mengembalikan sukses jika cap valid meskipun tidak sepenuhnya diperiksa. Gunakan dengan -c
dimana tidak semua -d, -r ditentukan untuk mendapatkan kode keluar yang berhasil pada valid tetapi sebagian
stempel yang diperiksa. Demikian pula dapat digunakan dengan -n, -l, -w dengan efek yang sama.

-M Saat memeriksa prangko, izinkan wildcard * mencocokkan nama sumber daya untuk membuatnya
lebih mudah untuk menentukan beberapa alamat email dan untuk memungkinkan pencocokan alamat penampung-semua
dan alamat termasuk subdomain. Ini adalah default. Lihat juga -S, -E dan -C

-S Saat memeriksa prangko, gunakan teks sederhana, bandingkan untuk membandingkan nama sumber daya dengan yang ada di
perangko. Lihat juga -M, -E dan -C.

-E Saat memeriksa perangko, gunakan ekspresi reguler untuk menentukan nama sumber daya untuk membuatnya
lebih mudah untuk menentukan beberapa alamat email, alamat penampung-semua, kelas ekstensi
alamat dan alamat termasuk subdomain. Perhatikan sintaks ekspresi reguler adalah POSIX
gaya: karakter khusus tidak perlu dikutip untuk memiliki arti khusus; tetapi
mereka harus dikutip dengan \ ke karakter itu dalam string yang dicari. NS
ekspresi reguler secara otomatis memiliki ^ ditambahkan di awal dan $ ditambahkan di akhir,
jika mereka tidak ditentukan. Karakter khusus ^ cocok dengan awal
sumber daya, dan $ cocok dengan akhir sumber daya.

(Perhatikan bahkan jika dikompilasi dengan ekspresi reguler BSD, sintaks gaya POSIX digunakan; juga
perhatikan ekspresi reguler BSD tidak mendukung rentang {}.)

-C Secara default, sumber daya dikanonikalisasikan ke huruf kecil pada pencetakan dan pemeriksaan. NS
-C flag menimpa ini sehingga sumber daya diperlakukan sebagai peka huruf besar/kecil dalam pemeriksaan,
dan tidak dikanonisasi pada pencetakan.

-P Cetak info kemajuan (jumlah iterasi, iterasi yang diharapkan, persentase selesai, terbaik
ukuran cap ditemukan sejauh ini).

-O inti
Pilih inti hashcash dengan nomor itu. Saat ini 0-9 adalah inti yang valid. Tidak semua inti
bekerja pada semua arsitektur. Misalnya beberapa adalah assembler khusus x86, yang lain khusus PPC
perakit. Jika inti tidak valid, hashcash mengembalikan kegagalan dan menjelaskan apa
terjadi.

-Z n
Kompres stempel. Ini adalah pertukaran waktu vs ruang. Perangko yang lebih besar lebih cepat, tapi
bisa dibilang sedikit jelek. Untuk perangko tercepat (default) gunakan -Z 0; untuk sebagian
perangko terkompresi menggunakan -Z 1; untuk perangko yang sangat terkompresi, tetapi agak lambat gunakan -Z 2.
(Catatan: karena bug yang terlambat ditemukan, -Z2 sama dengan -Z1 untuk saat ini sampai saya dapat memperbaikinya
bahwa.)

CONTOH

membuat perangko

"hashcash -s"
Cetak informasi waktu tentang berapa banyak tabrakan yang dapat dicoba mesin per detik.

"hashcash -sv"
Benchmarking yang lebih akurat tetapi cukup lambat dari pencetakan khusus prosesor yang berbeda
core.

"hashcash -s -b default"
Cetak berapa lama waktu yang dibutuhkan mesin untuk menghitung tabrakan berukuran default (tetapi
tidak benar-benar menghitung tabrakan).

"hashcash -s -b 32"
Cetak berapa lama waktu yang dibutuhkan mesin untuk menghitung tabrakan 32 bit (tetapi jangan
benar-benar menghitung tabrakan).

"hashcash -m"
Cetak perangko. Akan meminta nama sumber daya dan mint dengan nilai default (jumlah
tabrakan bit).

"hashcash -m foo"
Hitung tabrakan pada sumber daya foo. Akan dicetak dengan nilai default (jumlah tabrakan
bit).

"hashcash -m foo -b 10"
Hitung tabrakan 10 bit pada sumber daya foo.

"hashcash -a -3d"
Kurangi waktu acak antara 0 hari dan 3 hari dari waktu pembuatan prangko.
Ini adalah faktor fuzz yang sama yang digunakan oleh mixmaster untuk mengurangi risiko korelasi waktu.

Memeriksa Perangko

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan nilai cap (berapa banyak tumbukan) yang ada. Contohnya adalah
tabrakan 24 bit, yang membutuhkan rata-rata 25 detik untuk dibuat pada P3 4Ghz.

"hashcash -mq -b 10 foo hashcash -w"
Buat stempel dalam mode batch, berikan ke hashcash di stdin untuk memverifikasi, minta dicetak caranya
banyak bit yang ada.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan nama sumber daya dari cap. Nama sumber daya dalam contoh adalah foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Laporkan berapa lama hingga prangko kedaluwarsa jika kedaluwarsa dalam 30 tahun sejak pembuatannya
tanggal. (Perhatikan tanggal terlalu jauh ke masa depan hingga akhir 2038 Epoch, yaitu
analog waktu unix dari bug y2k).

Verifikasi Perangko

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Periksa apakah stempel itu valid. Perhatikan karena kami tidak memeriksa cap dalam pembelanjaan ganda
database, dan tidak menentukan nama sumber daya atau jumlah bit tabrakan yang diperlukan
dan hashcash akan menganggap cap tidak sepenuhnya diperiksa, dan akan melaporkannya sebagai valid
tetapi tidak sepenuhnya dicentang, atau tidak valid jika ada masalah dengan cap.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Periksa apakah nilai cap lebih besar atau sama dengan 24 bit. Contoh ini memiliki 24
nilai bit. Jika Anda menambah jumlah bit yang diminta atau mengganti cap dengan satu
dengan tabrakan kurang dari 24 bit cap akan ditolak.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Seperti di atas, periksa apakah prangko memiliki nilai yang cukup, tetapi sebagai tambahan periksa apakah
nama sumber daya yang diberikan cocok dengan nama sumber daya di cap.

Dua kali lipat Pengeluaran Pencegahan

Contoh yang diberikan dalam "Memverifikasi Stempel" dapat dimodifikasi untuk menyimpan database pengeluaran ganda
sehingga stempel yang sama tidak akan diterima dua kali. Perhatikan bahwa stempel hanya akan didaftarkan
dan ditambahkan ke database jika dinyatakan valid dan diperiksa sepenuhnya (jumlah yang diperlukan dari
bit tabrakan telah ditentukan dan sumber daya telah ditentukan).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Periksa cap dan tambahkan ke basis data pengeluaran ganda jika valid (memiliki sumber daya yang benar
nama dan nilai yang cukup).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Cobalah untuk menghabiskan dua kali lipat prangko. Itu akan ditolak sebagai pembelanjaan ganda.

Cap Kadaluwarsa

Untuk mencegah database pembelanjaan ganda tumbuh tanpa batas, penerima dapat meminta itu
perangko tidak boleh lebih lama dari jangka waktu tertentu. Setelah kedaluwarsa, perangko lama dapat dijatuhkan dari
basis data pembelanjaan ganda karena tidak lagi diperlukan - perangko yang kedaluwarsa dapat ditolak
murni berdasarkan tanggal lama mereka, sehingga ruang yang diambil oleh prangko kedaluwarsa dalam pembelanjaan ganda
database dapat disimpan tanpa risiko menerima cap yang kedaluwarsa meskipun dinyatakan valid.

Kolom ketiga dari stempel adalah waktu UTC sejak 1 Januari 1970. Waktu default
formatnya adalah YYMMDD, waktu dibulatkan ke bawah ke hari terdekat. Masa berlaku default adalah 28
hari.

Anda dapat memberikan periode validitas alternatif dengan -e .

"hashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Coba verifikasi stempel lama, stempel di atas dibuat 11 Agustus 2002.

Kami memberi pilihan -e 2d jadi tanggal kadaluwarsa perangko adalah 2 hari setelah pembuatan, yaitu sekarang
di masa lalu.

Catatan: jika waktu pembuatan dinyatakan dalam stempel dalam hari, maka pembuatan yang tepat
tanggal adalah awal dari hari yang ditentukan dalam waktu UTC (sama untuk unit alternatif
waktu pembuatan dibulatkan ke bawah ke awal unit yang dinyatakan dalam).
Untuk unit dalam hari, misalnya, ini mungkin berarti tergantung pada zona waktu Anda bahwa
cap tampaknya dianggap tidak valid di bawah periode kedaluwarsa yang ditentukan dalam beberapa hari
relatif terhadap pandangan relatif Anda tentang hari apa, karena perhitungan didasarkan pada
waktu saat ini dalam UTC, dan waktu pembuatan cap dinyatakan dalam waktu UTC.

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Uji apakah stempel itu valid, selain telah kedaluwarsa. Menghilangkan -e
memberitahu hashcash bahwa cap tidak akan pernah kedaluwarsa. Masa kadaluarsa selamanya juga bisa
diberikan secara eksplisit seperti ini: -e 0, di mana periode kedaluwarsa 0 berarti selamanya.

Membersihkan tua perangko

Jika -c, -d opsi digunakan bersama-sama, setiap kali cap dicentang, apakah itu valid dan
semua aspek wajib stempel diverifikasi (pemeriksaan bit tabrakan, sumber daya
cek nama) kemudian cap dan masa kadaluwarsanya ditulis ke file database. NS
periode kedaluwarsa default jika periode kedaluwarsa tidak diberikan secara eksplisit dengan -e pilihannya adalah 28
hari (yaitu perangko berakhir setelah 4 minggu).

Mint pertama dan kemudian tambahkan perangko:

"hashcash -m -b 10 foo -e 1m > cap"
Catatan: kami menentukan kedaluwarsa pada pencetakan dalam contoh ini, untuk memastikan bahwa cap
waktu pembuatan diberikan dalam resolusi yang cukup tinggi di stempel sehingga stempel tidak akan
dianggap kadaluarsa pada saat pembuatan. (Ingat resolusi default dalam hari,
prangko yang dibuat dengan waktu pembuatan yang dibulatkan ke awal hari adalah
tidak mungkin dianggap valid 1 menit kemudian kecuali Anda mencetaknya pada tengah malam UTC
waktu.)

"hashcash -cd -e 1m -b 10 -r foo < cap"
Perangko akan kedaluwarsa dalam 1 menit. Tunggu 1 menit dan kemudian secara eksplisit meminta yang kedaluwarsa
perangko dibersihkan:

"hashcash -p sekarang"
Kemudian coba kirim ulang stempel yang sama:

"hashcash -cd -e 1m -b 10 -r foo < cap"
dan stempel akan tetap ditolak karena telah kedaluwarsa, yang menggambarkan mengapa tidak
diperlukan untuk menyimpan cap ini dalam database.

Dengan database default (format sdb) isi database dapat dibaca manusia,
sehingga Anda dapat melihat isinya dengan memasukkannya ke terminal:

"cat hashcash.sdb"
untuk melihat bahwa cap benar-benar ditambahkan dan kemudian setelah dibersihkan kemudian dibersihkan karena
kadaluwarsa.

Membersihkan tua perangko on Permintaan

Untuk kenyamanan Anda dapat membersihkan sekaligus memeriksa prangko dengan menggunakan -p Option
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. -c .

"hashcash -m -b 10 foo > cap"
"hashcash -cd -p sekarang -e 1 -b 10 -r foo < cap"
Mungkin tidak efisien untuk membersihkan perangko pada setiap penggunaan karena seluruh database harus
scan untuk perangko kadaluarsa. Dengan memberikan jangka waktu kepada -p pilihan, Anda bisa tahu
"hashcash" untuk membersihkan tidak lebih sering dari periode waktu tersebut sejak pembersihan sebelumnya.

Sebagai contoh:

"hashcash -cd -p 1d -e 1 -b 10 -r foo < cap"
memberitahu "hashcash" untuk membersihkan perangko yang kadaluwarsa tidak lebih dari sekali per hari.

"hashcash -p 1M -j foo"
memberitahu "hashcash" untuk membersihkan hanya perangko kadaluarsa yang cocok dengan sumber daya foo sekali per bulan.

"hashcash -p sekarang -k"
memberitahu "hashcash" untuk membersihkan semua prangko (kedaluwarsa dan belum kedaluwarsa) sekarang.

cap format (Versi: kapan 1)

Format prangko saat ini adalah versi 1. Alat ini dapat memverifikasi prangko hashcash versi 0
juga, tetapi perangko versi 0 tidak lagi dibuat karena sedang dihapus demi
format stempel v1 yang lebih dapat diperluas.

ver:bit:tanggal:sumber:[ext]:baris:melawan

dimana

ver = 1
bit = berapa bit tumbukan parsial yang diklaim dimiliki oleh stempel
tanggal = YYMMDD[hhmm[ss]]
sumber = string sumber daya (misalnya alamat IP, alamat email)
ext = ekstensi -- diabaikan dalam versi saat ini
Format ekstensi:

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Perhatikan nilai juga dapat berisi =. Contoh ekstensi (bukan yang asli):

name1=2,3;name2;name3=var1=2,var2=3,2,val

Yang akan menjadi ekstensi name1 memiliki nilai 2 dan 3; ekstensi name2 tidak memiliki nilai;
ekstensi name3 memiliki 3 nilai "var1=2", "var2=3", "2" dan "val". hashcash
ekstensi dapat menginterpretasikan nilai-nilai yang dianggap cocok misalnya "var1=2" bisa menjadi nilai
dari opsi untuk nama ekstensi3.

baris = string karakter acak dari alfabet a-zA-Z0-9+/= untuk menghindari tabrakan dengan
perangko pengirim lain
melawan = untuk menemukan cap dengan jumlah bit tumbukan yang diinginkan perlu mencoba banyak
string yang berbeda penghitung ini bertambah pada setiap percobaan. Penghitung juga terdiri dari
karakter dari alfabet a-zA-Z0-9+/=. (Perhatikan bahwa implementasi tidak diperlukan untuk
menghitung secara berurutan).

Gunakan hashcash online menggunakan layanan onworks.net