Aller au contenu

Tenir un tirage

tilttek/raffle

Les enjeux et les sources

EnjeuGerme fourni parPourquoi
Stake::Prize : quelque chose de valeur est gagnéSeedSource::Beacon, toujoursUn organisateur qui détiendrait le germe pourrait tirer de nouveau jusqu'à ce qu'un ami gagne, avant de s'y engager
Stake::None : qui parle le premier, qui apporte les collationsSeedSource::CommitReveal par défaut, SeedSource::Beacon sur demandeRien à gagner en trichant ; aucun réseau nécessaire

open() refuse un prix dont le germe vient de l'organisateur, et un tirage par balise quand aucune balise n'est configurée.

$raffles->open('door-prize', Stake::Prize, winners: 3, alternates: 2);
$raffles->open('first-speaker', Stake::None);                          // commit-reveal
$raffles->open('pizza-topping', Stake::None, source: SeedSource::Beacon);

Un tirage désigne de 1 à 1 000 gagnants et de 0 à 1 000 substituts. Un tirage par engagement-révélation tire son germe — 32 octets du générateur aléatoire sécurisé — à son ouverture, et son engagement, le SHA-256 des 64 chiffres hexadécimaux du germe, figure dès lors dans le tirage et dans l'annonce.

Les inscriptions : une chance par participant

$raffles->enter('door-prize', 'member:1042');

Un participant est une référence opaque de 1 à 128 lettres, chiffres, points, deux-points, traits de soulignement, tildes ou traits d'union : un identifiant de membre ou de billet, publié dans la preuve, donc jamais une adresse ni un nom — l'@ d'une adresse est refusé. Un participant s'inscrit une fois : une seconde inscription est refusée, rien dans l'API n'accepte un nombre de chances, et le tirage est uniforme parmi les participants distincts. Un tirage accepte jusqu'à 100 000 participants, et aucune inscription une fois scellé.

Le scellement

$announcement = $raffles->seal('door-prize');
$announcement->toArray();     // raffle, stake, source, winners, alternates, entrants, entrants_hash, sealed_at,
                              // commitment, chain, round, drawable_at

seal() refuse un tirage sans participants, liste les participants dans l'ordre des octets, en calcule l'empreinte et, pour une balise, lit la chaîne et fixe la première ronde publiée strictement après la fermeture plus la marge — 30 secondes par défaut, de quoi laisser les horloges du serveur et de la balise différer. Publiez l'annonce aussitôt, là où les participants la voient : l'empreinte prouve qu'aucun participant n'a été ajouté ou retiré ensuite ; la ronde, annoncée avant d'exister, prouve que l'organisateur n'a pas pu la choisir. announcement() la redonne plus tard.

Le tirage

$proof = $raffles->draw('door-prize');
$proof->winnerList();         // the winners, in the order drawn
$proof->alternateList();      // the alternates, in the order they replace a winner

Un tirage par balise s'effectue une fois sa ronde publiée : avant drawableAt(), draw() refuse et ne lit rien. La ronde lue doit être la ronde annoncée. Un tirage par engagement-révélation s'effectue aussitôt, son germe révélé dans la preuve. Quand il y a moins de participants que de gagnants et de substituts, chaque participant est tiré, dans un ordre aléatoire.

Un tirage s'effectue une fois : un gagnant qui ne réclame pas son prix est remplacé par le substitut suivant, jamais par un nouveau tirage, de sorte que l'ordre de remplacement est fixé par le même germe et figure dans la preuve. proof() redonne la preuve plus tard.

L'événement

Une fois le tirage gardé comme effectué, Raffles envoie Event\RaffleDrawn, qui ne porte que l'identifiant du tirage. Un écouteur lit la preuve pour annoncer les gagnants, les pousser vers un écran ou jouer une célébration — des confettis sur la superposition d'une diffusion en direct — ; la bibliothèque elle-même n'affiche rien.