hashcash - En ligne dans le Cloud

PROGRAMME:

Nom

hashcash - outil de contre-mesure anti-spam / déni de service hashcash

SYNOPSIS

Menthe (créer) timbres:

haschich -m [[ Options ] [ ressource ... ] ... ]

En cliquant timbres:

haschich -c [[ Options ] -r ressource ... ] [ timbre ...]

Vitesse estimations:

haschich -s [ Options ] [ -b les bits ]

Purge base de données:

haschich -p maintenant [ -j ressource ] [ -k ] [ -t fiable ] [ -u ]

que vous avez collision morceaux:

haschich -w [ Options ] [ timbre ...]

Obtenez ressource nom:

haschich -n [ Options ] [ timbre ...]

Obtenez fiable restant jusqu'à expiration

haschich -l [ Options ] -e période [ timbre ...]

DESCRIPTION

Hashcash est un outil de contre-mesure de déni de service. Sa principale utilisation actuelle est d'aider
les utilisateurs de hashcash évitent de perdre des e-mails en raison de l'anti-spam basé sur le contenu et sur la liste noire
systèmes.

L'outil hashcash vous permet de créer des tampons hashcash à joindre aux e-mails que vous envoyez, et
pour vérifier les tampons hashcash joints aux e-mails que vous recevez. Les expéditeurs d'e-mails joignent du hashcash
tampons avec l'en-tête X-Hashcash:. Les vendeurs et auteurs d'outils anti-spam sont encouragés
d'exempter le courrier envoyé avec hashcash de leurs listes noires et règles de filtrage basées sur le contenu.

Un tampon hashcash constitue une preuve de travail qui prend une quantité de travail paramétrable
à calculer pour l'expéditeur. Le destinataire peut vérifier efficacement les timbres reçus.

La fonction de preuve de travail hashcash consiste à calculer les collisions de hachage partielles (le hachage SHA1
fonction est utilisée). En choisissant le nombre de bits de collision, le travail nécessaire pour
calculer une collision peut être rendu arbitrairement coûteux - de quelques fractions de seconde à
minutes ou heures. La vérification est efficace nécessitant le même petit coût quel que soit
la taille de collision.

Pour une discussion plus détaillée d'autres applications, hashcash a été utilisé pour voir
http://www.hashcash.org/

UTILISATION NOTES

Dans cette page de manuel, un nom de ressource est le nom du service ou l'adresse du tampon
créé pour. Dans le cas d'un e-mail, le nom de la ressource est l'adresse e-mail du destinataire dans
la forme [email protected].

Minting timbres

La -m drapeau doit être donné pour frapper un timbre.

