Privi Quantum Ledger

Privi Quantum Ledger MCP

（原名 Privi Ledger）

为 AI Agent 提供量子封存、防篡改的审计日志。 每家运行 Agent 的公司都需要证明这些 Agent 做了什么：访问了哪些数据、支付了什么、修改了什么，以及记录之后没有人篡改。Privi Ledger 为任何支持 MCP 的 Agent 提供记录每项操作的途径，也为审计人员提供验证日志的方式；每次检查通过 x402 使用 Base 上的 USDC 付费。

适用于 Claude、ChatGPT、Cursor、VS Code 和自定义 Agent。由 Privi World Co 构建，采用与 Privi Verify 相同的记录技术。

在线（测试网）： https://privi-ledger.onrender.com/mcp

工具

实时工具（live_*、approval_*、trust_events、gateway_*、room_*）详见下文的 Privi Live。

工具	访问权限	功能
ledger_pricing	免费	价格、网络、操作类型以及如何获取密钥
ledger_check_receipt	免费	确认操作回执（entry_hash）是否存在以及存在时间；不会披露内容
ledger_audit_stream	$0.02（x402）	审计 Agent 日志的完整性：是否完整、损坏位置、条目数、时间范围和头哈希。不包含操作内容
ledger_record_action	组织密钥	追加一项操作；返回条目及其 entry_hash 回执
ledger_read_stream	组织密钥	读取自己的条目并检查完整性
ledger_list_streams	组织密钥	查看自己的日志流及条目数
ledger_compliance_report	组织密钥	生成指定时段的 Agent 活动审计报告，并将其封存到 Privi 链上
ledger_report_pdf	组织密钥	获取封存报告的完整 PDF（也可使用组织密钥通过 GET /reports/<id>.pdf 获取）
ledger_handshake_offer / _accept / _reject / _inbox	组织密钥	Privi Handshake：记录公司之间交易往来的双方记录
ledger_handshake_verify	免费	公开检查握手记录及其链上封存；绝不披露条款
ledger_verify_report	免费	证明报告未被篡改且由 Privi Ledger 签发；检查其链上封存

操作类型：tool_call、data_access、data_change、payment、message、decision、approval、error、other。结果：success、failure、pending、blocked。

日志如何保持可信

每个条目的 SHA-256 指纹都包含其内容和同一日志流中前一个条目的指纹。编辑、删除或重新排序任何条目都会破坏从该条目开始的链，审计会报告链损坏的确切条目。组织只能查看自己的日志流；API 密钥以哈希形式存储。

日志流头部每隔几分钟就会锚定到 Privi 区块链上（参见“链上检查点”），因此无需信任 Privi 即可证明完整性。

套餐（自助服务）

套餐	方式	包含内容
免费	ledger_signup（无需密钥）	所有工具，每月最多 500 条记录
Pro	ledger_upgrade_pro，通过 x402 支付 29 USDC，有效期 30 天	无限条目；每次付款增加 30 天有效期
Enterprise	由 Privi 创建（/admin/orgs）	无限使用；按协议计费

任何公司或代表公司行事的 AI Agent，都可以自行注册、开始记录并升级，无需联系任何人。付款直接发送到 LEDGER_PAY_TO，每笔购买都会记录在组织自己的 privi-billing 日志流中。ledger_plan 可显示用量和续订情况。设置 LEDGER_FREE_MONTHLY 和 LEDGER_PRICE_PRO_MONTH 可更改限额。

为客户开通服务

使用管理员密钥（设置 LEDGER_ADMIN_KEY）创建组织：

curl -X POST https://<host>/admin/orgs \
  -H "Authorization: Bearer $LEDGER_ADMIN_KEY" -H 'Content-Type: application/json' \
  -d '{"name": "Acme Robotics"}'
# -> {"org_id": "org_...", "api_key": "plk_...", ...}  (the key is shown once)

