hashcash - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

hashcash - засіб проти спаму/відмови в обслуговуванні хешкешу

СИНТАКСИС

м'ята (створити) марки:

хеш-шаш -m [ [ опції ] [ ресурс ...] ... ]

перевірити марки:

хеш-шаш -c [ [ опції ] -r ресурс ...] [ друк ...]

швидкість кошторис:

хеш-шаш -s [ опції ] [ -b біти ]

Частка база даних:

хеш-шаш -p зараз [ -j ресурс ] [ -k ] [ -t час ] [ -u ]

Рахувати зіткнення біти:

хеш-шаш -w [ опції ] [ друк ...]

отримати ресурс Назва:

хеш-шаш -n [ опції ] [ друк ...]

отримати час решті до термін дії

хеш-шаш -l [ опції ] -e period [ друк ...]

ОПИС

Hashcash — це засіб боротьби з відмовою в обслуговуванні. Його головне поточне використання – допомога
Користувачі hashcash уникають втрати електронної пошти через антиспам на основі вмісту та чорного списку
систем.

Інструмент hashcash дозволяє створювати штампи хешкешу, щоб прикріплювати їх до електронних листів, які ви надсилаєте, та
для перевірки штампів хеш-кеш, доданих до електронних листів, які ви отримуєте. Відправники електронної пошти вкладають хешкеш
марки із заголовком X-Hashcash:. Заохочуються постачальники та автори засобів боротьби зі спамом
щоб виключити пошту, надіслану з хеш-кешом, зі своїх чорних списків і правил фільтрації на основі вмісту.

Хеш-штамп є підтвердженням виконання робіт, яке вимагає параметризованого обсягу роботи
обчислити для відправника. Одержувач може ефективно перевірити отримані марки.

Функція підтвердження роботи хешкешу полягає в обчисленні часткових колізій хешування (хеш SHA1
використовується функція). Вибравши кількість бітів зіткнення, робота, необхідна для
обчислити зіткнення можна як завгодно дорого - від часток секунди до
хвилин або годин. Перевірка ефективна і вимагає однакових невеликих витрат
розмір зіткнення.

Для більш детального обговорення інших програм хешкеш був використаний для див
http://www.hashcash.org/

ВИКОРИСТАННЯ ПРИМІТКИ

На цій довідковій сторінці ім’я ресурсу — це назва служби або адреса, за якою є штамп
створений для. У випадку електронної пошти ім’ям ресурсу є адреса електронної пошти одержувача
форма [захищено електронною поштою].

Карбування марок

Команда -m прапор повинен бути даний для карбування марки.

Ім’я ресурсу (адреса електронної пошти одержувача), для якого потрібно карбувати штамп, може передаватися як
аргумент, або, якщо його пропущено, читається зі стандартного входу. Якщо stdin є tty, користувачу буде запропоновано, якщо
stdin - це канал, ім'я ресурсу просто мовчки зчитується. Бажаний розмір зіткнення може
вказується за допомогою параметра -b. Якщо розмір колізії не вказано, за замовчуванням буде 20
біти. Дивіться також -b дефолт варіант.

Перевірка марок

Команда -c необхідно надати прапор для перевірки терміну дії марок. Штамп для перевірки можна надати як
аргумент до "hashcash". Якщо штамп не надано, штамп зчитується із стандартного входу. Якщо stdin є a
tty користувачу буде запропоновано, якщо stdin є каналом, штамп просто читається мовчки. А
Ім’я ресурсу (адреса електронної пошти одержувача) можна вказати разом із -r варіант. Якщо
Ім’я ресурсу дається, ім’я ресурсу порівнюється з ім’ям ресурсу в штампі, якщо
вони не збігаються, штамп відхиляється.

Примітка: якщо ім’я ресурсу не вказано, штамп все одно перевіряється, щоб перевірити, чи інакше
дійсний, але його можна карбувати для іншого ресурсу, що дозволить використовувати марки
повторно використовується на різних ресурсах, тому hashcash повертає неперевірений код виходу під час виходу.

Марки за замовчуванням вважаються дійсними протягом 28 днів. Термін дії може бути
змінено за допомогою -e прапор

Якщо штамп закінчився або має дату в майбутньому, штамп відхиляється та програма
негайно виходить.

