- org.lichess.puzzle.attempt record not from the namespace authority A record of a user's attempt at solving an org.lichess.puzzle. Ranked attempts carry a detached signature (sig) from the service proving the submitted moves were judged server-side. Rating is not part of the record: it is each scoring service's (appview's) own business.
- org.lichess.puzzle.defs defs not from the namespace authority The shared representation of a chess puzzle returned by the puzzle queries.
- org.lichess.puzzle.getById query not from the namespace authority Get a chess puzzle by its id.
- org.lichess.puzzle.getDaily query not from the namespace authority Get the puzzle of the day: one shared puzzle per UTC day, selected to target the current average rating of established players and to favor popular, frequently-played puzzles. The pick is stable for the whole UTC day and never repeats a previous day's puzzle.
- org.lichess.puzzle.getLeaderboard query not from the namespace authority The ranked leaderboard, best rating first. Only established players appear: provisional ratings (high deviation), players with too few rated attempts, and players currently limited from ranked play are excluded.
- org.lichess.puzzle.getNextRanked query not from the namespace authority Fetches the next ranked puzzle for the authenticated player. Each puzzle needs to be solved or failed before requesting another; if the player already holds an unresolved ranked puzzle, that same puzzle (with a freshly re-signed challenge) is returned so a client that lost its token can recover it.
- org.lichess.puzzle.getRandom query not from the namespace authority Get a random chess puzzle. Optionally filter by a target rating (a random puzzle within 100 of it is returned) and/or themes (matching at least one). With no parameters, returns a truly random puzzle from the dataset with no filtering.
- org.lichess.puzzle.getThemes query not from the namespace authority List all puzzle themes with their display names and descriptions. The keys returned here are the values accepted by the getRandom themes filter.
- org.lichess.puzzle.submitAttempt procedure not from the namespace authority Submits the outcome of a ranked puzzle previously issued by getNextRanked. The challenge token issued with the puzzle must be passed back verbatim, along with the full solution line the player played. The server validates those moves against the puzzle's actual solution: the attempt counts as solved only if they match. Applies the Glicko-2 rating update and returns the player's new rating, plus a detached signature (sig) proving the server judged the moves; the client should store it in its org.