客户将服务器添加到自己的 Agent，并在请求头中设置 Authorization: Bearer plk_...，然后指示 Agent 在每项重要操作后调用 ledger_record_action。客户将 org_id 和日志流名称分享给审计人员，由审计人员调用 ledger_audit_stream。

合规报告

ledger_compliance_report 会将组织的 Agent 日志转化为 SOC 2 审查、客户安全问卷和 AI 监管记录所需的证据。对于任意时间段，它都会报告各类型操作、执行者、失败、被阻止的操作、人工审批、日志完整性和链上状态。它还会列出审计人员可能提出的发现，例如完整性遭到破坏、日志尚未锚定、操作失败，或付款和数据变更没有记录人工审批。结果以 JSON 和可直接分享的 Markdown 版本提供。

每份报告都经过封存。报告的 SHA-256 哈希基于规范化 JSON 计算，并通过 Privi Anchor 锚定到 Privi 区块链上。任何持有报告的人都可以运行 ledger_verify_report，重新计算哈希，确认 Privi Ledger 签发的内容完全一致，并检查链上的锚定情况。即使只修改一个数字，例如隐藏一次失败，验证也会失败。

Privi Gov AI 清单（OMB M-25-21）

联邦机构必须维护其 AI 用例清单，以机器可读文件的形式发布可公开的用例，并展示高影响 AI 的最低风险实践。这项要求源自 OMB 备忘录 M-25-21 以及 OMB 关于 2025 年机构 AI 报告的指南。Privi Ledger 覆盖整个流程：

工具	功能
gov_ai_usecase_save	按照指南规定的报告字段添加或更新用例。每次更改都会生成一个新版本，并写入机构具备防篡改能力的 ai-inventory 日志
gov_ai_inventory	当前清单
gov_ai_inventory_check	标记审查时会指出的问题：缺少必填字段、含有 PII 却没有隐私影响评估，以及试点或部署中的高影响 AI 缺少任何一项最低实践（测试、影响评估、独立审查、监控、操作员培训、故障保护、申诉、公众反馈），或缺少近期活跃的活动日志作为监控证据。书面 CAIO 决定豁免的实践会予以认可
gov_ai_inventory_export	导出供 agency.gov/ai 发布的可公开用例 CSV，并在 Privi 链上封存其 SHA-256 哈希
gov_ai_verify_export（免费）	证明已发布的清单文件与机构导出的文件完全一致

清单会关联到各 Agent 的 Privi Ledger 活动日志（monitoring_streams），因此，“持续监控”有真实且具备防篡改能力的记录作为依据。

字段名称遵循 OMB 发布的报告字段。提交前请对照 OMB 当前使用的模板进行确认。此工具用于支持合规工作，不构成法律建议，也不是 OMB 批准的系统。

Privi 量子就绪（后量子迁移）

第 14409 号行政令（2026 年 6 月）要求联邦机构在 2030 年 12 月 31 日前将密钥建立迁移到后量子密码学，并在 2031 年 12 月 31 日前迁移数字签名。OMB M-26-15 要求每个机构制定迁移计划，并以密码资产清单（CBOM）为基础，优先处理高价值资产、高影响系统以及 2030 年之后仍须保持敏感的数据，同时要求在 2030 年 1 月 2 日前支持 TLS 1.3。

工具	功能
gov_pqc_classify（免费）	对算法和密码套件分类：易受量子攻击（RSA、ECDH、ECDSA、EdDSA、DH、DSA、MQV）、后量子（ML-KEM、ML-DSA、SLH-DSA）、混合、对称／哈希或未知
gov_pqc_system_save	记录一个系统的密码资产（由人员、扫描器或 Agent 提供）。版本化记录，并写入防篡改的 pqc-inventory 日志
gov_pqc_inventory	当前资产清单
gov_pqc_plan	按优先级排列的迁移队列，包含每项资产的截止日期和 NIST 替换方案、进度指标及调查结果：已过截止日期的目标、低于 1.3 的 TLS、没有目标日期的优先资产、无法识别的算法
gov_pqc_export	将 CBOM 和计划合并为一份 JSON 文档，并在 Privi 链上封存
gov_pqc_verify_export（免费）	证明导出的文档未被篡改

