@agntn/puzzles

中文文档
0.31.0发布于 2026/10/29MITTypeScriptES Module构建来源已验证近 30 天下载 2143

密码、谜题和挑战作为代理商的阶级数据

中文使用文档
文档目录13 节
  1. 为什么?
  2. * 特性
  3. QQ 安装
  4. 第一次通话
  5. 图标
  6. 图书馆
  7. · 收款情况
  8. 代理人
  9. ~ 这不起作用 ~
  10. 添加谜题
  11. 发展
  12. 谢谢
  13. 许可证

@ agntn/ 谜题

npm version npm downloads license Ask DeepWiki

公开密码谜题和奖赏,作为打字记录. 你问一个谜题,你得到它的地址,它的关键材料和链上发生的事情.

为什么?

每个谜题线索都有相同的三件事:地址,奖品,以及谁解决了什么. 每一个扫描仪和跟踪器都从线程中重新打出它们,每次都略有不同. 所以他们住在这里一次,作为代码。 谜题是 TypeScript 记录 。 类型检查器在测试之前读取. CLI,MCP服务器和Pi和OMP扩展读取一个登记册.

Docs,每个谜题一页和一个现场游乐场: 谜题.agntn.dev。 。 。 .

[尖叫声] 预1.0. API,CLI旗和数据模型仍然可以移动. 如果你在它的基础上再做一个精确的版本.

* 特性

  • 🧾 数据作为代码. 一个 PuzzleSpec 每个谜题的字元, 由一个 puzzle() 工厂每条链。 没有JSON,没有建设步骤.
  • 🕳️ 缺席意味着缺席. 没有解谜器或奖品的谜题没有这种密钥. 连载都是假的.
  • 🔑 每个形状的关键材料. Hex, WIF, BIP38 有效载荷, 种子短语, 秘密股份, 密封的 Arweave 密钥文件, 或只是略宽一些 。 多相之键也. 一个建筑师.
  • 💤 懒活登记. 正在导入包装入无记录 . get("bits/71") 导入一个收集模块.
  • ✅ 核查是一种价值. 已公布的密钥获得地址或者它没有. 无所投出坏记录.
  • 💰 生活平衡。 。 . puzzle.balance() 结束 @agntn/explorers基本单位为: bigint,API 密钥因出错而编辑.
  • 👀 出录一表. puzzles watch 列出存款和支出记录缺失, 奖金移动, 公用钥匙, 支出送出, 源页更改。 它从来不编辑记录。 你这样做.
  • 📋 周末前的核对表. puzzles eligibility 收集来源,地址,来自探险家的终身总数,其证据的状态和算什么作为解决方案. 不管谁能填满什么 都会像一个 missing 排队,从不猜测.
  • 🖼️ 谜题本身,不是它的一个链接. puzzles_assets 将图像模型、舞台文件和提示后面的存档帖子 与SHA -256记录针对照 链接腐烂。 这些没有.
  • 🤖 十五个代理工具. MCP, Pi 和 OMP 背后的一位执行者. 到处都是同样的答案.
  • 🌐 到处跑. 在获取 API 上中立的无害环境管理 。 节点 浏览器 边缘工人.

QQ 安装

pnpm add @agntn/puzzles

节点.js 26或更新的CLI.

第一次通话

npx @agntn/puzzles stats

印出总数,每个状态一个数 有多少谜题有已知的公钥。 没有钥匙 没有配置 没有网络 包裹内的纪录船. 赤裸裸的 puzzles 以下为 pnpm exec puzzles 在本地状态之后 pnpm add或仅仅是 puzzles 之后 pnpm add -g @agntn/puzzles。 。 。 .

puzzles show hash-collision/sha256
hash-collision/sha256	unsolved	0.27734251 BTC	35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
chain: bitcoin  address kind: p2sh
hash160: 292fb39df7cd619a396069383928e6bfb74ebec5
redeem script: 6e879169a87ca887 (hash 292fb39df7cd619a396069383928e6bfb74ebec5)
public key: unknown
private key: unknown
started: 2013-09-13 05:59:09
transactions: 1
    funding	2013-09-13 05:59:09	0.1 BTC	397f12ee15f8a3d2ab25c0f6bb7d3c64d2038ca056af10dd8251b98ae0f076b0
explorer: https://blockstream.info/address/35Snmmy3uhaer2gTboc81ayCip4m9DT4ko
source: https://bitcointalk.org/index.php?topic=293382.0

图标

