policyvault

Name: policyvault
Author: zapsoblige-hash

本地服务

github.com/zapsoblige-hash金融数据13 周前更新

代码仓库

关于 policyvault

PolicyVault 为 Kaspa L1 上的资金所有者和 Agent 提供委托支出金库。支出策略由共识层协定执行，签名者保留资金托管权；项目还提供 MCP 服务和客户端库。

主要功能

01共识层强制执行支出策略
02委托支出且不转移托管权
03所有者审批与金库操作
04Python 客户端及 Agent 集成

适用场景

01为 AI Agent 设置支出限额
02向员工或服务委托资金
03要求所有者审批委托规则变更

MCP 相关

`policyvault-mcp` 服务向 MCP 客户端提供 PolicyVault 操作；不提供创世、签名或提交工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "zapsoblige-hash-policyvault": {
      "command": "npx",
      "args": [
        "-y",
        "policyvault-mcp"
      ],
      "env": {
        "POLICYVAULT_MCP_SERVER_URL": "<POLICYVAULT_MCP_SERVER_URL>",
        "POLICYVAULT_MCP_TOKEN": "<POLICYVAULT_MCP_TOKEN>",
        "POLICYVAULT_MCP_SCOPES": "<POLICYVAULT_MCP_SCOPES>"
      }
    }
  }
}

启动命令npx -y policyvault-mcp

需要配置的环境变量