Якщо вказано необхідний розмір зіткнення з -b прапорець обчислюється значення штампів і
порівняно, якщо штамп має недостатнє значення, він відхиляється, і програма завершує роботу
негайно. Якщо -b прапор не подається, штамп перевіряється, чи інакше
дійсний, але hashcash повертає неперевірений код виходу під час виходу.

Якщо штамп витрачено подвійно, марка відхиляється. Подвійний захист витрат
більш детально розглянуто нижче в «Захист подвійних витрат». Якщо подвійні витрати
захист не ввімкнено, штамп може бути витрачений подвійно, тому хешкеш повернуться
неперевірений код виходу (код виходу 2) під час виходу.

Команда -w прапор може використовуватися для запиту на підрахунок кількості бітів зіткнення
і відображається. The -n прапор може використовуватися для запиту, щоб назва ресурсу в штамп була
розібрати та відобразити. The -l прапор може використовуватися для запиту кількості секунд до
закінчення терміну дії штампа виводиться.

Програма поверне коди виходу дійсні або недійсні, лише якщо -c використовується прапор -b
використовується прапор, -d, -r ресурс використовуються. Це мінімальний набір необхідних параметрів
повністю перевірити дійсність штампа. Якщо ці критерії не будуть дотримані, програма буде
повернути код виходу без прапорця (код виходу 2) під час виходу. (Див. також -y прапор.)

подвійний Витрати захист

Якщо -d прапорець використовується при перевірці марок, ведеться база витрачених марок.

За замовчуванням термін дії марок закінчується через 28 днів, без закінчення терміну дії база даних буде зростати
невизначено. Ви можете вказати альтернативний термін дії за допомогою -e прапор. Файл
рекомендований (і за замовчуванням) термін дії електронної пошти становить 28 днів. Після закінчення терміну придатності
Через певну кількість часу штамп все одно вважається простроченим і може бути видалено з бази даних
щоб заощадити простір. (Див. «Періодичне очищення та при наступному доступі», щоб дізнатися, як очищати штампи.)

З міркувань ефективності штамп перевіряється перед його перевіркою в базі даних; якщо це
інакше недійсна діяльність з базою даних не відбуватиметься.

Примітка. Рішення про те, як довго штамп вважати дійсним, приймається
верифікатор. Якщо він занадто короткий, для деяких застосувань штамп буде можливим
термін дії закінчується до прибуття до одержувача (наприклад, за допомогою електронної пошти). Рекомендована вартість 28 днів
має бути безпечним для звичайних затримок доставки електронної пошти. Вибір – це компроміс між
розмір бази даних і ризик закінчення терміну дії до прибуття, і залежить від програми.

Примітка. Різні марки в одній базі даних можуть мати різні терміни дії, тому для
можна зберігати приклади штампів для різних ресурсів з різними термінами дії
ту саму базу даних, або одержувач може змінити термін дії майбутніх марок
без впливу на термін дії старих штампів.

Чистка Періодично vs on МАЙБУТНІ доступу

Щоб періодично очищати старі марки під час перевірки штампів, використовуйте -p period можливість очищення
не раніше зазначеного періоду часу з моменту останньої чистки. Очищення можна використовувати з
-k можливість очищення марок, термін дії яких не закінчився, і з -j ресурс прапорець лише для очищення
марки для даного ресурсу.

Існують обставини, коли видаляти штампи під час наступного доступу може бути незручно,
наприклад, якщо існує велика база даних подвійних витрат, очищення якої потребує певного часу, і
час відгуку хешкеш-чекера важливий. Щоб уникнути цієї проблеми, продуйте
можна зробити окремо, використовуючи лише -p зараз можливість запитати лише операцію очищення.
Наприклад, у Unix ви можете викликати "hashcash -p зараз" у завданні cron один раз на день або на
попит, коли диск закінчився.

швидкість оцінки

Команда -s прапорець запитує вимірювання кількості зіткнень, які можна перевірити за секунду. Немає
штамп відкарбований або перевірений.

Якщо -b прапорець використовується з цією опцією, замість того, щоб оцінити кількість секунд
розраховується карбування марки заданого розміру в бітах. Щоб дізнатися, скільки часу
буде потрібно карбувати штамп стандартного розміру -s -b дефолт.

примітки