Le nom de la ressource (l'adresse e-mail du destinataire) sur laquelle frapper le tampon peut être transmis comme
un argument, ou si omis est lu à partir de stdin. Si stdin est un tty, l'utilisateur est invité, si
stdin est un tube dont le nom de la ressource est simplement lu en silence. La taille de collision souhaitée peut
être spécifié avec l'option -b. Si aucune taille de collision n'est spécifiée, la valeur par défaut est 20
morceaux. Voir aussi le -b défaut option.

Vérification timbres

La -c drapeau doit être donné pour vérifier l'expiration des timbres. Le tampon à vérifier peut être donné comme
argument à "hashcash". Si aucun tampon n'est donné, le tampon est lu à partir de stdin. Si stdin est un
tty l'utilisateur sera invité, si stdin est un tube, le tampon est simplement lu en silence. UNE
le nom de la ressource (l'adresse e-mail du destinataire) peut être donné avec le -r option. Si un
le nom de la ressource est donné le nom de la ressource est comparé au nom de la ressource dans le tampon, si
ils ne correspondent pas, le tampon est rejeté.

Remarque : si aucun nom de ressource n'est donné, le tampon est de toute façon vérifié pour voir s'il en est autrement
valide, mais il pourrait être émis pour une ressource différente, ce qui permettrait aux timbres d'être
réutilisé sur différentes ressources, donc hashcash renverra un code de sortie non vérifié à la sortie.

Les timbres sont par défaut considérés comme valables 28 jours. La période de validité peut être
modifié à l'aide du -e drapeau.

Si le tampon a expiré ou a une date dans le futur, le tampon est rejeté et le programme
sort immédiatement.

Si une taille de collision requise est donnée avec le -b flag, la valeur des timbres est calculée et
comparé, si le tampon a une valeur insuffisante, il est rejeté et le programme se termine
immédiatement. Si la -b flag n'est pas donné, le tampon est vérifié pour voir s'il en est autrement
valide, mais hashcash renverra un code de sortie non vérifié à la sortie.

Si le timbre est utilisé deux fois, le timbre est rejeté. La protection contre la double dépense est
discuté plus en détail ci-dessous dans « Protection contre les doubles dépenses ». Si doubler les dépenses
la protection n'est pas activée, le tampon pourrait être utilisé deux fois, donc hashcash reviendra
code de sortie non coché (code de sortie 2) à la sortie.

La -w indicateur peut être utilisé pour demander que le nombre de bits de la collision soit compté
et affiché. Les -n peut être utilisé pour demander que le nom de la ressource dans le tampon soit
analysé et affiché. Les -l indicateur peut être utilisé pour demander le nombre de secondes jusqu'à ce que
l'expiration du timbre est émise.

Le programme ne retournera les codes de sortie valides ou invalides que si le -c drapeau est utilisé, le -b
le drapeau est utilisé, -d, -r ressource sont utilisés. Il s'agit de l'ensemble minimum d'options nécessaires pour
bien vérifier la validité d'un timbre. Si ces critères ne sont pas remplis, le programme
renvoie le code de sortie non coché (code de sortie 2) à la sortie. (Voir aussi le -y drapeau.)

Double Dépenses Directory

Si la -d est utilisé lors de la vérification des timbres, une base de données des timbres épuisés est conservée.

Par défaut, les tampons expirent après 28 jours, sans expiration, la base de données augmenterait
indéfiniment. Vous pouvez spécifier une autre période d'expiration avec le -e drapeau. Les
La période d'expiration recommandée (et par défaut) pour les e-mails est de 28 jours. Après la période d'expiration
durée, le tampon est de toute façon considéré comme expiré et peut être purgé de la base de données
pour gagner de la place. (Voir « Purger périodiquement par rapport au prochain accès » pour savoir comment purger les tampons.)

Pour des raisons d'efficacité, un tampon est vérifié avant d'être vérifié dans la base de données ; Si c'est
sinon invalide, aucune activité de base de données ne se produira.

Remarque : La décision sur la durée pendant laquelle le timbre doit être considéré comme valide appartient au
vérificateur. S'il est trop court, il est possible pour certaines applications que le tampon
expirer avant d'arriver chez le destinataire (par exemple avec un e-mail.) La valeur suggérée de 28 jours
devrait être sûr pour les retards normaux de livraison des e-mails. Le choix est un compromis entre
la taille de la base de données et le risque d'expiration avant l'arrivée, et dépend de l'application.

Remarque : différents tampons dans la même base de données peuvent avoir des périodes de validité différentes, donc pour
des exemples de timbres pour différentes ressources avec différentes périodes de validité peuvent être stockés dans
la même base de données, ou le destinataire peut modifier la période de validité des futurs timbres
sans affecter la validité des anciens timbres.

Purge Périodiquement vs on Suivant Accès

Pour purger les anciens tampons périodiquement tout en vérifiant les tampons, utilisez le -p période possibilité de purger
pas avant la période donnée depuis la dernière purge. La purge peut être utilisée avec le
-k possibilité de purger les timbres non expirés également, et avec le -j ressource indicateur à purger uniquement
timbres pour la ressource donnée.

Il y a des circonstances où il peut être gênant de purger les tampons lors du prochain accès,
par exemple s'il existe une grande base de données à double dépense qui prend un certain temps à purger, et
le temps de réponse du vérificateur de hashcash est important. Pour éviter ce problème, purger
peut être fait séparément en utilisant simplement le -p maintenant option pour demander uniquement l'opération de purge.
Sur unix par exemple, vous pouvez appeler "hashcash -p now" dans une tâche cron une fois par jour, ou sur
demande lorsque le disque était faible.

Vitesse Estimations

La -s flag demande la mesure du nombre de collisions pouvant être testées par seconde. Non
le timbre est frappé ou vérifié.

Si la -b flag est utilisé avec cette option, à la place une estimation du nombre de secondes qu'il faudrait
prendre à l'atelier un timbre de la taille donnée en bits est calculé. Pour savoir combien de temps il
prendra à la menthe une utilisation de timbre de taille par défaut -s -b défaut.

Notes

Toutes les sorties d'informations sont imprimées sur stderr. Timbres frappés et résultats de timbre
la vérification et le timing sont imprimés sur stdout. Le drapeau tranquille -q supprime tout
sortie informationnelle. Les -v flag demande plus d'informations. La demande
sortie, qui est la seule information qui est sortie en mode silencieux (quand -q est spécifié)
est imprimé sur la sortie standard. Si stdout est un canal ou lorsque le mode silencieux est activé, le
la sortie est imprimée sans description (c'est-à-dire juste des bits, juste des secondes, juste une ressource).

OPTIONS

-c Vérifiez les informations d'expiration des tampons données en argument ou sur stdin. (Utiliser avec
-b, -d ainsi que -r ressource pour vérifier complètement les timbres).

-m Timbres neufs avec les ressources données en arguments ou sur stdin.

-b les bits
Lors de la frappe d'un timbre, créez une collision d'au moins ce nombre de bits. Lors de la vérification d'un
stamp exige qu'il ait une collision d'au moins ce nombre de bits, sinon rejette
ce. S'il est omis, la valeur par défaut est utilisée.

Lors de la vérification des tampons, exigez que les tampons aient ce nombre de bits.

Le nombre de bits par défaut peut être spécifié avec -b défaut. Bits relatifs au
par défaut peut également être spécifié avec -b +n pour n bits de plus que la valeur par défaut et -b -n
pour n bits de moins que la valeur par défaut.

-b défaut, -b +0 ainsi que -b -0 sont tous équivalents.

Lors du test de vitesse -s, peut mesurer la vitesse du jeton par défaut avec -s -b
défaut.

-r ressource
Lors de la frappe des timbres, le nom de la ressource (adresse e-mail du destinataire) pour frapper le timbre
contre peut être donné soit avec -r ressource ou comme argument de "hashcash".

Lors de la vérification des tampons, le nom de la ressource (votre propre adresse e-mail) est indiqué avec le -r
option. Si le nom de la ressource est donné, il est comparé au nom de la ressource dans le
tampon, et s'ils ne correspondent pas, le tampon est rejeté. Notez si le nom de la ressource est
pas donné, les timbres pour d'autres ressources seraient acceptés, et donc hashcash
renvoie le code de sortie non coché (code de sortie 2) à la sortie.

-o Lors de la vérification des tampons, plusieurs ressources peuvent être attribuées. Par défaut, les ressources sont
juste vérifié un par un jusqu'à ce qu'une ressource valide correspondante soit trouvée. Cependant, lorsque vous
utiliser des caractères génériques ou des expressions régulières (voir -E), il est utile de pouvoir préciser que
une ressource remplace une autre. Par exemple ceci : -b15 -r [email protected] -o -b10
*@dev.null indique que le courrier à l'adresse [email protected] nécessite 15 bits, mais envoyer à
*@dev.null ne nécessite que 10 bits. Si nous avons omis le -o remplacer la relation entre
les deux ressources, un tampon de 10 bits serait accepté pour adresse [email protected]
car alors qu'il serait rejeté comme ayant des bits insuffisants selon la première règle,
il serait accepté en vertu de la 2e règle. Les -o L'option vous permet d'éviter ce problème.

-e fiable
Délai d'expiration pour les timbres épuisés. Lors de la vérification des timbres (à l'aide du -c drapeau), si le
timbre a été frappé il y a plus de temps que prévu, il est considéré comme expiré.
Si cette option n'est pas utilisée, les tampons expirent par défaut après 28 jours. La période d'expiration
est donné en secondes par défaut (un argument de 0 signifie toujours). Un seul personnage
suffixe peut être utilisé pour spécifier d'autres unités (m = minutes, h = heures, d = jours, M =
mois, y = Y = années et s = secondes).