这些规则依据第 14409 号行政令和 OMB M-26-15 的公开摘要。依赖这些规则前，请对照官方文本和 NIST IR 8547 加以确认。此工具用于支持合规工作，不构成法律建议。

Privi Passport（AI Agent 的信任凭证）

无人能复制的功能：一种经签名并锚定在链上的凭证，用于说明 AI Agent 的可信度；评分范围为 0–1000，且仅依据 Privi Ledger 持有的证据。

组成部分	最高分	证据
历史记录	300	已验证条目数和活跃天数
完整性	250	每条哈希链均通过验证（全有或全无）
锚定情况	150	链上检查点与记录相符的数据流占比
可靠性	100	1 - 失败率
监督	50	敏感操作获得的人工审批
合规性	100	存在已封存且无问题的合规报告
握手	50	由其他 Privi 组织确认的交易

等级：A >= 850，B >= 700，C >= 550，D >= 400，低于此分数为 E。有效期为 30 天。

• passport_issue（组织密钥；Pro／企业版免费，免费套餐通过 x402 收取 $LEDGER_PRICE_PASSPORT）——由服务器使用 Ed25519 签名，哈希锚定在 Privi 链上，并逐项列出每个组成部分。
• passport_verify（免费）——验证签名、内容、有效期、吊销状态、链上锚定，以及实时重新评分：如果 Agent 的历史记录在签发后遭到篡改，Passport 验证将失败。
• passport_gate（免费）——通过一次调用，根据你的最低要求（min_score、min_grade、require_anchored）作出允许／拒绝决定；提供你自己的密钥，决定将记录到你的日志中，作为尽职调查证据。
• passport_list、passport_revoke（组织密钥）。
• 公开接口：GET /passports/<id>（JSON + 实时验证）、GET /passports/<id>/badge.svg（可嵌入的徽章）、GET /.well-known/privi-passport.json（发行方公钥）。

复利效应的来源：使用 Passport 进行准入控制的 Agent 会推动其交易对手加入 Privi Ledger；每条已记录的操作、报告和握手都会提高评分；评分越高，就越能赢得交易。设置 LEDGER_PASSPORT_SIGNING_KEY（32 字节十六进制 Ed25519 种子），即可在重新部署后固定发行方密钥；否则，系统会生成一个密钥并将其存储在数据库中。

Privi KYA（区块链钱包的了解你的 Agent）

随着 AI Agent 成为链上交易的主要发起方，每条链、DeFi 协议、交易所、稳定币发行方和 x402 服务商在接受交易前都需要知道一个答案：这个钱包是否由经过审计的 Agent 操作？它当前的可信度如何？ Privi KYA 给出答案，而且只有 Privi 能做到，因为答案就是 Passport。

• kya_challenge + kya_bind_wallet（组织密钥）— 通过钱包签署 Privi 挑战，将钱包绑定到你的 Passport（EIP-191 personal_sign，使用纯 Python 恢复签名；无需依赖 web3）。未签名的绑定仅为声明。
• kya_check <address>（免费）— 将钱包解析到所属组织及其实时 Passport；返回包含原因的允许/拒绝结果、当前评分和等级，以及由 Privi 签名、有效期为 60 分钟的 KYA 证明，服务商可缓存并离线验证。提交你的密钥后，决策会作为证据记录。
• kya_wallets、kya_unbind_wallet（组织密钥）— 轮换或泄露的密钥会立即被拒绝。
• 连接钱包页面： GET /kya/connect — 粘贴组织密钥，连接 MetaMask，签名一次；完成。无需编写代码。
• 公开接口：GET /kya/<address>（JSON 判定结果 + 证明；?min_score=&min_grade=&require_signed=）、GET /kya/<address>/badge.svg。