Вся інформація друкується на stderr. Викарбувані марки, результати марок
перевірка та час друкуються на стандартному виводі. Тихий прапор -q пригнічує все
інформаційний вихід. The -v прапорець запитує більше інформації. Запитуваний
вихід, який є єдиною інформацією, яка виводиться в тихому режимі (коли -q вказано)
друкується на стандартному виході. Якщо стандартний вихід є каналом або коли діє тихий режим, то
вихід друкується без опису (тобто лише біти, лише секунди, лише ресурс).

ВАРІАНТИ

-c Перевірте інформацію про закінчення терміну дії штампів, надану як аргумент або на стандартний номер. (Використовуйте з
-b, -d та -r ресурс для повної перевірки штампів).

-m Монтажні штампи з ресурсами, наданими як аргументи або на стандартному DIN.

-b біти
При карбуванні марки створіть зіткнення принаймні з такої кількості бітів. При перевірці а
stamp вимагають, щоб він мав зіткнення як мінімум з такою кількістю бітів, інакше відхиляється
це. Якщо опущено, використовується значення за замовчуванням.

Під час перевірки марок вимагайте, щоб у штампах було стільки бітів.

Кількість бітів за замовчуванням можна вказати за допомогою -b дефолт. Біти відносно
за замовчуванням також можна вказати за допомогою -b +n на n біт більше, ніж за замовчуванням і -b -n
на n біт менше, ніж за замовчуванням.

-b дефолт, -b +0 та -b -0 всі еквівалентні.

Під час виконання тесту на швидкість -s, можна вимірювати швидкість маркера за замовчуванням за допомогою -s -b
дефолт.

-r ресурс
Під час карбування марок вкажіть ім’я ресурсу (адреса електронної пошти одержувача), щоб карбувати штамп
проти може бути подано або з -r ресурс або як аргумент «хешкешу».

Під час перевірки штампів ім’я ресурсу (ваша власна адреса електронної пошти) вказується разом із -r
варіант. Якщо вказано ім’я ресурсу, воно звіряється з ім’ям ресурсу в файлі
штамп, а якщо вони не збігаються, штамп відхиляється. Зверніть увагу, чи є ім’я ресурсу
не надано, марки для інших ресурсів будуть прийняті, а отже, хешкеш
повертає код виходу без прапорця (код виходу 2) під час виходу.

-o Під час перевірки штампів можна надати кілька ресурсів. За замовчуванням ресурси є
просто перевіряли один за одним, поки не буде знайдено відповідний дійсний ресурс. Однак коли ви
використовуйте символи підстановки або регулярні вирази (див -E), корисно мати можливість вказати це
один ресурс замінює інший. Наприклад, це: -б15 -r [захищено електронною поштою] -o -б10
*@dev.null вказує, що пошта на адресу [захищено електронною поштою] вимагає 15 біт, але поштою до
*@dev.null вимагає лише 10 біт. Якщо ми пропустили -o перевизначити відносини між
для двох ресурсів для адреси буде прийнято 10 біт [захищено електронною поштою]
оскільки за першим правилом його буде відхилено як недостатньо бітів,
це буде прийнято відповідно до 2-го правила. The -o Опція дозволяє уникнути цієї проблеми.

-e час
Термін придатності витрачених марок. Під час перевірки штампів (за допомогою -c прапор), якщо
марка була викарбувана більше зазначеного часу тому, вона вважається простроченою.
Якщо цей параметр не використовується, за замовчуванням термін дії марок закінчується через 28 днів. Термін придатності
за замовчуванням задається в секундах (аргумент 0 означає назавжди). Один символ
суфікс можна використовувати для визначення альтернативних одиниць (m = хвилини, h = години, d = дні, M =
місяців, y = Y = роки і s = секунди).

Якщо використовується з -d варіант, відпрацьована марка та термін її дії фіксуються в
бази даних. Див -p опція для опису того, як видалити штампи з бази даних.

Під час карбування марок, в -e прапор може вплинути на роздільну здатність створеного часу
в марці. Без -e параметр, роздільна здатність за замовчуванням — дні (формат часу:
РРММДД). Альтернативні формати, засновані на діапазоні терміну придатності:

