Aller au contenu

Référence

tilttek/friend-challenges
TypeRôle
FriendChallengesCrée les défis, les fait évoluer, règle leurs lots et répartit les événements
ChallengeUn défi et sa machine à états ; son enregistrement écrit puis relu, vérifié
ChallengeDraftCe que demande un membre : identifiant, titre, lot, fin, invités, visibilité, validation, conditions, votes nécessaires
ChallengeRulesLes bornes du site : plus court et plus long défi, examen, plus gros lot
ChallengeStateOpen, Frozen, Won, Cancelled, Expired ou Removed
VisibilityFriends ou Open
ValidationCreator, Vote ou Moderator
ProofLa preuve d'un participant : identifiant, justificatif, heure, état, approbations et rejets
ProofStatePending, Accepted, Rejected ou Removed
PrizeUn montant d'une unité de points, jamais de l'argent
PrizeHoldLes points détenus pour un lot : 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 défi
ReportLe signalement d'un membre aux modérateurs : défi, auteur du signalement, raison, heure, preuve, note
ReportReasonSpam, Harassment, Cheating, Unsafe, Inappropriate ou Other
Contract\ChallengeStoreOù les défis sont conservés
Contract\PrizeEscrowOù les lots sont détenus : réserver, confirmer, annuler
Contract\FriendshipQui est l'ami de qui
Contract\ModerationOù vont les signalements, et qui modère
Escrow\PointsPrizeEscrowLes lots détenus dans le registre de tilttek/points
Escrow\InMemoryPrizeEscrowLes lots et les points des membres en mémoire
Store\InMemoryChallengeStoreLes défis en mémoire, conservés sous forme d'enregistrements
Store\InMemoryFriendshipLes amitiés en mémoire
Store\InMemoryModerationLes modérateurs et les signalements en mémoire
Event\ChallengeCreated, MemberInvited, ParticipantJoined, ProofSubmitted, ProofDecided, ChallengeWon, ChallengeEnded, ChallengeFrozen, ChallengeUnfrozenVoir Points d'extension

Instant, Check, Reader et ChallengeRecord 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\FriendChallengesExceptionL'interface de toutes les exceptions de la bibliothèque
Exception\InvalidChallengeUne valeur que la bibliothèque refuse : un identifiant, un titre, des conditions, un lot, un brouillon hors des règles, une heure, un enregistrement, une référence du genre erased donnée par un appelant
Exception\ChallengeRefusedUn mouvement que les règles n'autorisent pas : un défi ou une preuve inconnu, un membre qui n'y a pas droit, un état ou une heure hors de sa limite, une limite atteinte, un identifiant réutilisé
Exception\ChallengeConflictUn autre auteur a conservé le défi avant, trois fois de suite ; un défi du même identifiant est déjà conservé
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 créateur ne couvrent pas le lot

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 member:eve is not invited to the challenge "01JD3", which is between friends.