链或协议的集成方式：接受 Agent 交易前，调用 GET /kya/<from>；要求 allow: true（还可选要求 proof: "signature"）；将 attestation + signature 保存为合规记录。

Privi Quantum Ledger（量子封印区块，与 Privi Foundation 链融合）

每隔几分钟，整个日志都会被封印为由量子区块构成的链（LEDGER_QBLOCK_INTERVAL，默认 300 s）：

• 每个区块都包含前一区块、透明度日志的签名树头（大小 + Merkle 根），以及所新增条目的 SHA3-512 根。
• 区块使用 SHA3-512（FIPS 202；即使面对 Grover 量子搜索，仍具备 256 位安全性）进行哈希，并使用 ML-DSA-87（FIPS 204、CNSA 2.0）和 Ed25519 联合签名，密钥与 Privi Fortress 相同。
• 相邻区块通过 RFC 9162 一致性证明相连，因此可证明日志只会增长。
• 与 Privi Foundation 链融合（Cosmos SDK + CometBFT + Cosmos EVM，production-network/）：每个区块都列出 Foundation 链 ID（PRIVI_FOUNDATION_COSMOS_CHAIN_ID、PRIVI_FOUNDATION_EVM_CHAIN_ID），并在 PRIVI_FOUNDATION_RPC_URL 指向 Foundation 节点时，携带其最新区块的见证（高度 + 哈希）。在 Foundation 主网启动前，每个区块都会通过 Privi Anchor 在 Base 上结算。

工具（除封印外均免费）：qledger_status、qledger_block、qledger_verify_chain（任何人都可以重新验证整条链）、qledger_entry_proof（证明某个收据已封印在区块中，而不泄露内容）、qledger_seal（组织密钥；立即封印）。Privi Quantum Scan（/quantum-scan）是公开区块浏览器：展示每个区块、条目收据、树头、日志根和 Base 结算哈希，并可按区块高度或任意哈希搜索。只显示哈希和数量，绝不显示组织、流或条目内容。其背后的 JSON 接口：GET /quantum-ledger（状态）、/quantum-ledger/stats、/quantum-ledger/blocks?limit&before、/quantum-ledger/blocks/<height>、/quantum-ledger/entries?limit&offset&block、/quantum-ledger/search?q=。

这是工程控制措施，并非认证（FIPS 140-3、FedRAMP、DoD IL）。

Privi Fortress（防御级完整性控制）

符合 CNSA 2.0 和 NIST SP 800-53 的工程控制（AU-9 审计信息保护、AU-10 不可否认性、AC-5 职责分离、SC-13 加密保护）。这些控制不代表认证（不声称通过 FIPS 140-3 验证，也不声称获得 FedRAMP 或 DoD 影响级别授权）。

• 后量子联合签名。 通行证、合规报告、授权书、KYA 和授权书证明、树头及证据包均使用 Ed25519 和 ML-DSA-87 签名（NIST FIPS 204；CNSA 2.0 参数集）。密钥：fortress_keys、/.well-known/privi-passport.json。使用 LEDGER_PQ_SIGNING_KEY（32 字节十六进制）固定种子；否则系统会生成并存储一个种子。
• 透明度日志。 每个组织的每条记录都是同一棵 RFC 9162 Merkle 树（证书透明度设计）的叶子。ledger_tree_head 返回双重签名的树头，每隔 LEDGER_STH_INTERVAL 秒（默认值为 900）锚定到 Privi 链上；ledger_inclusion_proof 可证明某条记录包含在日志中，ledger_consistency_proof 可证明日志在两个树头之间只增不减。HTTP：/log/sth、/log/inclusion?hash=、/log/consistency?first=&second=。全部免费。
• 双人完整性控制。 fortress_tpi_policy 指定主管的钱包及所需的批准人数（至少为 2）。fortress_tpi_request 返回一个审批页面（/tpi/<id>）；每位主管使用自己的钱包签名，同一主管不能重复批准，外部人员会被拒绝，任何主管都可以否决。fortress_tpi_execute 会一次性使用该授权。每个步骤都会记录日志。
• 隔离网络的证据包。 ledger_evidence_bundle 导出记录、哈希链、包含证明、签名树头、链上检查点和 Privi 的密钥，并附上双重签名。运行 python verify_bundle.py bundle.json（从 /tools/verify_bundle.py 下载）即可在不访问网络的情况下验证所有内容。