Під час карбування ви також можете вказати явну ширину часу за допомогою -z натомість варіант.
(-z перевизначає -e якщо дано обидва. Якщо жоден із них не вказано, за замовчуванням буде 6 символів (час
формат: РРММДД)).

Правила автоматичного визначення відповідної часової ширини від -e якщо ні -z варіант
надано:

* період >= 2 роки, тоді використовується формат часу YY з округленням до найближчого року
почати;
* 2 роки < період <= 2 місяці, тоді використовується формат часу РРММ з округленням до значення
найближчий початок місяця;
* 2 місяці < період <= 2 дні, потім використовується формат часу РРММДД з округленням до
початок найближчого дня;
* 2 дні < період <= 2 хвилини, потім використовується формат часу РРММДДгчхм з округленням до
початок найближчої хвилини;
* період < 2 хвилини, тоді формат часу YYMMDDhhmmss використовується в секундах.

Зауважте, що округлення в меншу сторону здійснюється за часом UTC, а не за місцевим часом. Це може призвести до
спочатку дивовижні результати при округленні до, наприклад, днів у часових поясах, відмінних від GMT
(UTC = GMT). Це може бути зрозумілішим, якщо ви використовуєте -u варіант.

-z ширина
Команда -z Опція призначена для використання під час карбування та дозволяє користувачеві вибрати ширину ширини часу
поле. Дивіться також -e варіант надається в поєднанні з -m щоб вказати неявний
Ширина поля часу під описом -e прапор. Допустимі значення ширини: 6,10 або 12
символи, що відповідають відповідно: YYMMDD, YYMMDDhhmm і YYMMDDhhmmss, округлені в меншу сторону
до найближчого дня або хвилини відповідно.

Зауважте, що округлення в меншу сторону здійснюється за часом UTC, а не за місцевим часом. Це може призвести до
спочатку дивовижні результати при округленні до, наприклад, днів у часових поясах, відмінних від GMT
(UTC = GMT). Це може бути зрозумілішим, якщо ви використовуєте -u варіант.

-g period
Команда -g Ця опція використовується під час перевірки хеш-штампів за допомогою -c опція і
визначає пільговий період для перекосу годинника, тобто якщо приходить штамп хеш-касу з датою в
майбутнє чи минуле не буде відхилено як футуристична дата (або як
термін дії закінчився), якщо тільки він не є більш футуристичним (або термін його дії закінчився довше), ніж цей
період. За замовчуванням встановлено 2 дні, тобто стільки, скільки працює годинник системи-відправника
не більше ніж на 2 дні раніше (або на 2 дні позаду) годинника системи приймання,
штамп хеш-готівки все одно буде прийнято.

Одиницями за замовчуванням для пільгового періоду є секунди. Можна використовувати суфікс одного символу
щоб вказати альтернативні одиниці (m = хвилини, h = години, d = дні, M = місяці, y = Y =
роки, а s = секунди).

-d Зберігайте марки в базі даних подвійних витрат. Якщо штамп бачили раніше, він буде
відхилено, навіть якщо воно є дійсним. Файлом бази даних за замовчуванням є база даних.sdb in
поточний каталог. Тільки в іншому випадку дійсні штампи зберігатимуться в базі даних.
У базі даних зберігатимуться лише повністю перевірені штампи, за винятком випадків -y опція
дано.

-f dbname
Скористайтесь dbname замість імені файлу за замовчуванням для бази даних подвійних витрат.

-p period
Очищає базу даних марок, термін придатності яких закінчився, якщо з моменту минув заданий період часу
минулого разу його очищали. Як зручність -p зараз еквівалентна -p 0 обидва з яких
середнє очищення зараз, незалежно від того, коли база даних була очищена востаннє.

Якщо використовувати в поєднанні з -j ресурс тільки марки, викарбувані для даного ресурсу
очищаються.

Якщо використовувати в поєднанні з -k усі марки, навіть марки, термін дії яких не закінчився, очищаються. Може бути
використовується в поєднанні з -t час закінчитися так, як ніби поточний час є заданим часом.

-k Використовуйте з опцією -p щоб попросити видалити всі марки, а не лише прострочені.

-j ресурс
Використовуйте з опцією -p щоб попросити, щоб лише штампи, що збігаються з даною назвою ресурсу
бути очищені, а не за замовчуванням, яке передбачає очищення всіх марок, термін дії яких закінчився. Якщо
ім'я ресурсу є порожнім рядком, усі штампи збігаються (це еквівалентно
опускаючи -j варіант).