S'il est utilisé avec le -d l'option, le timbre usé et sa période d'expiration sont enregistrés dans le
base de données. Voir le -p option pour la description de la façon de purger les tampons de la base de données.

Lors de la frappe des timbres, le -e le drapeau peut avoir un effet sur la résolution du temps créé
dans le timbre. Sans le -e option, la résolution par défaut est jours (format de l'heure :
AAMMJJ). Les formats alternatifs basés sur la plage de période d'expiration sont les suivants :

Lors de la frappe, vous pouvez également donner une largeur de temps explicite avec le -z choix à la place.
(-z remplacements -e si les deux sont donnés. Si ni l'un ni l'autre n'est donné, la valeur par défaut est 6 caractères (temps
format : AAMMJJ)).

Les règles pour déterminer automatiquement la largeur de temps appropriée à partir de -e sinon -z option
est donné sont :

* période >= 2 ans puis le format d'heure AA est utilisé arrondi à l'année la plus proche
début;
* 2 ans < période <= 2 mois puis le format d'heure AAMM est utilisé arrondi à l'inférieur
début du mois le plus proche ;
* 2 mois < période <= 2 jours puis le format d'heure AAMMJJ est utilisé arrondi à l'inférieur
début du jour le plus proche ;
* 2 jours < période <= 2 minutes puis le format d'heure AAMMJJhhmm est utilisé arrondi à l'inférieur
début de la minute la plus proche ;
* période < 2 minutes puis le format d'heure AAMMJJhhmmss est utilisé en secondes.

