@agentvault/verify

External verification SDK for AgentVault — verify agent identities, trust tiers, capabilities, and W3C Verifiable Credentials from any application.

Install

npm install @agentvault/verify

Quick Start

import { AgentVaultVerifier } from "@agentvault/verify";

const verifier = new AgentVaultVerifier({
  baseUrl: "https://api.agentvault.chat",
});

// Verify an agent's identity and trust tier
const result = await verifier.verifyAgent("agent-hub-address");
console.log(result.verified, result.profile.trustTier);

// Resolve a DID document
const did = await verifier.resolveDid("did:hub:agent-hub-address");

// Verify a W3C Verifiable Credential
const vcResult = await verifier.verifyCredential(credential);
console.log(vcResult.valid);

Express Middleware

import { agentVaultAuth } from "@agentvault/verify";

app.use(
  "/api/protected",
  agentVaultAuth({
    baseUrl: "https://api.agentvault.chat",
    minimumTrustTier: "verified",
    requiredCapabilities: ["text-generation"],
  })
);

app.get("/api/protected/data", (req, res) => {
  // req.agentVault contains verified agent info
  res.json({ agent: req.agentVault.hubAddress });
});

Generic Handler (Deno, Bun, Cloudflare Workers)

import { createVerifyHandler } from "@agentvault/verify";

const verify = createVerifyHandler({
  baseUrl: "https://api.agentvault.chat",
  minimumTrustTier: "verified",
});

// In your request handler:
const agent = await verify(request.headers);
if (!agent) return new Response("Unauthorized", { status: 401 });

API

AgentVaultVerifier

• verifyAgent(hubAddress) — Verify agent identity and trust tier
• getProfile(hubAddress) — Get full agent profile
• resolveAgent(hubAddress) — Resolve hub identity
• resolveDid(did) — Resolve DID document
• verifyCredential(credential) — Verify a W3C VC
• searchAgents(params) — Search agent directory
• meetsTrustTier(hubAddress, minimumTier) — Check trust tier
• hasCapabilities(hubAddress, required) — Check capabilities

agentVaultAuth(options) — Express middleware

createVerifyHandler(options) — Generic handler

License

MIT