Sdk

io.github.bolyra由 GitHub 帳號 bolyra 發布v0.5.2更新於 Oct 24, 2026

TypeScript SDK for mutual ZKP authentication between humans and AI agents.

已驗證STDIO僅桌面開發者工具安全與監控

概覽

AI 產生的概覽

面向 Bolyra 的本機 TypeScript SDK，為助理提供人類與 AI 代理之間雙向零知識證明驗證的建構元件。

可以做什麼
建立人類身分與帶權限位元遮罩的代理憑證，並提供委派與驗證輔助函式；產生人類與代理之間的雙向握手證明，在本機驗證並讀取產生的 nullifier 與範圍承諾。使用底層 Poseidon 雜湊與 BabyJubjub EdDSA 簽章、驗證及公鑰推導，供自訂驗證器或重新計算承諾使用。透過 ethers.js 將證明提交至鏈上註冊表。
適用情境
適合在建置或測試以 Bolyra 為基礎的代理授權流程時使用，讓助理以 TypeScript 建立身分建立、權限編碼、握手證明與驗證，或外部驗證器邏輯。
執行需求
以本機 stdio 程序在桌面執行，從 npm 套件 @bolyra/sdk 安裝，需要 Node.js 與 npm。未宣告驗證、環境變數或標頭。鏈上驗證需要 ethers.js 與註冊表合約，握手證明據說明約需 16 秒。
安裝前請注意
此 SDK 涉及私鑰：代理憑證由操作者私鑰建立，README 範例直接傳入該私鑰。權限層級包含最高無上限的財務支出額度，以及代表簽章與再委派權限，位元遮罩設定錯誤會授予過大權限。將證明提交至鏈上會寫入資料，並可能產生 gas 費用。清單未列出任何工具，安裝前應確認伺服器實際提供的能力。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Sdk，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@bolyra/sdk

TypeScript SDK for Bolyra — mutual ZKP authentication for humans and AI agents.

New here? Start with the 5-minute Quickstart — from npm install to on-chain verification.

Install

bash
npm install @bolyra/sdk

Quick Start

typescript
import {  createHumanIdentity,  createAgentCredential,  Permission,  proveHandshake,  verifyHandshake,} from '@bolyra/sdk';
// 1. Create identitiesconst 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 locallyconst result = await verifyHandshake(humanProof, agentProof, nonce);console.log('Verified:', result.verified); // trueconsole.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);

Low-level primitives (v0.6.0+)

For advanced use — e.g. building an external verifier or recomputing credential/scope commitments — the SDK exports its Poseidon hashes and BabyJubjub EdDSA primitives:

typescript
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);         // booleanconst h   = await poseidon5(a, b, c, d, e);               // bigint

eddsaVerify returns false (never throws) on malformed input. See @bolyra/cli's bolyra verify for a full external-verifier reference.

Permissions

Permissions use cumulative bit encoding — higher tiers imply lower ones:

BitPermissionNotes
0READ_DATA
1WRITE_DATA
2FINANCIAL_SMALL< $100
3FINANCIAL_MEDIUM< $10,000 (implies bit 2)
4FINANCIAL_UNLIMITEDUnlimited (implies 2+3)
5SIGN_ON_BEHALF
6SUB_DELEGATE
7ACCESS_PII

API Status

FunctionStatus
createHumanIdentity()v0.1
createAgentCredential()v0.1
permissionsToBitmask()v0.1
validateCumulativeBitEncoding()v0.1
proveHandshake()v0.2
verifyHandshake()v0.2
delegate()v0.3
verifyDelegation()v0.3

License

Apache-2.0 — see LICENSE.

來源：sdk/README.md，提交 5e9de85

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.5.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分