Notez que l'arrondi est basé sur l'heure UTC, pas l'heure locale. Cela peut mener à
résultats initialement surprenants lors de l'arrondi à, par exemple, des jours dans des fuseaux horaires autres que GMT
(UTC = GMT). Il peut être plus clair de comprendre si vous utilisez le -u option.

-z largeur
La -z l'option est à utiliser pendant la frappe et permet à l'utilisateur de choisir la largeur de la largeur de temps
champ. Voir aussi le -e option offerte en combinaison avec -m pour spécifier un implicite
largeur du champ de temps sous la description du -e drapeau. Les largeurs valides sont 6,10 ou 12
caractères correspondant respectivement à : AAMMJJ, AAMMJJhhmm et AAMMJJhhmmss arrondis à l'inférieur
au jour ou à la minute le plus proche respectivement.

Notez que l'arrondi est basé sur l'heure UTC, pas l'heure locale. Cela peut mener à
résultats initialement surprenants lors de l'arrondi à, par exemple, des jours dans des fuseaux horaires autres que GMT
(UTC = GMT). Il peut être plus clair de comprendre si vous utilisez le -u option.

-g période
La -g L'option est à utiliser lors de la vérification des tampons hashcash avec le -c option et
spécifie une période de grâce pour le décalage d'horloge, c'est-à-dire si un tampon hashcash arrive avec une date dans
l'avenir ou dans le passé, il ne sera pas rejeté comme ayant une date futuriste (ou comme
expiré) à moins qu'il ne soit plus futuriste (ou qu'il ait expiré depuis plus longtemps) que celui-ci
période. La valeur par défaut est de 2 jours, ce qui signifie que tant que l'horloge du système d'envoi est
pas plus de 2 jours en avance (ou 2 jours en retard) sur l'horloge du système de réception, le
Le tampon hashcash sera toujours accepté.

Les unités par défaut pour la période de grâce sont les secondes. Un suffixe à un seul caractère peut être utilisé
pour spécifier d'autres unités (m = minutes, h = heures, d = jours, M = mois, y = Y =
années et s = secondes).

-d Stockez les timbres dans une base de données à double dépense. Si le timbre a été vu avant, il sera
rejeté même s'il est par ailleurs valable. Le fichier de base de données par défaut est base de données.sdb in
le répertoire courant. Seuls les tampons autrement valides seront stockés dans la base de données.
Seuls les tampons entièrement validés seront stockés dans la base de données, à moins que le -y option est
donné.

-f dbname
Utilisez dbname au lieu du nom de fichier par défaut pour la base de données à double dépense.

-p période
Purge la base de données des tampons expirés si la période donnée s'est écoulée depuis le
la dernière fois qu'il a été purgé. Par commodité -p maintenant équivaut à -p 0 les deux
signifie purger maintenant, quelle que soit la date de la dernière purge de la base de données.

Si utilisé en combinaison avec -j ressource uniquement les timbres frappés pour la ressource donnée
sont purgés.

Si utilisé en combinaison avec -k tous les timbres, même les timbres non expirés, sont purgés. Peut être
utilisé en combinaison avec -t fiable expirer comme si l'heure actuelle était l'heure donnée.

-k Utiliser avec option -p pour demander que tous les timbres soient purgés plutôt que ceux qui ont expiré.

-j ressource
Utiliser avec option -p demander que seuls les tampons correspondant au nom de ressource donné soient
être purgé, plutôt que la valeur par défaut qui consiste à purger tous les tampons expirés. Si la
le nom de la ressource est la chaîne vide, tous les tampons correspondent (cela équivaut à
en omettant le -j option).

Noter la -E, -M ainsi que -S type d'indicateurs de correspondance s'appliquent également aux ressources données avec le -j
ressource drapeau.

-s Imprimez uniquement les informations de synchronisation et ne créez pas de tampon. Si combiné avec
-b les bits flag print estimation de la durée nécessaire à la taille de collision demandée pour
calculer, si -s donné par lui-même, imprime juste la vitesse du détecteur de collision. Imprimer
une estimation de la durée d'utilisation du nombre de bits par défaut -b défaut.

