@kuberna/aip-adapter

Bridge between AIP (Agent Identity Protocol) and ERC-8004 on-chain agent identity registry.

Installation

npm install @kuberna/aip-adapter

Usage

import { AipAdapter } from '@kuberna/aip-adapter';
import { ethers } from 'ethers';

const adapter = new AipAdapter();

// Create an AIP identity
const identity = await adapter.createIdentity('My Agent');

// Register the identity on-chain via ERC-8004
const provider = new ethers.JsonRpcProvider('https://sepolia.base.org');
const signer = new ethers.Wallet('0x...', provider);
const registration = await adapter.registerOnChain(identity, signer);

// Create an AIP identity document linked to the on-chain record
const doc = await adapter.createIdentityDocumentWithChainLink(
  identity,
  registration.tokenId,
  84532
);

// Create and verify AIP compact tokens
const token = await adapter.createCompactToken(identity, {
  issuer: identity.identifier,
  subject: identity.identifier,
  scopes: ['tool:search', 'tool:browse'],
});
const verified = await adapter.verifyCompactToken(token, publicKeyBytes);

// Verify an AIP token against on-chain reputation
const chainVerification = await adapter.verifyTokenWithChain(
  token,
  registration.tokenId,
  provider
);

API

AipAdapter

| Method | Description | |--------|-------------| | createIdentity(name?) | Generate a new Ed25519 keypair and AIP identity | | createIdentityDocument(identity, options?) | Create a signed AIP identity document | | createIdentityDocumentWithChainLink(identity, tokenId, chainId, options?) | Create identity doc with ERC-8004 extension | | registerOnChain(identity, signer, options?) | Register agent on ERC-8004 contract | | resolveOnChain(tokenId, provider) | Resolve on-chain registration to identity info | | updateMetadataURI(tokenId, uri, signer) | Update on-chain metadata URI | | createCompactToken(identity, claims) | Create a signed AIP compact token (JWT) | | verifyCompactToken(token, publicKey) | Verify an AIP token's Ed25519 signature | | decodeToken(token) | Decode token without verifying signature | | hasScope(token, scope) | Check if token grants a specific scope | | verifyTokenWithChain(token, tokenId, provider) | Verify token + check on-chain reputation | | getReputation(tokenId, provider) | Query on-chain reputation (score, badges, rating) | | resolveIdentifier(identifier) | Resolve an AIP identifier to an identity document | | clearCache() | Clear the identity resolver cache |

License

MIT