Changelog
tilttek/friend-challengesAll notable changes to tilttek/friend-challenges will be documented in this file.
Updates should follow the Keep a CHANGELOG principles.
0.1.0-alpha - 2026-11-14
Added
FriendChallenges: challenges created with their prize held, the same creation sent again giving back the same challenge; invitees checked as friends; taking part, declining unseen by the creator, proofs and their review by the creator, a vote or a moderator; cancelling before any proof, expiring once the review is over,expireDue()for a scheduled task; reports to the moderators, freezing, unfreezing, removing a challenge or a proof; each move kept at the next version only, tried three times against other writers, settled in the escrow, then announced;settle()to make an escrow move again after a failure;erase()to take a member out of their challenges in bounded batches.Pseudonym: the open or frozen challenge of an erased creator removed and its prize given back, the waiting proofs of an erased participant removed, then a reference of the kinderased, drawn for each challenge, in their place; a challenge whose creator or winner was erased never settled again; a reference of the kinderasedgiven by a caller — creator, invitee, participant, judge, author of a report, moderator, member to erase — refused withInvalidChallengebefore anything is written, reported or any point moves.Challenge,ChallengeState,Visibility,Validation,ProofandProofState: an explicit state machine — open, frozen, won, cancelled, expired, removed —, each move checked for its member, its state and its time; 50 invitees, 100 participants, 200 proofs and 5 a participant at most; times kept in UTC to the microsecond and ordered, never compared with==or===; a record written and read back, checked field by field and as a whole.ChallengeDraft,ChallengeRulesandPrize: identifiers, titles and terms checked; a challenge between friends by default; a length, a review and a largest prize set by the site; a prize in a unit of points, never money.Contract\PrizeEscrow,PrizeHoldandPayout: the prize reserved, confirmed to the winner with the rest given back, or cancelled, each move keyed by its hold and following thePointsHoldcontract oftilttek/exchange-bundle;Escrow\PointsPrizeEscrowon the ledger oftilttek/pointsandEscrow\InMemoryPrizeEscrow, with an adapter ontilttek/exchange-bundlein the documentation.Contract\ChallengeStore,Contract\FriendshipandContract\Moderation, withReportandReportReason, and their memory implementations; the store lists the challenges that name a member.Event\ChallengeCreated,MemberInvited,ParticipantJoined,ProofSubmitted,ProofDecided,ChallengeWon,ChallengeEnded,ChallengeFrozenandChallengeUnfrozen, dispatched through PSR-14 and carrying identifiers only;ChallengeWonfor the celebration of the PHIL UX kit.Exception\FriendChallengesException, withInvalidChallenge,ChallengeRefused,ChallengeConflictandEscrowConflict.- Fuzz targets for the record of a challenge and for its state machine, and benchmarks of a full challenge.
- The documentation in
doc/, one file per topic, indexed by the README. CONTRIBUTING.md,SECURITY.mdandCODE_OF_CONDUCT.md.