@ agenticprimitives/ 地理地物
部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包
代理人运作的地方是最敏感的事实之一——大多数地理登记处默认公布. 协调需要共享每个人可以参考的地理环境;安全需要代理人-地点协会保持保密。 此套件拆分两个: a 地理特征 是一个公开的,版本的,在链上锁定 GeoFeatureRegistry (几何散列物+覆盖/来源根+粗细的bbox;准确的GeoJSON不连锁);a 地质索赔 ——智能特工与特写的关系——是 私人可核查的证书 在那个特工的金库,指向链上 (featureId, version)协会从来不是连锁的——它会泄露业务数据.
由于主体和发行商是智能代理地址,验证人通过签署 endorsementDigest 具有自己的链上身份(ERC-1271-可验证),该主张在主体的关键旋转中幸存下来,而选择进入的公开主张则重新使用通用 attestations 证书-hash路径——绝不是地理特有契约.
部分 代理原始产品 ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.
今天的什么战舰
这个SDK拥有证书形状(GeoClaimCredential),自负/自负的建设者,承诺/最深的数学,以及一薄的链上功能读取器(第251类:
- 构建器 —— 说
buildSelfGeoClaim财务报告和审定财务报表buildEndorsedGeoClaim(交叉发行;返回endorsementDigest发行者标志. - 代码列表 —— 说
GEO_KIND(与GeoFeatureRegistry.KIND_*在链上, ADR-0009 (英语), (中文(简体) ),GEO_RELATION, (中文(简体) ),GeoVisibility全都是凯查克的杂草ns/geo#C-box概念URIs. - 数学 —— 说
computeFeatureId, (中文(简体) ),geometryHash, (中文(简体) ),geoClaimId, (中文(简体) ),geoEndorsementDigest, (中文(简体) ),geoClaimHash。 。 。 . - 特性读取器 —— 说
geoFeatureExists(read, registry, ref)通过注射readContract函数(无viem/合同依赖)+GEO_FEATURE_READ_ABI。 。 。 .
import { buildEndorsedGeoClaim, GEO_RELATION, geoFeatureExists } from '@agenticprimitives/geo-features';
const { credential, endorsementDigest } = buildEndorsedGeoClaim({
chainId: 84532,
subject: orgAgent,
issuer: validator,
feature: { featureId, version: 1 }, // points to the on-chain GeoFeatureRegistry
relation: GEO_RELATION.servesWithin,
visibility: 'public-coarse',
nonce,
});
// the issuer signs `endorsementDigest` (ERC-1271); the app stores `credential` in the subject's vault.
Vault I/O是应用程序的工作——这个包是可忽略的。 精确的几何学不连锁(SDK只处理它的 geometryHash(三); evidenceCommit 是一个字节32的承诺,从来没有URI.
怎么不一样
开放边界数据集和地理空间登记处回答"存在的地方";它们没有"哪个代理人可以核查地运行,按照代理人的术语披露"的模式. 这里的三角洲:
- 只有中立的公共地理. 一个特点是一个通用的公共场所——它从未被操作或敏感性数据所标记. 灵敏度(英語:Sensitive)是一款以中性特征为上层的脱链应用政策(Spec 251 GFR-07).
- 占有是私人的默认. 代理商声称在代理商的金库里是一家签名的VC;能见度级(
public-coarse, (中文(简体) ),private-commitment, (中文(简体) ),private-zk,.)让持有者选择披露颗粒. - 锁定,CI检查.
GEO_KIND.Region === GeoFeatureRegistry.KIND_REGION——代码列表被绑定在合同常数上,因此SDK不能从链中漂出.
技能是独立的兄弟 @agenticprimitives/capability-claims ——没有技能QQGeo映射;"技能X在Y区"的事实是两个独立的主张. 中性底物: 无垂直词汇 (ADR-0021 (英语)) (中文(简体) ).
状态
W1地基——Spec-251技能/地基的离链地层被运出. 链上对等点是 GeoFeatureRegistry.sol 内 packages/contracts。见 审计。 。 。 .
测试网/飞行员准备 生产启动在基础README的公开核对表上进行——包括第三方合同审计和治理关键轮换。 追踪所有安全发现
docs/audits/findings.yaml。 。 。 .
权威规格 : specs/251-skills-and-geo-features.md. 地壳: CLAUDE.md + 键 capability.manifest.json。 。 。 .
构建
pnpm --filter @agenticprimitives/geo-features typecheck
pnpm --filter @agenticprimitives/geo-features test
pnpm --filter @agenticprimitives/geo-features build