Зверніть увагу на -E, -M та -S тип прапорів відповідності також застосовується до ресурсів, наданих з -j
ресурс прапор

-s Роздрукуйте лише інформацію про час і не створюйте штамп. Якщо поєднується з
-b біти flag print оцінка того, як довго триватиме запитуваний розмір колізії
обчислити, якщо -s заданий сам по собі, просто виводить швидкість пошуку зіткнень. Друкувати
оцінка того, як довго буде використовуватися кількість бітів за замовчуванням -b дефолт.

-h Роздрукуйте коротку інформацію про використання.

-v Надрукуйте більш детальну інформацію про карбування чи перевірку штампа. (Якщо
-v є єдиним аргументом, виводить номер версії інструмента.)

-V Друкує номер версії інструмента.

-q Пакетний режим. Не друкує жодної інформації, крім вихідної інформації. Цей параметр замінює -v
варіант.

-X Під час карбування друкує X-заголовок електронної пошти хешкешу «X-Hashcash:» перед штампом.
Без цієї опції друкується лише голий штамп.

Під час перевірки, після сканування штампів, наведених як аргументи, сканує stdin на наявність рядків
починаючи з рядка 'X-Hashcash:', і використовує решту відповідного рядка як
штамп. Скануються лише рядки, які закінчуються першим порожнім рядком (див
-i прапор, який можна використовувати, щоб змінити це). Порожній рядок є роздільником, який використовується
відокремте заголовки від тіла повідомлення або статті USENET. Це мається на увазі
щоб було зручно передавати повідомлення електронної пошти або статтю USENET для хешкешування на стандартний ідентифікатор.

-x розширення
Рядок розширення, що складається з наборів значень імені. Описано формат розширення
нижче в розділі про формат хеш-штампів. Це дозволяє користувачам визначати їх
власні розширення марок, які хешуються в штамп, перевірені одержувачами, що
підтримують їх і ігнорують одержувачами, які їх не підтримують. Зверніть увагу на розширення
механізм гачка ще не реалізований. Це буде в наступному випуску.

-i При перевірці та використанні -X прапорець, ігноруйте порожню межу рядка між заголовками
і тіло повідомлення, а також перевірте наявність зіткнення в тілі, якщо його не знайдено
у заголовках.

-t час
Уявіть, що поточний час – це час, призначений для карбування марок, перевірки
марок і видалення старих штампів з бази даних. Час подається у форматі на основі
Формат UTCTIME YYMMDD[hhmm[ss]].

За замовчуванням час виражається за місцевим часом. Використовуйте з -u прапорець, щоб задати час у UTC
(GMT).

Ви також можете вказати час відносно поточного, додавши до аргументу префікс +
або -. Типовими одиницями відносного часу є секунди. Суфікс одного символу може
використовуватися для визначення альтернативних одиниць (m = хвилини, h = години, d = дні, M = місяці, y =
Y = роки і s = секунди).

Примітка: коли час виражається за місцевим часом, якщо у вас є літній час
часового поясу, є одна або дві неоднозначні години на рік на момент зміни від
літній час на звичайний час.

-u Введіть і виведіть абсолютний час у UTC (GMT) замість місцевого часу.

-a period
Додайте (або відніміть, якщо число від’ємне) випадкове значення з попереднього поточного часу
карбування марки. Це приховує час створення штампа, що може бути корисним для
анонімні користувачі. Зауважте, що додавання (а не віднімання) випадкового часу може бути ризикованим, якщо
штамп приходить менше, ніж доданий час, оскільки одержувач відхилить марки
з мітками часу в майбутньому.

-n Ім’я ресурсу друку розібрано з штампа, що перевіряється. Повертає код виходу без прапорця
ВХІД.

-l Роздрукуйте кількість секунд, що залишилося до закінчення терміну дії штампа. Повертає код виходу без прапорця
ВХІД.

Примітка: розрахунок включає пільговий період, тому пільговий період може бути збільшений до 2 разів
довше, ніж ви могли б очікувати (швидкий годинник, але система повинна припустити, що це може
будь повільним). Якщо ви хочете виключити пільговий період, додайте -g0 встановити пільговий період на 0
для розрахунку.