Privi 授权书（经人工授权的 Agent 支出）

经签名的证明，表明某人已授权 AI Agent 支出；任何商户或支付服务商都可以在收取 Agent 款项前进行核验。

1. mandate_create（组织密钥）起草条款：预算、单笔支付上限、允许的收款方（0x 地址或域名）、有效期、用途。它会返回一个 sign_url。
2. 人类打开 /mandates/<id>/sign，阅读通俗易懂的条款，并使用自己的钱包签名一次（EIP-191；免费，无需交易）。Privi 会对条款哈希进行共同签名，并将其锚定到 Privi 链上，同时记录此次批准。
3. 每次支付前，Agent 都会调用 mandate_spend；该工具会以原子方式强制执行限额、收款方名单、有效期和剩余预算，并将支付（或被拦截的尝试）写入 Agent 的防篡改日志。
4. 商户和支付服务商调用 mandate_check 或 GET /mandates/<id>/check?amount=&payee=（免费），即可获得允许或拒绝的结果及原因，以及 Privi 签名的证明。
5. 人类可在同一页面使用一次签名撤销授权，组织也可以调用 mandate_revoke。

公开接口：GET /mandates/<id>（条款、签名、预算、近期支出）。

Privi Guard（提示词注入和数据泄露检查，附带凭证）

一次调用即可在 Agent 对内容采取行动或发送内容前进行检查：

• **入站：**提示词注入、伪造的系统轮次、数据外泄和提示词泄露请求、隐瞒行为、工具和支付胁迫、隐藏文本、Markdown 图片数据外泄、Base64 隐藏指令；
• **出站：**云服务和 API 密钥、私钥、令牌、助记词、密码、银行卡号、SSN 和 URL 数据夹带，并提供已脱敏副本。

每次检查都会返回一份 Ed25519 签名的凭证，其中包含内容的 SHA-256 哈希（绝不包含内容本身）。凭证每五分钟批量写入一次 Merkle 透明日志，并锚定到链上。

MCP	guard_check、guard_check_many、guard_receipt、guard_balance、guard_buy_credits、guard_pricing；gateway_set_guard 会通过 Privi Gateway 筛查每个工具结果（tag 或 block）
HTTP	POST /guard/v1/check、/check_many、/signup、/demo（网站，限流，不提供凭证）；GET /guard/v1/receipts/<id>、/pricing、/stats、/revenue（管理员密钥）
价格	每个组织每月免费 1,000 次检查，之后使用额度（1k / 10k / 100k 次，价格分别为 7 / 50 / 300 USDC），或通过 x402 按每次检查 1 美分付费（MCP _meta 或 HTTP PAYMENT-REQUIRED / PAYMENT-SIGNATURE）
SDK	guard-sdk/：Python 和 JS 客户端（零依赖）以及 Claude Code 钩子

Privi Scan（公开 MCP 信任注册表）

Privi Scan 会同步官方 MCP Registry。它只通过 initialize 和 tools/list 读取每个公开的流式 HTTP 服务的工具列表，不会调用任何工具。它会按工具投毒风险为每个服务评级，从 A 到 F：

• 提示词注入标记
• 对用户隐瞒
• 索要 SSH 密钥、.env 文件或助记词
• 工具影子
• 不可见字符
• 未经身份验证即可执行的高影响工具

