agentwallet-sdk 6.0.5 → 6.1.0

package/README.md

@@ -373,6 +373,44 @@ const rep = await reputation.getAgentReputation(agentId!);
 console.log(`Score: ${rep.totalScore} from ${rep.count} reviews`);
 ```
 
+## Cross-Chain Identity (UAID)
+
+ERC-8004 identities live on EVM chains. For agents on Solana, Hedera, or off-chain frameworks, the UAID (Universal Agent Identifier) resolver bridges identities across all chains via the [HOL Registry](https://hol.org).
+
+```typescript
+import { UAIDResolver, ERC8004Client } from 'agentwallet-sdk';
+
+const resolver = new UAIDResolver();
+
+// Resolve any agent by UAID — works across all chains
+const result = await resolver.resolve(
+  'uaid:aid:eip155:8453:0x8004...;uid=42;proto=erc8004'
+);
+if (result.resolved) {
+  console.log(result.identity?.paymentAddress); // Payment address, any chain
+  console.log(result.trustScore);               // Trust score (0-100)
+}
+
+// Convert your ERC-8004 identity to universal format
+const erc8004 = new ERC8004Client({ chain: 'base' });
+const identity = await erc8004.lookupAgentIdentity(42n);
+const universal = resolver.erc8004ToUniversal(identity, 'base');
+console.log(universal.uaid); // Cross-chain discoverable ID
+
+// Verify any agent before transacting (chain-agnostic)
+const check = await resolver.verify('uaid:aid:hedera:0.0.5678;uid=x;proto=openconvai');
+if (check.verified) { /* safe to transact */ }
+
+// Register for cross-chain discovery (requires HOL API key)
+const registrar = new UAIDResolver({ apiKey: process.env.HOL_API_KEY });
+const uaid = await registrar.registerERC8004Agent({
+  agentId: 42n, chain: 'base',
+  name: 'My Agent', description: 'Trading agent with x402 support',
+});
+```
+
+See [`examples/cross-chain-identity.ts`](./examples/cross-chain-identity.ts) for the full walkthrough.
+
 ## Decimal Helpers
 
 ```typescript
@@ -419,11 +457,66 @@ Stateless design — wallet state lives on-chain, not in application memory. Mul
 - SpendingPolicy changes are on-chain events — tamper-proof
 - NFT transfer = instant revocation of all agent permissions — no "forgot to deprovision" risk
 
+## Supported Payment Rails — Three-Rail Architecture
+
+AgentWallet SDK routes payments across three independent rails, selecting the optimal one based on amount, session context, autonomy level, and ecosystem preference:
+
+| Rail | Status | Use Case | Overhead |
+|------|--------|----------|----------|
+| ✅ **x402** (Base, EVM) | **Live** | Autonomous micropayments, API access, agent-to-agent commerce | 0 bps (no protocol fee) |
+| ✅ **Stripe MPP** | **Live** | High-frequency session payments, fiat-connected merchants, dispute resolution | ~290 bps |
+| 🔜 **Google AP2** | **Roadmap** | Google-managed identity + payment bundle, enterprise SSO integration | ~100 bps (est.) |
+| 🔜 **Solana x402** | **Roadmap Q2** | Solana-native agent payments via Solana Foundation gateway | 0 bps |
+
+### How the Router Decides
+
+The `PaymentRouter` evaluates each transaction and selects the rail automatically:
+
+- **Micropayments (< $1) + autonomous agent** → x402 (zero overhead, on-chain audit)
+- **High-frequency session (5+ txns)** → MPP (batching efficiency)
+- **Larger amounts or supervised agent** → MPP (fiat rails, dispute resolution)
+- **Google ecosystem preference** → Google AP2 (when live — managed identity + payment)
+- **Solana preference** → x402-solana (when live)
+
+AgentWallet SDK is the **multi-rail abstraction layer** — your agent code doesn't change when you add a new payment rail. Write once, pay on any chain or protocol.
+
+```typescript
+import { createX402Client } from 'agentwallet-sdk';
+
+// Same API regardless of underlying rail
+const client = createX402Client(wallet, {
+  supportedNetworks: ['base:8453'],  // Solana coming soon
+  globalDailyLimit: 50_000_000n,
+});
+```
+
+## Open Wallet Standard (OWS) Compatibility
+
+AgentWallet SDK is designed to work **on top of** [MoonPay's Open Wallet Standard](https://github.com/moonpay/open-wallet-standard) — not compete with it. OWS handles wallet key management (multi-chain signing, hardware-backed vaults, encrypted local storage). AgentWallet SDK handles everything above that: MCP integration, framework abstraction, spend-policy enforcement, payment routing, and human-in-the-loop approval.
+
+**The complete stack:**
+
+| Layer | Component | Responsibility |
+|-------|-----------|---------------|
+| Wallet & Key Management | **Open Wallet Standard (OWS)** | Multi-chain signing, hardware-backed keys (Ledger), encrypted vault, policy engine |
+| Framework & Integration | **AgentWallet SDK** | On-chain spend limits, payment routing (x402/MPP/AP2), human approval, framework adapters |
+| MCP Server | **[agentpay-mcp](https://github.com/up2itnow0822/agentpay-mcp)** | MCP-native payment tools for any MCP-compatible agent |
+
+If your agent framework or wallet provider already implements OWS, AgentWallet SDK plugs in as the payment execution and policy layer. Your agent gets supervised spending, multi-rail routing, and auditable on-chain payments without replacing your existing key management.
+
+## Market Context
+
+The agentic AI SDK market is projected to grow from **$2.4B (2025) to $16B by 2030** (Mordor Intelligence). AI agents are forecast to drive **$262B in bank sales** via embedded payments and lending by 2026. x402 alone has processed **140M+ agent payment transactions** ($43M) in 9 months, with 98.6% USDC settlement.
+
+AgentWallet SDK is [production-validated with NVIDIA NeMo](https://github.com/NVIDIA/NeMo-Agent-Toolkit-Examples/pull/17) — demonstrating enterprise-grade agent payment integration at scale. NVIDIA reports 88% revenue impact and 87% cost reduction from AI agent deployments.
+
 ## Links
 
 - [GitHub](https://github.com/up2itnow0822/agent-wallet-sdk)
 - [npm](https://www.npmjs.com/package/agentwallet-sdk)
 - [ERC-8004 Spec](https://eips.ethereum.org/EIPS/eip-8004)
+- [Open Wallet Standard](https://github.com/moonpay/open-wallet-standard) — wallet key management layer
+- [HOL Registry](https://hol.org) — Cross-chain agent identity registry (UAID resolution)
 - [agentpay-mcp](https://github.com/up2itnow0822/agentpay-mcp) — MCP server wrapping this SDK
 
 ## Patent Notice

package/dist/identity/index.d.ts

@@ -4,4 +4,6 @@ export { ReputationClient, ReputationRegistryAbi } from './reputation.js';
 export type { ReputationClientConfig, GiveFeedbackParams, FeedbackEntry, AgentReputationSummary, FeedbackFilters, RespondToFeedbackParams, } from './reputation.js';
 export { ValidationClient, ValidationRegistryAbi } from './validation.js';
 export type { ValidationClientConfig, RequestValidationParams, RespondToValidationParams, ValidationStatus, ValidationSummary, } from './validation.js';
+export { UAIDResolver } from './uaid.js';
+export type { UAIDProtocol, ParsedUAID, UAIDResolution, UniversalAgentIdentity, UAIDResolverConfig, RegisterUAIDParams, } from './uaid.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/identity/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,0BAA0B,EAAE,aAAa,EACxD,sBAAsB,EAAE,wBAAwB,EAChD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,mBAAmB,GAC3F,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EACnE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EACxD,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,GACvE,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,sBAAsB,EAAE,kBAAkB,EAAE,aAAa,EACzD,sBAAsB,EAAE,eAAe,EAAE,uBAAuB,GACjE,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,sBAAsB,EAAE,uBAAuB,EAAE,yBAAyB,EAC1E,gBAAgB,EAAE,iBAAiB,GACpC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,0BAA0B,EAAE,aAAa,EACxD,sBAAsB,EAAE,wBAAwB,EAChD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,mBAAmB,GAC3F,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EACnE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EACxD,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,GACvE,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,sBAAsB,EAAE,kBAAkB,EAAE,aAAa,EACzD,sBAAsB,EAAE,eAAe,EAAE,uBAAuB,GACjE,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,sBAAsB,EAAE,uBAAuB,EAAE,yBAAyB,EAC1E,gBAAgB,EAAE,iBAAiB,GACpC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAChE,kBAAkB,EAAE,kBAAkB,GACvC,MAAM,WAAW,CAAC"}

package/dist/identity/index.js

@@ -1,4 +1,6 @@
 export { ERC8004Client, ERC8004IdentityRegistryAbi, METADATA_KEYS, REGISTRATION_FILE_TYPE, KNOWN_REGISTRY_ADDRESSES, buildDataURI, parseDataURI, resolveAgentURI, validateRegistrationFile, formatAgentRegistry, } from './erc8004.js';
 export { ReputationClient, ReputationRegistryAbi } from './reputation.js';
 export { ValidationClient, ValidationRegistryAbi } from './validation.js';
+// ─── UAID: Cross-Chain Identity Resolution ─────────────────────────────────
+export { UAIDResolver } from './uaid.js';
 //# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,0BAA0B,EAAE,aAAa,EACxD,sBAAsB,EAAE,wBAAwB,EAChD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,mBAAmB,GAC3F,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAAE,0BAA0B,EAAE,aAAa,EACxD,sBAAsB,EAAE,wBAAwB,EAChD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,wBAAwB,EAAE,mBAAmB,GAC3F,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM1E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM1E,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/identity/uaid.d.ts

@@ -0,0 +1,193 @@
+/**
+ * uaid.ts — Universal Agent Identifier (UAID) Resolution Layer
+ *
+ * Provides cross-chain agent identity resolution via the HOL Registry Broker.
+ * UAIDs are chain-agnostic identifiers that bridge ERC-8004 tokens on EVM chains
+ * to agents on Solana, Hedera, off-chain frameworks, and any other protocol.
+ *
+ * This module is an optional extension — agents that only operate on EVM chains
+ * can continue using ERC8004Client directly.
+ *
+ * Registry: https://hol.org
+ * SDK: @hol-org/rb-client (peer dependency — install only if needed)
+ *
+ * @module identity/uaid
+ */
+import type { AgentIdentity, AgentRegistrationFile, SupportedChain } from './erc8004.js';
+import type { Address } from 'viem';
+/** Supported protocol types in the UAID ecosystem */
+export type UAIDProtocol = 'erc8004' | 'a2a' | 'openconvai' | 'virtuals' | 'x402' | 'hedera' | 'solana' | string;
+/** A parsed UAID with its component parts */
+export interface ParsedUAID {
+    /** Raw UAID string */
+    raw: string;
+    /** Agent identifier portion */
+    aid: string;
+    /** Unique identifier portion */
+    uid: string;
+    /** Protocol used for resolution */
+    protocol: UAIDProtocol;
+    /** Native identifier on the protocol's own chain/system */
+    nativeId?: string;
+}
+/** Result of resolving a UAID to a known identity */
+export interface UAIDResolution {
+    /** Whether resolution succeeded */
+    resolved: boolean;
+    /** The UAID that was resolved */
+    uaid: string;
+    /** Resolved agent identity (if ERC-8004 backed) */
+    identity: UniversalAgentIdentity | null;
+    /** Protocol the agent was resolved through */
+    protocol: UAIDProtocol;
+    /** Chain the identity lives on (if applicable) */
+    chain?: string;
+    /** Trust score from the registry (0-100) */
+    trustScore?: number;
+    /** Whether the agent is verified in the HOL registry */
+    registryVerified: boolean;
+    /** Error message if resolution failed */
+    error?: string;
+}
+/**
+ * Universal agent identity — superset of ERC-8004 AgentIdentity that works
+ * across chains. For EVM agents, this mirrors AgentIdentity. For non-EVM
+ * agents, it provides equivalent fields using native identifiers.
+ */
+export interface UniversalAgentIdentity {
+    /** Identifier — ERC-8004 tokenId for EVM, native ID for others */
+    agentId: string;
+    /** Owner — EVM address, Hedera account, Solana pubkey, etc. */
+    owner: string;
+    /** Agent URI / metadata endpoint */
+    agentURI: string;
+    /** Payment address (chain-native format) */
+    paymentAddress: string;
+    /** Registration metadata (if available) */
+    registrationFile: AgentRegistrationFile | null;
+    /** Source protocol */
+    protocol: UAIDProtocol;
+    /** Source chain */
+    chain: string;
+    /** UAID for cross-chain reference */
+    uaid: string;
+}
+/** Configuration for the UAID resolver */
+export interface UAIDResolverConfig {
+    /** HOL Registry Broker API key (optional for read-only resolution) */
+    apiKey?: string;
+    /** Custom broker base URL (defaults to production) */
+    brokerUrl?: string;
+    /** Request timeout in ms (default: 10000) */
+    timeoutMs?: number;
+    /** Cache resolved identities for this many ms (default: 300000 = 5 min) */
+    cacheTtlMs?: number;
+}
+/** Parameters for registering an ERC-8004 identity as a UAID */
+export interface RegisterUAIDParams {
+    /** ERC-8004 agent ID (tokenId) */
+    agentId: bigint;
+    /** Chain the identity is registered on */
+    chain: SupportedChain;
+    /** Registry contract address (uses known defaults if omitted) */
+    registryAddress?: Address;
+    /** Agent name for the registry */
+    name: string;
+    /** Agent description */
+    description: string;
+    /** Optional: additional capabilities to advertise */
+    capabilities?: string[];
+}
+export declare class UAIDResolver {
+    private readonly brokerUrl;
+    private readonly apiKey?;
+    private readonly timeoutMs;
+    private readonly cacheTtlMs;
+    private readonly cache;
+    constructor(config?: UAIDResolverConfig);
+    /**
+     * Resolve a UAID to an agent identity.
+     *
+     * Works across chains — the resolver contacts the HOL Registry Broker to
+     * find the agent's identity regardless of whether it lives on EVM, Hedera,
+     * Solana, or off-chain.
+     *
+     * @param uaid - Universal Agent Identifier string
+     * @returns Resolution result with identity details
+     *
+     * @example
+     * ```ts
+     * const resolver = new UAIDResolver();
+     * const result = await resolver.resolve('uaid:aid:0x8004...;uid=42;proto=erc8004');
+     * if (result.resolved) {
+     *   console.log(result.identity?.paymentAddress);
+     * }
+     * ```
+     */
+    resolve(uaid: string): Promise<UAIDResolution>;
+    /**
+     * Search the HOL registry for agents matching criteria.
+     *
+     * @param query - Search terms (name, capability, protocol)
+     * @param options - Optional filters
+     * @returns Array of matching UAIDResolution results
+     */
+    search(query: string, options?: {
+        protocol?: UAIDProtocol;
+        limit?: number;
+        minTrustScore?: number;
+    }): Promise<UAIDResolution[]>;
+    /**
+     * Convert an ERC-8004 AgentIdentity to a UniversalAgentIdentity.
+     *
+     * Useful when you already have an on-chain identity and want to work
+     * with the universal format (e.g., for cross-chain discovery).
+     */
+    erc8004ToUniversal(identity: AgentIdentity, chain: SupportedChain): UniversalAgentIdentity;
+    /**
+     * Build a UAID string for an ERC-8004 agent.
+     *
+     * This creates the identifier — it does NOT register with the HOL registry.
+     * Use registerERC8004Agent() to make the agent discoverable cross-chain.
+     */
+    buildERC8004UAID(agentId: bigint, chain: SupportedChain, ownerAddress: Address): string;
+    /**
+     * Register an ERC-8004 agent in the HOL registry for cross-chain discovery.
+     *
+     * After registration, agents on Solana, Hedera, or any protocol can
+     * discover and verify this agent's identity via its UAID.
+     *
+     * Requires an API key with write permissions.
+     *
+     * @param params - Registration parameters
+     * @returns The assigned UAID
+     */
+    registerERC8004Agent(params: RegisterUAIDParams): Promise<string>;
+    /**
+     * Verify an agent's identity via UAID — works across any chain.
+     *
+     * This is the cross-chain equivalent of ERC8004Client.lookupAgentIdentity().
+     * For EVM agents, it verifies the UAID maps to a valid on-chain ERC-8004 token.
+     * For non-EVM agents, it verifies through the registry's native trust mechanism.
+     *
+     * @param uaid - Universal Agent Identifier to verify
+     * @returns Verification result
+     */
+    verify(uaid: string): Promise<{
+        verified: boolean;
+        identity: UniversalAgentIdentity | null;
+        trustScore: number;
+        protocol: UAIDProtocol;
+        error?: string;
+    }>;
+    /**
+     * Parse a UAID string into its components.
+     *
+     * Format: `uaid:aid:<identifier>;uid=<unique-id>;proto=<protocol>[;nativeId=<id>]`
+     */
+    static parseUAID(uaid: string): ParsedUAID | null;
+    /** Clear the resolution cache */
+    clearCache(): void;
+    private brokerRequest;
+}
+//# sourceMappingURL=uaid.d.ts.map

package/dist/identity/uaid.d.ts.map

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

package/dist/identity/uaid.js

@@ -0,0 +1,296 @@
+/**
+ * uaid.ts — Universal Agent Identifier (UAID) Resolution Layer
+ *
+ * Provides cross-chain agent identity resolution via the HOL Registry Broker.
+ * UAIDs are chain-agnostic identifiers that bridge ERC-8004 tokens on EVM chains
+ * to agents on Solana, Hedera, off-chain frameworks, and any other protocol.
+ *
+ * This module is an optional extension — agents that only operate on EVM chains
+ * can continue using ERC8004Client directly.
+ *
+ * Registry: https://hol.org
+ * SDK: @hol-org/rb-client (peer dependency — install only if needed)
+ *
+ * @module identity/uaid
+ */
+// ─── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_BROKER_URL = 'https://hol.org/registry/api/v1';
+const DEFAULT_TIMEOUT_MS = 10000;
+const DEFAULT_CACHE_TTL_MS = 300000; // 5 minutes
+/** EVM chain IDs for UAID protocol mapping */
+const EVM_CHAIN_IDS = {
+    'ethereum': 1,
+    'base': 8453,
+    'base-sepolia': 84532,
+    'arbitrum': 42161,
+    'arbitrum-sepolia': 421614,
+    'polygon': 137,
+};
+// ─── Client ──────────────────────────────────────────────────────────────────
+export class UAIDResolver {
+    constructor(config = {}) {
+        this.cache = new Map();
+        this.brokerUrl = (config.brokerUrl ?? DEFAULT_BROKER_URL).replace(/\/+$/, '');
+        this.apiKey = config.apiKey;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.cacheTtlMs = config.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    }
+    // ── Core resolution ──────────────────────────────────────────────────────
+    /**
+     * Resolve a UAID to an agent identity.
+     *
+     * Works across chains — the resolver contacts the HOL Registry Broker to
+     * find the agent's identity regardless of whether it lives on EVM, Hedera,
+     * Solana, or off-chain.
+     *
+     * @param uaid - Universal Agent Identifier string
+     * @returns Resolution result with identity details
+     *
+     * @example
+     * ```ts
+     * const resolver = new UAIDResolver();
+     * const result = await resolver.resolve('uaid:aid:0x8004...;uid=42;proto=erc8004');
+     * if (result.resolved) {
+     *   console.log(result.identity?.paymentAddress);
+     * }
+     * ```
+     */
+    async resolve(uaid) {
+        // Check cache
+        const cached = this.cache.get(uaid);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.result;
+        }
+        try {
+            const response = await this.brokerRequest('GET', `/agents/resolve?uaid=${encodeURIComponent(uaid)}`);
+            if (!response.ok) {
+                const result = {
+                    resolved: false, uaid, identity: null, protocol: 'unknown',
+                    registryVerified: false, error: `Registry returned ${response.status}`,
+                };
+                return result;
+            }
+            const data = await response.json();
+            const identity = {
+                agentId: String(data.agentId ?? data.nativeId ?? ''),
+                owner: data.owner ?? data.controller ?? '',
+                agentURI: data.agentURI ?? data.metadataUri ?? '',
+                paymentAddress: data.paymentAddress ?? data.agentWallet ?? '',
+                registrationFile: data.registrationFile ?? null,
+                protocol: data.protocol ?? 'unknown',
+                chain: data.chain ?? '',
+                uaid,
+            };
+            const result = {
+                resolved: true, uaid, identity,
+                protocol: data.protocol ?? 'unknown',
+                chain: data.chain,
+                trustScore: data.trustScore,
+                registryVerified: data.verified ?? false,
+            };
+            // Cache the result
+            this.cache.set(uaid, { result, expiresAt: Date.now() + this.cacheTtlMs });
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                resolved: false, uaid, identity: null, protocol: 'unknown',
+                registryVerified: false, error: `Resolution failed: ${message}`,
+            };
+        }
+    }
+    /**
+     * Search the HOL registry for agents matching criteria.
+     *
+     * @param query - Search terms (name, capability, protocol)
+     * @param options - Optional filters
+     * @returns Array of matching UAIDResolution results
+     */
+    async search(query, options) {
+        try {
+            const params = new URLSearchParams({ q: query });
+            if (options?.protocol)
+                params.set('protocol', options.protocol);
+            if (options?.limit)
+                params.set('limit', String(options.limit));
+            if (options?.minTrustScore)
+                params.set('minTrust', String(options.minTrustScore));
+            const response = await this.brokerRequest('GET', `/agents/search?${params}`);
+            if (!response.ok)
+                return [];
+            const data = await response.json();
+            const results = (data.agents ?? []).map((agent) => ({
+                resolved: true,
+                uaid: agent.uaid,
+                identity: {
+                    agentId: String(agent.agentId ?? agent.nativeId ?? ''),
+                    owner: (agent.owner ?? agent.controller ?? ''),
+                    agentURI: (agent.agentURI ?? agent.metadataUri ?? ''),
+                    paymentAddress: (agent.paymentAddress ?? agent.agentWallet ?? ''),
+                    registrationFile: (agent.registrationFile ?? null),
+                    protocol: (agent.protocol ?? 'unknown'),
+                    chain: (agent.chain ?? ''),
+                    uaid: agent.uaid,
+                },
+                protocol: (agent.protocol ?? 'unknown'),
+                chain: agent.chain,
+                trustScore: agent.trustScore,
+                registryVerified: (agent.verified ?? false),
+            }));
+            return results;
+        }
+        catch {
+            return [];
+        }
+    }
+    // ── ERC-8004 ↔ UAID bridge ────────────────────────────────────────────────
+    /**
+     * Convert an ERC-8004 AgentIdentity to a UniversalAgentIdentity.
+     *
+     * Useful when you already have an on-chain identity and want to work
+     * with the universal format (e.g., for cross-chain discovery).
+     */
+    erc8004ToUniversal(identity, chain) {
+        const chainId = EVM_CHAIN_IDS[chain];
+        return {
+            agentId: identity.agentId.toString(),
+            owner: identity.owner,
+            agentURI: identity.agentURI,
+            paymentAddress: identity.agentWallet,
+            registrationFile: identity.registrationFile,
+            protocol: 'erc8004',
+            chain: `eip155:${chainId}`,
+            uaid: `uaid:aid:eip155:${chainId}:${identity.owner};uid=${identity.agentId};proto=erc8004`,
+        };
+    }
+    /**
+     * Build a UAID string for an ERC-8004 agent.
+     *
+     * This creates the identifier — it does NOT register with the HOL registry.
+     * Use registerERC8004Agent() to make the agent discoverable cross-chain.
+     */
+    buildERC8004UAID(agentId, chain, ownerAddress) {
+        const chainId = EVM_CHAIN_IDS[chain];
+        return `uaid:aid:eip155:${chainId}:${ownerAddress};uid=${agentId};proto=erc8004`;
+    }
+    /**
+     * Register an ERC-8004 agent in the HOL registry for cross-chain discovery.
+     *
+     * After registration, agents on Solana, Hedera, or any protocol can
+     * discover and verify this agent's identity via its UAID.
+     *
+     * Requires an API key with write permissions.
+     *
+     * @param params - Registration parameters
+     * @returns The assigned UAID
+     */
+    async registerERC8004Agent(params) {
+        if (!this.apiKey) {
+            throw new Error('UAIDResolver: API key required for registration. Get one at https://hol.org');
+        }
+        const chainId = EVM_CHAIN_IDS[params.chain];
+        const uaid = `uaid:aid:eip155:${chainId}:${params.registryAddress ?? '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432'};uid=${params.agentId};proto=erc8004`;
+        const response = await this.brokerRequest('POST', '/agents/register', {
+            uaid,
+            protocol: 'erc8004',
+            chain: `eip155:${chainId}`,
+            agentId: params.agentId.toString(),
+            name: params.name,
+            description: params.description,
+            capabilities: params.capabilities ?? [],
+            registryAddress: params.registryAddress ?? '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => '');
+            throw new Error(`UAIDResolver: Registration failed (${response.status}): ${errorBody}`);
+        }
+        const data = await response.json();
+        return data.uaid ?? uaid;
+    }
+    // ── Verification ──────────────────────────────────────────────────────────
+    /**
+     * Verify an agent's identity via UAID — works across any chain.
+     *
+     * This is the cross-chain equivalent of ERC8004Client.lookupAgentIdentity().
+     * For EVM agents, it verifies the UAID maps to a valid on-chain ERC-8004 token.
+     * For non-EVM agents, it verifies through the registry's native trust mechanism.
+     *
+     * @param uaid - Universal Agent Identifier to verify
+     * @returns Verification result
+     */
+    async verify(uaid) {
+        const resolution = await this.resolve(uaid);
+        if (!resolution.resolved || !resolution.identity) {
+            return {
+                verified: false,
+                identity: null,
+                trustScore: 0,
+                protocol: resolution.protocol,
+                error: resolution.error ?? 'Agent not found in registry',
+            };
+        }
+        return {
+            verified: resolution.registryVerified,
+            identity: resolution.identity,
+            trustScore: resolution.trustScore ?? 0,
+            protocol: resolution.protocol,
+        };
+    }
+    // ── Utility ───────────────────────────────────────────────────────────────
+    /**
+     * Parse a UAID string into its components.
+     *
+     * Format: `uaid:aid:<identifier>;uid=<unique-id>;proto=<protocol>[;nativeId=<id>]`
+     */
+    static parseUAID(uaid) {
+        if (!uaid.startsWith('uaid:'))
+            return null;
+        const parts = uaid.split(';');
+        const aidPart = parts.find(p => p.startsWith('uaid:aid:'));
+        const uidPart = parts.find(p => p.startsWith('uid='));
+        const protoPart = parts.find(p => p.startsWith('proto='));
+        const nativeIdPart = parts.find(p => p.startsWith('nativeId='));
+        if (!aidPart || !uidPart || !protoPart)
+            return null;
+        return {
+            raw: uaid,
+            aid: aidPart.replace('uaid:aid:', ''),
+            uid: uidPart.replace('uid=', ''),
+            protocol: protoPart.replace('proto=', ''),
+            nativeId: nativeIdPart?.replace('nativeId=', ''),
+        };
+    }
+    /** Clear the resolution cache */
+    clearCache() {
+        this.cache.clear();
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    async brokerRequest(method, path, body) {
+        const url = `${this.brokerUrl}${path}`;
+        const headers = {
+            'Accept': 'application/json',
+            'User-Agent': 'agentwallet-sdk/uaid-resolver',
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            return await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=uaid.js.map

package/dist/identity/uaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uaid.js","sourceRoot":"","sources":["../../src/identity/uaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwGH,gFAAgF;AAEhF,MAAM,kBAAkB,GAAG,iCAAiC,CAAC;AAC7D,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAClC,MAAM,oBAAoB,GAAG,MAAO,CAAC,CAAC,YAAY;AAElD,8CAA8C;AAC9C,MAAM,aAAa,GAAmC;IACpD,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,IAAI;IACZ,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,KAAK;IACjB,kBAAkB,EAAE,MAAM;IAC1B,SAAS,EAAE,GAAG;CACf,CAAC;AASF,gFAAgF;AAEhF,MAAM,OAAO,YAAY;IAOvB,YAAY,SAA6B,EAAE;QAF1B,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAGrD,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,oBAAoB,CAAC;IAC9D,CAAC;IAED,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAErG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAmB;oBAC7B,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS;oBAC1D,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,QAAQ,CAAC,MAAM,EAAE;iBACvE,CAAC;gBACF,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,MAAM,QAAQ,GAA2B;gBACvC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACpD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE;gBAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;gBACjD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;gBAC7D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;gBAC/C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;gBACvB,IAAI;aACL,CAAC;YAEF,MAAM,MAAM,GAAmB;gBAC7B,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ;gBAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,gBAAgB,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;aACzC,CAAC;YAEF,mBAAmB;YACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1E,OAAO,MAAM,CAAC;QAEhB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS;gBAC1D,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,OAAO,EAAE;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA6E;QAE7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,QAAQ;gBAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAChE,IAAI,OAAO,EAAE,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/D,IAAI,OAAO,EAAE,aAAa;gBAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;YAElF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,kBAAkB,MAAM,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,EAAE,CAAC;YAE5B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,OAAO,GAAqB,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAA8B,EAAE,EAAE,CAAC,CAAC;gBAC7F,QAAQ,EAAE,IAAI;gBACd,IAAI,EAAE,KAAK,CAAC,IAAc;gBAC1B,QAAQ,EAAE;oBACR,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACtD,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,CAAW;oBACxD,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAW;oBAC/D,cAAc,EAAE,CAAC,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAW;oBAC3E,gBAAgB,EAAE,CAAC,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAAiC;oBAClF,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAiB;oBACvD,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAW;oBACpC,IAAI,EAAE,KAAK,CAAC,IAAc;iBAC3B;gBACD,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAiB;gBACvD,KAAK,EAAE,KAAK,CAAC,KAA2B;gBACxC,UAAU,EAAE,KAAK,CAAC,UAAgC;gBAClD,gBAAgB,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAY;aACvD,CAAC,CAAC,CAAC;YAEJ,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E;;;;;OAKG;IACH,kBAAkB,CAAC,QAAuB,EAAE,KAAqB;QAC/D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE;YACpC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,cAAc,EAAE,QAAQ,CAAC,WAAW;YACpC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;YAC3C,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,UAAU,OAAO,EAAE;YAC1B,IAAI,EAAE,mBAAmB,OAAO,IAAI,QAAQ,CAAC,KAAK,QAAQ,QAAQ,CAAC,OAAO,gBAAgB;SAC3F,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,OAAe,EAAE,KAAqB,EAAE,YAAqB;QAC5E,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,mBAAmB,OAAO,IAAI,YAAY,QAAQ,OAAO,gBAAgB,CAAC;IACnF,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,oBAAoB,CAAC,MAA0B;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,mBAAmB,OAAO,IAAI,MAAM,CAAC,eAAe,IAAI,4CAA4C,QAAQ,MAAM,CAAC,OAAO,gBAAgB,CAAC;QAExJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE;YACpE,IAAI;YACJ,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,UAAU,OAAO,EAAE;YAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;YACvC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,4CAA4C;SACxF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAE7E;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QAOvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACjD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,6BAA6B;aACzD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,UAAU,CAAC,gBAAgB;YACrC,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,CAAC;YACtC,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;IACJ,CAAC;IAED,6EAA6E;IAE7E;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;QAEhE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,OAAO;YACL,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YACrC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAChC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAiB;YACzD,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,IAAY,EAAE,IAAc;QACtE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAA2B;YACtC,QAAQ,EAAE,kBAAkB;YAC5B,YAAY,EAAE,+BAA+B;SAC9C,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE;gBACtB,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC7C,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}