@agenticprimitives/estate-projection

中文文档
0.0.0-alpha.21发布于 2026/10/26MITTypeScriptES Module近 30 天下载 4049

An estate's public projection of its authority (spec 410 §4): the live-grant root and the membership root over blinded commitments, anchored on public ground; the authority presentation a verifier in another estate checks against them, learning that a gra

原始使用文档

@agenticprimitives/estate-projection

An estate's public projection of its authority — spec 410 §4.

Grants and relationships are enforced on an estate's own chain and kept in its principals' vaults. A verifier in another estate cannot read either. What the estate publishes is two Merkle roots over blinded commitments: the live-grant root (every grant currently live) and the membership root (every countersigned relationship credential). They are anchored on public ground with a monotonic sequence, signed by the estate's governance.

A holder presents one leaf with its opening and a proof. A verifier in another estate checks it against the roots it reads from the anchor and learns exactly one thing: this subject holds a live grant, or is a member, in that estate as of that sequence. It learns nothing else — not the terms, not the counterparty, not any other leaf.

import { buildProjection, makeAuthorityPresentation, verifyAuthorityPresentation } from '@agenticprimitives/estate-projection';

const projection = buildProjection({ chainId: 34348, governance, sequence: 7, liveGrants, memberships });
// … the estate signs projectionDigest(projection) and anchors the roots on public ground …
const pres = makeAuthorityPresentation(projection, 'membership', credentialDigest, { nonce, audience });
const verdict = verifyAuthorityPresentation(pres, rootsReadFromTheRegistry, { subject, nonce, audience, now, maxAgeSeconds: 3600 });

The issuer row

A credential issuer anchors one more root on the same registry: its live-credential set, the credentials it still stands behind. The leaf is credentialDigestOf(jwt) — keccak over the issuer-signed compact JWT — under a per-leaf blind; the row id is estateIdOf(chainId, issuerSA) and the row is tagged ISSUER_ROW_TAG, so a verifier tells it from an estate's. Revoking a credential is retiring its leaf: the next root is anchored without it, and every status presentation built at an older sequence is stale against the chain. No chain is asked about a credential's liveness; the issuer's own ledger decides it.

import { buildIssuerProjection, credentialDigestOf, makeCredentialStatusPresentation, verifyCredentialStatusPresentation } from '@agenticprimitives/estate-projection';

const row = buildIssuerProjection({ chainId, issuer, sequence, liveCredentials }); // anchored by the issuer's projector
const status = makeCredentialStatusPresentation(row, credentialDigestOf(jwt), { nonce, audience });
const verdict = verifyCredentialStatusPresentation(status, issuerRootsReadFromTheRegistry, { nonce, audience, now, maxAgeSeconds });

A status presentation names no subject. It is linkable to the credential's leaf, which is why a verifier asks for it only where the alternative is phoning a status list.

Evidence, never authority: whether the receiving estate lets the agent act is its own mandate, verified per step. An inclusion proof over the live set, deliberately — a revocation is a removal and a new root.

版本与发布记录

@agenticprimitives/estate-projection 共发布 22 个版本,首次发布于 2026/09/21;过去 12 个月发布了 22 个版本。

版本发布日期距今
0.0.0-alpha.21latest2026/10/2612 天前
0.0.0-alpha.202026/10/2612 天前
0.0.0-alpha.192026/10/1721 天前
0.0.0-alpha.182026/10/1722 天前
0.0.0-alpha.172026/10/1622 天前
0.0.0-alpha.162026/10/1622 天前

关于 @agenticprimitives/estate-projection 的常见问题

@agenticprimitives/estate-projection 是什么?

An estate's public projection of its authority (spec 410 §4): the live-grant root and the membership root over blinded commitments, anchored on public ground; the authority presentation a verifier in another estate checks against them, learning that a gra

如何安装 @agenticprimitives/estate-projection?

在项目目录运行 npm install @agenticprimitives/estate-projection,或使用 pnpm add / yarn add / bun add。

@agenticprimitives/estate-projection 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agenticprimitives/estate-projection 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agenticprimitives/estate-projection 可以商用吗?

@agenticprimitives/estate-projection 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agenticprimitives/estate-projection 的下载量有多少?

根据 npm 官方下载统计,@agenticprimitives/estate-projection 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,049 次,日均约 135 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agenticprimitives/estate-projection 还在维护吗?

最新版本 0.0.0-alpha.21 发布于 2026/10/26(12 天前);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/09/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。