-w Надрукувати кількість бітів зіткнення штампа. Повертає код виходу, який не встановлено під час виходу.

-y Повертає успіх, якщо штамп дійсний, навіть якщо він не повністю перевірений. Використовуйте з -c
де не всі -d, -r вказано, щоб отримати код успішного виходу на дійсний, але частковий
перевірений штамп. Аналогічно можна використовувати з -n, -l, -w з таким же ефектом.

-M Під час перевірки штампів дозвольте підстановку * відповідність у назві ресурсу, щоб зробити це
простіше вказати кілька адрес електронної пошти та дозволити відповідність адресам, що охоплюють усі
та адреси, включаючи субдомени. Це значення за замовчуванням. Дивись також -S, -E та -C

-S Під час перевірки штампів використовуйте простий текст порівняння, щоб порівняти назви ресурсів з тими, що в
марки. Дивись також -M, -E та -C.

-E Під час перевірки штампів використовуйте регулярні вирази, щоб вказати імена ресурсів, щоб зробити це
простіше вказати кілька адрес електронної пошти, загальнодоступних адрес, класів розширення
адреси та адреси, включаючи субдомени. Зауважте, що синтаксис регулярного виразу – POSIX
стиль: спеціальні символи не потрібно вводити в лапки, щоб мати своє особливе значення; але
вони мають бути в лапках \ до цього символу в рядку пошуку. The
регулярний вираз автоматично додає ^ на початку і $ додається в кінці,
якщо вони не вказані. Спеціальні символи ^ відповідають початку
resouce, а $ відповідає кінця ресурсу.

(Зауважте, що навіть якщо скомпільовано з регулярними виразами BSD, використовується синтаксис стилю POSIX; також
зауважте, що регулярні вирази BSD не підтримують діапазони {}.)

-C За замовчуванням ресурси канонізовані до нижнього регістру під час карбування та перевірки. The
-C прапорець перевизначає це, щоб ресурси розглядалися як чутливі до регістру під час перевірки,
і не канонізований на карбуванні.

-P Інформацію про хід друку (кількість ітерацій, очікувані ітерації, відсоток виконання, найкраще
розмір марки, знайдений на даний момент).

-O ядро
Виберіть хешкеш-ядро з цим номером. Наразі 0-9 є дійсними ядрами. Не всі ядра
працювати над усіма архітектурами. Наприклад, деякі є спеціальними для x86 ассемблерами, інші специфічними для PPC
монтажник. Якщо ядро ​​недійсне, хешкеш повертає помилку та пояснює, що
сталося.

-Z n
Стисніть штамп. Це компроміс між часом і простором. Більші марки швидше, але
можливо, трохи потворний. Для найшвидших штампів (за замовчуванням) використовуйте -Z 0; для частково
стиснені марки використовують -Z 1; для дуже стиснутих, але дещо повільних штампів використовуйте -Z 2.
(Примітка: через пізно виявлену помилку, -Z2 наразі такий самий, як -Z1, поки я не зможу виправити
це.)

ПРИКЛАДИ

створення марок

"hashcash -s"
Роздрукуйте інформацію про час, скільки зіткнень машина може спробувати за секунду.

"hashcash -sv"
Більш точний, але досить повільний бенчмаркінг різних процесорів
сердечники.

"hashcash -s -b за замовчуванням"
Надрукуйте, скільки часу знадобиться машині, щоб обчислити зіткнення розміру за замовчуванням (але
насправді не обчислюйте зіткнення).

"hashcash -s -b 32"
Роздрукуйте, скільки часу знадобиться машині, щоб обчислити 32-розрядну колізію (але не
фактично обчислити зіткнення).

"hashcash -m"
Викарбувати марку. Запропонує ввести назву ресурсу та монетний двір із значенням за замовчуванням (кількість
біти зіткнення).

"hashcash -m foo"
Обчислити зіткнення на ресурсі foo. Буде карбувати зі значенням за замовчуванням (кількість зіткнень
біти).

"hashcash -m foo -b 10"
Обчисліть 10-бітну колізію на ресурсі foo.

"hashcash -a -3d"
Від часу створення штампа відніміть випадковий час від 0 до 3 днів.
Це той самий коефіцієнт fuzz, який використовується mixmaster для зниження ризику тимчасових кореляцій.