每个工具定义都会经过哈希处理。首次观察到的内容及每次变更都会写入 Privi Ledger 透明日志（Merkle 树，锚定到链上）。这样，任何人都能永久查证某个服务的工具声明过什么内容，以及何时发生变更。

目录	/scan，单个服务位于 /scan/s/<server_id>
免费检查	mcp_server_check(url, expected_tools_hash?)，或 GET /scan/api/check?url=&expected=
搜索	scan_search、scan_server、scan_changes、scan_stats，或 /scan/api/servers、/scan/api/changes、/scan/api/stats
监控（组织密钥）	scan_watch 会固定 tools_hash，并在你的 org Live 频道上实时发送 scan.tools_changed / scan.risk_found / scan.server_down 事件；免费版支持 3 个服务，Pro 支持 500 个
所有者	scan_claim_start / scan_claim_verify（在 /.well-known/privi-scan.txt 中放置令牌）、scan_rescan、scan_owner_listing（选择退出）
徽章	/scan/badge/<server_id>.svg
Live 频道	scan（公开，免费版会延迟）和 scan:<server_id>

配置：SCAN_ENABLED（默认值为 1）、SCAN_INTERVAL（300 s）、SCAN_BATCH（40）、SCAN_REPROBE_S（6 h）、SCAN_REGISTRY_URL。

Privi Live（实时：流、人工审批、紧急停止开关、网关、房间）

此处的所有功能都通过 WebSocket 和服务器发送事件运行，并由一个持久化事件日志提供支持（可回放 7 天）。

流（live_info 会列出这些流）：wss://…/live/ws、GET /live/events（SSE）、GET /live/trust/recent，以及位于 /live 的仪表板。

• 通道：trust（公开：护照签发 / 撤销 / 重新评分、钱包绑定、授权激活或撤销、透明度日志头锚定）、mandate:<id> 和 org（私有：实时追踪你的审计日志、审批、紧急停止开关和房间）。
• WebSocket 帧：{"type":"auth","key":"…"}、{"type":"subscribe","channels":["trust","org"],"replay":20,"filter":{"address":"0x…","types":["passport."]}}、{"type":"kill","stream_id":"agent|*"}、{"type":"ping"}。服务器帧：{"type":"event","event":"passport.score_changed","id":N,"channel":"trust","at":"…","data":{…}}、heartbeat。
• API 密钥绝不能放在 URL 中：请使用 Authorization: Bearer（SSE/HTTP），或将密钥放在首个 WebSocket 帧中。
• 免费和匿名订阅者收到的公开通道数据会延迟 LIVE_FREE_DELAY_S（默认值为 300 s）；Pro 和企业用户可实时接收。后台监视器每隔 LIVE_TRUST_INTERVAL 秒（默认值为 120）重新评估每个实时护照的评分，并广播评分或状态变化（有效 → 失效 / 过期）。

人工审批。 approval_policy_set 可让 mandate_spend 在付款金额超过阈值时暂停：它会返回 approval_required 和一个 approve_url；授权的委托人使用其钱包（EIP-191）签署批准 / 拒绝消息后，Agent 再次调用 mandate_spend 并传入 approval_id。一项审批只针对一笔付款（授权、金额和收款方必须匹配），自获批后 10 分钟内有效，且只能使用一次。approval_request / approval_wait 可对任意操作执行相同流程。组织的 API 密钥只能取消，因此 Agent 无法自行批准。

紧急停止开关。 live_kill（或 privi kill、/live 仪表板或 WebSocket 帧）可在下一次调用时，停止某个或所有 Agent 的 mandate_spend、组织网关和房间消息，并向实时通道推送 agent.killed。审计日志记录绝不会被阻止。live_resume 可解除停止状态。

