Changelog
tilttek/luck-tokensAll notable changes to tilttek/luck-tokens will be documented in this file.
Updates should follow the Keep a CHANGELOG principles.
0.1.0-alpha - 2026-11-15
Added
LuckTokens: tokens granted by a game master or, for a kind that allows it, by anyone; spent by their holder, by an actor who controls them or by a game master; passed from one holder to another; set at the start of a session by carry-over and refresh for the holders of the ledger and those given; a balance never under zero nor over its cap; operations named by the caller, sent again without writing more, an identifier reused with other values refused; appended after the last position read, read and checked again after a conflict, three times in all; a ledger full at 100 000 entries; balances, the ledger and the entries of a holder for the audit; a member erased from every ledger under a pseudonym drawn for the erasure,erased:and 32 random hexadecimal digits, as holder and as actor, the balances, positions and order left as they were, a member erased already left alone.TokenKind,HolderScope,Refresh,GrantPolicyandTableRules: kinds of a key, a name, a cap up to 1 000, a scope, a refresh, a carry-over, who grants and whether they pass; 16 kinds and 16 game masters a table; read from plain values or JSON within 64 KiB and 6 levels, a field not known refused, and written back.Ledger\LedgerEntryandLedger\EntryType: the entries of the ledger with their position, operation, type, kind, holder, change, balance, actor, time in UTC, reason and session; written and read back as plain values, checked; the entry with a pseudonym in place of a member, bypseudonymized().ReceiptandBalance: what an operation wrote and the balance it left, and the balance of a holder.Event\TokensGranted,Event\TokensSpent,Event\TokensTransferredandEvent\SessionStarted, dispatched through PSR-14 once the entries are written, andEvent\HolderErased, with the pseudonym and the number of entries rewritten, naming neither the member nor a table.Contract\TokenRules,Contract\TokenLedger— witheraseHolder(), the one rewriting of the ledger — andContract\HolderAccess, withStore\InMemoryTokenRules,Store\InMemoryTokenLedger— its balances, holders and sessions indexed — andStore\SelfAccess.Exception\LuckTokensException, withInvalidTokenRule,TokenRefusedandLedgerConflict.- A fuzz target for the rules of a table, and benchmarks of a spending after 10 000 entries and of the start of a session.
- The documentation in
doc/, one file per topic, indexed by the README. CONTRIBUTING.md,SECURITY.mdandCODE_OF_CONDUCT.md.