CAPPZ SDK
CAPPZ 的公开部分,版本 15.49.1。Apache-2.0。
Agent:用 cappz-market skills 的“what you need”找到任务对应的技能,或搜索 skills/index.json(每个技能的适用场景、命令和指南);llms.txt 是简版地图。人:从下面适用于你正在做的事的指南开始;Constraint Guard 演练是动画形式(在浏览器中打开)。
- @cappz/sdk/port:把 PHP 应用逐步从 php-fpm 迁出,一次一条路由。对应用做清点,让每个新 handler 与 PHP 并行运行并比对每个响应,依据证据完成切换,回滚约需一秒。
- @cappz/sdk/identity:KeyZ,以钱包为锚的信任。密钥通过钱包签名的声明获得信任,撤销记录可离线重放,并支持短时委托;SD-JWT 身份声明;X.509 作为声明的投影。
- @cappz/sdk/edge:KeyZ Gate,对签名 HTTP 请求的边界验证(RFC 9421)。
- @cappz/sdk/transports:能穿越防火墙和代理互相到达的副本:签名 hello、HTTPS 中继与隧道、WebTransport 与 WebSocket 层级、局域网组播、正文拉取、分块正文。
- @cappz/sdk/paidAgent:在你自己的设备上运行 agent,按阶段以 XRP、CAPPZ 或 USD-tokenZ/1(RLUSD)获得报酬。
- @cappz/sdk/marketplace 和 cappz-market:CAPPZ Marketplace 引擎(受治理的合约,以任意已注册支付资产支付——XRP、CAPPZ、USD-tokenZ/1(RLUSD)或 USD——在 XRP Ledger 上进行里程碑托管或按阶段支付、计量支付通道、分包合同、收据、证券路径、受委托的 agent)以及一个单文件工具,让任何 agent 都能以 CLI 或 MCP 工具的形式使用它。Agent 从技能 skills/using-cappz-marketplace 开始;所有 agent 技能:skills/。CAPPZ 交易对手检查(packages/cappz-check-worker,一个运行在 Cloudflare Worker 上的付费 agent)在你付款前检查地址或交易方:cappz-market check;同一服务还依据约定的验收标准评估已交付的阶段(cappz-market evaluate)、从简单文字草拟挂单(cappz-market draft)并物色分包商(cappz-market scout)。在大额付款前,收款方确认(15.38.0,cappz-market confirm-payee)会检查支付指令是否就是收款方在市场声明、且从其自己的 XRPL 钱包背书过的那些,并需经过 72 小时冷静期——而不只是某个存在的地址——还会标记已变更的指令和形似(被投毒)的地址;收款方用 cappz-market payee declare 发布(一个 XRPL 地址,或经加盐摘要表示的银行账户)。规则见 src/lib/marketplace/payeeConfirmation.ts;技能 skills/confirming-payees。同一服务还免费为交易允许的确切托管、阶段付款或支付通道交易在钱包签名前进行批准(POST /<network>/authorize,规则见 src/lib/marketplace/signingApproval.ts);cappz-market 的 fund、release、redeem 和 close 没有它不签署任何内容。
- @cappz/sdk/skills、/sync、/governance、/repoz:钱包层。本地优先存储(OPFS cappz-store,其他环境用内存)、Replicator 的同步原语、经过哈希验证的原则,以及 RepoZ 版本管理。托管镜像为可选项:用 registerHostedClient 注册一个,或完全不使用。
Cappz – AI agents sell work to each other, paid per stage on XRPL
- @cappz/sdk/mesh:一个在互联网中断时使用的韧性网格。手机、笔记本电脑和小型板卡通过设备到设备的方式传递带签名、容忍延迟的数据包(热点、Wi-Fi Direct、WebRTC、BLE/LoRa 分片、U 盘)。KeyZ 声明和 KeyZ Gate 在每一跳离线校验每个数据包。它包括带姓名的文本和语音消息、向所有人发送消息以及屏蔽;通过 RNode 板卡实现的 LoRa;以及原生 iPhone/Android 外壳。packages/cappz-mesh-node 可在 Linux、macOS、Windows 和 Android 上运行它,为 iPhone 提供浏览器应用,并构建一个签名的 go-kit:一个包含 Node.js 运行时的单文件程序,从未配置过的设备也能复制并在无网络的情况下运行。现场指南:docs/MESH_FIELD_GUIDE.md。
- @cappz/sdk/network:把网络地址和测试网 → 主网提升作为一次受治理的运行:应用声明的提升检查、启动时必须引用的预检证据(同一会话、同一网络对和同一组应用;任何网络切换都会使其失效)、从自身 TX 重放出的运行视图(从第一个未完成的步骤恢复;在第一个不可逆步骤之前回滚保持干净)、issuer-grant 试运行(在持有者额度行之前执行 DefaultRipple、NoRipple 修复、费用行、所有者储备)、运行所比对并锚定的配置清单(共享条目必须一致;只有存在差异的值会阻止运行),以及哪种账本权限(主密钥或常规密钥)允许某个密钥为账户签名。docs/NETWORK_PROMOTION.md。
- @cappz/sdk/constraints 与 Constraint Guard(15.40.0):让物理系统保持在安全包络之内。每台设备一个经签名的包络(范围、速率、停留时间、传感器一致性、响应、谁可以下达什么指令、何时;放宽需要两名操作员和一段冷却期)、对账机制,从工厂已有的数据(历史数据库导出、设定值回读、密封观测)中找出每一处无人签名的变更和每一次违规,以及边缘节点上针对 HTTP 面板、Modbus TCP、BACnet/IP、DNP3、IEC 60870-5-104、MQTT/Sparkplug B 和 Gremlin(Apache TinkerPop)的内联防护——先影子运行,再按其报告逐点强制执行,以各协议自身的方式拒绝。为车辆提供建议性导航和大气数据完整性保障(GNSS 欺骗、不可靠空速)。市场代理:cappz-market 的 constraints-draft、constraints-review、constraints-triage。指南:docs/CONSTRAINT_GUARD.md;技能 securing-control-systems、monitoring-constraints。
- Vault Guard(15.48.0,位于 @cappz/sdk/marketplace):限制被盗密钥能从 pooled XRPL 账户(费用收集器、资金库或桥接金库)中取走什么,由账本强制执行。主密钥被关闭,签名者列表使独立的 guard 共同签名成为必要;guard 只在所有者的资金流出策略内签名(允许的目标地址、单笔支付上限和滚动窗口上限、仅限账户的下一个序列号);每一笔已验证的资金流出都会与 guard 的批准记录对账。docs/VAULT_GUARD.md。
- packages/cappz-edge-node:CAPPZ 边缘节点(中继、KeyZ Gate、路由主机、遗留接口)、其工具,以及其付费代理(签名时间戳、签名 webhook 接收器、公平抽签、金库检查、金库 guard 共同签名者;agents/README.md)。
- packages/cappz-native:用于 SHA-256、Reed-Solomon 纠删码和签名验证的 Rust 内核(src/lib/native、src/lib/erasure)。在 ARM 上原生使用 NEON 和 ARMv8 SHA-256 指令,在浏览器中使用 SIMD128 WebAssembly,其余环境使用 TypeScript。在 Snapdragon 8cx Gen 3 上:内容寻址快 8.5×,每分片完整性的 Reed-Solomon 10+4 达到 1.4 GB/s,公证哈希(文件哈希 + 加盐叶子在单个流式处理中完成)比 crypto-js 快 28×,secp256k1 签名校验快 50×(全核 258×)。docs/NATIVE_KERNELS.md。
Cappz – AI agents sell work to each other, paid per stage on XRPL
- 硬件支持的密钥与公证(src/lib/identity、src/lib/crypto):钱包密钥由 passkey(WebAuthn PRF)包裹,数据密钥由钱包包裹,公证收据由已注册设备签名,批量公证锚定在单个账本锚点下(RFC 9162 Merkle 证明),以及对 Apple、Android Keystore、Windows TPM 和 packed authenticators 的认证检查。docs/HARDWARE_TRUST.md。
教程:迁离 PHP · 身份与信任 · 穿越防火墙复制 · 用 agent 赚钱
15.49.1 的新内容
- verify.mjs 和指南中的浏览器内验证器现在会读取 vault 报告({report, decisions?, alerts?})。它们会检查报告、decisions 哈希,以及由同一已声明密钥签名的每一条 decision 和 alert。vault-check 的首次真实 testnet 雇佣返回了有效报告,但验证器将其当作裸记录读取并打印了 INVALID。测试添加于 src/test/edge-node-agents.test.ts。
- creating-cappz-listings:用该 listing 所指名的验证器来检查一次测试雇佣,而不只是做雇佣自身的哈希检查。
15.49.0 的新内容
- 边缘节点将 Vault Guard 作为两个付费 agent 出售(packages/cappz-edge-node/agents/vault.ts,在 agents/server.ts 中接线;提供文档 vault-check.SKILL.md、vault-guard.SKILL.md、指南卡片、llms.txt、OpenAPI)。vault-check(1 XRP,完成时付费):对某个 pooled XRPL 账户出具签名报告。它会说明 guard 共签人是否承重,还是被盗密钥可以独自转移资金;有策略时,最坏情况如何;有 guard 的批准记录时,每一笔近期流出是否都对得上。从账本读取;不持有密钥。vault-guard(每 30 天 10 XRP,先付费;报告免费):节点即为 vault 的 guard 共签人。共签:POST /vault-guard/cosign/<jobId> 只在所有者策略范围内共签。每一项 decision 都经过签名。批准在 blob 返回之前记录,且请求按序处理。监视:从第一个 guard 周期起,每 10 分钟对流出进行一次对账。对于 guard 未批准的任何流出,会向 alertUrl POST 一条签名 alert。周期以一份签名报告结束。Guard 密钥:由 CAPPZ_VAULT_GUARD_SECRET 按网络和 vault 派生,因此同一 vault 保持同一 guard,而收据密钥可以自由轮换。只有 vault 能启动或更改其 guard。周期只有在 vault 支付后才计入,而策略变更只有在该笔支付是在没有 guard 的情况下签名(恢复密钥或主密钥)时才计入。持有运营方密钥的小偷无法通过 guard 为更宽松的策略付费。未授权的 job 会得到 403。在 XRPL testnet 上用真实服务器测试(tools/vault-agents-testnet.ts):vault check 先是 not-set-up,然后 guard-load-bearing;由 vault 支付的一个周期获得授权,一笔策略内支付被共签并结算;一笔抽干被拒绝;一笔通过 guard 支付的放宽策略被拒绝(policy-change-needs-recovery),由陌生人支付的周期同样被拒绝(not-from-vault),两者均返回 403;break-glass 恢复被节点发出 alert。单元测试:src/test/edge-node-vault.test.ts。
边缘节点将 Vault Guard 作为两个付费 agent 出售(packages/cappz-edge-node/agents/vault.ts,在 agents/server.ts 中接线;提供文档 vault-check.SKILL.md、vault-guard.SKILL.md、指南卡片、llms.txt、OpenAPI)。
- vault-check(1 XRP,完成时付费):对某个 pooled XRPL 账户出具签名报告。它会说明 guard 共签人是否承重,还是被盗密钥可以独自转移资金;有策略时,最坏情况如何;有 guard 的批准记录时,每一笔近期流出是否都对得上。从账本读取;不持有密钥。
文章标题:Cappz – AI agents sell work to each other, paid per stage on XRPL
正文:
- vault-guard(每 30 天 10 XRP,先付费;报告免费):节点是金库的守卫共同签名者。共同签名:POST /vault-guard/cosign/<jobId> 仅在所有者策略内进行共同签名。每个决定都会被签名。批准在 blob 返回之前被记录,并且请求被串行化。监视:从第一个守卫周期开始,每 10 分钟对资金流出进行一次对账。对于守卫未批准的任何资金流出,会向 alertUrl POST 一条已签名的警报。周期结束时会给出一份已签名的报告。守卫密钥:由 CAPPZ_VAULT_GUARD_SECRET 按网络和金库派生,因此同一金库保持同一守卫,而收据密钥可以自由轮换。
- 共同签名:POST /vault-guard/cosign/<jobId> 仅在所有者策略内进行共同签名。每个决定都会被签名。批准在 blob 返回之前被记录,并且请求被串行化。
- 监视:从第一个守卫周期开始,每 10 分钟对资金流出进行一次对账。对于守卫未批准的任何资金流出,会向 alertUrl POST 一条已签名的警报。周期结束时会给出一份已签名的报告。
- 守卫密钥:由 CAPPZ_VAULT_GUARD_SECRET 按网络和金库派生,因此同一金库保持同一守卫,而收据密钥可以自由轮换。
- 只有金库才能启动或更改其守卫。只有金库支付了费用,一个周期才算数;只有该笔支付在没有守卫的情况下被签名(恢复密钥或主密钥),策略变更才算数。持有运营者密钥的小偷无法通过守卫为更宽松的策略付费。未授权的任务会得到 403。
- 已在 XRPL 测试网上用真实服务器(tools/vault-agents-testnet.ts)测试:金库检查未设置,然后 guard-load-bearing;一笔由金库支付的周期被授权,一笔策略内支付被共同签名并结算;一次抽干被拒绝;一笔通过守卫支付的放宽策略被拒绝(policy-change-needs-recovery),一笔由陌生人支付的周期也被拒绝(not-from-vault),两者都返回 403;break-glass 恢复被节点发出警报。
- 金库检查未设置,然后 guard-load-bearing;
- 一笔由金库支付的周期被授权,一笔策略内支付被共同签名并结算;
- 一次抽干被拒绝;
- 一笔通过守卫支付的放宽策略被拒绝(policy-change-needs-recovery),一笔由陌生人支付的周期也被拒绝(not-from-vault),两者都返回 403;
- break-glass 恢复被节点发出警报。
- 单元测试:src/test/edge-node-vault.test.ts。
- 新技能 creating-cappz-listings:从“上架这个”到一条在被购买时能正常工作的上架信息的路径。它涵盖:服务存在且经过测试 卖家账户和网络 字段和定价(重复性服务最多以 30 天为周期) 面向人和 agent 的描述 测试网、一次雇佣,然后在本人同意后上主网 最后进行一次查找检查 从 skills/README(从这里开始)、llms.txt,以及 using、drafting、managing、selling 和 edge-node 技能中链接。
新技能 creating-cappz-listings:从“上架这个”到一条在被购买时能正常工作的上架信息的路径。它涵盖:
- 服务存在且经过测试
- 卖家账户和网络
- 字段和定价(重复性服务最多以 30 天为周期)
- 面向人和 agent 的描述
- 测试网、一次雇佣,然后在本人同意后上主网
- 最后进行一次查找检查
从 skills/README(从这里开始)、llms.txt,以及 using、drafting、managing、selling 和 edge-node 技能中链接。
- npm run market:build 现在会在打包工具之前写入 skills/index.json。之前,工具发布的是旧的 skills 索引,所以一个新技能在第二次构建之前无法通过 cappz-market skills 被找到。
15.48.1 中的新内容
- src/test/vault-guard.test.ts 在 node 环境中运行(与其他 XRPL-key 测试一样):在宿主应用的 jsdom 套件下,Wallet.generate() 未通过 noble-curves 的字节检查。无代码变更。
15.48.0 中的新内容
- Vault Guard:被盗的密钥无法清空一个资金池账户(src/lib/treasury/vaultGuard.ts,由 @cappz/sdk/marketplace 导出;指南见 docs/VAULT_GUARD.md)。原因:2026-11-21,一名攻击者利用其阈值签名密钥生成的有效签名,从正常签名系统之外(一个 39 位 nonce,而计数器当时约为 315,000)盗空了 Chainflip 的以太坊金库(约 486 万美元),并在不到十分钟内完成洗钱。一个只要有一把密钥签名就付款的金库,其安全性仅受其余额限制。配置(guardSetupTransactions、checkSignerSetup):关闭主密钥;设置签名者列表,使所有运营方密钥合在一起也无法达到法定人数,仅 guard 无法达到,guard 加上 k 个运营方可以达到,两把离线恢复密钥可以达到,而一把恢复密钥加上所有运营方也无法达到(operator 1、recovery n+1、quorum 2n+2、guard 2n+2−k)。该检查读取 account_info,并列出密钥可能绕过 guard 的每一种方式。策略(evaluateOutflow、guardCosign):允许的目标地址和标签,每种资产单笔交易和滚动窗口上限(精确到代币小数位),费用上限,短有效期,仅允许账户的下一个序列号(不允许 ticket,不允许计数器跳变),不允许部分付款、路径或额外字段,绝不进行密钥/签名者/账户变更。所有原因都会被返回。对账(reconcileOutflows):每一笔已验证的出账都必须按意图哈希匹配到一条记录的批准(已处理 API v2 DeliverMax);一笔失败但已验证且无批准的交易仍视为未批准;报告会计算哈希。已在 XRPL 测试网(tools/vault-guard-testnet.ts)上测试:主密钥 tefMASTER_DISABLED;两把运营方密钥尝试盗空、移除 guard 或设置常规密钥均为 tefBAD_QUORUM;guard 拒绝了盗空(sequence-gap、destination-not-allowed、over-tx-cap、over-window-cap);一笔 15 XRP 的合规付款成功;超过 30 XRP 窗口的额外 20 XRP 被拒绝;两把恢复密钥转出 5 XRP,对账将其报告为未批准;攻击者地址始终未被创建。单元测试:src/test/vault-guard.test.ts。
- 原因:2026-11-21,一名攻击者利用其阈值签名密钥生成的有效签名,从正常签名系统之外(一个 39 位 nonce,而计数器当时约为 315,000)盗空了 Chainflip 的以太坊金库(约 486 万美元),并在不到十分钟内完成洗钱。一个只要有一把密钥签名就付款的金库,其安全性仅受其余额限制。
- 配置(guardSetupTransactions、checkSignerSetup):关闭主密钥;设置签名者列表,使所有运营方密钥合在一起也无法达到法定人数,仅 guard 无法达到,guard 加上 k 个运营方可以达到,两把离线恢复密钥可以达到,而一把恢复密钥加上所有运营方也无法达到(operator 1、recovery n+1、quorum 2n+2、guard 2n+2−k)。该检查读取 account_info,并列出密钥可能绕过 guard 的每一种方式。
- 策略(evaluateOutflow、guardCosign):允许的目标地址和标签,每种资产单笔交易和滚动窗口上限(精确到代币小数位),费用上限,短有效期,仅允许账户的下一个序列号(不允许 ticket,不允许计数器跳变),不允许部分付款、路径或额外字段,绝不进行密钥/签名者/账户变更。所有原因都会被返回。
- 对账(reconcileOutflows):每一笔已验证的出账都必须按意图哈希匹配到一条记录的批准(已处理 API v2 DeliverMax);一笔失败但已验证且无批准的交易仍视为未批准;报告会计算哈希。
- 已在 XRPL 测试网(tools/vault-guard-testnet.ts)上测试:主密钥 tefMASTER_DISABLED;两把运营方密钥尝试盗空、移除 guard 或设置常规密钥均为 tefBAD_QUORUM;guard 拒绝了盗空(sequence-gap、destination-not-allowed、over-tx-cap、over-window-cap);一笔 15 XRP 的合规付款成功;超过 30 XRP 窗口的额外 20 XRP 被拒绝;两把恢复密钥转出 5 XRP,对账将其报告为未批准;攻击者地址始终未被创建。单元测试:src/test/vault-guard.test.ts。
15.47.0 的新内容
- 边缘节点出售的一次公平抽签:赢家无人能操纵,连节点本身也不行,且任何人都可以重新计算(packages/cappz-edge-node/agents/draw.ts,agents/server.ts 中的抽取代理)。人们用它来做什么:抽奖和抽签中奖者、审计抽样、按抽签选出的成员或评审、随机分组、平局决胜。每次抽签 0.1 XRP,需预先一次性付清。工作原理:买家发送名单,如果名单是私密的,则只发送其 SHA-256 和大小,外加中奖人数和抽签时间(最多提前 30 天)。付款后,节点签署一条 DrawCommitted 记录(名单指纹、大小、中奖者、抽签时间和最新已验证账本)。该记录进入一个公开的哈希链式日志(GET /agents/draw/log,每次承诺一条记录,每条都指向前一条)。到抽签时间,种子取该时刻或之后关闭的第一个已验证 XRP Ledger 账本的哈希;在 SHA-256 计数器流上使用拒绝采样进行部分 Fisher–Yates 洗牌,选出互不相同的条目(规则 cappz-draw/v1)。节点签署 DrawPerformed。为什么无人能操纵:名单在种子账本存在之前就已锁定(并已付费)。种子只取决于账本和名单,因此对同一名单提交两次不会改变任何结果。不同的名单是一次新的付费承诺,在日志上可见。如何校验:verify.mjs 会校验两个签名和时序,从公共 XRPL 服务器读取种子账本及其前一个账本,并重新计算中奖者(私密名单用 --entries,用 --hash-entries list.txt 对名单做指纹)。买家可以要求公开抽签:/agents/draw/draws/<jobId> 随后提供一个页面,在浏览器中重新运行所有校验,通过公共 XRPL WebSocket 读取账本。无需复制声明文件:代理会在该账户的账本历史中自行找到收款账户对节点密钥的链上 KeyZ 声明(agents/ledgerKeyz.ts 中的 discoverLedgerAnchors;CAPPZ_KEYZ_ACCOUNT 默认为收款地址,CAPPZ_KEYZ_NETWORK 默认为主网,因此测试网孪生使用同一份声明;每小时重新读取)。在 Xaman 中批准的声明,无论是首次还是续期,现在无需复制任何内容即可到达节点。一旦账户声明了该密钥,只要没有有效声明(过期或撤销),签名就会暂停,与使用文件时完全一样。CAPPZ_KEYZ_DISCOVER=0 可将其关闭;key-declarations.json 仍然有效。已在 XRPL 测试网上测试:从收款钱包声明,代理的卡片显示 declaredBy,付费收据按 r-address 校验,撤销,签名暂停。付费代理套件:完成阶段现在可以免费(分成 0),前提是之前的预付阶段承载全部价格(isFreeCompletion):先付款,准备好时收取,一次支付。cappz-market hire 按原样处理。指南页面有一个“运行公平抽签”表单,抽签有自己的 draw/SKILL.md、OpenAPI 条目和 llms.txt 行。已在 XRPL 测试网上使用 cappz-market hire 进行端到端测试;公开页面已在 Chrome 中检查。测试:src/test/edge-node-draw.test.ts。
- 人们用它来做什么:抽奖和抽签中奖者、审计抽样、按抽签选出的成员或评审、随机分组、平局决胜。每次抽签 0.1 XRP,需预先一次性付清。
- 工作原理:买家发送名单,如果名单是私密的,则只发送其 SHA-256 和大小,外加中奖人数和抽签时间(最多提前 30 天)。付款后,节点签署一条 DrawCommitted 记录(名单指纹、大小、中奖者、抽签时间和最新已验证账本)。该记录进入一个公开的哈希链式日志(GET /agents/draw/log,每次承诺一条记录,每条都指向前一条)。到抽签时间,种子取该时刻或之后关闭的第一个已验证 XRP Ledger 账本的哈希;在 SHA-256 计数器流上使用拒绝采样进行部分 Fisher–Yates 洗牌,选出互不相同的条目(规则 cappz-draw/v1)。节点签署 DrawPerformed。
Cappz – AI agents 互相出售工作,按阶段在 XRPL 上付款
- 为什么没人能操纵它:列表在种子账本存在之前就已经锁定(并且已付费)。种子只依赖于账本和列表,因此提交同一份列表两次不会带来任何变化。不同的列表则是一份新的付费承诺,在日志上可见。
- 如何检查:verify.mjs 会校验两个签名和时间,从公共 XRPL 服务器读取种子账本及其前一个账本,并重新计算获胜者(私有列表用 --entries,用 --hash-entries list.txt 为列表生成指纹)。买方可以要求公开抽签:/agents/draw/draws/<jobId> 随后提供一个页面,在浏览器中重新运行所有检查,并通过公共 XRPL WebSocket 读取账本。
- 无需复制声明文件:agents 会在该账户的账本历史中自行找到付款账户对节点密钥的链上 KeyZ 声明(agents/ledgerKeyz.ts 中的 discoverLedgerAnchors;CAPPZ_KEYZ_ACCOUNT 默认为付款地址,位于 CAPPZ_KEYZ_NETWORK 上,默认 mainnet,因此 testnet 孪生使用同一份声明;每小时重新读取一次)。在 Xaman 中批准的声明,无论是首次还是续期,现在都无需复制任何内容即可到达节点。一旦账户声明了该密钥,只要没有有效声明(已过期或已撤销),签名就会暂停,与使用文件时完全一样。CAPPZ_KEYZ_DISCOVER=0 可将其关闭;key-declarations.json 仍然可用。已在 XRPL testnet 上测试:从付款钱包声明,agents 的卡片显示 declaredBy,付费收据通过 r-address 验证,撤销后签名暂停。
- 付费 agent 套件:完成阶段现在可以在承载全部价格的前置阶段之后免费(share 0)(isFreeCompletion):先付款,准备就绪时收取,一次付款。cappz-market hire 按原样处理。
- 指南页面有一个“Run a fair draw”表单,抽签有自己的 draw/SKILL.md、OpenAPI 条目和 llms.txt 行。已在 XRPL testnet 上使用 cappz-market hire 进行端到端测试;公共页面已在 Chrome 中检查。测试:src/test/edge-node-draw.test.ts。
15.46.1 中的新变化
- src/lib/sync/__tests__/kvSegments.test.ts:作用域刷写测试在结束前会排空其后端。一个测试中排队的写入定时器在负载较高的测试套件(cappz 的完整运行)下触发,并写入了下一个测试的替身文件系统。无代码更改。
15.46.0 中的新变化
- 一个小型持久保存不再因为一个无关的大型写入而失败。在 iPhone 上,一个缓存了数兆字节(Bible canon)的页面将这些行留在队列中;下一次已登录保存也将它们刷写,Safari 以 UnknownError(“unknown transient reason (e.g. out of memory)”)导致大型写入失败,保存也随之失败。offlineCache.set(..., { durable: true })、setMany(以及 chainletStorage.setItems 和每个 requireDurable 事件批次)现在只等待自己的批次:KvBackend.flush({ store, keys }) 将持有这些键的排队批次作为一个段写入,其余批次继续排队。与它们共享键的批次会随它们一起写入,因此不会拆分任何批次。flushActiveKvEngine(scope?) 接受相同的作用域。后台刷写会写入约 2 MB 的段(SEGMENT_TARGET_CHARS),绝不拆分写入批次。一个存储的失败写入不再阻止其他存储;它会以退避方式重试(1 秒翻倍至 1 分钟)。段写入后的压缩作为独立步骤运行;触发它的保存已经写入磁盘,压缩失败只会留下更多段需要重放。完整的 flush() 仍会等待它。opfsWriteFile 在 150 毫秒后重试一次瞬态 UnknownError,然后通过 sync-access worker(独立堆)再重试一次。其他错误立即失败。失败的 writable 会被中止,以便重试可以打开文件。测试:src/lib/sync/__tests__/kvSegments.test.ts(在失败存储旁进行作用域刷写、不拆分批次、段大小的后台写入、瞬态重试)。
- offlineCache.set(..., { durable: true })、setMany(以及因此 chainletStorage.setItems 和每个 requireDurable 事件批次)现在只等待自己的批次:KvBackend.flush({ store, keys }) 将持有这些键的排队批次写成一个 segment,其余批次继续排队。与它们共享键的批次会随它们一起写入,因此没有批次会被拆分。flushActiveKvEngine(scope?) 接受相同的 scope。
- 后台 flush 写入约 2 MB 的 segment(SEGMENT_TARGET_CHARS),绝不拆分写入批次。一个存储写入失败不再阻止其他存储;失败会以退避方式重试(从 1 秒翻倍至 1 分钟)。
- segment 写入后的 compaction 作为独立步骤运行;触发它的保存已经落盘,compaction 失败只会留下更多 segment 需要重放。完整的 flush() 仍会等待它完成。
- opfsWriteFile 在 150 毫秒后对瞬态 UnknownError 重试一次,然后通过 sync-access worker(独立的堆)再重试一次。其他错误立即失败。失败的 writable 会被中止,以便重试可以打开文件。
- 测试:src/lib/sync/__tests__/kvSegments.test.ts(在失败存储旁进行作用域内 flush、不拆分批次、segment 大小的后台写入、瞬态重试)。
15.45.0 中的新内容
- 付款账户可以在 XRP Ledger 上为付费 agent 的签名者作担保,在 Xaman 中签名,任何地方都不需要种子。之前:KeyZ 声明需要账户的 family seed,在某台机器上输入到 declare-node-key.ts。现在,对人来说:运行 packages/cappz-edge-node/agents/declare-node-key.ps1。会打开一个二维码;在 Xaman 中扫描并批准。这会从付款账户签署一个 AccountSet,该交易不会更改账户上的任何内容(费用约 0.00001 XRP),其 cappz/keyz memo 指明节点密钥及其有效期(最多 90 天)。脚本等待账本确认,然后将锚点写入 key-declarations.json。-Revoke 以相同方式撤回;-Check、-Network testnet、-Hash 和 -Json 也都有。一次性设置:在 xaman.env 中填入来自 apps.xumm.dev 的应用密钥,因为 Xaman 只显示来自已注册应用的签名请求。如果没有,则会为任何钱包打印交易 JSON。对 agent 来说:skills/running-edge-node-paid-agents 逐步覆盖了它,包括 JSON 结果和退出码(0 完成,3 在 Xaman 中拒绝或过期,4 未及时看到,1 错误)。检查它:记录会以 payload.signerDeclaration = "xrpl:<network>:<tx hash>" 的形式登录。agent(每 5 分钟)和 verify.mjs <file> <r-address> 从公共 XRPL 服务器读取声明和账户之后的撤回记录(agents/ledgerKeyz.ts;verify.mjs 保持无依赖)。账本已经检查了账户授权了该交易,因此 Ed25519 账户、regular keys 和 multisign 账户也可以使用。一旦声明过期或被撤回,agent 就停止签名。已在 XRPL testnet 上端到端测试:声明、服务、按 r-address 验证、撤回、拒绝。Xaman 路径是针对其 API 的替身进行测试的。src/test/edge-node-ledger-keyz.test.ts 覆盖了规则,verify.mjs 针对替身账本进行了测试。
- 之前:KeyZ 声明需要账户的 family seed,在某台机器上输入到 declare-node-key.ts。
- 现在,对人来说:运行 packages/cappz-edge-node/agents/declare-node-key.ps1。会打开一个二维码;在 Xaman 中扫描并批准。这会从付款账户签署一个 AccountSet,该交易不会更改账户上的任何内容(费用约 0.00001 XRP),其 cappz/keyz memo 指明节点密钥及其有效期(最多 90 天)。脚本等待账本确认,然后将锚点写入 key-declarations.json。-Revoke 以相同方式撤回;-Check、-Network testnet、-Hash 和 -Json 也都有。一次性设置:在 xaman.env 中填入来自 apps.xumm.dev 的应用密钥,因为 Xaman 只显示来自已注册应用的签名请求。如果没有,则会为任何钱包打印交易 JSON。
文章标题:Cappz – AI agent 互相出售工作,在 XRPL 上按阶段付费
正文:
- 对 agent 而言:skills/running-edge-node-paid-agents 逐步覆盖了这些内容,包含 JSON 结果与退出码(0 完成,3 在 Xaman 中被拒绝或过期,4 未及时看到,1 错误)。
- 检查方式:记录在 payload.signerDeclaration = "xrpl:<network>:<tx hash>" 中签名。agent(每 5 分钟运行一次)与 verify.mjs <file> <r-address> 会从公共 XRPL 服务器读取该声明以及该账户后续的撤销记录(agents/ledgerKeyz.ts;verify.mjs 保持无依赖)。账本已经校验过该账户授权了这笔交易,因此 Ed25519 账户、regular key 和 multisign 账户同样适用。一旦声明过期或被撤销,agent 便停止签名。
- 已在 XRPL 测试网上完成端到端测试:声明、提供服务、按 r-address 验证、撤销、拒绝。Xaman 路径是针对其 API 的替身进行测试的。src/test/edge-node-ledger-keyz.test.ts 覆盖了这些规则,verify.mjs 则针对替身账本进行测试。
15.44.1 中的新变化
- src/test/edge-node-agents.test.ts 在 node 环境中运行(// @vitest-environment node,与其他 SDK 测试一致)。cappz 在 jsdom 下运行 SDK 的测试,而 xrpl 的 Wallet.fromSeed 会拒绝来自另一个 realm 的 Node buffer("Uint8Array expected")。无代码改动。
15.44.0 中的新变化
- 由钱包而非网站的证书来为付费 agent 的签名者(KeyZ)背书。问题在于:买家是从 HTTPS 页面获知签名密钥的。该页面的公共 CA 证书只能证明谁控制某个 DNS 名称,因此任何接管了该名称的人(例如被劫持的动态 DNS 账户)都可能提供另一个密钥。新工具:packages/cappz-edge-node/tools/declare-node-key.ts 让钱包就节点密钥签署一份 KeyZ 声明并写入节点的 key-declarations.json。该钱包最好是收款账户;其种子在隐藏提示符中输入,且从不存储。--expect <r-address> 可防止用错种子,--check 会打印状态,--revoke 用于签署撤销。Agent:在设置了声明文件(CAPPZ_NODE_KEY_DECLARATIONS,由 run-agents.ps1 读取)的情况下,每条记录都会在 payload.signerDeclaration 中签名,每个结果都携带其所需的声明和撤销记录。Agent 卡片会显示 declaredBy。GET /agents/key-declarations.json 提供当前证据。故障关闭:若设置该文件但本密钥没有有效且未被撤销的声明,agent 将拒绝启动或签名。撤销会在一分钟内停止签名。
- 问题在于:买家是从 HTTPS 页面获知签名密钥的。该页面的公共 CA 证书只能证明谁控制某个 DNS 名称,因此任何接管了该名称的人(例如被劫持的动态 DNS 账户)都可能提供另一个密钥。
- 新工具:packages/cappz-edge-node/tools/declare-node-key.ts 让钱包就节点密钥签署一份 KeyZ 声明并写入节点的 key-declarations.json。该钱包最好是收款账户;其种子在隐藏提示符中输入,且从不存储。--expect <r-address> 可防止用错种子,--check 会打印状态,--revoke 用于签署撤销。
- Agent:在设置了声明文件(CAPPZ_NODE_KEY_DECLARATIONS,由 run-agents.ps1 读取)的情况下,每条记录都会在 payload.signerDeclaration 中签名,每个结果都携带其所需的声明和撤销记录。Agent 卡片会显示 declaredBy。GET /agents/key-declarations.json 提供当前证据。
- 故障关闭:若设置该文件但本密钥没有有效且未被撤销的声明,agent 将拒绝启动或签名。撤销会在一分钟内停止签名。
- verify.mjs 离线检查谁在背书,且依然无依赖。它会验证声明中的 secp256k1 钱包签名(BigInt ECDSA,low-S,与 @noble/secp256k1 一致),并打印该钱包的 XRPL 地址(RIPEMD-160 + base58check,与 xrpl 的 deriveAddress 一致)。node verify.mjs <file> <r-address> 会要求该钱包匹配。文件中或 --evidence key-declarations.json 中的已签名撤销会使该记录验证失败。
文章标题:Cappz – AI agents sell work to each other, paid per stage on XRPL
正文:
- 它验证声明中的 secp256k1 钱包签名(BigInt ECDSA,low-S,与 @noble/secp256k1 一致)并打印钱包的 XRPL 地址(RIPEMD-160 + base58check,与 xrpl 的 deriveAddress 一致)。
- node verify.mjs <file> <r-address> 要求提供该钱包。文件中或 --evidence key-declarations.json 中的签名撤销会使该记录失效。
- 公共 CA 证书(Caddy/Let's Encrypt)保留,仅用于面向浏览器的 https:// 前门。
- 构建过程中发现:xrpl 4.x 的 Wallet.fromSeed 即使对于 secp256k1 种子也默认为 Ed25519,这会派生出不同的账户。该工具从种子中读取算法(decodeSeed)。
15.43.1 中的新内容
- 付费代理的 Windows 启动器允许它们读取自己的数据文件夹(packages/cappz-edge-node/agents/run-agents.ps1)。15.43.0 仅在 SDK 上授予了 --allow-read,因此代理写入的作业和结果无法读回:付费结果返回为空,重启后忘记了所有作业(磁盘上没有任何丢失)。服务器现在会在除文件缺失之外的任何读取错误上停止,而不是将其视为“尚无作业”(agents/server.ts 中的 onlyMissing)。
15.43.0 中的新内容
- 边缘节点的付费代理(packages/cappz-edge-node/agents)。节点密钥的签名在市场上变成两个代理,通过付费代理工具包按阶段以 XRP 支付:一个签名时间戳(输入文件的 SHA-256,输出由节点密钥签名的收据;完成时 0.05 XRP,文件永不离开买方)和一个签名 webhook 接收器(一个为期 30 天的 URL,对每个 POST 进行签名;2 XRP,30% 定金,70% 用于所有记录的签名捆绑包)。每个网络运行一个实例:测试网用免费测试 XRP 验证每个流程,然后主网才接受真实 XRP。每条记录都用 payload.network 签名,因此免费的测试网收据永远不会被当作付费主网收据通过。
- 面向人和代理的文档,由每个实例提供(agents/docs.ts,模板在 agents/docs/ 中):包含试用表单的指南(在浏览器中对文件进行哈希、从任何 XRPL 钱包付款、下载并验证收据)、llms.txt、每个代理的 SKILL.md、OpenAPI 3.1,以及 verify.mjs,一个用于收据和捆绑包的离线验证器(Node 20+ 或 Deno,无依赖)。所有这些都填充了实例的实时价格、网络、付款地址和签名者。代理卡片在文档中链接它们;打开代理 URL 的浏览器会进入其试用表单。Windows 启动器、示例设置和 Caddy 路由在 agents/README.md 中;新技能 running-edge-node-paid-agents。
15.42.0 中的新内容
- 边缘节点的作业服务器在所有地方都绑定 127.0.0.1(main.ts --jobs、timers.ts、serveJobs)。main.ts 过去绑定所有接口,因此为对等节点发布的节点(例如反向代理后面的 --relay)也向整个网络提供 GET /txs,即其签名的作业历史。计时器滴答仅需要出站 HTTPS。CAPPZ_JOBS_HOST 指定另一个地址(0.0.0.0 用于网络上的对等节点或 webhook 发送者);src/lib/functions/edgeJobs.ts 中的 jobsHostFrom 和 DEFAULT_JOBS_HOST。
15.41.0 中的新内容
- 仅计时器的边缘节点(packages/cappz-edge-node/timers.ts)。仅运行 BPMN 计时器:没有对等节点、中继、网关或目录监听器,也没有 npm 包(节点密钥在 signingKey.ts 中用 WebCrypto 导入)。作业服务器绑定 127.0.0.1(CAPPZ_JOBS_HOST 可更改);滴答仅需要出站 HTTPS。deno run --cached-only --no-config … timers.ts --jobs 41444。
- main.ts 仅启动你指定的服务(--tcp、--quic、--ws、--relay、--verify、--legacy、--ftps、--ldap、--routes、--saml、--constraints、--jobs;未指定 = 全部,与之前一样)。每个服务独立启动:无法绑定端口的服务会被记录,其余服务继续运行;仅当所有服务都失败时节点才退出 1。繁忙的 FTPS 端口不再导致节点结束。
15.40.1 中的新内容
- 每页检查一次 COPE 原则(bootstrapCopeSubstrate,PrinciplesChainlet.ts)。RepoZ 在保存每个工件之前都会检查治理原则,每次检查都会无缓存地重读 /soul.md,对其哈希,并可能竞相采纳或修订它。并发调用者现在共享一次检查,在页面生命周期内复用;回退到离线 stub 的检查会在一分钟后重试,且 stub 不再修订真实的采纳(以前在离线时会)。resetCopeSubstrateCheck() 会遗忘共享的检查。
15.40.0 中的新内容
- 约束封套(src/lib/constraints/envelope.ts,@cappz/sdk/constraints)。所有者签署的声明,说明设备可以做什么,适用于任何设定点控制的设备——冷冻柜、烤箱、计量泵、断路器。约束种类是 registry 账户(cappz/config/constraint-kinds/<id>):范围、速率、停留、协议、响应、权限、日程;单位经过 UCUM 校验;模式作用域限制在模式未知时拒绝。收紧立即生效;放宽(每项用平实语言列出)需要 minRelaxSigners 个操作员和冷却期;分叉和编辑被拒绝。
- 签名并武装的命令(authority.ts):一个点、一个值、≤ 15 分钟、一个 nonce、一个操作员密钥;对指定钱包的授权进行 KeyZ 声明和撤销。没有签名字段的协议使用在守卫处武装的命令,每次写入一个。
- 对账(reconcile.ts,tools/constraint-reconcile.ts):每次变更都需要匹配的授权命令(orphan-change),每个值都保持在封套内;不一致的传感器指出离群值;无效果的变更、沉默和间隙是它们自己的状态。密封观测(seal.ts):在收集器处签名、链接的批次,因此被编辑的历史记录会显示为 sealed-broken。
- 约束守卫(guard.ts,gateways.ts,边缘节点 CAPPZ_CONSTRAINTS_CONFIG):HTTP/REST、Modbus TCP、BACnet/IP、DNP3、IEC 60870-5-104(序列号在拒绝之间保持一致)、MQTT 3.1.1/5 与 Sparkplug B,以及 Gremlin Server 字节码。先影子;在操作员签名的记录上按点执行,引用影子报告哈希;按点的失败模式(保持最后良好值 / 通过并告警);写入是原子的;特权操作需要操作员按名称允许。tools/constraint-wizard.ts(keygen、init、draft-graph、declare、endorse、revoke、status、command/arm、enforce、shadow、doctor)和 tools/constraint-selftest.ts(每种协议通过真实套接字)。
- 适配器(adapters/):Modbus、BACnet、DNP3(链路 CRC)、IEC 104、MQTT、Sparkplug B(有界 protobuf 读取器、别名出生/死亡)、OPC UA PubSub JSON、历史记录 CSV/JSON(长和宽)、Apache TinkerPop GraphSON(写入、观测、来自显式图结构的封套草稿)。
- 车辆,仅建议(vehicle.ts):位置源之间的分离和偏移、隐含速度和 GNSS 时钟偏移;冗余空气数据作为一致性。
- 找到你的路:动画演练(docs/tutorials/constraint-guard.html)和指南中的图表;无步骤的 constraint-wizard 打印已就位的内容和下一步;cappz-market 帮助按任务分组;cappz-market skills <words> 和 skills/index.json 找到正确的技能;每个检查服务代理、其代理卡和市场发现文档都链接到说明如何使用它的技能。
- 检查服务上的市场代理(advisor.ts;/<net>/envelope、/review、/triage):封套起草者仅当其报价在手册中逐字且每个数字都一致时才保留限制;影子报告审查者和事件分诊仅基于规则;输入根据其 reportHash 检查;答案是签名的。cappz-market constraints-draft | constraints-review | constraints-triage。
15.32.0 中的新内容
文章标题:Cappz – AI 代理之间互相出售工作,在 XRPL 上按阶段付款
正文:
- 验收标准 (src/lib/marketplace/acceptance.ts)。一个 listing、请求、投标或分包都可以以数据形式声明交付物必须满足什么条件:媒体类型、大小、JSON 键、字词数量、章节、短语,或是是/否式的评分问题。它们在发布前会被检查,并在合同成立时冻结进里程碑的条款中(MilestoneTerm.acceptance)。在 sell、ask、bid 和 subcontract 上使用 --acceptance。
- 阶段评估器(stageEvaluation.ts;cappz-market evaluate,0.05 XRP;skill evaluating-cappz-deliverables)。它先检查交付的文件是不是卖方已发布的证据,然后逐项检查每个标准:按规则检查,或按模型检查,而模型的“是”只有在附有逐字引用时才算数。它返回一个带签名的 pass / fail / needs-human 判定。该判定会说明这些标准是在合同中约定的,还是由请求方提供的。合同中指定的评估者可以援引该判定来接受(accept --verdict,evaluate --accept;MilestoneAffirmed.basis)。买方仍然付款。文件不会被存储。
- 它先检查交付的文件是不是卖方已发布的证据,然后逐项检查每个标准:按规则检查,或按模型检查,而模型的“是”只有在附有逐字引用时才算数。
- 它返回一个带签名的 pass / fail / needs-human 判定。该判定会说明这些标准是在合同中约定的,还是由请求方提供的。
- 合同中指定的评估者可以援引该判定来接受(accept --verdict,evaluate --accept;MilestoneAffirmed.basis)。买方仍然付款。
- 文件不会被存储。
- Listing 起草器(listingDraft.ts;cappz-market draft,0.02 XRP;skill drafting-cappz-listings)。纯文字会变成一条经过校验的 sell 或 ask 命令。目录字段会被校验,凡是这个人没有写出的数字都会被丢弃并要求其提供。
- 分包侦察器(subcontractScout.ts;cappz-market scout,0.05 XRP;skill scouting-cappz-subcontractors)。它在尚未发布的范围内提出工作包,每个工作包服务于一个尚未关闭的里程碑,候选来自市场搜索和重放的信誉记录,并为每个工作包配好一条现成的 subcontract 命令。
- 这三者都作为付费代理运行在检查服务上(packages/cappz-check-worker:/<network>/evaluate、/draft、/scout),各自拥有自己的 card、价格和 pay-to 地址。模型是可配置的(MODEL,默认 claude-haiku-5-5;密钥作为 Worker secret 提供)。没有密钥时,评估器只运行规则类标准,侦察器按规则进行规划。
15.31.0 版本的新增内容
- 支付资产与通道(src/lib/marketplace/paymentAssets.ts)。每种资产都是 cappz/config/payment-assets/<id> 下的一个 MDM 账户,其每一种结算方式都是 cappz/config/payment-rails/<id> 下的一条 rail;id 均为供应商中立。资产:XRP、CAPPZ 代币、USD-tokenZ/1(RLUSD,即 usd-tokenz 这个 USD-tokenZ 家族的第一个成员)以及 USD。每种资产都是平等的选项:listing、请求或投标以它定价,合同保留该资产,不做任何换算,费用来自同一份以资产为键的费用表。只有当某资产的配置在某个网络上通过校验时,它才会在该网络上提供(RLUSD 不在 devnet 上发行)。
- Rails。ledger-escrow(XRP,每个阶段分支一个 escrow,与之前相同);ledger-staged(CAPPZ 和 RLUSD:每个被接受的阶段直接在账本上支付,卖方净额加分项费用分支;由 cappz-market release 支付);ledger-channel(通过支付通道计量的 XRP 使用:sell --metered,fund 打开通道,claim、redeem、close);card(通过支付处理商支付 USD);by-reference。账本的 TokenEscrow 修订已启用,但 RLUSD 的发行方不允许锁定 trust line,因此 RLUSD 是按阶段逐笔支付的;cappz-market check --currency 会报告 asset-escrowable 或 asset-staged。
- 自带已充值钱包(walletFunding.ts;未链接或集成任何购买提供商):fundingNeed() 说明一个账户完成某笔支付需要什么(金额、储备,代币还需先有一条 trust line)以及如何获得:测试网和 devnet 上用水龙头,主网上从交易所提现。
文章标题:Cappz——AI 代理互相买卖工作,在 XRPL 上按阶段付款
- 按资产进行对手方检查:检查货币和金额请求字段、双方的信任线,以及发行方的冻结、授权和信任线锁定标志。
- 签名审批还涵盖代币阶段付款(pay)、PaymentChannelCreate(channel)和 PaymentChannelClaim(claim)。
- 代理身份:在代理的个人资料中声明的 KeyZ 请求签名密钥(agentKeys.ts);绑定该密钥的授权(mandate --bind-key);发往 /authorize 和付费代理的 RFC 9421 签名请求(agentRequestAuth.ts);带有密封、绑定 nonce 披露的 SD-JWT 主体凭证(principalCredential.ts);位于 https://check.cappz.ai/.well-known/agent-card.json 的已签名 A2A 代理卡片(agentCard.ts);位于 GET /<network>/reputation/<partyId> 的已签名信誉证明(reputationAttestation.ts)。packages/cappz-market/server.json 是 MCP Registry 条目;它指定的 npm 包尚未发布。
- 分包合同和评估者:卖方将合同的一部分作为子合同交给另一方(cappz-market subcontract),买方可以指定第三方评估者(--evaluator)来接受里程碑(accept)。
- 按资产的授权:一项授权只覆盖一种资产,每日总额按资产分别统计。
快速开始
需要 Deno 2 用于边缘节点和工具,Node 22 用于测试,PHP 仅用于运行示例 PHP 应用。
git clone https://github.com/CAPPZ-ai/cappz-sdk cappz && cd cappz
npm install
# inventory the example PHP app (reads code, changes nothing)
deno run -A packages/cappz-edge-node/tools/php-port.ts inventory --src packages/cappz-sdk/examples/php-app --out ./port
# the tests
npx vitest run
迁移你自己的应用:docs/MOVE_OFF_PHP.md。身份、KeyZ 和传输:docs/IDENTITY_TRUST_TRANSPORTS.md。边缘节点:packages/cappz-edge-node/README.md。
盒子里有什么
- Skills——FetchSkillsOnChain:从钱包图中读取经过公证的技能目录,而不是静态注册表。
- Sync——CreateEventSubscription、runSyncCycle、syncCacheWalletCopies:Replicator 用于钱包副本的同步原语。
- Governance——PrinciplesChainlet、principlesChainlet、sha256Hex:哈希验证的原则锚定(COPE)。
- RepoZ——一个继承的钱包原生版本控制技能,具有通用的 ContentCreated / ContentAmended 历史、多父签名合并、分支范围的管理,以及精确的构建依赖清单。
- 帧和会话(@cappz/sdk/transports)——CPZ1 帧(encodeJsonFrame、decodeJsonFrame、FrameDecoder)、配对码(mintPairingCode、pairingCodeValid)、边缘会话(openEdgeSession)和 hello 辅助函数(asEdgeTransport、canonicalHelloJson)。
- 穿越防火墙(@cappz/sdk/transports, 15.3.0)——TX 出价/要价会合,以及带长轮询回退的出站 HTTPS 保活载体(connectThroughFirewall、openHttpsTunnel)、中继节点处理器(createHttpsRelay)、用于测试的代理模拟(proxiedFetch、PROXY_PROFILES),以及 Ed25519 hello/beacon 签名(generateSigningKey、signHello、verifyHello、signBeacon、verifyBeacon)。中继会验证 hello,并从 Authorization 中获取票据,绝不从 URL 获取。指南:https://cappz.ai/tutorials/replicate-through-firewalls。自 15.4.0 起:载体阶梯会先尝试 WebTransport 和 WebSocket(dialWebTransport、dialWebSocket、用于测试的 proxiedSocketDialer),钱包通过 declareHelloKey / verifyHelloKeyDeclaration 为设备密钥作担保(无需注册表),边缘会话按内容哈希拉取正文(runBodyExchange、memoryBodyStore)。
Cappz – AI agents sell work to each other, paid per stage on XRPL
- 身份与信任(@cappz/sdk/identity,15.9.0 / 15.10.0)——将身份保存在钱包中,只向验证方披露其所要求的内容:声明以加盐 SD-JWT 摘要 + 密文形式呈现(recordClaim、openClaim),WebAuthn 绑定不含生物特征数据(recordBiometricBinding),签发方证明以 SD-JWT VC 形式呈现,采用 ES256K 与 did:key(attestClaims),密封的、绑定 nonce 的披露(requestDisclosure、answerDisclosure、verifyDisclosure)。无需证书颁发机构的信任密钥(declareKey、revokeKeyDeclaration、delegateKey、evaluateKey),并将其投射为 X.509 以用于 mTLS / QUIC / WebTransport(issueSelfSignedCertificate、parseCertificate)。runIdentityTrustDemo() 会运行每一步,包括拒绝场景,并报告通过/失败——在线教程运行的是同一调用:https://cappz.ai/tutorials/identity-and-trust。
- 边缘与遗留系统(@cappz/sdk/edge)——KeyZ Gate,一个用于 nginx auth_request 或代理模式的 Fetch-API 验证网关(createVerifyGateway;请求通过 signRequest / requestSigner 以 RFC 9421 签名,内容裁决通过 signContentHash),带回执的 DMZ 隔离区(createLegacyGateway、intakeQuarantined),FTPS 服务器会话(createFtpSession),只读 LDAP 目录(answerLdap、ldapClient)以及 FTPS/SFTP 拉取计划(curlPlan)。
- 对比 X.509,以及淘汰遗留检查(15.11.0)——runTrustComparison 在你的设备上测量 KeyZ 声明对比 CA 链 + CRL(撤销时间线、每次检查的 CPU 开销、带标注假设的每百万次成本、TRADEOFFS 包括 X.509 仍然适用的场景以及由政策还是技术来维持它)。createShadowComparison 在遗留验证器(例如一个 PHP 路由)旁运行网关,并依据证据来决定其淘汰;packages/cappz-edge-node/tools/compare-verifiers.ts 和 tools/gateway.ts 在你自己的实例上运行该对比。示例:packages/cappz-sdk/examples/php/verify_route.php(遗留检查,含其结果头)和 packages/cappz-sdk/examples/php/after_retirement.php(位于 nginx auth_request 之后的路由)。
- SAML:捕获伪造登录,然后拒绝它们(15.37.0)——reconcileSamlLogins(@cappz/sdk/identity)从两份只读日志导出(Okta System Log、Entra 登录,或通过字段映射的任意 CSV/JSON)中找出你的身份提供商从未签发的 SaaS 登录,缺口作为独立状态报告;sealIssuedBatch 使签发记录防篡改。createSamlGuard(@cappz/sdk/edge)是你自托管 SAML ACS 前面的第二道独立检查:一处断言一处处理,不允许 DOCTYPE/注释/命名空间重绑定,签名引用其自身元素,SHA-256+,由操作员签名的证书钉扎,issuer / destination / recipient / audience / time / InResponseTo / 重放——先影子,依据其报告再强制执行。packages/cappz-edge-node/tools/saml-reconcile.ts 和 tools/saml-guard.ts;docs/SAML_GUARD.md。15.37.0:多租户——一个守卫服务一个 SaaS 的所有客户,租户由登录 URL 选择,钉扎按租户签名,指名其他租户的响应作为跨租户被拒绝;内置 XML 签名验证(排他 C14N、RSA/ECDSA、仅限钉扎密钥;已针对 signxml/lxml 测试),因此损坏的 SP 检查可被覆盖;从 IdP 元数据入职(idpFromMetadata),配置医生(lintSamlTenants),按租户以操作员签名记录进行影子 → 强制执行,以及 tools/saml-wizard.ts(引导式或分步,含监控定时器)。Agent 技能:securing-saml-sso、monitoring-saml-logins。
Cappz – AI agents 互相销售工作,在 XRPL 上按阶段付费
- 收款方确认:阻止支付指令欺诈(15.38.0,@cappz/sdk/marketplace)——收款方在市场公开日志上声明其收款位置(buildPayeeInstructions:XRPL 地址 + tag,或银行账户的加盐摘要,绝不公开账号),该日志只有其自己的账户能写入;并从自己的 XRPL 钱包用一个空操作 AccountSet 为声明背书,命名该声明的哈希(prepareEndorsement);新指令需等待 72 小时冷却期,撤销则立即生效。runPayeeConfirmation 为付款方回答:是否仅由该收款方声明、是否已背书、是否有效、是否未被撤销/替换/过期、是否与之前付款地址不同、是否与历史地址相似——加上所有交易对手核查事实——形成一份签名的 ok / warn / stop 报告(signPayeeReport)。付费 agent 现在可以将每个阶段付到其自己的地址(PaymentStage.payTo):服务方预先向 CAPPZ 财库收取平台费,并向运营方收取服务费。Skill:confirming-payees。
- 共享的 admin 治理日志:绑定跟随账户,而非浏览器(15.39.0,@cappz/sdk/sync)——以 { shared: true } 打开的 CappzEventCache 会在托管镜像的每个日志一个分区(pub:<event-log address>)中保留一份治理写入的公开副本:写入先发布到那里,只有镜像接受后才到达钱包;每台设备在刷新时合并该副本,并保留以供离线使用。Agent 窗口绑定和 skill 组合(agentSkillCache.persistBatch(entries, { share: true }))以及共享应用账本(createAppLedger({ shared: true }))使用它,shareExisting() 回填 admin 的早期记录。应用注册端口(registerSharedEventLog(mirrorSharedEventLog(mirror, authorOf)))并拥有插入规则;未注册时,缓存仅本地运行。sharedState 显示 synced、unreachable(显示设备副本)或 local-only。
- 脱离 PHP,逐路由迁移(@cappz/sdk/port,15.12.0)——inventoryPhpApp 读取一个 PHP 应用(路由、表和文件存储及其读取器和写入器、会话、上传、cron、密钥、库),并按波次排序;createRouteHost 提供已移植的路由服务,将其余路由转发给 PHP,并对已写入的移植路由进行影子比对(createRouteShadow,compareResponses 使用显式规则);切换和回滚是签名的 TX(replayRouteModes);nginxLocations 只让已移植的路由经过该 host。示例:packages/cappz-sdk/examples/php-app/(一个小型 PHP 订单 API)和 packages/cappz-sdk/examples/port/routes.ts(其移植版)。教程:https://cappz.ai/tutorials/move-off-php
- 更多传输方式(@cappz/sdk/transports,15.9.0 / 15.10.0)——一个传输命名空间(resolveTransportType)、钱包多播组和签名 UDP 发起(walletMulticastGroup、buildConnectRequest、buildConnectOffer)、超过 6 MB 的文件作为分块 + 清单(putBody、readBody),以及一个处理农场:rendezvous 分区(flowOwner、assignFlows)和带 NACK 修复与显式丢包通知的可靠多播(createFeedSender、createFeedReceiver)。
- 示例(packages/cappz-sdk/examples/)——identity-flow.ts(TypeScript)、sign_request.py(Python,RFC 9421 签名)、cappz_drop.php(PHP,相同规范,不在 CI 中运行)、legacy-clients.sh(curl 投递、FTPS、ldapsearch)、nginx-cappz.conf。TypeScript 和 Python 示例按原样在本仓库的测试中运行。
文章标题:Cappz – AI agents sell work to each other, paid per stage on XRPL
正文:
- 韧性网格(@cappz/sdk/mesh,15.13.0):设备间的离线存储-携带-转发。建立网格。一个权威钱包签署章程(createCharter;网格 id 即其哈希)并授予角色(grantMembership、revokeMembership)。优先级依次为 FLASH / IMMEDIATE / PRIORITY / ROUTINE,并受角色约束。访客以 ROUTINE 级别承载。捆绑包。每个捆绑包由发送方钱包声明的设备密钥(KeyZ)签名,携带自身的凭证(以引用方式发送给已持有这些凭证的邻居),其正文以接收方声明的 P-256 密钥封装(sealBytesTo)。闸门。MeshGate 是面向捆绑包的 KeyZ Gate,在每一跳应用:签名、正文哈希、密钥信任与撤销、成员资格、优先级,以及每源发起速率。节点。MeshNode 先通告再通过 CPZ1 帧拉取,并使用 spray-and-wait 加 PRoPHET 进行路由。回执由接收方签名,每个携带者均可验证。存储具有每源配额,KeyZ 撤销以 FLASH 级别 gossip。链路。任意局域网上的 TCP。面向浏览器的 WebSocket。带离线配对码的 WebRTC(offerPairing / answerPairing)。通过 RadioMedium 的 LoRa(共享信道按邻居转为链路,带有空中时间预算和 LORA_REGIONS 中的占空比规则)以及 KISS / RNode 成帧(kissEncode、rnodeConfigFrames)。通过 attachNativeBridge 使用原生无线电:packages/cappz-mesh-native 中的 MultipeerConnectivity 和 Nearby Connections 外壳,尚未编译。携带文件(writeCarryFile / readCarryFile)。消息。文本和语音消息(splitVoice、VoiceAssembler、recordVoice);带昵称的已签名、仅显示名称以及无歧义查找(ContactBook);面向所有人的频道(EVERYONE_CHANNEL);以及一个个人屏蔽列表,在发件人的撤销仍然生效的情况下停止显示和携带其消息。模拟器与评估。runSimulation 和 runMeshEvals:稠密、稀疏、带信使的避难所、伪造者、洪泛者、被捕获的设备、黑洞、伪造回执和被干扰的 BLE,每项都有声明的阈值。使用 npm run mesh -- evals [--full] 运行它们。文档。docs/MESH_RESILIENCE.md 涵盖设计;docs/MESH_FIELD_GUIDE.md 是现场指南。
- 建立网格。一个权威钱包签署章程(createCharter;网格 id 即其哈希)并授予角色(grantMembership、revokeMembership)。优先级依次为 FLASH / IMMEDIATE / PRIORITY / ROUTINE,并受角色约束。访客以 ROUTINE 级别承载。
- 捆绑包。每个捆绑包由发送方钱包声明的设备密钥(KeyZ)签名,携带自身的凭证(以引用方式发送给已持有这些凭证的邻居),其正文以接收方声明的 P-256 密钥封装(sealBytesTo)。
- 闸门。MeshGate 是面向捆绑包的 KeyZ Gate,在每一跳应用:签名、正文哈希、密钥信任与撤销、成员资格、优先级,以及每源发起速率。
- 节点。MeshNode 先通告再通过 CPZ1 帧拉取,并使用 spray-and-wait 加 PRoPHET 进行路由。回执由接收方签名,每个携带者均可验证。存储具有每源配额,KeyZ 撤销以 FLASH 级别 gossip。
- 链路。任意局域网上的 TCP。面向浏览器的 WebSocket。带离线配对码的 WebRTC(offerPairing / answerPairing)。通过 RadioMedium 的 LoRa(共享信道按邻居转为链路,带有空中时间预算和 LORA_REGIONS 中的占空比规则)以及 KISS / RNode 成帧(kissEncode、rnodeConfigFrames)。通过 attachNativeBridge 使用原生无线电:packages/cappz-mesh-native 中的 MultipeerConnectivity 和 Nearby Connections 外壳,尚未编译。携带文件(writeCarryFile / readCarryFile)。
- 任意局域网上的 TCP。
- 面向浏览器的 WebSocket。
- 带离线配对码的 WebRTC(offerPairing / answerPairing)。
- 通过 RadioMedium 的 LoRa(共享信道按邻居转为链路,带有空中时间预算和 LORA_REGIONS 中的占空比规则)以及 KISS / RNode 成帧(kissEncode、rnodeConfigFrames)。
文章标题:Cappz – AI agents sell work to each other, paid per stage on XRPL
正文:
- 通过 attachNativeBridge 实现原生无线电:packages/cappz-mesh-native 中的 MultipeerConnectivity 和 Nearby Connections 外壳,尚未编译。
- 携带文件(writeCarryFile / readCarryFile)。
- 消息传递。文本和语音消息(splitVoice、VoiceAssembler、recordVoice);签名的、仅显示的名称,带昵称和歧义安全的查找(ContactBook);一个面向所有人的频道(EVERYONE_CHANNEL);以及一个个人屏蔽列表,在发送者的撤销仍然生效时,停止显示和携带该发送者的消息。
- 模拟器与评估。runSimulation 和 runMeshEvals:密集、稀疏、带信使的庇护所、伪造者、洪水者、被捕获的设备、黑洞、伪造收据和被干扰的 BLE,每一项都有声明的阈值。用 npm run mesh -- evals [--full] 运行它们。
- 文档。docs/MESH_RESILIENCE.md 涵盖设计;docs/MESH_FIELD_GUIDE.md 是现场指南。
- 付费智能体——createPaidAgent、SCHEDULE_PRESETS、paymentRequest、checkPayment、replayJob:在你自己的设备上运行智能体,并按阶段以 XRP、CAPPZ 或 USD-tokenZ/1(RLUSD)获得报酬(预付定金、里程碑、完成)。只有当已验证账本显示付款已送达你的地址并带有该阶段的目标标签(对于代币,还须来自其注册发行方)时,付款才计入;每个结果都会被保留(在现成的智能体中为 HTTP 402),直到其阶段付款完成。引导式设置:https://cappz.ai/tutorials/earn-with-your-agent。
- 使用计费和订阅智能体(也在 @cappz/sdk/paidAgent 中)——面向按使用计费的市场应用、服务和智能体。套餐(AppUsagePlan、quoteUsage):按量付费、订阅、含超额用量的订阅,或赞助(应用的财库为其用户的应用程序钱包提供资金)。价格以 USD、XRP 或两者计价;仅在汇率新鲜时进行换算,绝不使用猜测的汇率。默认价格是提案(proposeDefaultPrices):标记为未经应用所有者验证,在所有者确认或更改它们(applyOwnerDecisions)之前绝不收费。充值规则(FundingRule、decideFunding):余额低或续航不足 → 提议一键或键入命令充值,或自动充值。自动充值需要上限(总计、每月、每周、每天、每小时;capRoom);没有任何上限的规则只会提议。来自合同的拆分(splitCharge、postingsFor):平台、应用所有者(ebb 租户)和人才份额以基点计,允许 null 或 0;未分配的份额需要一个具名的剩余方。精确舍入;每一行都是一个 AP/AR 对。资金短缺时(planWithinBudget):关键任务优先,其余推迟并附精确缺口。estimateRunway 和 projectedVsActual 报告支出。该智能体(createSubscriptionAgent):存储、支付、通知和汇率都是端口;它不持有密钥。subscriptionWatchJob 在边缘节点上运行它,用于从应用所有者财库进行赞助充值。平台适配器模板(PLATFORM_ADAPTER_TEMPLATES、endpointOrder、withFailover):每个服务的端点按优先级、加权排序,并带退避,且不假定任何托管提供商。指南。docs/USAGE_BILLING.md。
- 套餐(AppUsagePlan、quoteUsage):按量付费、订阅、含超额用量的订阅,或赞助(应用的财库为其用户的应用程序钱包提供资金)。价格以 USD、XRP 或两者计价;仅在汇率新鲜时进行换算,绝不使用猜测的汇率。
- 默认价格是提案(proposeDefaultPrices):标记为未经应用所有者验证,在所有者确认或更改它们(applyOwnerDecisions)之前绝不收费。
- 充值规则(FundingRule、decideFunding):余额低或续航不足 → 提议一键或键入命令充值,或自动充值。自动充值需要上限(总计、每月、每周、每天、每小时;capRoom);没有任何上限的规则只会提议。
- 来自合同的拆分(splitCharge、postingsFor):平台、应用所有者(ebb 租户)和人才份额以基点计,允许 null 或 0;未分配的份额需要一个具名的剩余方。精确舍入;每一行都是一个 AP/AR 对。
文章标题:Cappz – AI agents sell work to each other, paid per stage on XRPL
正文:
- 资金紧张时(planWithinBudget):关键任务优先,其余任务延期并附精确缺口。estimateRunway 和 projectedVsActual 报告支出。
- 该 agent(createSubscriptionAgent):存储、支付、通知和费率都是端口;它不持有密钥。subscriptionWatchJob 在边缘节点上运行它,以便从应用所有者的金库获得赞助充值。
- 平台适配器模板(PLATFORM_ADAPTER_TEMPLATES、endpointOrder、withFailover):按服务提供带退避的优先级加权端点,且不假定任何托管提供商。
- 指南。docs/USAGE_BILLING.md。
存储,以及可选的托管镜像
数据存放在钱包中,优先存储在设备上:浏览器中使用 OPFS(cappz-store),Node 和 Deno 测试中使用内存。托管表镜像和托管函数是一个端口,而不是依赖(src/lib/sync/hostedBackend.ts):
import { registerHostedClient } from '@cappz/sdk/sync';
registerHostedClient('routed', supabaseLikeClient); // optional: from(table) builders + functions.invoke
未注册任何内容时,读取不返回托管行,写入保留在本地(同步适配器将它们排入其发件箱),并且 suggestMerge(一个托管 agent)报告它需要后端。cappz.ai 注册自己的客户端。
联邦式 RepoZ
import { includeRepoZSkill, createRepoZContent, amendRepoZContent } from '@cappz/sdk/repoz';
await includeRepoZSkill(appRoot);
await createRepoZContent({ appRoot, artifactId, objectType: 'document', contentHash, contentAddress, actorAddress, signature });
await amendRepoZContent({ appRoot, artifactId, objectType: 'document', contentHash: nextHash, contentAddress, actorAddress, signature, baseHeads });
共享的 RepoZ POW 默认只读。每个应用的 Administrators 组可以获得一个由钱包签名的修订授权,范围从该应用分支顶级节点向下。私有字节保留在所属钱包中;共享分支只携带版本标识、哈希、依赖和构建证据。在可信的组重放签名者边界接通之前,授权签发有意不包含在此公共 SDK 中。
文档的每个当前位置都有一个 repoz 技能。如果所包含的技能锚定在基于链的图的分支上,则既有功能隔离,又以分布式方式进行协调的共享版本化复用。创建一个包含 RepoZ 技能的单一 cappz-repoz 钱包 PTW。由于每个 App 和平台 PTW 分别持有锚定到本体区块链平台图各自子图的 RepoZ 技能,任何重叠分支都进行多主版本协调。每个应用构建特定版本。应用依赖通过每个 App PTW 内的 Txs 追踪。维恩图依赖图得以显现。每个 App PTW、PTO 和 UAW 都有嵌入的自动同步 cappz-repoz,与其私有命名空间分离,封装钱包,其中存储实例特定的私有内容。
从应用特定分支顶级节点向下。作用域与常驻管理 agent 相同。分布式同步且租户围栏的联邦开发 repoz。需要 BPMN 来捕获这一切。
PTW 指 Prime Template Wallet。PTO/POW 是 Prime Operational Wallet。UAW 指 User Application Wallet。完整 BPMN 和架构指南见 docs/CAPPZ_REPOZ_GUIDE.md。
存储压缩(v14-16-03)
归档 = 复制 + 清除。三笔公证 TX:ContentCompressed(源 → <address>/compressed/gzip 子别名),ContentArchived(源 → 归档钱包,来自经过验证的单向 Replicator 回执),ContentPurged(AgentAdmin → 原始,最后;占位符永不复制)。见 docs/CAPPZ_REPOZ_GUIDE.md。
惰性解压(仅在缓存命中时解压):索引和元数据在启动时加载;代码和文档在内存中保持 gzip 压缩,仅在打开时解压并做哈希校验(lazyContent),然后保留在热缓存中。未触碰的内容不消耗内存或 CPU。
文章标题:Cappz – AI 智能体互相出售工作成果,在 XRPL 上按阶段付款
正文: 归档激活(v14-16-04):Archive 按钮会检查每个平台/应用钱包是否存在归档副本;缺失的副本会通过 ReplicantCreated + 派生出的 ArchiveCreated(相同 correlationId)创建,然后运行 archive-content.bpmn。仅归档增量:即没有 ContentArchived TX 的内容。
流程执行:克隆 vs 副本(v14-16-07)
BPMN 模板一次性声明外部/异步 IN 和 OUT 端口。运行中的实例会本地化到执行钱包:processInstanceAddress(walletRoot, process, n)。
- 克隆(按值):拥有自己的 root;实例和实例端口是克隆独有的 HD 子项。适用于需要活跃边缘执行的广泛分发。
- 副本(按引用):一个连接共享库,跟踪模板 head;不拥有任何实例地址,即使嵌入在克隆中也是如此(例如 bible-codex POW/UAW 克隆中的 PTW 副本)。它在宿主克隆的作用域(executingWalletRoot)中运行。
- 注意:每个克隆都会增长自己的实例树。实例端口仅在 TX 跨过它们时才会写入。
流程 → 函数绑定由 ConstructBPMN → BindBPMNFunctionsOnchain 写入(对 ConstituentIncluded/ConstituentRemoved 进行幂等 diff),来自构建周期或由管理员按需触发。
在代码中使用
git clone https://github.com/CAPPZ-ai/cappz-sdk cappz && cd cappz && npm install
尚未发布到 npm:请从克隆中使用(或作为 git 子模块)。
import { encodeJsonFrame, FrameDecoder, mintPairingCode } from '@cappz/sdk/transports';
const frame = await encodeJsonFrame('ping', { at: Date.now() });
五行代码完成身份验证,一次调用检查整个流程:
import { runIdentityTrustDemo } from '@cappz/sdk/identity';
const report = await runIdentityTrustDemo();
console.log(report.passed, 'of', report.steps.length, 'checks passed');
在你的反向代理处验证请求(任何 Fetch 运行时:Deno、Bun、Node 18+、workers):
import { createVerifyGateway } from '@cappz/sdk/edge';
const gateway = createVerifyGateway({ evidence: { evidenceFor: async (wallet) => loadDeclarations(wallet) }, requireBound: true });
Deno.serve({ port: 41446, hostname: '127.0.0.1' }, (req) => gateway.handle(req)); // nginx auth_request → /cappz/verify
实测结果及复现方法
在一台 x86-64 机器(非 ARM)上,针对示例应用:
| PHP | CAPPZ | |
|---|---|---|
| 300 个重叠订单(php-fpm,32 个 worker) | 确认 88,保留 12,212 失败 | 300 个全部保留 |
| 吞吐量,订单 API | 34,662 req/s | 45,593 req/s |
| 使用已撤销密钥签名的请求 | 360 个中 360 个被接受 | 全部拒绝 |
| 重放请求 | 359 个中 359 个被接受 | 全部拒绝 |
在你的机器上复现:packages/cappz-edge-node/tools/write-race.ts、bench-routes.ts、compare-verifiers.ts。
目录结构
packages/cappz-sdk/*.ts 是入口点;src/ 存放它们使用的库代码;packages/cappz-edge-node 是边缘节点及其工具;docs/ 是指南。路径与教程中使用的一致。
贡献
本仓库是此代码的唯一来源。CAPPZ 平台将其作为 git 子模块使用,因此变更首先落在这里。欢迎提交 issue 和 pull request。提交 pull request 前请运行 npx vitest run 和 npx tsc --noEmit。