Вивчення Марки

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Повідомте значення штампа (скільки бітів зіткнення). Приклад є
24-розрядне зіткнення, створення якого займає в середньому 25 секунд на 3Ghz P4.

"hashcash -mq -b 10 foo ⎪ hashcash -w"
Створіть штамп у пакетному режимі, перейдіть до hashcash на stdin, щоб перевірити, надрукуйте як
було багато шматочків.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Повідомте назву ресурсу зі штампа. Ім’я ресурсу в прикладі – foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Повідомте, скільки часу до закінчення терміну дії марки, якщо вона закінчується через 30 років з моменту її створення
дата. (Зверніть увагу, що дати надто далекого майбутнього переходять до кінця епохи 2038 року, тобто
аналог часу unix помилки y2k).

Перевірка Марки

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Перевірте, чи штамп дійсний. Зауважте, що ми не перевіряємо штамп у подвійних витратах
бази даних і не вказав ім’я ресурсу чи необхідну кількість бітів колізії
і hashcash вважатиме штамп не повністю перевіреним, і повідомить його як дійсний
але не повністю знято, або як недійсне, якщо є якісь проблеми зі штампом.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Перевірте, чи значення штампа більше або дорівнює 24 бітам. У цьому прикладі 24
бітове значення. Якщо ви збільшите потрібну кількість бітів або заміните штамп на один
при зіткненні менше ніж 24 біт штамп буде відхилено.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Як зазначено вище, перевірте, чи має штамп достатню цінність, але додатково перевірте, чи є штамп
вказана назва ресурсу відповідає назві ресурсу в штампі.

подвійний Витрати Попередження

Приклади, наведені в розділі "Перевірка штампів", можна змінити, щоб зберегти базу даних подвійних витрат
так що один і той же штамп не буде прийнятий двічі. Зауважте, що штамп буде зареєстровано
і додано до бази даних, якщо вона дійсна й повністю перевірена (необхідна кількість
вказано біти колізії та вказано ресурс).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Перевірте штамп і додайте його в базу даних подвійних витрат, якщо вона дійсна (має правильний ресурс
назва та достатня вартість).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Спробуйте витратити марку вдвічі. Це буде відхилено як подвійне витрати.

Друк Термін дії

Щоб запобігти постійному зростанню бази даних подвійних витрат, одержувач може запитати це
марки бути не старшими за визначений період. Після закінчення терміну дії старі марки можна викинути
базу даних подвійних витрат, оскільки вони більше не знадобляться – прострочені штампи можуть бути відхилені
виходячи виключно з їх старої дати, тому місце, зайняте простроченими марками, у подвійному витрачають
базу даних можна зберегти без ризику прийняти прострочений, хоча в іншому випадку дійсний штамп.

Третє поле штампа – це час UTC з 1 січня 1970 року. Час за замовчуванням
формат РРММДД, час округлено до найближчого дня. Період дії за замовчуванням – 28
днів.

Ви можете вказати альтернативний термін дії за допомогою -e варіант.

"hashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Спробуйте перевірити старий штамп, наведений вище штамп було створено 11 серпня 2002 року.

Ми дали варіант -e 2d тож термін придатності марок – 2 дні після створення, який зараз
в минулому.

Примітка: якщо час створення зазначено у штампі в днях, точне створення
дата – це початок вказаного дня за UTC (аналогічно для альтернативних одиниць
час створення округлюється до початку одиниці, в якій вона виражена).
Для одиниць у днях, наприклад, це може означати залежно від вашого часового поясу
штамп вважається недійсним протягом зазначеного терміну дії в днях
відносно вашого відносного уявлення про те, який сьогодні день, на основі розрахунку
поточний час у UTC, а час створення штампа виражається в часі UTC.

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Перевірте, чи є штамп дійсним іншим чином, окрім терміну його дії. Пропускаючи -e
повідомляє hashcash, що штамп ніколи не закінчиться. Термін дії назавжди також може
бути надано так чітко: -e 0, де термін дії 0 означає назавжди.

Чистка старий марок

