@agntn/puzzles changelog

v0.23.0

Fri, 25 Sep 2026 15:24:57 GMT

Compare changes

Enhancements

collections: Archive quizchain blocks 2 to 5 (#265)
docs: Sortable rosters on UTable (#267)
errors: Did you mean b1000/135? (#268)
collections: Add ktimesg (#271)
collections: Iamabananaamaa GIF puzzle (#273)
docs: Landing roster of collections (#274)
collections: Wickex YouTube puzzle (#275)
docs: Verify console on the landing (#277)
collections: Add iamabananaamaa/caesar (#279)
cli: Serve mcp from src inside a checkout (#281)
docs: Record file on the console shell (#283)
collections: Add picture_puzzle (#284)
collections: Add quizchain/6 (#287)
collections: Add quizchain/7 (#289)
docs: Landing registry as a manifest map (#290)
collections: Add quizchain/8 (#291)
docs: Custom collection panel in two files (#293)
registry: Type built-in collection lookups (#295)
docs: One design system across the site (#296)

Fixes

tools: Reject an empty collection filter (#280)
collections: AoiNakamoto asked r/Bitcoin (#282)
parts: Mark keys rebuilt from a recipe (#294)

Refactors

dataset: Drop @noble/hashes (#269)
verify: Breaking: Rename verifyPuzzle to verify (#288)

Chore

Apply automated updates (515377e)

Tests

fixtures: Give the refresh tests 30 s (#286)

v0.22.0

Wed, 23 Sep 2026 20:34:08 GMT

Compare changes

Enhancements

collections: Zden/level_5 claimed (#254)
docs: Puzzle lists join the instruments (#255)
collections: Add quizchain/4 (#258)
collections: Add quizchain/5 (#260)
docs: One dossier per puzzle page (#262)

Performance

verify: Breaking: Load keys on the first verification (#259)

Fixes

collections: Zden/demobit_2018 has no capture (#253)

Documentation

Pin example results to the dataset (#256)
Counts come from the library (#261)

Build

Lint, test and pack through Vite+ (#252)

v0.21.3

Tue, 22 Sep 2026 20:45:51 GMT

Compare changes

Enhancements

docs: Playground on the dossier instruments (#238)
cli: Page a long list (#239)
collections: Add book_quiz (#241)
docs: The playground runs the author tools (#242)
collections: Archive the satoshi_birthday_quiz thread (#243)
collections: Add quizchain (#246)
docs: Collection pages open on a dossier (#247)
collections: Add quizchain/2 (#250)
collections: Add quizchain/3 (#251)

Fixes

tools: Dust prints as 1e-8 (#244)

Documentation

The skill follows the hint contract (#245)
Skills ask the tools and ship with the package (#248)

v0.21.2

Tue, 22 Sep 2026 14:11:59 GMT

Compare changes

Enhancements

collections: Credit Level 4's winner (#224)
collections: Codex key from Zden (#225)
tools: Browse puzzles without repeats (#227)
dataset: List the puzzles of one chain (#228)
dataset: Look a puzzle up by its address (#230)
collections: Add mineshop (#231)
collections: Add satoshi_birthday_quiz (#236)
authors: Sourced records, one page each (#237)

Fixes

balance: 18 decimals outrun a double (#229)
errors: A miss names what does exist (#232)
tools: Overlapping imports lose the dataset (#234)

Documentation

Preserve the cited source tweets (#226)

v0.21.1

Mon, 21 Sep 2026 21:49:04 GMT

Compare changes

Enhancements

collections: TORCHED H34R7S painting (#215)
docs: Give tool results a compact panel (#216)
collections: White paper wallet key (#219)
collections: Movie Enigma's original rules (#222)

Fixes

tools: Say what each list status means (#217)
tools: A missing id was loading keys (#218)
registry: Retain loader registrations (#220)
verify: Hex must not change a WIF verdict (#221)

Chore

Apply automated updates (2369ec1)

v0.21.0

Mon, 21 Sep 2026 12:15:57 GMT

Compare changes

Enhancements

collections: Dug's student treasure hunt (#204)
collections: Genesis wallet and its hints (#206)
docs: Refresh landing fixtures (#211)
collections: RushWallet's missing video hint (#214)

Performance

tools: Speed up discovery and stats (#213)

Refactors

puzzle: Breaking: Reserve solver for people (#203)

v0.20.3

Sun, 20 Sep 2026 14:35:40 GMT

Compare changes

Enhancements

collections: Decred Autonomy puzzle (#197)
collections: Janus 33*bbb hint (#199)
collections: LuckyLurker vaults and hints (#202)

Fixes

dataset: Keep export hashes consistent (#195)
verify: Skip unsupported address kinds (#196)
collections: 1bitcoin claim was 777 sats (#201)

Documentation

Pin prose counts to the registry (#200)

v0.20.2

Sat, 19 Sep 2026 20:25:06 GMT

Compare changes

Enhancements

docs: Collection pages list their hints (#186)
collections: Zden/level_5 hints (#187)
cli: Add a hints command (#188)
collections: Zden hints the author published (#189)
collections: Zden solver images (#192)
collections: Add ledger_donjon (#193)

Fixes

dataset: Collection rows count every status (#190)
tools: Hints report the hint assets too (#191)
dataset: Handle non-string puzzle ids (#194)

v0.20.1

Sat, 19 Sep 2026 13:41:44 GMT

Compare changes

Enhancements

collections: Add movie_enigma (#178)
puzzle: Record hints and what confirms them (#183)
collections: B1000 carries its author's hint (#185)

Fixes

tools: Show the whole record in puzzles_show (#162)
chains: Check txids through @agntn/chains (#163)
cli: Print domain errors as one line (#164)
parts: Make the Key builder immutable (#166)
puzzle: Freeze the record a factory builds (#170)
dataset: Memoized views refuse a rewrite (#173)
collection: Resolve only canonical queries (#176)
cli: Keep the verify crypto out of --help (#179)
tools: Link the hints and the solver asset (#180)

Refactors

verify: Let @agntn/keys derive addresses (#165)

Chore

Add renovate.json (9a47cd9)
Remove CLAUDE.md (da6bde5)

CI

publish: Install the docs before pnpm test (#161)

v0.20.0

Fri, 18 Sep 2026 09:36:52 GMT

Changed

Rename the package to @agntn/puzzles and the binary to puzzles.
Rewrite the package as an ESM TypeScript library built around classes.
Define puzzles as typed PuzzleSpec records built by a factory per chain and read through Puzzle methods. Collections hold the resulting instances.
Read puzzle fields through methods: puzzle.address() instead of puzzle.address, and the same for every other field.
Serialize without null placeholders. Absent data means no key at all, which also drops address.chain and the always-empty witness_program.
Build addresses, keys, transactions, assets, and parties with constructors from src/core/parts.ts, including a chained Key builder.
Split the data model: src/core/puzzle.ts holds the puzzle contract and chain bases, src/core/parts.ts holds the pieces.
Rename the Author and Solver types to one Party type.
Move lookup, balance, and verification behavior onto the abstract Collection contract.
Replace the Rust CLI and build pipeline with pnpm, strict TypeScript, Vitest, and obuild.
Rebuild the CLI on citty with one module per command and a new collections command.
Adopt the agntn project template: Node.js 24+ baseline, TypeScript 7, oxlint/oxfmt, obuild, changelogen, and the shared GitHub workflows.
Rename the base error class from BohaError to PuzzlesError.
Replace the collections array with a lazy manifest registry. builtins lists { key, load } entries, a collection module is imported on the first lookup for its key, and importing the package loads no records. collectionKeys() and hasCollection() stay synchronous. The views that need instances are asynchronous: collections(), getCollection(), requireCollection(), all(), get(), requirePuzzle(), selectPuzzles(), stats(), dataVersion() and dataset(). registerCollection() takes an instance or a { key, load } entry.
Publish every collection as its own entry, @agntn/puzzles/collections/<key>, with its class and canonical instance. The root entry no longer re-exports them.
Build one bundle for the library, CLI, MCP server, tools and collections. They share one registry, no entry embeds a second copy of anything, and typebox is inlined for a faster MCP start.
Enforce the argument limits the tool schemas declare inside the executors too. An unknown status, a fractional or out-of-range limit, or an too long identifier, collection key or API key throws InvalidArgumentError.
Build the Pi and MCP parameter schemas once from facts in packages/shared/puzzles-tool-schemas.ts. The OMP extension rebuilds them from the host TypeBox build, labels itself and renders sanitized call lines.
Load the shared tool executors in the extensions through literal import() specifiers, so OMP's compiled loader can see the dependencies, and type them from src/ instead of dist/.
Sanitize control characters out of MCP error text and quote the echoed name of an unknown tool.
Derive BalanceError from PuzzlesError, so one base class covers every failure the package raises.
Turn dataVersion into a lazily computed function instead of a generated constant.
Balance derives decimals from its chain, so the constructor takes the chain and the two amounts only.
Collection.verify() and verifyById() are asynchronous and load the verification crypto on first use, which keeps it out of CLI startup. verifyPuzzle() stays synchronous.
hasPrivateKey() and verification read one secretOf() resolver, so a seed record with only a derivation path or an xpub no longer counts as a known private key.
Drop the bits filler from the 38 records outside b1000. bits marks a search space width only, so keyRange() is undefined elsewhere and the validation gate checks every declared width.
Agent tool names, titles, descriptions, parameter constraints, and the status list live once in src/tool-operations.ts. The tools import the library directly instead of receiving it, and the Pi and OMP extensions load that one module before registering.
The validation gate decrypts BIP38 payloads with Node's native scrypt, pinned to the BIP-38 test vectors, instead of the bip38 package.
Fetch balances through @agntn/explorers from puzzle.balance(): Mempool for Bitcoin and Litecoin, Etherscan V2, Dcrdata and the Arweave gateway. Collections forward balance(query) to the puzzle. The providers load on the first lookup. BalanceOptions takes apiKey, baseUrl and timeout.
Read chain names, symbols, decimals, explorer bases and address format rules from @agntn/chains instead of local tables. Bitcoin links now point at blockstream.info and Litecoin links at litecoinspace.org. parseChain() accepts the @agntn/chains aliases.
Puzzle.key() and PuzzleSpec.key are typed Readonly<Key>: a record hands the builder to its factory and never mutates it.
Lint and format follow the shared @agntn/ox policy: exported functions carry typed JSDoc, object parameters are Readonly, and docs/ is checked like the rest of the repository.
pnpm test:packed packs the tarball and runs the library, the MCP server, both extensions and the CLI bin from the packed layout, in CI and before publish. pnpm test:live runs the provider roundtrips. Unit tests never reach them, because fetch is stubbed to fail there.
A Docus site under docs/, published at puzzles.agntn.dev. A guide, one page per collection with a facts strip read off the library, and one page per puzzle with its record, transactions, key material, assets and live balance. The landing walks fourteen records in the browser. The playground runs the real tool executors and the worker's balance route.
Print one discovery row from puzzles collections and puzzles_collections alike, key: N puzzles, N solved, N unsolved, by author, through formatCollection().
Round the per currency prize totals of stats() to eight decimal places, so the CLI, the tools and the docs print 1058.06884913 BTC instead of float carry.
Load the verification crypto in puzzles_verify on the first call, the way Collection.verifyById() does, so registering the tools in MCP, Pi or OMP costs no secp256k1.

Fixed

puzzles --help no longer loads the MCP SDK: the mcp command imports the server when it runs.
Refresh lazy dataset views, identifier lookups, statistics, and data versions when a collection is registered or replaced.
Resolve historical aliases without inheriting Object prototype properties.
Export the documented passphrase() key builder and don't count a WIF passphrase alone as a private key representation.
Declare sideEffects as the CLI entry only, which is correct once the registry seeds itself instead of relying on collection modules registering on import.

Added

Regression tests for all six puzzle factories, optional fields, and registry mutations.
MCP server (puzzles mcp) plus Pi and OMP extensions sharing one tool implementation.
Data validation gate as tests, covering identifiers, chain agreement, address formats, key derivation, BIP38 payloads, claimed public keys, and asset paths.
isValidAddress(chain, address) for chain-aware address format checks.
selectPuzzles({ collection, status, withPubkey }), the one puzzle selection the CLI and agent tools share.
collectionSummaries() and the puzzles_collections agent tool, which print the same rows as puzzles collections.
InvalidArgumentError for arguments that break the shared tool contract.
secretOf(keyData), the private key representation a key record exposes.

Removed

The generated data/generated.jsonc artifact, the src/generated/ module and the generator script. Use dataset() or puzzles export instead.
Per-collection subpath exports. Import collections from the package root.
Puzzle images from the published tarball, which drops it from 38 MB to under 3 MB. assetUrl() still resolves them from the repository.
The Rust sources, PKGBUILD, AUR and crates.io workflows, and the justfile.
The local balance adapters, fetchBalance(), fetchPuzzleBalance(), and the fetch and baseURL options. Stub globalThis.fetch in tests instead.

v0.19.0

Sat, 01 Aug 2026 00:00:00 GMT

Features

rushwallet: Add 30 RushWallet brainwallet contest puzzles (#152)
b1000: Change 135 to solved (#159)

v0.18.1

Sat, 09 May 2026 00:00:00 GMT

Features

warp: Backfill keys + passphrases + KDF salt + schema fixes (#153)

Documentation

Fix README and skill drift (#151)

Miscellaneous Tasks

cli: Remove unused #[allow(dead_code)] annotations
release: V0.18.1

v0.18.0

Mon, 30 Mar 2026 00:00:00 GMT

Features

puzzle: Add currency field for non-native token prizes (#143)
balance: Add Arweave balance fetching (#144)
arweave: Add weave9 puzzle (100 DAI on Ethereum) (#145)
warp: Add WarpWallet challenge collection (#149)

Bug Fixes

cli: Reject unknown collections in list (#137)
search: Honor case-sensitive fields (#139)
search: Match chain symbols (BTC, LTC, XMR, DCR) (#142)
balance: Add Decred support (#140)
search: Include currency field in search results (#146)
verify: Pass BIP39 passphrase to seed derivation (#147)

Refactor

collection: Centralize dispatch registry (#141)

Miscellaneous Tasks

release: V0.18.0

v0.17.0

Sun, 15 Mar 2026 00:00:00 GMT

Features

Add Display and FromStr for Chain and Status (#122)
verify: Implement verify_puzzle with chain dispatch (#123)
Add Chain::address_explorer_url and Puzzle::explorer_url (#129)
hash_collision: Add solved() iterator (#126)
balance: Add Litecoin balance fetching (#127)
skills: Add agent skills (#133)

Bug Fixes

cli: Support ballet in author command (#120)
Use PUZZLES.len() instead of hardcoded count() (#124)
Accept mixed-case hex in Chain::is_valid_txid (#125)

Documentation

Add vusi and kangaroo to related tools

Testing

I32 IntoPuzzleNum edge cases (#121)
Cover format_duration_human_readable edge cases
Cover Chain::is_valid_txid across all formats (#128)
Cover Chain methods (explorer URLs, symbol, name, ALL) (#130)

Miscellaneous Tasks

Remove community section from README.md
Add PR lint caller
Update README.md
Update AGENTS.md
Add clippy config (#135)
release: V0.17.0

v0.16.0

Sat, 21 Feb 2026 00:00:00 GMT

Features

arweave: Add Arweave collection (#111)

Refactor

chain: Multichain prep (#109)
zden: Normalize names to snake_case (#114)

Miscellaneous Tasks

release: V0.16.0

v0.15.0

Tue, 27 Jan 2026 00:00:00 GMT

Features

cli: Add search command (#94)
build: Embed data version at build time (#97)
cli: Add verify command (#98)
data: Migrate from TOML to JSONC (#101)
Add pubkey validation for claimed puzzles (#103)
cli: Add export command (#106)

Refactor

scripts: Migrate from TOML to JSONC (#104)
scripts: Unified typed address structs (#108)

Documentation

Standardize badges and add community section

Miscellaneous Tasks

release: V0.15.0

v0.14.0

Tue, 13 Jan 2026 00:00:00 GMT

Features

zden: Add private key for Level 1 puzzle (#81)
build: WIF validation at build time (#93)

Other

zden: Add private key for Level 2 puzzle (#85)
zden: Add Level 3 private key (#87)

Refactor

pubkey: Rename key to value and use inline TOML tables (#83)

Documentation

Update AGENTS.md metadata to current commit

Miscellaneous Tasks

release: V0.14.0

v0.13.0

Mon, 05 Jan 2026 00:00:00 GMT

Features

collection: Add Ballet challenge (#76)
data: Add WIF format to solved puzzles (#79)
release: Update README.md version during release

Documentation

Sync AGENTS.md with Ballet collection addition

Miscellaneous Tasks

release: V0.13.0

v0.12.1

Mon, 05 Jan 2026 00:00:00 GMT

Bug Fixes

package: Exclude assets from crates.io package

Miscellaneous Tasks

release: V0.12.1

v0.12.0

Mon, 05 Jan 2026 00:00:00 GMT

Features

solvers: Add retired_coder (#71)
assets: Add puzzle assets support (#74)

Documentation

Add Related Tools section with vuke and vgen

Miscellaneous Tasks

release: V0.12.0

v0.11.0

Sun, 04 Jan 2026 00:00:00 GMT

Features

address: Add Address struct (#60)
puzzle: Add Key struct (#61)
cli: Add human-panic for friendly crash reports (#62)
balance: Add Ethereum API support (#63)
scripts: Add Decred API support (#64)
address: Add SegWit support (#67)
address: Add Taproot (P2TR) address type support (#68)
bitaps: Add mnemonic challenge (#69)
collections: Add bitimage puzzle collection (#70)

Refactor

solver: Extract solvers to dedicated TOML file (#72) (#73)

Documentation

Sync AGENTS.md with zden collection
Update outdated code references
Sync AGENTS.md with recent changes

Miscellaneous Tasks

Add context7.json
release: V0.11.0

v0.10.0

Fri, 02 Jan 2026 00:00:00 GMT

Features

zden: Add visual crypto puzzles (#57)
data: Add timestamps to dates (#59)

Miscellaneous Tasks

release: V0.10.0

v0.9.0

Fri, 02 Jan 2026 00:00:00 GMT

Features

puzzle: Add claim_txid accessors and explorer URLs (#43)
puzzle: Add solver information for solved puzzles (#51)

Testing

Add pubkey to h160 validation (#41)
balance: Add coverage for balance feature (#42)
Add private-key-to-address derivation verification (#45)

Miscellaneous Tasks

release: V0.9.0

v0.8.0

Fri, 02 Jan 2026 00:00:00 GMT

Features

puzzle: Add transaction history (#34)

Miscellaneous Tasks

release: V0.8.0

v0.7.0

Fri, 02 Jan 2026 00:00:00 GMT

Features

puzzle: Add KeySource enum for key derivation semantics (#33)
author: Add Author struct for collections (#36)

Documentation

Update AGENTS.md with code map and testing info

Miscellaneous Tasks

Add deepwiki badge
Ad deepwiki badge
release: V0.7.0

v0.6.0

Wed, 31 Dec 2025 00:00:00 GMT

Features

puzzle: Generalize key_range (#30)
puzzle: Add solve_time field (#32)

Miscellaneous Tasks

release: V0.6.0

v0.5.0

Wed, 31 Dec 2025 00:00:00 GMT

Features

puzzle: Add h160 field for P2PKH addresses (#17)
puzzle: Add script_hash for P2SH (#22)
ci: Integrate autofix.ci for automatic formatting (#23)

Refactor

data: Rename btc field to prize in TOML files (#25)

Documentation

Add gsmg collection to AGENTS.md

Miscellaneous Tasks

release: V0.5.0

v0.4.0

Wed, 31 Dec 2025 00:00:00 GMT

Features

puzzle: Add Chain enum (#15)
puzzle: Add pubkey_format field (#16)

Miscellaneous Tasks

release: V0.4.0

v0.3.0

Wed, 31 Dec 2025 00:00:00 GMT

Features

collections: Add GSMG puzzle collection (#10)

Miscellaneous Tasks

release: V0.3.0

v0.2.0

Tue, 30 Dec 2025 00:00:00 GMT

Features

puzzle: Add start_date field (#7)
puzzle: Add source_url field (#8)

Miscellaneous Tasks

release: V0.2.0

v0.1.0

Tue, 30 Dec 2025 00:00:00 GMT

Bug Fixes

Limit version sed to package section only

Other

Crypto bounties, puzzles and challenges data library
Update balances from mempool.space API

Refactor

Move hash_collision data to TOML source of truth

Documentation

Reorder README sections - CLI before Library
Add boha list without args to README
Add detailed puzzle list to Collections section
Fix b1000 puzzle status breakdown
Add CONTRIBUTING.md
Add AGENTS.md project knowledge base

Styling

Fix formatting in cli.rs

Miscellaneous Tasks

Track Cargo.lock for reproducible builds
release: V0.1.0