sdk

Name: sdk
Author: bolyra

本地服务

github.com/bolyra安全04 天前更新

代码仓库

关于 sdk

@bolyra/sdk 是用于在人类与 AI Agent 之间实现零知识证明双向认证的 TypeScript SDK，提供身份与凭证创建、握手和委托验证，以及底层密码学原语。

主要功能

01创建人类身份和 Agent 凭证
02生成并验证认证握手
03委托并验证权限
04编码和校验权限位掩码
05Poseidon 哈希与 BabyJubjub EdDSA 原语

适用场景

01为人类与 AI Agent 构建双向认证
02创建并检查委托的 Agent 凭证
03使用导出的原语构建外部验证器

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "bolyra-sdk": {
      "command": "npx",
      "args": [
        "-y",
        "@bolyra/sdk"
      ]
    }
  }
}

启动命令npx -y @bolyra/sdk

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

安装包

npm@bolyra/sdk0.5.2stdio

工具

还没有获取到工具列表

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

详细介绍

@bolyra/sdk

面向 Bolyra 的 TypeScript SDK——为人类和 AI Agent 提供相互 ZKP 身份验证。

刚开始使用？ 从5 分钟快速入门开始——从 npm install 到链上验证。

安装

npm install @bolyra/sdk

快速开始

import {
  createHumanIdentity,
  createAgentCredential,
  Permission,
  proveHandshake,
  verifyHandshake,
} from '@bolyra/sdk';

// 1. Create identities
const human = await createHumanIdentity(123456789n);
const agent = await createAgentCredential(
  12345n,
  operatorPrivateKey,
  [Permission.READ_DATA, Permission.WRITE_DATA],
  BigInt(Math.floor(Date.now() / 1000) + 86400),
);

// 2. Generate mutual handshake proofs (parallel, ~16s)
const { humanProof, agentProof, nonce } = await proveHandshake(human, agent);

// 3. Verify locally
const result = await verifyHandshake(humanProof, agentProof, nonce);
console.log('Verified:', result.verified); // true
console.log('Human nullifier:', result.humanNullifier);
console.log('Agent scope commitment:', result.scopeCommitment);

// 4. Submit to chain (via ethers.js)
// await registry.verifyHandshake(humanProof, agentProof, nonce);

底层原语（v0.6.0+）

用于高级场景，例如构建外部验证器或重新计算凭证／范围承诺时，SDK 会导出 Poseidon 哈希和 BabyJubjub EdDSA 原语：

import { poseidon5, eddsaSign, eddsaVerify, derivePublicKey } from '@bolyra/sdk';

const pub = await derivePublicKey(operatorPrivateKey);   // { x, y }
const sig = await eddsaSign(operatorPrivateKey, message); // { R8: { x, y }, S }
const ok  = await eddsaVerify(pub, message, sig);         // boolean
const h   = await poseidon5(a, b, c, d, e);               // bigint

eddsaVerify 在输入格式错误时会返回 false（不会抛出异常）。完整的外部验证器参考示例请参阅 @bolyra/cli 中的 bolyra verify。

权限

权限采用累积位编码——更高级别的权限包含较低级别的权限：

位	权限	说明
0	`READ_DATA`
1	`WRITE_DATA`
2	`FINANCIAL_SMALL`	< $100
3	`FINANCIAL_MEDIUM`	< $10,000（包含位 2）
4	`FINANCIAL_UNLIMITED`	无限（包含位 2 和 3）
5	`SIGN_ON_BEHALF`
6	`SUB_DELEGATE`
7	`ACCESS_PII`

API 状态

函数	状态
`createHumanIdentity()`	v0.1
`createAgentCredential()`	v0.1
`permissionsToBitmask()`	v0.1
`validateCumulativeBitEncoding()`	v0.1
`proveHandshake()`	v0.2
`verifyHandshake()`	v0.2
`delegate()`	v0.3
`verifyDelegation()`	v0.3