POLICYVAULT_MCP_SERVER_URLBare origin of the PolicyVault server (e.g. https://app.policy-vault.org, or your self-hosted origin). Refused if it embeds credentials or a path.

POLICYVAULT_MCP_TOKEN密钥Machine-identity bearer credential (pvmk_...), minted by the vault operator in the PolicyVault app with exactly the scopes the agent should hold. Never logged; deleted from the process environment after being read.

POLICYVAULT_MCP_SCOPESOptional comma-separated scope list to narrow which tools are advertised (display-side only; enforcement is always server-side).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmpolicyvault-mcp1.6.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

PolicyVault

Kaspa L1 上非托管的委托支出金库，面向个人和 AI Agent。

PolicyVault 让金库所有者可以将支出密钥交给代理——员工、服务、机器人或 AI Agent——而无需交出资金控制权。支出策略由 Kaspa L1 共识通过契约强制执行：即使代理绕过整个应用，直接与 Kaspa 节点通信，也无法超出所有者设定的策略。

权限模型始终如一，处处强制执行：

AI 可以提出请求。POLICYVAULT 以确定性方式作出决定。契约负责强制执行。签名者保留托管权。

生产状态（如实标注）

界面	状态
Web / Agent 平台	服务位于 https://app.policy-vault.org；服务返回的健康状态可识别当前构建版本。此代码树对应 fullscale-rc45 构建版本 `1fa26b33`，是 fullscale-rc44（`df5b8de`）之后，用于修复对账和委托周期起始时间问题的后续版本。
当前生产源代码	此代码树为 v1.10.11（fullscale-rc45），镜像 `sha256:32d45a3096b29eefc0dd97f2fc1e582ee00cb32236bbd7293c6626fd8bd4652d`；其已发布的前一版本为 v1.10.10。准备就绪不代表已经部署；服务返回的健康状态可识别当前构建版本。
组织 M-of-N 所有者根（契约 v0.7）	保留现有 RC40 主网生成策略。此版本不会更改创建权限、契约字节或原生 KAS 状态标签。
浏览器中的根化金库所有者操作（R7-05）+ 预留/取款指南（F-6）	保留；签名阈值行为不变。此版本更改了根化金库所有者操作和审批；变更日志中的委托周期起始时间和组织根条目列出了相关更改，包括：`policyvault-0.7-kas` 金库的委托规则变更必须收集所有所有者的批准，并在新委托人或变更后的委托人的预算周期结束前、以该构建版本规定的十分钟为界完成（不得少于一分钟；对于 1 小时周期为 50 分钟）；根请求会显示其最终确认截止时间；过期后 PolicyVault 不会最终确认该请求，此时只能撤回并重新构建（Web 界面没有用于设置更晚起始时间的输入项）；未曾尝试过的此类请求即使已有所有者批准，仍可撤回；`policyvault-0.7-kas` 金库的新委托人，其预算周期从按下 Build 时读取的网络位置开始；此类金库中已安装委托人的钱包需要通过移除并重新添加委托人来更改；若根请求会花费节点报告为未花费的输出以外的输出，则该请求会被拒绝；如果 Verify 将金库标记为 UNRESOLVED，则托管构建、最终确认和广播都会被拒绝（对其现有委托请求的批准仍会记录，但无法上链；对其委托请求的撤回和 Verify 仍会返回结果）；Verify 可以将 PolicyVault 外部广播的根迁移归因于创建该交易的已记录请求；已最终确认的根请求在 Submit 时会先读取其输入，若某个输入已被另一笔交易花费，则可分两步撤回该请求。五个已服务资源（`app-v4.js`、`app.js`、`kas-vault-ui.js`、`org-root-ui.js`、`refusal-explain.js`）针对 v0.4 系列 Verify、请求、委托周期起始时间、旧版控制台和组织根展示进行了更改。
所有路由系列的托管租户隔离 + 生成门控（rc11 修复）	已上线——修复 rc8 发现的问题（未经身份验证的托管构建、基于原型的版本选择、在主网上不安全地创建非标准 v0.4 版本）
上线后运行栈审查修正（rc29：Webhook 目标策略 + DNS 传输、SDK 传输恢复密钥、旧版相同效果完成归属、镜像/软件包 LICENSE + NOTICE、保护隐私的运行时产物、恢复指南）	包含于此源代码和 `fullscale-rc29` 镜像中——对运行中的 rc28 栈进行独立只读审查发现的每个问题，均以 RED 优先的方式修正，并添加永久回归测试；已服务的 buildId 读数为 `f217011` 后，托管部署即包含这些修正；已安装的 SDK / 移动客户端必须升级才能获得传输修正
第二次上线后审查修正（rc30：Webhook 响应套接字生命周期上限；编译器和参考程序旁附上游 Silverscript ISC 声明）	包含于此源代码和 `fullscale-rc30` 镜像中——对运行中的 rc29 栈进行独立只读上线审查发现的两个问题，均以 RED 优先的方式修正，并添加永久真实套接字回归测试；已服务的 buildId 读数为 `9dbc5f7` 后，托管部署即包含这些修正；SDK / 移动客户端字节未更改
组织界面可用性修正（rc31：仅在能力发现明确支持时提供组织根创建；生成拒绝信息说明更改地址/金额无法启用不受支持的主网生成版本；构建错误限定在向导内）	包含于此源代码和 `fullscale-rc31` 镜像中——针对所有者在 RC30 中发现的问题进行修正，采用 RED 优先方式，并添加 13 个用例的 DOM 回归测试，通过合成钱包和拦截的 HTTP 请求驱动真实页面和脚本；仅涉及浏览器展示——服务器 / SDK 生成门控未更改，仍为权威依据；SDK / 移动客户端字节未更改
MCP 软件包（npm 上的 `policyvault-mcp`）	未更改：`[email protected]`，SHA256 `128403f81d4af7b73ae86a31a750d39ec21c28f518d214f4e678807c3dff0c14`。未公开创世、签名或提交工具。对于此服务，在结果不确定后重试相同 MCP 请求会被拒绝（返回 `IDEMPOTENCY_OUTCOME_UNKNOWN`，或在服务器或存储故障后返回 `IDEMPOTENCY_IN_PROGRESS`），或返回保留的结果，而不会再次执行操作。如果凭据对应的钱包参与了金库，但既不是请求的签名者，也不是金库所有者，则拒绝工具会返回 `403 REQUEST_FORBIDDEN`。通过 MCP 发送的委托周期起始时间是下限；调用方收到的 `422 PERIOD_START_REQUIRED` 是一个 `REFUSED` 信封（没有 MCP 工具会继续到返回 `409 PERIOD_START_STALE` 的后续检查）。
旗舰版第 1 波（v1.6.0 / v1.7.0）和第 2 波（v1.8.0）源代码	已纳入；适用项已上线（参见各版本的 CHANGELOG 条目；v0.6 仅用于 FIXTURE 场景 / 不支持主网兑换；x402 facilitator 已达到生产就绪状态，但尚未部署；MCP 使用遥测已关闭）
契约协议 v0.6（原子可组合性）	契约字节已冻结（2026-09-03）：已在真实引擎上使用生产字节通过 VM 验证，并通过测试网验证（在 testnet-10 上完成真实 SELL + BUY）。仅用于 FIXTURE 场景——没有真实 DEX 场所、不支持主网兑换、没有服务器/Web/移动端/MCP 界面，`deadlineDaa` 是签名前边界，并非共识过期时间，且低于约 10 KAS 时兑换在经济上不可行。PolicyVault 不是 DEX，也不会成为 DEX。参见 `docs/postlaunch/v0.6-covenant-byte-freeze.md`
v0.5 代币控制器契约（字节已冻结）+ 最小权限发现 / 控制台修正 + MCP 1.4.2（v1.5.0）	已上线——生产运行时后续版本 `fullscale-rc8`（buildId `1c02162`）于 2026-09-02 部署并通过自动验收：按主体限定范围的能力发现、生产环境中不探测开发签名者、退出登录时不进行任何特权读取、可选择启用钱包诊断；`[email protected]` 仅公布凭据作用域所涵盖的工具（服务器端强制机制未更改）。v0.5 TOKEN CONTROLLER 契约（`contracts/PolicyVault.v0.5.sil`，sha256 `c693aeff…`）以源代码形式提供——契约字节已冻结，已使用生产字节通过 VM 验证，并通过一次真实生命周期的测试网验证；非生产版本（无 v0.5 界面，无主网 v0.5 金库）。包含演示式引导教程（仅展示）。参见 CHANGELOG
分发：MCP 注册表、Agent 示例、自托管（v1.4.0）	源代码/分发版本——不更改运行时（生产环境仍使用 buildId `6c3177f`）：MCP 服务以 npm/注册表软件包形式发布（`policyvault-mcp`、`io.github.zapsoblige-hash/policyvault`），精简的 OpenAI-Agents-SDK/LangChain/CrewAI 接线示例位于 `examples/agents/`，一条命令即可自托管，相关文件为 `deploy/selfhost.sh` + `docs/selfhost-quickstart.md`；参见 CHANGELOG
Bearer 钱包会话 + 原生移动端传输（v1.3.0）	已上线：为非浏览器客户端提供可选择启用的 Bearer 钱包会话身份验证（仅用于身份验证，绝不赋予签名权限或托管权限；Cookie Web 身份验证不变），并提供原生 Android 传输（在平台边界明确使用 CapacitorHttp；不扩大 CORS 范围，Web 客户端仍严格遵循同源策略）。已在真实打包的 Android 运行时上针对真实生产环境验证完整 Bearer 生命周期；参见 CHANGELOG
响应式客户端 + 简洁的退出登录体验（v1.2.0）	提升登录后的导航速度（保留状态、并行读取、准确反映进度状态——待处理绝不表示成功），且不会无故弹出退出登录错误提示；参见 CHANGELOG
网络身份横幅修复（v1.1.1）	Web 客户端的网络横幅现在根据服务器节点验证过的 `/network/status` 生成，并在失败时安全关闭为明确的 UNKNOWN 状态——绝不使用过时或假定的网络；参见 CHANGELOG
应用内文档发现（v1.1.0）	Web 客户端中的文档链接 + 上下文帮助，可深层链接至 https://docs.policy-vault.org——仅涉及展示的后续版本；参见 CHANGELOG
外部审批人发现修复（2026-08-27）	已部署并通过自动验收（故障安全关闭的可用性缺陷，不涉及资金/权限/隐私泄露；参见 CHANGELOG 中的“Fixed”。验收由自动化完成；不声称通过了人工验收测试）
契约协议 v0.4.1	可在主网上运行（有真实主网生命周期证据；准确的已验证内容和验证方式见 SECURITY.md）
契约协议 v0.5（代币控制器）	契约字节已冻结（2026-09-02）：已在真实引擎上使用生产字节通过 VM 验证，并通过测试网验证（在 testnet-10 上完成真实生命周期，负向用例被共识拒绝）；非生产版本——没有服务器/API/Web 界面，也没有主网实例；参见 `docs/postlaunch/v0.5-covenant-byte-freeze.md`
Python 客户端、MCP 服务、x402/AP2 适配器、平台 Agent API	已发布；由此代码库中的自动一致性/集成测试套件覆盖
原生移动端（iOS/Android）	开发中——尚不具备生产使用条件。Android 应用（位于 `mobile/` 的完整 Capacitor 项目，包含原生生产传输和 Bearer 登录）已在真实模拟器上针对真实生产环境完成验证——包括读取、完整 Bearer 身份验证生命周期和安全关闭的负向场景——但生产签名、应用商店打包以及相机/QR 码采集仍待完成；请勿基于它构建托管工作流
安全保障	仅限内部且以证据为依据：针对每个确切候选版本开展独立内部 AI 证伪审查（审查者绝不修复自己的候选版本），在真实 Kaspa 脚本引擎上使用生产字节进行对抗性 / 恶意测试，采用 RED 优先方式复现问题并添加永久回归测试，执行贴近生产环境的机械验证，收集真实 testnet-10 证据，验证确切产物和已冻结字节，并由所有者在每次部署后亲自在真实主网上验证。PolicyVault 未接受任何外部专业安全审计，且这不属于其流程的一部分（所有者政策，2026-09-05）；此代码库中的任何内容均未声称并非如此

x402 FACILITATOR（integrations/x402-facilitator/，2026-09-02）： 设计已冻结（经所有者授权；docs/postlaunch/x402-facilitator-design-freeze.md） · 已实现 · 已通过单元测试 · 已通过对抗性测试 · 已通过集成测试（真实 HTTP 服务 + 真实 PostgreSQL 权益声明存储）· 已通过测试网验证（在 testnet-10 上使用真实 KAS + 真实且已冻结的 v0.5 代币付款； docs/testnet-x402-facilitator-evidence.json）。这是一个单独部署、无特权、只读的链上验证 / 结算证明服务，针对拟议的 Kaspa 方案 pv-x402-kaspa-exact-upfront/1（网络标识符 kaspa:mainnet / kaspa:testnet-10 是 PolicyVault 临时采用的 CAIP-2 语法标识符—— 不声称已在上游注册）。它绝不签名、广播、托管或收费。不是托管式生产服务（须通过单独的所有者门控）；上游不存在 Kaspa x402 方案，因此在不作此限定的情况下，它并非“兼容 x402”。

Covenant 强制执行的内容（由共识而非软件强制执行）

由所有者控制的金库——创建、管理、暂停、恢复、关闭。
委托支出——每个金库最多可有 10 个独立 Agent，每个 Agent 都有自己的策略，可在所有者定义的限额内使用真实 KAS 支出。
单笔交易上限和周期累计预算 （由共识验证的基于 DAA 分数的记账）。
收款方允许列表——由 Merkle 树提交承诺；Agent 只能向所有者批准的收款方付款。
超过所有者设定阈值时需获得 M-of-N 批准。
由 Covenant 控制的手续费储备金——Agent 无需 Gas 钱包；网络手续费由 Covenant 精确核算的储备金支付。
所有者紧急暂停和终局恢复——绝不受任何托管工作流限制。

平台在 Covenant 之上添加的功能（托管协调，而非权限）

意图清单 + 独立浏览器验证——签名前，浏览器会根据待签名的确切字节重新推导交易的作用，并在发现任何不匹配时拒绝操作（web/verify-intent.js、 docs/postlaunch/intent-manifest-spec.md、docs/postlaunch/browser-verification.md）。
治理——针对扩展权限的策略变更，采用提案/批准流程（经 Schnorr 验证，并进行域分离）（docs/postlaunch/governance-spec.md）。
风险处理流水线——仅允许限制性操作的可配置审查/拒绝适配器（docs/postlaunch/risk-adapter-spec.md）。
预算预留、哈希链审计、Webhook/通知、机器身份 + 限定范围的权限、幂等性、试运行模拟 （docs/postlaunch/*）。
通用签名器接口，包含 KasWare 映射和离线 CLI 签名器参考（docs/postlaunch/signer-interface-spec.md、 signer-kasware-mapping.md、signer-cli-reference.md）。
Agent 接口：REST 平台 API、MCP 服务、Python 客户端、x402 + AP2 支付协议适配器——都是同一个确定性核心的轻量级调用方；均不持有独立的金融权限。

PolicyVault 的 API 和随附的 MCP 工具提供限定范围的读取、受支持的模拟和未签名请求。MCP 工具不持有签名密钥，也不提供签名或提交操作。PolicyVault 的验证工具允许外部签名器在签名前检查确切操作。更广泛的 API 支持附加外部生成的签名，并支持单独授权的提交；浏览器也会使用外部钱包。获授权的委托方（包括使用外部钱包或签名器的 Agent）须在 Covenant 限额、允许的收款方、预算和所需批准范围内操作。请求、签名、提交和经验证的链上接受是不同阶段。Kaspa 共识强制执行 Covenant。

仓库目录

路径	内容
`contracts/`	Covenant 源文件（v0.1…v0.6），可重新生成且字节级一致（`tools/gen_v3.js`、`gen_v4.js`、`gen_v4_1.js`、`gen_v5.js`、`gen_v6.js`）
`core/`	可移植的确定性核心：模型、意图清单、说明、治理、风险、签名器（v1 及增量式 v2 接口）、执行证明、跨运行时等价性
`sdk/`	Node SDK：构建器、冻结/签名/定稿、VM 预检、提交 + 链上证明、对账、存储（JSON + PostgreSQL）
`server/`	托管运行时：API、身份验证/租户管理/请求保护、治理/风险强制执行、审计链、Webhook、通知、证明导出、可选 MCP 遥测（关闭）、迁移 001–010
`web/`	浏览器客户端 + 浏览器本地独立验证（`verify-intent.js`、`core-bundle.js`）
`mcp/`、`python/`、`integrations/`	MCP 服务、Python 客户端、x402 + AP2 适配器
`conformance/`	一个矩阵，通过相同场景驱动 JS + Python + MCP + x402 + AP2（跨路径字节等价）
`security/`	针对面向 Agent 的边界的内部对抗性（恶意 AI）测试套件
`mobile/`	原生移动应用（Capacitor Android 项目 + 可移植 Web 负载、原生生产传输、Bearer 登录）——开发状态（见上文）
`tests/vm/`	真实 Kaspa VM covenant 验证工作区（Rust；TxScriptEngine）
`deploy/`	容器构建 + 暂存/生产/自托管 compose 示例 + 环境模板 + 可复现部署流水线（`deploy/pipeline/`，仅本地证明）
`docs/`	协议规范、架构、威胁模型、不变量、托管设计、各界面规范、covenant 冻结记录
`tools/`、`release-signers.json`	Covenant 生成器、验收测试工具、证明验证器，以及发布清单/签名/验证工具（签名者公钥是尚未填写的 `OWNER-TO-FILL` 占位符；尚未签署任何发布版本）

快速开始（可自托管，testnet-10）

# prerequisites: Node 20.x; a local Kaspa testnet-10 node with --utxoindex
#   (rusty-kaspa; JSON wRPC on ws://127.0.0.1:18210)
cd sdk && npm ci && npm test          # the SDK suite (serialized)
cd ../server && node src/server.js    # self-hosted mode, JSON persistence
# open http://127.0.0.1:3080 — connect a testnet KasWare wallet

完整说明包括基于 PostgreSQL 的托管模式、容器构建、covenant 重新生成 + 字节级一致性验证，以及 VM 套件： docs/deployment.md、docs/hosted-deployment.md、docs/test-plan.md。 VM 工作区需要同级检出公开的 silverscript 和 rusty-kaspa 项目（参见 tests/vm/ 和 tools/stage-vendor.sh）。

产品政策（永久）

免费软件并支持自托管——Apache 2.0 许可证，包括商业用途。官方托管服务目前免费。Kaspa 网络交易手续费仍需支付。协议及其机制不申请专利。自愿捐赠 KAS 可支持持续开发和托管： kaspa:qyppakv5y7kmeynffldl9zshwgkjrl3fy9jjj8wf24v7f64v0gnuragz7ehdqhn （公开收款地址；本软件绝不会索要或处理捐赠钱包密钥）。详情见：docs/product-policy.md。