Getting Started

npm install @credat/sdk

import { createAgent, delegate, verifyDelegation } from "@credat/sdk";
 
// 1. Create an agent identity on your domain
const agent = await createAgent({
  domain: "acme.com",
  algorithm: "ES256",
});
 
console.log(agent.did);
// "did:web:acme.com"
 
// 2. Delegate permissions (in real usage, ownerKeyPair comes from your key management)
const ownerKeyPair = await generateOwnerKeys(); // see below
 
const delegation = await delegate({
  agent: agent.did,
  owner: "did:web:acme.com",
  ownerKeyPair: ownerKeyPair,
  scopes: ["files:read", "files:write"],
  validUntil: "2026-12-31T23:59:59Z",
});
 
// 3. Verify the delegation
const result = await verifyDelegation(delegation.token, {
  ownerPublicKey: ownerKeyPair.publicKey,
});
 
console.log(result.valid);   // true
console.log(result.scopes);  // ["files:read", "files:write"]
console.log(result.agent);   // "did:web:acme.com"
console.log(result.owner);   // "did:web:acme.com"

import { generateKeyPair } from "@credat/sdk";
 
const ownerKeyPair = generateKeyPair("ES256");
// { algorithm: "ES256", publicKey: Uint8Array, privateKey: Uint8Array }