Attested Memory Market

🔄 从 monorepo 同步而来，同时保留完整历史记录。 attested-memory 镜像了 AI-Factory 的规范 monorepo。此处的历史记录只追加（不会强制推送）。 欢迎提交拉取请求——已合并的 PR 会导入回 monorepo，再次同步到此处，因此你的贡献会成为规范内容。 💬 欢迎提交问题 · 拉取请求。

# Attested Memory Hub

Attested Memory — 面向 AI Agent 的可验证记忆
记忆市场 · 真实层 · 来源账本 · 统一的 Memory Unit 合约

首页 · 线上站点 · GitHub Pages · clients/python

生产环境使用 docs/production-postgres.md 中介绍的 PostgreSQL 16 配置。设置 AIFACTORY_PROD=1 并提供生成的 DSN/密钥；SQLite 仅用于本地开发和测试。

面向 AI Agent 的可验证记忆：每条记忆都能证明其来源以及值得信任的理由，因此伪造或投毒的记忆会在 Agent 采取行动之前被发现。它属于开源的 AIMarket 生态系统；作为独立的 AIMarket 兼容 Hub 运行，并与其他 Hub 联邦互通。

该 Hub 围绕统一的 Memory Unit 合约组合了三个可分别部署的服务：

服务	角色	核心功能
memory-market	主要产品：存储、查找、共享和定价可移植的 Agent 记忆	memory.write、memory.read、memory.search、memory.share、memory.score
truth-layer	证据和矛盾分析	memory.verify、claim.check、contradiction.scan、evidence.pack
provenance-ledger	仅追加的来源记录和签名回执	memory.attest、lineage.get、receipt.verify

市场是产品的切入点。真实性和来源是记忆的属性，而非相互竞争的入口。

三个提供方以各自独立的身份向内置 AIMarket Hub 发布 12 项在线功能。随后，AIMarket 和 Independent Alien Monitor 部署都可以发现其签名的 ecosystem.nodes。

Agent 也可以通过生产环境 MCP 端点 https://hub.attestedmemory.net/mcp 直接使用 Hub。该端点提供 market_search 和 market_invoke；搜索结果包含可直接复制的 max_price_usd，Hub 会在开始工作或付款前拒绝被重新定价的路由。请参阅 MCP 接入。

运行 Hub

要求：Docker Compose v2、Git 和 OpenSSL。

./start.sh

start.sh 会调用 scripts/ensure_env.sh，该脚本会在首次运行时生成强密钥，并轮换 .env.example 中遗留的任何 replace-with-* / 短占位符。MEMORY_MARKET_API_KEY 是其中一种密钥；生产部署会将同一值共享给 SaaS 产品外壳。

对于生产主机（HTTPS URL、KOVA、付款接收方、SaaS 边缘服务）：

./scripts/deploy_attested_memory.sh   # maintainers: lives in the AIMarket monorepo; see its header

• 市场控制台和 API：http://127.0.0.1:8810
• AIMarket 兼容 Hub：http://127.0.0.1:9084
• Truth API 文档：http://127.0.0.1:8811/docs
• Provenance API 文档：http://127.0.0.1:8812/docs

start.sh 会固定并获取 Hub 运行时，创建权限模式为 0600 的本地密钥，并启动完整服务栈。数据和签名密钥存储在命名 Docker 卷中。此 Hub 的提供方和来源回执已启用并要求使用 Ed25519 + ML-DSA-65 混合签名。默认配置仅供本地使用；在配置接收钱包之前，直接结算会安全失败。

直接钱包付款

在 .env 中设置运营方的公开 Base 地址，然后重启整个服务栈：

PAYMENT_RECIPIENT=0xYour40HexCharacterBaseAddress

随后即可通过控制台或 /v1/billing API 使用 Base 上的原生 Circle USDC 购买付费记忆单元。资金会直接转入该地址；服务不持有私钥。系统会为每笔订单分配精确金额，验证链上转账已最终确认，并以原子方式发放买家的访问授权。在生产环境中启用前，请参阅付款指南。

若要在两个外部 Alien Monitor 中显示，请在启动前将 AIMARKET_PUBLIC_HUB_URL 设置为部署的公开 HTTPS 源站地址。引导程序会向 modelmarket.dev 和 independentai.network 发布公告；这些根节点的运营方仍须批准并固定该对等方。请参阅 Alien Monitor 集成。

开发

每项服务都是独立的 Python 包，可单独测试：

./scripts/check.sh

这些 API 有意采用内容哈希和引用，而不是在服务之间传输私有源材料。请参阅架构、功能、安全、付款和变现。

安全审查状态、已修复的问题和生产部署关卡记录在 docs/security-audit-2026-09-06.md 中。

源代码与贡献

在 AIMarket 单体代码库中开发，并发布为 alexar76/attested-memory。发布的 代码库还在 apps/ 下包含基于此 Hub 构建的三个产品外壳： Personal Attested Memory、Team Memory OS 和 Expert Memory Market。欢迎在该代码库中提交问题和拉取请求。

状态

这是一个可自托管的 MVP：已实现持久记忆记录、确定性证据评分、仅追加的混合签名来源记录、十二项 Hub 功能、双根联邦引导、直接 Base USDC 结算和运营方控制台。语义验证、嵌入、托管／x402 授权、退款、多租户和生产级身份均为明确的扩展点，而非模拟功能。

许可证

Apache-2.0。请参阅 LICENSE。