Aller au contenu

Référence

tilttek/bounties
TypeRôle
BountiesOffre les primes, les fait évoluer, règle leurs points et répartit les événements
BountyUne prime et sa machine à états ; ses attributions, ses paiements et son enregistrement écrit puis relu, vérifié
BountyDraftCe que demande un membre : identifiant, sujet, raison, montant, fin
BountyRulesLes bornes du site : plus courte et plus longue prime, délai de grâce, plus petit et plus grand montant, primes ouvertes par commanditaire
BountyStateOpen, Awarded, Expired ou Cancelled
BountyReasonAttention, Detail, Sources, Reward, Creativity ou Other
ClaimLa réclamation d'un membre : identifiant, réclamant, preuve, heure
AwardLes points que le commanditaire attribue à une réclamation : identifiant, réclamation, montant, heure
PrizeUn montant d'une unité de points, jamais de l'argent
BountyHoldLes points détenus pour une prime : clé, payeur, montant, unité, depuis quand et jusqu'à quand
PayoutDes points d'une détention payés à un membre
PseudonymCe qui tient lieu d'un membre effacé : une référence du genre erased, tirée pour chaque prime
Contract\BountyStoreOù les primes sont conservées, une seule prime ouverte par sujet
Contract\BountyEscrowOù les points sont détenus : réserver, confirmer, annuler
Escrow\PointsBountyEscrowLes points détenus dans le registre de tilttek/points
Escrow\InMemoryBountyEscrowLes points et les détentions en mémoire
Store\InMemoryBountyStoreLes primes en mémoire, conservées sous forme d'enregistrements
Event\BountyOffered, BountyClaimed, AwardGiven, BountyAwarded, BountyClosedVoir Points d'extension

Instant, Check, Reader et BountyRecord sont internes : l'heure en UTC, les vérifications de ce que la bibliothèque reçoit, et la lecture et la vérification d'un enregistrement.

Exceptions

ExceptionLancée quand
Exception\BountiesExceptionL'interface de toutes les exceptions de la bibliothèque
Exception\InvalidBountyUne valeur que la bibliothèque refuse : un identifiant, un montant, une unité, un brouillon hors des règles, une heure, un enregistrement, une référence du genre erased donnée par un appelant
Exception\BountyRefusedUn mouvement que les règles n'autorisent pas : une prime ou une réclamation inconnue, un membre qui n'y a pas droit, un état ou une heure hors de sa limite, une limite atteinte, un montant supérieur à ce qui reste, un sujet pris, un identifiant réutilisé
Exception\BountyConflictUn autre auteur a conservé la prime avant, trois fois de suite ; une prime du même identifiant, ou sur le même sujet, est déjà conservée
Exception\EscrowConflictUn mouvement de séquestre qui contredit sa détention : une autre détention sous sa clé, des paiements supérieurs à son montant, une détention réglée deux fois
Tilttek\Points\Exception\InsufficientPointsLes points du commanditaire ne couvrent pas la prime

Rien n'est conservé et aucun point ne bouge quand une exception est lancée pendant un mouvement, sauf un échec du séquestre après que le mouvement est conservé, que settle() répare. Chaque message dit ce qui était attendu, comme The bounty "01JD4" has 40 points left to award; 41 is too many.