命令印着什么
puzzles stats总数、状况计数、奖金和数据版本
puzzles collections每集一行:按键、计数、作者
puzzles authors [key]每个作者一行,或作者有其来源事实的记录
puzzles author <key>一个作者的记录,直接从 puzzles_author 工具
puzzles solvers [key]每个命名的解析器一行,或者一个解析器的记录:每个解析,剖析和来源的事实
puzzles solver <key>一个解决者的记录,直接从 puzzles_solver 工具
puzzles show <id>一个谜题的记录:关键材料,交易,提示和链接. --json 数据
puzzles hints <id>收藏的提示,谜题的自有,然后是它的提示文件. --json 两者
puzzles stages <id>多阶段谜题的阶段与他们的页面,文件和已公布的答案. --json 用于列表
puzzles assets <id>SHA -256和大小的拼图船 存档页. --read <path> 写一个, --check编号 :--live 校验
puzzles list [collection]每行一个谜题. --address, (中文(简体) ), --chain, (中文(简体) ), --status, (中文(简体) ), --technique 财务报告和审定财务报表 --with-pubkey 缩小范围, --limit 财务报告和审定财务报表 --offset 页面
puzzles verify [id]已经公布的密钥及其与地址相对的配方. --all 或 list 集的过滤器, 在不匹配时退出 1
puzzles balance [id]活平相会. 这个 list 过滤器检查整个集,每集一行. --api-key,或每个链条一个变量
puzzles watch [id]链子知道什么 记录没有. --since 检查源页, 任何发现的第1出入口
puzzles eligibility <query>奖项工作前的核对表,通过身份或地址。 缺少任何字段时退出 1
puzzles export整个数据集及其 data_version
puzzles mcpMCP 服务器通过 stdio

--json 打印文本后的数据, bigint 作为字符串和遗漏的字段。 命令来自代理商得到的相同的工具定义,所以旗下的一个打字失败了,就像它失败了模型一样. 旗帜和出口代码在 CLI 指南。 。 。 .

图书馆

import { get, stats, verify } from "@agntn/puzzles";
import { bits } from "@agntn/puzzles/collections/bits";

const puzzle = await get("bits/71"); // loads the bits collection, nothing else
puzzle?.address().value; // "1PWo3JeB9jrGwfHDNpdGK54CRas7fsVzXU"
puzzle?.keyRange(); // [2n ** 70n, 2n ** 71n - 1n]

(await verify(bits.require(1))).verified; // true, key 1 derives its address
(await stats()).unsolved; // how many are still waiting for a key
(await bits.require(71).balance()).totalUnits(); // 7.10190014 when I ran it, mempool.space decides

这是大部分,真的。 收藏是它自己的入口 上面的一切都是同步的 横跨收藏的视图在等待一负荷。 出错从 PuzzlesError平衡有他们自己的家庭 BalanceError其余部分在指南中: 记录, (中文(简体) ), 登记, (中文(简体) ), 浏览, (中文(简体) ), 核查, (中文(简体) ), 结余。 。 。 .

· 收款情况

密钥链条这是什么
bits比特币1至256比特的密钥,每个地址一个
quizchain比特币以键为链的查询区块
quizchain2比特币Quizchain第二出道 从2019年5月起
rushwallet比特币2014年比赛的脑袋
zden比特币,乙烷,利特币,去除Zden 的视觉谜题
weaver, etherTiamat 谜题编织系列
move-over-brokers比特币十二个隐藏在块链簿中的密钥
mini比特币,比特币现金退休的Coder的七个小谜团
warp比特币Keybase 的 scrypt 脑钱包挑战
hash-collision比特币彼得·托德的P2SH相撞弹
teikhos醚支付公用钥匙的合同
ballet比特币BIP38 键被打印在物理钱包上
dug比特币2025年学生种子狩猎
coin-games比特币有头骨、狮子和金星的钞票
bitimage比特币从相片上散出种子
luckylurker比特币二个比特币假发种子挑战
iamabananaamaa比特币一个ZIP在GIF, 然后一个假凯撒
doges-gambit乙烷、多吉币两把钥匙读出一盘棋盘视频
crypto-puzzles醚隐藏在短视频中的原始以太密钥
walking-banks比特币藏在比特币惊悚小说里的种子
grycoin比特币Quizchain 重新命名, 在关闭前几天
smith-lyle-moore比特币一个乐队的两次打猎,每一次
real-big-block比特币777 mBTC for a Wattpad 分会,无要求
school-of-bitcoin比特币后面有张1M的名片
liberte-guidant-le-peuple比特币穿黄背心的Delacroix,法语种子
hunting-time比特币在小说中伪装成时代的种子词
bitaps比特币5个秘密分享计划中的3个
gsmg比特币多相相图像谜题
movie-enigma比特币作为种子词的电影标题,已解决 2026
ledger-donjon比特币剪刀保密分享
coin-artist比特币TORCHED H34R7S 画
genesis比特币创世纪块 OP RETURN 拼图
mineshop醚种子在视频和帖子之间分割
satoshi-birthday-quiz比特币7个答题被拼入钱包
book-quiz比特币一个书考,没有谁及时赢了
80-bit比特币80个隐藏的位子和一个集市比赛
wickex比特币Hex, Morse 和一个分光谱密码句
picture-puzzle比特币四张拼写密钥数据库的相片
brave-new-world比特币隐藏在2020年拼图中的种子短语
wealth-in-poetry比特币隐藏在2019年中篇散文中的种子词
path-to-greatness立克币游戏演示的线索, Litecoin 密钥
proof-of-writing电子现金散文对角上的卡什塔布种子
bitaddress比特币BIP38 有被遗忘密码的钱包
powerful-moss基础专辑中的种子,合同中的奖金
trivia-brainwallet比特币十二个三维谜语被盐化成碎屑
great-riddle比特币隐藏在球点笔画中的种子词
satoshi-maze比特币一个从e乘以2个 Base58 字的质数
natasha-otomoski比特币8个骆驼字作为原始密钥字节
phy比特币一个签名的帖子和一个灰色的螺旋相间
seed-phrase比特币约会线索,然后两年的沉默
9vw04比特币一个微博中的世界投资基金,彩虹未包含在内