-h Imprimez de brèves informations d'utilisation.

-v Imprimez une sortie d'information plus détaillée sur la frappe ou la vérification du timbre. (Si
-v est le seul argument, imprime le numéro de version de l'outil.)

-V Imprime le numéro de version de l'outil.

-q Temps différé. N'imprime aucune information autre que la sortie. Cette option remplace la -v
option.

-X Lors de la frappe, imprime l'en-tête X de l'e-mail hashcash « X-Hashcash : » avant le tampon.
Sans cette option, seul le tampon nu est imprimé.

Lors de la vérification, après avoir scanné les tampons donnés en arguments, scanne stdin pour les lignes
commençant par la chaîne « X-Hashcash : », et utilise le reste de la ligne correspondante comme
timbre. Seules les lignes jusqu'à et se terminant à la première ligne vierge sont numérisées (voir aussi
-i indicateur qui peut être utilisé pour annuler cela). Une ligne vide est le séparateur utilisé pour
séparez les en-têtes du corps d'un message électronique ou d'un article USENET. Ceci est signifié
pour faciliter le transfert d'un message électronique ou d'un article USENET vers hashcash sur stdin.

-x extension
Une chaîne d'extension composée d'ensembles de valeurs de nom. Le format d'extension est décrit
ci-dessous dans la section sur le format du tampon hashcash. Cela permet aux utilisateurs de définir leur
propres extensions de tampon qui sont hachées dans le tampon, vérifiées par des destinataires qui
les soutiennent, et ignorés par les destinataires qui ne les soutiennent pas. Notez l'extension
mécanisme de crochet n'a pas encore été mis en œuvre. Cela viendra dans une version ultérieure.

-i Lors de la vérification et de l'utilisation du -X indicateur, ignorer la limite de ligne vide entre les en-têtes
et le corps du message, et vérifiez également la collision dans le corps si aucun n'est trouvé
dans les en-têtes.

-t fiable
Prétendre que l'heure actuelle est l'heure donnée aux fins de frappe des timbres, vérifiant
timbres et purger les anciens timbres de la base de données. L'heure est donnée dans un format basé sur
Format HEURE UTC AAMMJJ[hhmm[ss]].

L'heure est exprimée en heure locale par défaut. Utiliser avec -u drapeau pour donner l'heure en UTC
(GMT).

Vous pouvez également donner l'heure relative à l'heure actuelle en préfixant l'argument avec +
ou -. Les unités par défaut pour le temps relatif sont les secondes. Un suffixe à un seul caractère peut
être utilisé pour spécifier des unités alternatives (m = minutes, h = heures, d = jours, M = mois, y =
Y = années et s = secondes).

Remarque : lorsque l'heure est exprimée en heure locale, s'il y a l'heure d'été dans votre
fuseau horaire, il y a une ou deux heures ambiguës par an au moment du changement de
l'heure d'été à l'heure normale.

-u Saisie et sortie des heures absolues en UTC (GMT) au lieu de l'heure locale.

-a période
Ajouter (ou soustraire si nombre est négatif) une valeur aléatoire de l'heure actuelle avant
frapper le timbre. Cela masque l'heure à laquelle le tampon a été créé, ce qui peut être utile pour
utilisateurs anonymes. Notez que l'ajout (plutôt que la soustraction) d'un temps aléatoire peut être risqué si
le timbre prend moins que le temps supplémentaire pour arriver car le destinataire rejettera les timbres
avec des horodatages dans le futur.

-n Imprimer le nom de la ressource analysé à partir du tampon en cours de vérification. Renvoie le code de sortie non coché sur
Sortie.

-l Imprimer le nombre de secondes restantes avant l'expiration du tampon. Renvoie le code de sortie non coché sur
Sortie.

Remarque : le calcul comprend le délai de grâce, il peut donc aller jusqu'à 2 fois le délai de grâce
plus longtemps que prévu (horloge rapide mais le système doit présumer qu'il pourrait
sois lent). Si vous souhaitez exclure le délai de grâce, ajoutez -g0 pour définir la période de grâce à 0
pour le calcul.

-w Imprimer le nombre de bits de collision du tampon. Renvoie le code de sortie non coché à la sortie.