Якщо -c, -d параметри використовуються разом, щоразу, коли перевіряється штамп, якщо він дійсний і
всі обов’язкові аспекти штампу перевіряються (перевірка бітів зіткнення, ресурс
перевірка імені), потім штамп і термін його дії записуються у файл бази даних. The
Термін дії за замовчуванням, якщо термін дії не вказано явно з -e варіант 28
днів (тобто термін дії марок закінчується через 4 тижні).

Спочатку карбуйте, а потім додайте штамп:

"hashcash -m -b 10 foo -e 1m > stamp"
Примітка: у цьому прикладі ми вказали термін дії карбування, щоб переконатися, що штамп
Час створення наведено у штампі з достатньо високою роздільною здатністю, що штамп не буде
вважати простроченими на момент створення. (Пам’ятайте, що роздільна здатність за замовчуванням визначається днями,
штамп, створений із часом створення, округленим до початку дня
навряд чи буде вважатися дійсним через 1 хвилину, якщо ви не відкарбуєте його опівночі UTC
час.)

"hashcash -cd -e 1m -b 10 -r foo < stamp"
Термін дії марки закінчується через 1 хвилину. Зачекайте 1 хвилину, а потім явно запитайте, що термін дії закінчився
марки бути очищені:

"hashcash -p зараз"
Потім спробуйте повторно надіслати той самий штамп:

"hashcash -cd -e 1m -b 10 -r foo < stamp"
і штамп все одно буде відхилено, оскільки термін його дії закінчився, що пояснює, чому це не так
необхідно зберегти цей штамп у базі даних.

З базою даних за замовчуванням (формат sdb) вміст бази даних читається людиною,
тож ви можете переглянути їх вміст, підключивши їх до терміналу:

"cat hashcash.sdb"
щоб побачити, що штамп дійсно додається, а потім після очищення згодом очищається через
закінчення терміну дії.

Чистка старий марок on Попит

Для зручності ви можете очищати одночасно з перевіркою штампів за допомогою -p варіант
з -c варіант.

"hashcash -m -b 10 foo > штамп"
"hashcash -cd -p now -e 1 -b 10 -r foo < stamp"
Може бути неефективним очищати штампи під час кожного використання, оскільки має бути вся база даних
відскановано на наявність прострочених марок. Надаючи період часу для -p варіант, можете сказати
"hashcash", щоб очищати не частіше, ніж цей період часу з моменту попереднього очищення.

Наприклад:

"hashcash -cd -p 1d -e 1 -b 10 -r foo < stamp"
наказує "hashcash" очищати будь-які прострочені марки не частіше ніж один раз на день.

"hashcash -p 1M -j foo"
наказує "hashcash" очищати лише прострочені марки, що відповідають ресурсу foo, раз на місяць.

"hashcash -p зараз -k"
наказує "hashcash" зараз очистити всі штампи (прострочені та нетерміновані).

друк формат (версія 1)

Поточний формат марок – версія 1. Цей інструмент може перевірити марки хешкешу версії 0
також, але штампи версії 0 більше не створюються, оскільки їх поступово припиняють
більш розширюваний формат штампа v1.

версія:біти:дата:ресурс:[ext]:рядок:протидія

де

версія = 1
біти = скільки бітів часткового зіткнення має штамп
дата = РРММДД[ггмм[сс]]
ресурс = рядок ресурсу (наприклад, IP-адреса, адреса електронної пошти)
ext = розширення -- ігнорується в поточній версії
Формат розширення:

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Зверніть увагу, що значення також може містити =. Приклад розширення (не справжнє):

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

Яке розширення name1 має значення 2 і 3; розширення name2 не має значень;
розширення name3 має 3 значення "var1=2", "var2=3", "2" і "val". Хешкеш
розширення може інтерпретувати значення так, як вважає за потрібне, наприклад, значенням може бути "var1=2".
опції для розширення name3.

рядок = рядок випадкових символів з алфавіту a-zA-Z0-9+/=, щоб уникнути зіткнень з
штампи іншого відправника
протидія = щоб знайти штамп із потрібною кількістю бітів зіткнення, потрібно спробувати багато
різних рядків цей лічильник збільшується при кожній спробі. Лічильник також складається з
символи з алфавіту a-zA-Z0-9+/=. (Зверніть увагу, що реалізація не потрібна
рахувати послідовно).

Використовуйте хешкеш онлайн за допомогою служб onworks.net