标识符是 collection/name单子,例如 gsmg, (中文(简体) ), genesis 或者说 80-bit只是关键 每个集都有一页 故事、怪事和每个谜题: 谜题.agntn.dev/收藏。 。 。 .

代理人

claude mcp add puzzles --scope user -- npx -y @agntn/puzzles mcp
claude mcp add --transport http puzzles https://puzzles.agntn.dev/mcp # nothing to install
pi install npm:@agntn/puzzles
{
  "mcpServers": {
    "puzzles": { "command": "npx", "args": ["-y", "@agntn/puzzles", "mcp"] }
  }
}

15个工具: puzzles_stats, (中文(简体) ), puzzles_collections, (中文(简体) ), puzzles_authors, (中文(简体) ), puzzles_author, (中文(简体) ), puzzles_solvers, (中文(简体) ), puzzles_solver, (中文(简体) ), puzzles_show, (中文(简体) ), puzzles_hints, (中文(简体) ), puzzles_stages, (中文(简体) ), puzzles_assets, (中文(简体) ), puzzles_list, (中文(简体) ), puzzles_verify, (中文(简体) ), puzzles_balance, (中文(简体) ), puzzles_watch 财务报告和审定财务报表 puzzles_eligibility。最后三个离开过程,同样 puzzles_assets 当它读一个文件。 他们的说明是这样说的。 文本包含什么,限制在哪里: 代理指南。 。 。 .

~ 这不起作用 ~

解无所取. 没有扫描仪,没有袋鼠, 没有脑花饼干, 和没有猜测 从交易列表. solved, (中文(简体) ), swept, (中文(简体) ), claimed 财务报告和审定财务报表 expired 因为债权交易加上已公布的密钥仍意味着解决。 链式事实来自 @agntn/chains,从 @agntn/keys 余额 @agntn/explorers。这个包裹不会重新执行其中的任何一项.

添加谜题

一个记录文件下 src/collections/<key>/ 和收藏模块中的一行。 礛 pnpm test 运行数据门:独特的ID、地址和txid格式、密钥衍生、BIP38有效载荷、资产路径及其SHA-256,无空。 记录的形状在 谜题记录 和规则 捐款额。 。 。 .

发展

pnpm install      # the library and the docs site, one lockfile
pnpm lint         # vp lint and vp fmt, docs included
pnpm typecheck    # builds first, then checks src, Pi and OMP
pnpm test         # unit tests and the data gate
pnpm test:packed  # packs the tarball and runs every published entry without src/
pnpm run docs     # the Docus site on localhost

一个安装也覆盖了网站. 没有第二次旅行 docs/没有第二个锁文件 悄悄地离开第一个。 还有 run 最后一行不是装饰 pnpm 12有一个 docs 它想要一个包名,而不是我们的网站.

谢谢

此软件包的存在得益于Anthropic和OpenAI的开源程序: Claude 打开源代码 财务报告和审定财务报表 开源代码。 。 。 .

许可证

麻省理工学院

版本与发布记录

@agntn/puzzles 共发布 27 个版本,首次发布于 2026/09/18;过去 12 个月发布了 27 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.31.0latest2026/10/299 天前
0.30.02026/10/1424 天前
0.29.02026/10/071 个月前
0.28.42026/10/071 个月前
0.28.32026/10/061 个月前
0.28.22026/10/051 个月前

关于 @agntn/puzzles 的常见问题

@agntn/puzzles 是什么?

密码、谜题和挑战作为代理商的阶级数据

如何安装 @agntn/puzzles?

在项目目录运行 npm install @agntn/puzzles,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 puzzles,可以用 npx puzzles 直接运行。

@agntn/puzzles 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agntn/puzzles 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agntn/puzzles 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=26。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agntn/puzzles 可以商用吗?

@agntn/puzzles 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agntn/puzzles 的下载量有多少?

根据 npm 官方下载统计,@agntn/puzzles 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,143 次,日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agntn/puzzles 还在维护吗?

最新版本 0.31.0 发布于 2026/10/29(9 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/09/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。