-y Renvoie le succès si le tampon est valide même s'il n'est pas entièrement vérifié. Utiliser avec -c
où tout n'est pas -d, -r sont spécifiés pour obtenir le code de sortie de succès sur valide mais partiellement
timbre vérifié. De même peut utiliser avec -n, -l, -w avec le même effet.

-M Lors de la vérification des tampons, autorisez les caractères génériques * correspondance dans le nom de la ressource pour le faire
plus simple de spécifier plusieurs adresses e-mail et d'autoriser la correspondance des adresses fourre-tout
et les adresses, y compris les sous-domaines. C'est la valeur par défaut. Voir également -S, -E ainsi que -C

-S Lors de la vérification des tampons, utilisez une comparaison de texte simple pour comparer les noms de ressources à ceux de
timbres. Voir également -M, -E ainsi que -C.

-E Lors de la vérification des tampons, utilisez des expressions régulières pour spécifier les noms de ressources afin de les rendre
plus simple de spécifier plusieurs adresses e-mail, adresses fourre-tout, classes d'extension
adresses et adresses, y compris les sous-domaines. Notez que la syntaxe des expressions régulières est POSIX
style : les caractères spéciaux n'ont pas besoin d'être cités pour avoir leur signification particulière ; mais
ils doivent être entre guillemets avec \ à ce caractère dans la chaîne recherchée. Les
l'expression régulière a automatiquement ^ ajouté au début et $ ajouté à la fin,
s'ils ne sont pas spécifiés. Les caractères spéciaux ^ correspondent au début du
resouce, et $ correspond à la fin de la ressource.

(Notez que même si compilé avec des expressions régulières BSD, la syntaxe de style POSIX est utilisée ; également
note Les expressions régulières BSD ne prennent pas en charge les plages {}.)

-C Par défaut, les ressources sont canonisées en minuscules lors de la frappe et de la vérification. Les
-C flag remplace ceci afin que les ressources soient traitées comme sensibles à la casse lors de la vérification,
et non canonisé à la frappe.

