Skip to content

feat: add Bolyra action provider for ZKP agent identity#1351

Open
saneGuy wants to merge 1 commit into
coinbase:mainfrom
saneGuy:feat/bolyra-action-provider
Open

feat: add Bolyra action provider for ZKP agent identity#1351
saneGuy wants to merge 1 commit into
coinbase:mainfrom
saneGuy:feat/bolyra-action-provider

Conversation

@saneGuy

@saneGuy saneGuy commented Jun 30, 2026

Copy link
Copy Markdown

Summary

Adds bolyraActionProvider with two actions for ZKP-based agent identity verification:

  • create_identity_proof — Generate a credential proving this agent's identity and permissions using zero-knowledge proofs
  • verify_identity_proof — Verify another agent's proof envelope and optionally check required permissions

Complements the ERC-8004 provider: ERC-8004 handles on-chain registry identity, Bolyra handles off-chain ZKP portable identity with privacy-preserving proofs. Network-agnostic (off-chain ZKP).

Files added:

  • typescript/agentkit/src/action-providers/bolyra/bolyraActionProvider.ts — provider class
  • typescript/agentkit/src/action-providers/bolyra/schemas.ts — Zod input schemas
  • typescript/agentkit/src/action-providers/bolyra/bolyraActionProvider.test.ts — unit tests
  • typescript/agentkit/src/action-providers/bolyra/index.ts — re-exports
  • typescript/agentkit/src/action-providers/bolyra/README.md — documentation

Uses @bolyra/sdk as a lazy-loaded optional peer dependency.

WISHLIST.md alignment

Addresses aspects of:

  • "Interact with smart wallet/spend permissions" — permission-scoped credentials
  • "Claude MCP support" — Bolyra's MCP packages complement this provider
  • "Integrate with commerce rails for agent payments" — identity verification before payment

Test plan

  • Constructor throws when operatorSecret is missing
  • Accepts bigint and hex string secrets
  • create_identity_proof generates valid proof with permissions
  • create_identity_proof rejects invalid permission strings
  • verify_identity_proof passes for valid proofs
  • verify_identity_proof fails for invalid proofs
  • verify_identity_proof checks required permissions and reports missing ones
  • Error message when @bolyra/sdk is not installed
  • supportsNetwork returns true for all networks

Links

@saneGuy saneGuy requested a review from murrlincoln as a code owner June 30, 2026 02:10
@cb-heimdall

cb-heimdall commented Jun 30, 2026

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jun 30, 2026
Adds bolyraActionProvider with two actions for ZKP-based agent
identity verification:

- create_identity_proof: generate a credential proving this agent's
  identity and permissions using zero-knowledge proofs
- verify_identity_proof: verify another agent's proof envelope and
  optionally check required permissions

Complements ERC-8004: ERC-8004 handles on-chain registry identity,
Bolyra handles off-chain ZKP portable identity with privacy-preserving
proofs. Network-agnostic (off-chain ZKP).

Uses @bolyra/sdk as a lazy-loaded optional peer dependency.

Signed-off-by: Viswanadha Pratap Kondoju <kondojuviswanadha@gmail.com>
@saneGuy saneGuy force-pushed the feat/bolyra-action-provider branch from 5912d31 to 2fe9016 Compare June 30, 2026 02:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants