a2a-did 0.1.0

package/dist/did/resolver.js

@@ -0,0 +1,120 @@
+/**
+ * DID Resolver
+ * Combines modular resolvers for different DID methods
+ * @module did/resolver
+ */
+import { Resolver } from 'did-resolver';
+import { createWebResolver } from './resolvers/web.js';
+import { createEthrResolver } from './resolvers/ethr.js';
+// Singleton resolver instance (lazy initialized)
+let defaultResolver = null;
+let defaultConfig = null;
+/**
+ * Create a new DID resolver with specified configuration
+ * @param config - Resolver configuration
+ * @returns Configured Resolver instance
+ *
+ * @example
+ * // did:web only (no external dependencies)
+ * const resolver = createResolver({ web: true });
+ *
+ * @example
+ * // did:web + did:ethr
+ * const resolver = createResolver({
+ *   web: true,
+ *   ethr: {
+ *     networks: [{
+ *       name: 'sepolia',
+ *       rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
+ *     }]
+ *   }
+ * });
+ */
+export function createResolver(config = {}) {
+    const resolvers = {};
+    // did:web (enabled by default)
+    if (config.web !== false) {
+        Object.assign(resolvers, createWebResolver());
+    }
+    // did:ethr (requires explicit configuration)
+    if (config.ethr) {
+        Object.assign(resolvers, createEthrResolver(config.ethr));
+    }
+    // Future DID methods can be added here following the same pattern
+    return new Resolver(resolvers);
+}
+/**
+ * Configure the default resolver
+ * Call this at application startup to set up DID resolution
+ *
+ * IMPORTANT: If you use did:ethr, you MUST call this function before resolving did:ethr DIDs.
+ * Otherwise, did:ethr resolution will fail.
+ *
+ * @param config - Resolver configuration
+ *
+ * @example
+ * // In your app initialization (required for did:ethr)
+ * configureResolver({
+ *   web: true,
+ *   ethr: {
+ *     networks: [{ name: 'sepolia', rpcUrl: process.env.SEPOLIA_RPC_URL }]
+ *   }
+ * });
+ */
+export function configureResolver(config) {
+    defaultConfig = config;
+    defaultResolver = createResolver(config);
+}
+/**
+ * Get the default resolver instance
+ * If not configured, creates a did:web-only resolver
+ * @returns The default Resolver instance
+ */
+export function getResolver() {
+    if (!defaultResolver) {
+        // Default: did:web only (no external dependencies)
+        defaultResolver = createResolver({ web: true });
+        defaultConfig = { web: true };
+    }
+    return defaultResolver;
+}
+/**
+ * Get the current resolver configuration
+ * @returns Current configuration or null if using defaults
+ */
+export function getResolverConfig() {
+    return defaultConfig;
+}
+/**
+ * Check if a specific DID method is enabled
+ * @param method - DID method to check (e.g., 'web', 'ethr')
+ * @returns true if the method is enabled in the current configuration
+ */
+export function isMethodEnabled(method) {
+    const config = defaultConfig ?? { web: true };
+    switch (method) {
+        case 'web':
+            return config.web !== false;
+        case 'ethr':
+            return !!config.ethr;
+        default:
+            return false;
+    }
+}
+/**
+ * Resolve a DID to its document
+ * @param did - The DID to resolve
+ * @returns The DID Document if found, null otherwise
+ */
+export async function resolveDID(did) {
+    const resolver = getResolver();
+    const result = await resolver.resolve(did);
+    if (result.didResolutionMetadata.error) {
+        return null;
+    }
+    return result.didDocument;
+}
+// Re-export resolver types and utilities
+export { createWebResolver } from './resolvers/web.js';
+export { createEthrResolver, createSepoliaResolver, KNOWN_NETWORKS, } from './resolvers/ethr.js';
+//# sourceMappingURL=resolver.js.map

package/dist/did/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/did/resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAoB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAA2B,MAAM,qBAAqB,CAAC;AAkBlF,iDAAiD;AACjD,IAAI,eAAe,GAAoB,IAAI,CAAC;AAC5C,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,SAAyB,EAAE;IACxD,MAAM,SAAS,GAAgC,EAAE,CAAC;IAElD,+BAA+B;IAC/B,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,6CAA6C;IAC7C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,kEAAkE;IAElE,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,aAAa,GAAG,MAAM,CAAC;IACvB,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,mDAAmD;QACnD,eAAe,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,aAAa,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,MAAM,MAAM,GAAG,aAAa,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAC9C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QACvB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,WAAqC,CAAC;AACtD,CAAC;AAED,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GAIf,MAAM,qBAAqB,CAAC"}

package/dist/did/resolvers/ethr.d.ts

@@ -0,0 +1,74 @@
+/**
+ * did:ethr Resolver
+ * Resolves did:ethr DIDs from Ethereum chains via RPC
+ * @module did/resolvers/ethr
+ */
+import { type DIDResolver } from 'did-resolver';
+/**
+ * Known Ethereum networks with their default configurations
+ */
+export declare const KNOWN_NETWORKS: {
+    readonly mainnet: {
+        readonly chainId: 1;
+        readonly registry: "0xdca7ef03e98e0dc2b855be647c39abe984fcf21b";
+    };
+    readonly sepolia: {
+        readonly chainId: 11155111;
+        readonly registry: "0x03d5003bf0e79c5f5223588f347eba39afbc3818";
+    };
+    readonly goerli: {
+        readonly chainId: 5;
+        readonly registry: "0xdca7ef03e98e0dc2b855be647c39abe984fcf21b";
+    };
+};
+export type KnownNetwork = keyof typeof KNOWN_NETWORKS;
+/**
+ * Configuration for a single Ethereum network
+ */
+export interface EthrNetworkConfig {
+    /** Network name (e.g., 'mainnet', 'sepolia') */
+    name: string;
+    /** RPC URL for the network */
+    rpcUrl: string;
+    /** Chain ID (optional if using known network) */
+    chainId?: number;
+    /** EthereumDIDRegistry contract address (optional if using known network) */
+    registry?: string;
+}
+/**
+ * Configuration for did:ethr resolver
+ */
+export interface EthrResolverConfig {
+    /** Network configurations */
+    networks: EthrNetworkConfig[];
+}
+/**
+ * Create did:ethr resolver with explicit configuration
+ * @param config - Network configuration(s)
+ * @returns DID resolver methods for did:ethr
+ *
+ * @example
+ * // Single network
+ * createEthrResolver({
+ *   networks: [{
+ *     name: 'sepolia',
+ *     rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
+ *   }]
+ * });
+ *
+ * @example
+ * // Multiple networks
+ * createEthrResolver({
+ *   networks: [
+ *     { name: 'mainnet', rpcUrl: 'https://mainnet.infura.io/v3/KEY' },
+ *     { name: 'sepolia', rpcUrl: 'https://sepolia.infura.io/v3/KEY' },
+ *   ]
+ * });
+ */
+export declare function createEthrResolver(config: EthrResolverConfig): Record<string, DIDResolver>;
+/**
+ * Convenience function to create resolver for Sepolia testnet
+ * @param rpcUrl - Sepolia RPC URL
+ */
+export declare function createSepoliaResolver(rpcUrl: string): Record<string, DIDResolver>;
+//# sourceMappingURL=ethr.d.ts.map

package/dist/did/resolvers/ethr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethr.d.ts","sourceRoot":"","sources":["../../../src/did/resolvers/ethr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAc1F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAOjF"}

package/dist/did/resolvers/ethr.js

@@ -0,0 +1,67 @@
+import { getResolver as getEthrResolver } from 'ethr-did-resolver';
+/**
+ * Known Ethereum networks with their default configurations
+ */
+export const KNOWN_NETWORKS = {
+    mainnet: {
+        chainId: 1,
+        registry: '0xdca7ef03e98e0dc2b855be647c39abe984fcf21b',
+    },
+    sepolia: {
+        chainId: 11155111,
+        registry: '0x03d5003bf0e79c5f5223588f347eba39afbc3818',
+    },
+    goerli: {
+        chainId: 5,
+        registry: '0xdca7ef03e98e0dc2b855be647c39abe984fcf21b',
+    },
+};
+/**
+ * Create did:ethr resolver with explicit configuration
+ * @param config - Network configuration(s)
+ * @returns DID resolver methods for did:ethr
+ *
+ * @example
+ * // Single network
+ * createEthrResolver({
+ *   networks: [{
+ *     name: 'sepolia',
+ *     rpcUrl: 'https://sepolia.infura.io/v3/YOUR_KEY',
+ *   }]
+ * });
+ *
+ * @example
+ * // Multiple networks
+ * createEthrResolver({
+ *   networks: [
+ *     { name: 'mainnet', rpcUrl: 'https://mainnet.infura.io/v3/KEY' },
+ *     { name: 'sepolia', rpcUrl: 'https://sepolia.infura.io/v3/KEY' },
+ *   ]
+ * });
+ */
+export function createEthrResolver(config) {
+    const networks = config.networks.map((network) => {
+        // Use known network defaults if available
+        const known = KNOWN_NETWORKS[network.name];
+        return {
+            name: network.name,
+            rpcUrl: network.rpcUrl,
+            chainId: network.chainId ?? known?.chainId,
+            registry: network.registry ?? known?.registry,
+        };
+    });
+    return getEthrResolver({ networks });
+}
+/**
+ * Convenience function to create resolver for Sepolia testnet
+ * @param rpcUrl - Sepolia RPC URL
+ */
+export function createSepoliaResolver(rpcUrl) {
+    return createEthrResolver({
+        networks: [{
+                name: 'sepolia',
+                rpcUrl,
+            }],
+    });
+}
+//# sourceMappingURL=ethr.js.map

package/dist/did/resolvers/ethr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethr.js","sourceRoot":"","sources":["../../../src/did/resolvers/ethr.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,4CAA4C;KACvD;IACD,OAAO,EAAE;QACP,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,4CAA4C;KACvD;IACD,MAAM,EAAE;QACN,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,4CAA4C;KACvD;CACO,CAAC;AA0BX;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/C,0CAA0C;QAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,IAAoB,CAAC,CAAC;QAE3D,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,EAAE,OAAO;YAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK,EAAE,QAAQ;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,kBAAkB,CAAC;QACxB,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,SAAS;gBACf,MAAM;aACP,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/did/resolvers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DID Resolvers
+ * Modular resolvers for different DID methods
+ * @module did/resolvers
+ */
+export { createWebResolver } from './web.js';
+export { createEthrResolver, createSepoliaResolver, KNOWN_NETWORKS, type EthrNetworkConfig, type EthrResolverConfig, type KnownNetwork, } from './ethr.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/did/resolvers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/did/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC"}

package/dist/did/resolvers/index.js

@@ -0,0 +1,8 @@
+/**
+ * DID Resolvers
+ * Modular resolvers for different DID methods
+ * @module did/resolvers
+ */
+export { createWebResolver } from './web.js';
+export { createEthrResolver, createSepoliaResolver, KNOWN_NETWORKS, } from './ethr.js';
+//# sourceMappingURL=index.js.map

package/dist/did/resolvers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/did/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GAIf,MAAM,WAAW,CAAC"}

package/dist/did/resolvers/web.d.ts

@@ -0,0 +1,13 @@
+/**
+ * did:web Resolver
+ * Supports HTTP for localhost, HTTPS for production domains
+ * @module did/resolvers/web
+ */
+import { type DIDResolver } from 'did-resolver';
+/**
+ * Create did:web resolver
+ * - localhost: Uses HTTP
+ * - Production domains: Uses HTTPS via web-did-resolver
+ */
+export declare function createWebResolver(): Record<string, DIDResolver>;
+//# sourceMappingURL=web.d.ts.map

package/dist/did/resolvers/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/did/resolvers/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAY,KAAK,WAAW,EAA4C,MAAM,cAAc,CAAC;AAIpG;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAyC/D"}

package/dist/did/resolvers/web.js

@@ -0,0 +1,97 @@
+import { getResolver as getWebResolver } from 'web-did-resolver';
+/**
+ * Create did:web resolver
+ * - localhost: Uses HTTP
+ * - Production domains: Uses HTTPS via web-did-resolver
+ */
+export function createWebResolver() {
+    const webResolver = getWebResolver();
+    async function resolve(did, parsed) {
+        // Decode domain from DID (e.g., localhost%3A3001 → localhost:3001)
+        const domainPart = parsed.id.split(':')[0];
+        if (!domainPart) {
+            return {
+                didDocument: null,
+                didDocumentMetadata: {},
+                didResolutionMetadata: {
+                    error: 'invalidDid',
+                    message: 'Invalid DID format',
+                },
+            };
+        }
+        const domain = decodeURIComponent(domainPart);
+        // For localhost, use HTTP and custom resolution
+        if (domain.startsWith('localhost')) {
+            return resolveLocalhost(did, parsed);
+        }
+        // For production domains, delegate to web-did-resolver (uses HTTPS)
+        const webResolverFn = webResolver.web;
+        if (!webResolverFn) {
+            return {
+                didDocument: null,
+                didDocumentMetadata: {},
+                didResolutionMetadata: {
+                    error: 'internalError',
+                    message: 'Web resolver not available',
+                },
+            };
+        }
+        return webResolverFn(did, parsed, {}, {});
+    }
+    return { web: resolve };
+}
+/**
+ * Resolve localhost did:web DIDs using HTTP
+ */
+async function resolveLocalhost(did, parsed) {
+    // Build path: did:web:localhost%3A3001:agents:agent-a → localhost:3001/agents/agent-a/did.json
+    const pathSegments = parsed.id.split(':').map(decodeURIComponent);
+    const domain = pathSegments[0];
+    const path = pathSegments.length > 1
+        ? `${pathSegments.slice(1).join('/')}/did.json`
+        : '.well-known/did.json';
+    const url = `http://${domain}/${path}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            return {
+                didDocument: null,
+                didDocumentMetadata: {},
+                didResolutionMetadata: {
+                    error: 'notFound',
+                    message: `HTTP ${response.status}: ${response.statusText}`,
+                },
+            };
+        }
+        const didDocument = await response.json();
+        // Verify document ID matches requested DID
+        if (didDocument.id !== did) {
+            return {
+                didDocument: didDocument,
+                didDocumentMetadata: {},
+                didResolutionMetadata: {
+                    error: 'notFound',
+                    message: 'DID document id does not match requested did',
+                },
+            };
+        }
+        return {
+            didDocument: didDocument,
+            didDocumentMetadata: {},
+            didResolutionMetadata: {
+                contentType: didDocument['@context'] ? 'application/did+ld+json' : 'application/did+json',
+            },
+        };
+    }
+    catch (error) {
+        return {
+            didDocument: null,
+            didDocumentMetadata: {},
+            didResolutionMetadata: {
+                error: 'notFound',
+                message: `Failed to fetch DID document: ${error}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/did/resolvers/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/did/resolvers/web.ts"],"names":[],"mappings":"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"}

package/dist/did/service-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent DID Service Loader
+ * Dynamically loads and registers DID method handlers
+ * @module did/service-loader
+ */
+import type { AgentDIDService } from './service.js';
+/**
+ * Register DID method handlers to an AgentDIDService instance
+ * Uses dynamic imports for lazy loading
+ *
+ * @param service - The AgentDIDService instance
+ * @param methods - Array of DID methods to register ('web', 'ethr')
+ */
+export declare function registerDIDHandlers(service: AgentDIDService, methods: Array<'web' | 'ethr'>): Promise<void>;
+//# sourceMappingURL=service-loader.d.ts.map

package/dist/did/service-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-loader.d.ts","sourceRoot":"","sources":["../../src/did/service-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/did/service-loader.js

@@ -0,0 +1,20 @@
+/**
+ * Register DID method handlers to an AgentDIDService instance
+ * Uses dynamic imports for lazy loading
+ *
+ * @param service - The AgentDIDService instance
+ * @param methods - Array of DID methods to register ('web', 'ethr')
+ */
+export async function registerDIDHandlers(service, methods) {
+    for (const method of methods) {
+        if (method === 'web') {
+            const { DIDWebMethodHandler } = await import('./handlers/web-handler.js');
+            service.registerMethod('web', new DIDWebMethodHandler());
+        }
+        else if (method === 'ethr') {
+            const { DIDEthrMethodHandler } = await import('./handlers/ethr-handler.js');
+            service.registerMethod('ethr', new DIDEthrMethodHandler());
+        }
+    }
+}
+//# sourceMappingURL=service-loader.js.map

package/dist/did/service-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-loader.js","sourceRoot":"","sources":["../../src/did/service-loader.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAwB,EACxB,OAA8B;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC1E,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YAC5E,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,oBAAoB,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/did/service.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Agent DID Service
+ * Orchestrates DID operations for AI Agents through pluggable method handlers
+ */
+import type { DIDIdentity, ServiceEndpoint } from './types.js';
+import type { DIDConfig } from './config-types.js';
+/**
+ * DID Method Handler Interface
+ * Each DID method (ethr, web, etc.) implements this interface
+ */
+export interface DIDMethodHandler {
+    /**
+     * Create a new DID identity
+     */
+    createIdentity(options: {
+        agentId: string;
+        config: DIDConfig;
+        services?: ServiceEndpoint[];
+    }): Promise<DIDIdentity>;
+    /**
+     * Register a service endpoint for the DID
+     * @param serviceEndpoint - Already uploaded URI (e.g., ipfs://...)
+     */
+    registerServiceEndpoint(options: {
+        did: string;
+        privateKey: string;
+        serviceEndpoint: string;
+        config: DIDConfig;
+    }): Promise<string[]>;
+    /**
+     * Extract wallet address from DID
+     * @param did - DID string (e.g., "did:ethr:sepolia:0x...")
+     * @returns Wallet address or undefined if not applicable
+     */
+    extractWalletAddress(did: string): string | undefined;
+    /**
+     * Get default key ID for DID
+     * @param did - DID string
+     * @returns Key identifier (e.g., "did:ethr:...#controller")
+     */
+    getKeyId(did: string): string;
+}
+/**
+ * Agent DID Service
+ * Provides a unified interface for DID operations across different methods for AI Agents
+ * Handlers must be explicitly registered using registerMethod()
+ */
+export declare class AgentDIDService {
+    private methods;
+    constructor();
+    /**
+     * Register a custom DID method handler
+     * Can be used to add new methods or override built-in ones
+     * @param name - DID method name (e.g., 'ethr', 'web', 'ion')
+     * @param handler - Method-specific implementation
+     */
+    registerMethod(name: string, handler: DIDMethodHandler): void;
+    /**
+     * Create a DID identity
+     * @throws {Error} If DID method is not supported
+     */
+    createIdentity(options: {
+        method: string;
+        agentId: string;
+        config: DIDConfig;
+        services?: ServiceEndpoint[];
+    }): Promise<DIDIdentity>;
+    /**
+     * Register a service endpoint for a DID
+     * @param serviceEndpoint - Already uploaded URI (e.g., ipfs://...)
+     * @throws {Error} If DID method is not supported
+     */
+    registerServiceEndpoint(options: {
+        method: string;
+        did: string;
+        privateKey: string;
+        serviceEndpoint: string;
+        config: DIDConfig;
+    }): Promise<string[]>;
+    /**
+     * Extract wallet address from DID
+     * Delegates to the appropriate handler based on DID method
+     * @param did - DID string
+     * @param method - DID method name
+     * @returns Wallet address or undefined
+     * @throws {Error} If DID method is not supported
+     */
+    extractWalletAddress(did: string, method: string): string | undefined;
+    /**
+     * Get default key ID for a DID
+     * Delegates to the appropriate handler based on DID method
+     * @param did - DID string
+     * @param method - DID method name
+     * @returns Key identifier
+     * @throws {Error} If DID method is not supported
+     */
+    getKeyId(did: string, method: string): string;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/did/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/did/service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,CAAC;QAClB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;KAC9B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzB;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,SAAS,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtB;;;;OAIG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgC;;IAO/C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI7D;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,CAAC;QAClB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;KAC9B,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxB;;;;OAIG;IACG,uBAAuB,CAAC,OAAO,EAAE;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,SAAS,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQrB;;;;;;;OAOG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQrE;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAO9C"}

package/dist/did/service.js

@@ -0,0 +1,75 @@
+/**
+ * Agent DID Service
+ * Provides a unified interface for DID operations across different methods for AI Agents
+ * Handlers must be explicitly registered using registerMethod()
+ */
+export class AgentDIDService {
+    methods;
+    constructor() {
+        // Empty initialization - handlers must be registered explicitly
+        this.methods = new Map();
+    }
+    /**
+     * Register a custom DID method handler
+     * Can be used to add new methods or override built-in ones
+     * @param name - DID method name (e.g., 'ethr', 'web', 'ion')
+     * @param handler - Method-specific implementation
+     */
+    registerMethod(name, handler) {
+        this.methods.set(name.toLowerCase(), handler);
+    }
+    /**
+     * Create a DID identity
+     * @throws {Error} If DID method is not supported
+     */
+    async createIdentity(options) {
+        const handler = this.methods.get(options.method.toLowerCase());
+        if (!handler) {
+            throw new Error(`Unsupported DID method: ${options.method}`);
+        }
+        return handler.createIdentity(options);
+    }
+    /**
+     * Register a service endpoint for a DID
+     * @param serviceEndpoint - Already uploaded URI (e.g., ipfs://...)
+     * @throws {Error} If DID method is not supported
+     */
+    async registerServiceEndpoint(options) {
+        const handler = this.methods.get(options.method.toLowerCase());
+        if (!handler) {
+            throw new Error(`Unsupported DID method: ${options.method}`);
+        }
+        return handler.registerServiceEndpoint(options);
+    }
+    /**
+     * Extract wallet address from DID
+     * Delegates to the appropriate handler based on DID method
+     * @param did - DID string
+     * @param method - DID method name
+     * @returns Wallet address or undefined
+     * @throws {Error} If DID method is not supported
+     */
+    extractWalletAddress(did, method) {
+        const handler = this.methods.get(method.toLowerCase());
+        if (!handler) {
+            throw new Error(`Unsupported DID method: ${method}`);
+        }
+        return handler.extractWalletAddress(did);
+    }
+    /**
+     * Get default key ID for a DID
+     * Delegates to the appropriate handler based on DID method
+     * @param did - DID string
+     * @param method - DID method name
+     * @returns Key identifier
+     * @throws {Error} If DID method is not supported
+     */
+    getKeyId(did, method) {
+        const handler = this.methods.get(method.toLowerCase());
+        if (!handler) {
+            throw new Error(`Unsupported DID method: ${method}`);
+        }
+        return handler.getKeyId(did);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/did/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/did/service.ts"],"names":[],"mappings":"AA+CA;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,CAAgC;IAE/C;QACE,gEAAgE;QAChE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAY,EAAE,OAAyB;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,OAKpB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,uBAAuB,CAAC,OAM7B;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,oBAAoB,CAAC,GAAW,EAAE,MAAc;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAW,EAAE,MAAc;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}