-P Imprimer les informations de progression (nombre d'itérations, itérations attendues, pourcentage effectué, meilleur
taille de timbre trouvée jusqu'à présent).

-O core
Sélectionnez le noyau hashcash avec ce numéro. Actuellement, 0-9 sont des cœurs valides. Pas tous les cœurs
travailler sur toutes les architectures. Par exemple, certains sont spécifiques à l'assembleur x86, d'autres spécifiques au PPC
assembleur. Si un noyau n'est pas valide, hashcash renvoie un échec et explique ce que
passé.

-Z n
Compressez le tampon. Il s'agit d'un compromis entre le temps et l'espace. Les timbres plus gros sont plus rapides, mais
sans doute un peu moche. Pour les tampons les plus rapides (par défaut), utilisez -Z 0 ; pour en partie
les timbres compressés utilisent -Z 1 ; pour les tampons très compressés, mais un peu lents, utilisez -Z 2.
(Remarque : en raison d'un bogue découvert tardivement, -Z2 est le même que -Z1 pour le moment jusqu'à ce que je puisse corriger
cette.)

EXEMPLES

La création timbres

"hashcash -s"
Imprimez des informations de synchronisation sur le nombre de collisions que la machine peut essayer par seconde.

"hashcash -sv"
Analyse comparative plus précise mais assez lente de différents monnayages spécifiques au processeur
noyaux.

"hashcash -s -b par défaut"
Imprimez combien de temps il faudrait à la machine pour calculer une collision de taille par défaut (mais
ne calcule pas réellement une collision).

"hashcash -s -b 32"
Imprimez combien de temps il faudrait à la machine pour calculer une collision 32 bits (mais ne
calculer réellement une collision).

"hashcash -m"
Frappez un timbre. Demandera le nom de la ressource et la menthe avec la valeur par défaut (nombre de
bits de collision).

"hashcash -m foo"
Calculez la collision sur la ressource foo. Sera neuf avec la valeur par défaut (nombre de collisions
morceaux).

"hashcash -m foo -b 10"
Calculer une collision de 10 bits sur la ressource foo.

"hashcash -a -3d"
Soustrayez une heure aléatoire comprise entre 0 et 3 jours de l'heure de création du tampon.
C'est le même facteur de fuzz utilisé par mixmaster pour réduire le risque de corrélations temporelles.

Examiner Estampes

"hashcash -w 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Indiquez la valeur du tampon (combien de bits de collision) il y a. L'exemple est
une collision 24 bits, dont la création prend en moyenne 25 secondes sur un P3 4Ghz.

"hashcash -mq -b 10 foo ⎪ hashcash -w"
Créez un tampon en mode batch, passez à hashcash sur stdin pour vérifier, faites-le imprimer comment
il y avait beaucoup de morceaux.

"hashcash -n 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Indiquez le nom de la ressource à partir du tampon. Le nom de la ressource dans l'exemple est foo.

"hashcash -l -e 30y 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Indiquez combien de temps avant l'expiration du timbre s'il expire dans les 30 ans suivant sa création
Date. (Notez que les dates trop éloignées dans le futur se prolongent jusqu'à la fin d'Epoch en 2038, qui est
l'analogue de temps unix du bug y2k).

Vérification Estampes

"hashcash -c 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Vérifiez si le tampon est valide. Notez que nous ne vérifions pas le timbre dans une double dépense
base de données et n'a pas spécifié de nom de ressource ou le nombre requis de bits de collision
et hashcash considérera que le tampon n'est pas entièrement vérifié et le signalera comme valide
mais pas complètement décoché, ou comme invalide s'il y a un problème avec le tampon.

"hashcash -c -b24 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Vérifiez que la valeur du tampon est supérieure ou égale à 24 bits. Cet exemple a 24
valeur en bits. Si vous augmentez le nombre de bits demandé ou remplacez le tampon par un
avec une collision inférieure à 24 bits, le tampon sera rejeté.

"hashcash -c -b24 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Comme ci-dessus, vérifiez si le timbre a une valeur suffisante, mais vérifiez en plus que le
le nom de ressource donné correspond au nom de ressource dans le tampon.

Double Dépenses Prévention

Les exemples donnés dans « Vérification des tampons » peuvent être modifiés pour conserver une base de données à double dépense
afin que le même timbre ne soit pas accepté deux fois. Notez qu'un timbre ne sera enregistré que
et ajouté à la base de données si elle est par ailleurs valide et entièrement vérifiée (un nombre requis de
des bits de collision ont été spécifiés et une ressource a été spécifiée).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Vérifiez le tampon et ajoutez-le à la base de données double dépensée s'il est valide (a la ressource correcte
nom et valeur suffisante).

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Essayez de doubler le timbre. Il sera rejeté en tant que double dépensé.

Cachet Expiration

Pour éviter que la base de données de double dépense ne s'agrandisse indéfiniment, le destinataire peut demander que
les timbres ne datent pas d'une période spécifiée. Après expiration, les anciens timbres peuvent être retirés du
base de données de double dépense car ils ne seront plus nécessaires - les timbres expirés peuvent être rejetés
basé uniquement sur leur ancienne date, de sorte que l'espace occupé par les timbres expirés dans la double dépense
la base de données peut être sauvegardée sans risque d'accepter un tampon expiré mais par ailleurs valide.

Le troisième champ du tampon est l'heure UTC depuis le 1er janvier 1970. L'heure par défaut
le format est AAMMJJ, l'heure est arrondie au jour le plus proche. La période de validité par défaut est 28
jour.

Vous pouvez fournir une autre période de validité avec le -e option.

"hashcash -cd -b 10 -e 2d -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Essayez de vérifier un ancien tampon, le tampon ci-dessus a été créé le 11 août 2002.

Nous avons donné l'option -e 2d donc la date d'expiration des timbres est de 2 jours après la création, ce qui est maintenant
dans le passé.

Remarque : si le temps de création est exprimé dans le timbre en jours, la création précise
date est le début du jour spécifié en heure UTC (de même pour les unités alternatives
le temps de création est arrondi au début de l'unité dans laquelle il est exprimé).
Pour les unités en jours, par exemple, cela peut signifier en fonction de votre fuseau horaire que le
le timbre semble être considéré comme invalide dans le délai d'expiration spécifié en jours
par rapport à votre vision relative du jour, car le calcul est basé sur
l'heure actuelle en UTC et l'heure de création du tampon est exprimée en heure UTC.

"hashcash -cd -b 10 -r foo 1:24:040806:foo::511801694b4cd6b0:1e7297a"
Testez si le timbre est par ailleurs valide, en plus d'avoir expiré. En omettant le -e
indique à hashcash que le tampon n'expirera jamais. Une période d'expiration pour toujours peut également
être donné explicitement comme ceci : -e 0, où une période d'expiration de 0 signifie pour toujours.

Purge et les sites anciens timbres

Si la -c, -d sont utilisées ensemble, à chaque fois qu'un tampon est vérifié, s'il est valide et
tous les aspects obligatoires du tampon sont vérifiés (contrôle des bits de collision,
vérification du nom) puis le tampon et sa période d'expiration sont écrits dans le fichier de la base de données. Les
délai d'expiration par défaut si un délai d'expiration n'est pas indiqué explicitement avec le -e l'option est 28
jours (c'est-à-dire que les timbres expirent après 4 semaines).

D'abord neuf puis ajout d'un tampon :

"hashcash -m -b 10 foo -e 1m > timbre"
Remarque : nous avons spécifié une date d'expiration à la frappe dans cet exemple, pour garantir que le timbre
le temps de création est donné dans une résolution suffisamment élevée dans le tampon pour que le tampon ne
être considéré comme expiré au moment de sa création. (Rappelez-vous que la résolution par défaut est en jours,
un timbre créé avec une heure de création arrondie au début de la journée est
il est peu probable qu'il soit considéré comme valide 1 minute plus tard, sauf si vous le frappez à minuit UTC
temps.)

"hashcash -cd -e 1m -b 10 -r foo < stamp"
Le timbre expire dans 1 minute. Attendez 1 minute, puis demandez explicitement qu'il a expiré
les timbres soient purgés :

"hashcash -p maintenant"
Essayez ensuite de renvoyer le même tampon :

"hashcash -cd -e 1m -b 10 -r foo < stamp"
et le timbre sera rejeté de toute façon car il a expiré, illustrant pourquoi il n'a pas été
nécessaire de conserver ce cachet dans la base de données.

Avec la base de données par défaut (le format sdb), le contenu de la base de données est lisible par l'homme,
afin que vous puissiez visualiser leur contenu en les signalant au terminal :

"chat hashcash.sdb"
pour voir que le timbre est vraiment ajouté, puis après la purification par la suite purgé en raison de
expiration.

Purge et les sites anciens timbres on Demande

Pour plus de commodité, vous pouvez purger en même temps que vérifier les tampons en utilisant le -p option
les -c option.

"hashcash -m -b 10 foo > tampon"
"hashcash -cd -p now -e 1 -b 10 -r foo < stamp"
Il peut être inefficace de purger les tampons à chaque utilisation car l'ensemble de la base de données doit être
scanné pour les timbres expirés. En donnant un délai au -p option, vous pouvez dire
"hashcash" pour purger pas plus fréquemment que cette période depuis la purge précédente.

Par exemple :

"hashcash -cd -p 1d -e 1 -b 10 -r foo < timbre"
dit à "hashcash" de purger tous les timbres expirés pas plus d'une fois par jour.

"hashcash -p 1M -j foo"
dit à "hashcash" de purger uniquement les timbres expirés correspondant à la ressource foo une fois par mois.

"hashcash -p maintenant -k"
dit à "hashcash" de purger tous les tampons (expirés et non expirés) maintenant.

timbre le format (version 1)

Le format de tampon actuel est la version 1. Cet outil peut vérifier les tampons de la version 0 du hashcash.
également, mais les timbres de la version 0 ne sont plus créés car ils sont progressivement supprimés au profit de
le format de tampon v1 plus extensible.

ver:les bits:données:ressource:[poste]:rand:contrer

De

ver = 1
les bits = combien de bits de collision partielle le tampon est censé avoir
données = AAMMJJ[hhmm[ss]]
ressource = chaîne de ressource (par exemple, adresse IP, adresse e-mail)
poste = extension -- ignoré dans la version actuelle
Format de prolongation :

[name1[=val1[,val2...]];[name2[=val1[,val2...]]...]]
Notez que la valeur peut également contenir =. Exemple d'extension (pas une vraie):

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

Ce qui serait l'extension name1 a les valeurs 2 et 3 ; l'extension name2 n'a pas de valeurs ;
l'extension name3 a 3 valeurs "var1=2", "var2=3", "2" et "val". Le haschich
l'extension peut interpréter les valeurs comme bon lui semble, par exemple "var1=2" pourrait être la valeur
d'une option à l'extension name3.

rand = chaîne de caractères aléatoires de l'alphabet a-zA-Z0-9+/= pour éviter les collisions avec
timbres d'autres expéditeurs
contrer = pour trouver un tampon avec le nombre souhaité de bits de collision, il faut essayer beaucoup de
différentes chaînes, ce compteur est incrémenté à chaque essai. Le Comptoir est également composé de
caractères de l'alphabet a-zA-Z0-9+/=. (Notez qu'une implémentation n'est pas nécessaire pour
compter séquentiellement).

Utilisez hashcash en ligne en utilisant les services onworks.net