网关。 gateway_create 可将任意公开的 HTTPS MCP 服务接入 /gw/<id>/mcp（以及 wss://…/gw/<id>/ws，通过一条持久连接传输相同的 JSON-RPC）。Privi 会对每位调用者实施速率限制，可以要求提供护照（min_score：调用者需使用新鲜的 personal_sign，对 Privi Gateway <id>\nTimestamp: <ts> 签名，以证明其 KYA 钱包），对每个 tools/call 计量，将每次调用写入你的日志，并原样转发请求（包括 x402 付款标头），因此上游自身的付费墙仍会生效。紧急停止开关可立即停止网关。解析到私有、回环或链路本地地址的上游服务将被拒绝。免费方案：1,000 次计量调用和 2 个网关；Pro：不限调用次数，50 个网关。每个工具的统计信息：gateway_stats。

房间。 room_open 可在两个组织的 Agent 之间创建实时的哈希链式对话（wss://…/rooms/<id>/ws；可通过组织 ID 或一次性加入码邀请）。可选按消息向访客收费，由其人工签署的授权支付（预算、上限、收款方列表、审批策略和紧急停止开关均适用）。关闭房间后，对话记录将被封存：使用 Ed25519 和 ML-DSA-87 签名，锚定到 Privi 链上，并写入两个组织的日志。room_verify（免费）可根据封存记录验证对话记录。Privi 会执行并记录每条消息的费用；资金划转由双方自行处理。

Privi AI Act Pack（欧盟《人工智能法案》登记册）

在欧盟构建或使用 AI 的每家公司，都需要了解每个系统的风险级别，并证明其履行了相关义务。 ai_act_system_save 用于登记系统、筛查其是否违反第 5 条禁令、对其分类（禁止 / 高风险 / 透明度 / 通用 / 最低风险），并列出其角色对应的义务及日期（根据《数字综合法案》Regulation (EU) 2026/1744，附件 III 高风险义务自 2027 年 12 月 2 日起适用，附件 I 自 2028 年 8 月 2 日起适用）。ai_act_check 用于标记缺漏；ai_act_export 会返回一份在链上封存的登记册，任何人都可以使用 ai_act_verify_export 免费核验。本工具用于辅助工作流，不构成法律建议。

Privi Supplier Proof（买方要求，供应商加入）

买方发布供应商必须证明的事项（supplier_requirement_create，可分享的邀请页面位于 /supplier/requirements/<id>）。供应商使用自己的 Privi 组织提交答复，其中仅包含文档指纹（supplier_proof_submit）。审批通过后（supplier_proof_decide），Privi 会颁发证书，列出双方公司和证据哈希，并在链上封存；证书还提供公开页面 /certs/<id> 和徽章 /certs/<id>/badge.svg。supplier_cert_verify 可免费核验，并确认是否涵盖特定文档。

Privi Content Seal（辨别真实内容与 AI 生成内容）

seal_content 会封存文件或文本的 SHA-256 哈希、创作者身份，以及是否涉及 AI（human、ai_assisted、ai_edited、ai_generated + tool）；最多 50 项内容可批量使用一个链上锚点。任何人都可以通过 seal_verify、GET /seal/<sha256>、徽章或拖放页面 /seal/check 免费核验（文件会在浏览器中计算哈希，绝不会上传）。

Privi Handshake

两家公司之间的交易，例如付款、数据传输、交付或协议，会由双方共同记录，任何一方都无法单独否认或改写记录。

1. 公司 A 的 Agent 使用另一家公司的 org_id 和交易条款调用 ledger_handshake_offer。A 的日志会记录该提议。
2. 公司 B 的 Agent 可在 ledger_handshake_inbox 中查看提议，并调用 ledger_handshake_accept 接受，或调用 ledger_handshake_reject 并说明原因。
3. 接受后，B 的日志会记录相同条款及 A 条目的哈希；A 的日志会记录确认信息及 B 条目的哈希；绑定条款和双方条目的配对哈希则会锚定到 Privi 区块链上。
4. 任何人都可以运行 ledger_handshake_verify，查看双方、状态、双方条目是否仍然存在以及链上封存信息，而无需查看交易条款。

