dmt-receipts

DMT Receipts

通过 TAP Protocol / Ordinals 实现可移植、永久保存在 Bitcoin 上的 Agent 记忆。

DMT Receipts 是一个本地 stdio MCP 服务（prepare_memory、verify_inscription），并提供浏览器演示。它会将包含 5 个字段的 dmt-memory/v1 JSON 对象转换为可用于铭文的载荷。这里所说的永久保存，意味着这些记忆字节已作为 Ordinals 铭文内容提交到 Bitcoin L1，并符合 TAP（"p":"tap"）规范。请在你控制的存储中保留记忆，以及铭文 ID / txid。调用 prepare_memory 后，状态为 已准备。钱包或 Ordinals 工具负责铭刻这些字节并支付 Bitcoin 费用。

在线站点 · 协议指南 · 仓库介绍 · 完整规范 · TAP 规范

维护者：github.com/Colchora

从这里开始

在线站点可在浏览器中准备并验证记忆。不会上传任何内容；收据会保存在 localStorage 中，直到你将其导出。本软件包与本地 MCP 服务使用相同的协议。它未发布到 npm registry，因此请从克隆的仓库安装（见下文）或使用在线站点。

你的需求	位置
准备记忆，无需安装	在线应用 → 锚定
验证铭文	在线应用 → 验证
查看保存在此浏览器中的收据	在线应用 → 收据
验证本地工具	先运行 npm ci，再运行 node examples/run-demo.mjs
Agent 索引（工具、运行、演示）	此仓库中的 llms.txt
规范字节规则	在线 llms.txt
完整协议	spec.md
机器可读清单	agent.json
MCP 注册表 ID	io.github.Colchora/dmt-receipts（server.json、glama.json）

可选的随喜资助与铭文费用相互独立：支持和回购。

收据能证明什么——以及不能证明什么

收据可以证明	收据无法证明
这些确切的规范字节已作为 Ordinals 内容铭刻在 Bitcoin 交易中（当 inscription_id / 内容匹配时）。	谁创建或拥有这些字节；作者身份需要另行采用签名方案。
本地 verify_inscription 可以重新计算摘要，并可选地获取公开的铭文内容进行比较。	记忆的真实性、准确性、原创性、意图或排他性所有权。
TAP 索引器 / Ordinals 浏览器可以独立于此仓库显示该铭文。	免费的仅哈希日历证明。铭文费用是真实的 Bitcoin 费用。

此 MCP 服务不会广播交易或支付费用。调用 prepare_memory 后，状态为已准备，而非已铭刻。

使用演示

Node.js 18+。npm ci 会安装依赖并构建 dist/index.js。该服务通过 stdin 使用 MCP 通信，并会保持开启，直到客户端连接。

git clone https://github.com/Colchora/dmt-receipts.git
cd dmt-receipts
npm ci
node examples/run-demo.mjs

该脚本会对 examples/demo-memory.json 调用 prepare_memory，然后在不提供 inscription id 的情况下调用 verify_inscription。通过检查后会输出：

检查项	值
sha256	76f3f9ff531cecbfe46e676e932f9b0d9d02b3d7c04e5a558924a8092cb0294b
byte_length	170
status	prepared
matches_expected_sha256	true
ok	在字节被铭刻之前为 false

内存仅处于准备状态时，ok 会保持为 false。只有铭刻内容与规范字节匹配，后续验证才能成功。相同的数值也记录在 examples/expected-digest.json 中。

构建完成后，Cursor 会加载 .cursor/mcp.json。${workspaceFolder} 是包含该文件的目录：

{
  "mcpServers": {
    "dmt-receipts": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"]
    }
  }
}

Claude Desktop 和其他客户端使用构建文件的绝对路径：

{
  "mcpServers": {
    "dmt-receipts": {
      "command": "node",
      "args": ["/absolute/path/to/dmt-receipts/dist/index.js"]
    }
  }
}

使用 examples/demo-memory.json 中的五个字段（agent_id、key、content、tags、created_at）调用 prepare_memory。将返回的 memory 和 sha256 传给 verify_inscription，并将 fetch_content 和 include_trac 设为 false，直到获得 inscription_id。

工具：

• prepare_memory — 规范化内存、计算哈希，并返回 Ordinals/TAP 铭刻方案（UTF-8 内容 + 可选的 dta 指针）。
• verify_inscription — 重新计算摘要；可选择获取铭刻内容并进行比较；返回区块浏览器链接。

操作指南：examples/README.md。Agent 索引：llms.txt。协议字节：在线 llms.txt。

检查

npm run typecheck
npm run build
npm test

npm run typecheck 会运行 tsc --noEmit。编译器使用 strict、noUncheckedIndexedAccess 和 exactOptionalPropertyTypes。npm test 会重新构建 dist/、运行单元测试，并运行 examples/run-demo.mjs。

准备、铭刻、验证

1. 使用 agent_id、key 和 content 调用 prepare_memory。
2. 使用 TAP Wallet 或任何 Ordinals/TAP 工具，将 inscription_recipe.content_utf8 作为 Ordinals 内容（application/json 或 text/plain）铭刻。可选的 TAP dta（≤512 字节）可在 token-deploy 流程中携带 sha256:<hex>。
3. 使用 inscription_id / txid 存储内存。
4. 使用内存和 inscription_id 调用 verify_inscription。

无需安装，即可在浏览器中执行相同的准备和验证步骤：Anchor，然后是 Verify。

规范内存格式

紧凑的 UTF-8 JSON，不带尾随换行符，键按 Unicode 码点排序，非 ASCII 字符以字面形式表示：

{"agent_id":"demo-agent","content":"Remember this exact state.","created_at":"2026-11-05T17:00:00Z","key":"notes/hello","tags":["demo"]}

字段	类型	说明
agent_id	string	Agent 的稳定标识符。
key	string	内存键、slug 或路径。
content	string、object、array、number 或 boolean	嵌套值必须与 JSON 兼容。
tags	字符串数组	没有标签时使用 []。
created_at	string	以 Z 结尾的 ISO-8601 UTC 时间，精确到整秒。
(扩展字段)	任意 JSON 值	可选。额外字段会与其他字段一起排序，并纳入哈希。prepare_memory 会保留其他工具参数。

协议与隐私

铭刻内容会公开在 Bitcoin 上。请勿铭刻机密信息。此工具绝不会将内存字节上传到自有后端；如果在验证期间获取内容，你将连接到公共区块浏览器。

许可证

MIT

支持与 Tap 回购

实时网站上提供可选的诚信制资助：

• 支持计划 — 免费准备、支持、Tap 回购
• 回购中心 — 所有贡献所得都定向至此（USDC 地址 + 本地付款参考记录）

准备/铭刻记忆的工具始终免费，但需支付给矿工/铭刻服务商的 Bitcoin 网络铭刻费用除外。此代码库不处理银行卡付款。