Handshake 仅适用于 Privi Ledger 上的组织。

链上检查点

服务器每 5 分钟会通过 Privi Anchor 将每条有变更数据流的最新指纹锚定到 Privi 区块链上。审计结果包含 onchain_checkpoint：锚定位置、交易和 Merkle 证明，以及任何人都可以运行的 anchor_verify 调用。如果存储的历史记录与锚定内容不再匹配，即使所有本地哈希都已重新计算且彼此一致，审计仍会失败。设置 LEDGER_ANCHOR_KEY（Anchor API 密钥）即可启用此功能；LEDGER_ANCHOR_INTERVAL 可更改间隔（秒，默认为 300）。

付款

与 Privi Verify 使用相同的 x402 v2 MCP 流程：未付款的调用会返回 PaymentRequired；Agent 会在 _meta["x402/payment"] 中附上签名的 USDC 授权后重试；服务器验证授权、运行审计、结算并在 _meta["x402/payment-response"] 中返回收据。资金会直接转入 LEDGER_PAY_TO。

运行、测试、部署

pip install -e ".[dev]"
cp .env.example .env
pytest
privi-ledger-mcp            # HTTP :8000, MCP at /mcp
privi-ledger-mcp --stdio    # local clients; set LEDGER_LOCAL_ORG_KEY

Dockerfile 可在 Railway 上运行，并使用 /data 卷。请从 base-sepolia 开始；只有在使用生产环境的 facilitator 时，才切换到 base。

路线图

• 按组织订阅计费
• 保留策略并导出到客户存储空间

许可证

MIT © 2026 Dario Canoy, Privi World Co

双重支付基础：USDC 生产计费 + 无价值 PRVI_TEST 模拟

现有的 通过 x402 使用 USDC 的支付工具保持不变。新增的 MCP 工具 privi_payment_options 会报告两条明确区分的路径：

• USDC_X402：现有的真实／暂存支付通道，具体取决于 LEDGER_NETWORK 和 LEDGER_PAYMENTS_ENABLED。所有结算仍通过现有的促进服务处理。
• PRVI_TEST_SIMULATION：严格限于链下、无价值的开发者模拟器。 它不能支付服务费用、发行或转移 PRVI、授予 Ledger Pro、增加 Guard 额度、 激活任何金融链，也不能用作结算证明。

模拟器默认禁用。如需在一次性开发环境 或隔离的暂存服务中启用，请设置 PRVI_TEST_PAYMENT_MODE=1 并且 设置 LEDGER_NETWORK=base-sepolia。当 LEDGER_NETWORK=base 时，即使设置了 该标志，模拟也始终会被强制关闭。生产环境中请将该标志保持为 0。

拥有 API 密钥的已验证 Ledger 组织可以执行以下操作：

1. privi_payment_options（无需密钥；列出支付方式和上线状态）。
2. privi_test_payment_quote，并设置 sku=ledger_upgrade_pro（需要 API 密钥）。
3. privi_test_payment_simulate，使用返回的报价 ID 和 acknowledgement="VALUELESS TEST ONLY"（使用同一组织的密钥）。

模拟回执会显示 SIMULATED_NOT_PAID、paid: false、settled: false、 service_unlocked: false 和 real_transaction_hash: null。报价 10 分钟后过期， 绑定到单个组织，且只能使用一次，并存放在进程的临时内存中。真实 USDC 计费 仍仅通过现有工具（例如 ledger_upgrade_pro）和原有的 x402 促进服务处理。

尚未启用 PRVI 原生真实结算。 在设计任何具有真实价值的 PRVI 路径之前， PRVI 主网发布、费用和代币经济模型、安全审计、独立验证者、法律审查、 链 ID、预言机／报价政策、托管和支付重放保护必须分别通过经审查的上线关卡。

运行隔离的开发者安全测试套件：

cd ledger-server && python -m pytest tests/test_dual_payments.py