@oobe-protocol-labs/synapse-client-sdk 2.0.0 → 2.0.5

package/dist/esm/ai/sap/discovery.js

@@ -1,311 +0,0 @@
-/**
- * @module ai/sap/discovery
- * @description SAP — On-chain agent discovery via `getProgramAccounts`.
- *
- * Queries the Solana blockchain for registered agents, applying filters
- * like capability, protocol, reputation, price range, and uptime.
- *
- * Uses the SDK's native {@link HttpTransport} — no external dependencies.
- *
- * @example
- * ```ts
- * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
- * import { SAPDiscovery } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const client = new SynapseClient({ endpoint: 'https://api.mainnet-beta.solana.com' });
- * const discovery = new SAPDiscovery(client, { programId: 'SAPAgnt1...' });
- *
- * // Find agents that support Jupiter swaps
- * const result = await discovery.find({ capability: 'jupiter:swap', minReputation: 700 });
- * for (const agent of result.agents) {
- *   console.log(agent.name, agent.reputation.score, agent.x402Endpoint);
- * }
- * ```
- *
- * @since 1.3.0
- */
-import { SAP_DEFAULT_PROGRAM_ID, SAP_ACCOUNT_DISCRIMINATOR } from './types.js';
-import { deserializeAgentAccount, deriveAgentPDA } from './pda.js';
-/* ═══════════════════════════════════════════════════════════════
- *  SAPDiscovery
- * ═══════════════════════════════════════════════════════════════ */
-/**
- * @description Error class for SAP discovery failures.
- * @since 1.3.0
- */
-export class SAPDiscoveryError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.code = code;
-        this.name = 'SAPDiscoveryError';
-    }
-}
-/**
- * @description On-chain agent discovery engine.
- *
- * Queries the Solana blockchain for SAP-registered agents using
- * `getProgramAccounts` with memcmp filters for efficient querying.
- *
- * @since 1.3.0
- */
-export class SAPDiscovery {
-    transport;
-    config;
-    /**
-     * @param {RpcClient} client - Client providing RPC transport
-     * @param {Partial<SAPConfig>} [config] - Discovery configuration
-     */
-    constructor(client, config) {
-        this.transport = client.transport;
-        this.config = {
-            programId: config?.programId ?? SAP_DEFAULT_PROGRAM_ID,
-            commitment: config?.commitment ?? 'confirmed',
-            maxAccounts: config?.maxAccounts ?? 100,
-        };
-    }
-    /**
-     * @description Find a single agent by wallet public key.
-     *
-     * Derives the PDA and fetches the account data directly.
-     *
-     * @param {string} walletPubkey - Agent's wallet (base58)
-     * @returns {Promise<AgentPDAAccount | null>} Agent account or null
-     *
-     * @example
-     * ```ts
-     * const agent = await discovery.findAgent('7xKXwJ...');
-     * if (agent) console.log(agent.name, agent.capabilities);
-     * ```
-     *
-     * @since 1.3.0
-     */
-    async findAgent(walletPubkey) {
-        const pda = deriveAgentPDA(walletPubkey, this.config.programId);
-        const result = await this.transport.request('getAccountInfo', [pda.address, { encoding: 'base64', commitment: this.config.commitment }]);
-        if (!result?.value?.data)
-            return null;
-        try {
-            const bytes = Buffer.from(result.value.data[0], 'base64');
-            return deserializeAgentAccount(pda.address, bytes);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * @description Find agents matching the given filters.
-     *
-     * Uses `getProgramAccounts` with a memcmp filter on the discriminator
-     * to fetch all SAP accounts, then applies client-side filters.
-     *
-     * @param {AgentDiscoveryFilter} [filter] - Query filters
-     * @returns {Promise<DiscoveryResult>} Discovery results with matching agents
-     *
-     * @example
-     * ```ts
-     * const result = await discovery.find({
-     *   capability: 'jupiter:swap',
-     *   minReputation: 600,
-     *   maxPricePerCall: 5000n,
-     *   sortBy: 'reputation',
-     *   limit: 20,
-     * });
-     * ```
-     *
-     * @since 1.3.0
-     */
-    async find(filter = {}) {
-        const start = performance.now();
-        const { activeOnly = true, capability, protocol, minReputation, maxPricePerCall, minUptime, sortBy, sortDirection = 'desc', limit = 50, } = filter;
-        // Fetch all accounts with discriminator filter
-        const accounts = await this.fetchAllAccounts();
-        const totalScanned = accounts.length;
-        // Apply filters
-        let matched = accounts.filter((agent) => {
-            if (activeOnly && !agent.isActive)
-                return false;
-            if (capability && !agent.capabilities.some(c => c.id === capability))
-                return false;
-            if (protocol && !agent.capabilities.some(c => c.protocol === protocol))
-                return false;
-            if (minReputation !== undefined && agent.reputation.score < minReputation)
-                return false;
-            if (maxPricePerCall !== undefined) {
-                const cheapest = agent.pricing.reduce((min, p) => p.pricePerCall < min ? p.pricePerCall : min, agent.pricing[0]?.pricePerCall ?? 0n);
-                if (cheapest > maxPricePerCall)
-                    return false;
-            }
-            if (minUptime !== undefined && agent.reputation.uptimePercent < minUptime)
-                return false;
-            return true;
-        });
-        const totalMatching = matched.length;
-        // Sort
-        if (sortBy) {
-            const mul = sortDirection === 'asc' ? 1 : -1;
-            matched.sort((a, b) => {
-                switch (sortBy) {
-                    case 'reputation': return mul * (a.reputation.score - b.reputation.score);
-                    case 'latency': return mul * (a.reputation.avgLatencyMs - b.reputation.avgLatencyMs);
-                    case 'uptime': return mul * (a.reputation.uptimePercent - b.reputation.uptimePercent);
-                    case 'calls': return mul * Number(a.reputation.totalCallsServed - b.reputation.totalCallsServed);
-                    case 'price': {
-                        const aMin = a.pricing[0]?.pricePerCall ?? 0n;
-                        const bMin = b.pricing[0]?.pricePerCall ?? 0n;
-                        return mul * Number(aMin - bMin);
-                    }
-                    default: return 0;
-                }
-            });
-        }
-        // Limit
-        if (matched.length > limit) {
-            matched = matched.slice(0, limit);
-        }
-        return {
-            agents: matched,
-            totalScanned,
-            totalMatching,
-            queryLatencyMs: Math.round(performance.now() - start),
-        };
-    }
-    /**
-     * @description Find all active agents (shortcut for `find({ activeOnly: true })`).
-     * @returns {Promise<AgentPDAAccount[]>} Active agent accounts
-     * @since 1.3.0
-     */
-    async findActive() {
-        const result = await this.find({ activeOnly: true, limit: this.config.maxAccounts });
-        return result.agents;
-    }
-    /**
-     * @description Find agents by capability ID.
-     * @param {string} capabilityId - Capability to search for (e.g. `"jupiter:swap"`)
-     * @returns {Promise<AgentPDAAccount[]>} Agents with the given capability
-     * @since 1.3.0
-     */
-    async findByCapability(capabilityId) {
-        const result = await this.find({ capability: capabilityId, limit: this.config.maxAccounts });
-        return result.agents;
-    }
-    /**
-     * @description Find agents by protocol name.
-     * @param {string} protocol - Protocol name (e.g. `"jupiter"`, `"raydium"`)
-     * @returns {Promise<AgentPDAAccount[]>} Agents offering tools for the given protocol
-     * @since 1.3.0
-     */
-    async findByProtocol(protocol) {
-        const result = await this.find({ protocol, limit: this.config.maxAccounts });
-        return result.agents;
-    }
-    /**
-     * @description Find the cheapest agent for a given capability.
-     * @param {string} capabilityId - Capability to search for
-     * @returns {Promise<AgentPDAAccount | null>} Cheapest agent or null
-     * @since 1.3.0
-     */
-    async findCheapest(capabilityId) {
-        const result = await this.find({
-            capability: capabilityId,
-            sortBy: 'price',
-            sortDirection: 'asc',
-            limit: 1,
-        });
-        return result.agents[0] ?? null;
-    }
-    /**
-     * @description Find the most reputable agent for a given capability.
-     * @param {string} capabilityId - Capability to search for
-     * @returns {Promise<AgentPDAAccount | null>} Most reputable agent or null
-     * @since 1.3.0
-     */
-    async findMostReputable(capabilityId) {
-        const result = await this.find({
-            capability: capabilityId,
-            sortBy: 'reputation',
-            sortDirection: 'desc',
-            limit: 1,
-        });
-        return result.agents[0] ?? null;
-    }
-    /**
-     * @description Compute aggregate metrics across all registered agents.
-     *
-     * @returns {Promise<SAPAggregateMetrics>} Network-wide agent statistics
-     *
-     * @example
-     * ```ts
-     * const metrics = await discovery.getAggregateMetrics();
-     * console.log(`${metrics.activeAgents} active agents`);
-     * console.log(`${metrics.totalCallsServed} total calls served`);
-     * console.log(`Protocols: ${metrics.protocols.join(', ')}`);
-     * ```
-     *
-     * @since 1.3.0
-     */
-    async getAggregateMetrics() {
-        const agents = await this.fetchAllAccounts();
-        const protocols = new Set();
-        const capabilities = new Set();
-        let totalCalls = 0n;
-        let totalReputation = 0;
-        let totalLatency = 0;
-        let activeCount = 0;
-        for (const agent of agents) {
-            if (agent.isActive)
-                activeCount++;
-            totalCalls += agent.reputation.totalCallsServed;
-            totalReputation += agent.reputation.score;
-            totalLatency += agent.reputation.avgLatencyMs;
-            for (const cap of agent.capabilities) {
-                capabilities.add(cap.id);
-                if (cap.protocol)
-                    protocols.add(cap.protocol);
-            }
-        }
-        return {
-            totalAgents: agents.length,
-            activeAgents: activeCount,
-            totalCallsServed: totalCalls,
-            avgReputation: agents.length > 0 ? Math.round(totalReputation / agents.length) : 0,
-            avgLatencyMs: agents.length > 0 ? Math.round(totalLatency / agents.length) : 0,
-            protocols: [...protocols],
-            capabilities: [...capabilities],
-        };
-    }
-    /* ── Internal ── */
-    /**
-     * @description Fetch all SAP accounts from the blockchain using getProgramAccounts.
-     * @returns {Promise<AgentPDAAccount[]>} All deserialized agent accounts
-     * @internal
-     */
-    async fetchAllAccounts() {
-        // memcmp filter: match the 8-byte discriminator at offset 0
-        const discriminatorBase64 = Buffer.from(SAP_ACCOUNT_DISCRIMINATOR).toString('base64');
-        const rpcResult = await this.transport.request('getProgramAccounts', [
-            this.config.programId,
-            {
-                encoding: 'base64',
-                commitment: this.config.commitment,
-                filters: [
-                    { memcmp: { offset: 0, bytes: discriminatorBase64, encoding: 'base64' } },
-                ],
-            },
-        ]);
-        if (!Array.isArray(rpcResult))
-            return [];
-        const agents = [];
-        for (const entry of rpcResult) {
-            try {
-                const bytes = Buffer.from(entry.account.data[0], 'base64');
-                agents.push(deserializeAgentAccount(entry.pubkey, bytes));
-            }
-            catch {
-                // Skip malformed accounts
-            }
-        }
-        return agents;
-    }
-}
-//# sourceMappingURL=discovery.js.map

package/dist/esm/ai/sap/discovery.js.map

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

package/dist/esm/ai/sap/pda.d.ts

@@ -1,205 +0,0 @@
-/**
- * @module ai/sap/pda
- * @description SAP — PDA derivation, account serialization & deserialization.
- *
- * Provides Solana Program Derived Address (PDA) computation for agent
- * identity accounts, plus Borsh-compatible binary serialization for
- * reading and writing on-chain agent data.
- *
- * PDA seeds: `["synapse_agent", <wallet_pubkey_32_bytes>]`
- *
- * @example
- * ```ts
- * import { deriveAgentPDA, deserializeAgentAccount } from '@oobe-protocol-labs/synapse-client-sdk/ai';
- *
- * const { address, bump } = deriveAgentPDA(walletPubkey, programId);
- * const account = deserializeAgentAccount(address, rawBytes);
- * ```
- *
- * @since 1.3.0
- */
-import type { AgentPDAAccount } from './types';
-/**
- * @description Decode a base58-encoded string to raw bytes.
- * @param {string} str - Base58-encoded string
- * @returns {Uint8Array} Decoded bytes
- * @since 1.3.0
- */
-export declare function base58Decode(str: string): Uint8Array;
-/**
- * @description Encode raw bytes to a base58 string.
- * @param {Uint8Array} bytes - Raw bytes
- * @returns {string} Base58-encoded string
- * @since 1.3.0
- */
-export declare function base58Encode(bytes: Uint8Array): string;
-/**
- * @description Check whether a 32-byte hash lies on the ed25519 curve.
- * Uses Node.js `crypto.createPublicKey` to attempt point decompression.
- *
- * @param {Uint8Array} point - 32-byte candidate
- * @returns {boolean} `true` if the point is a valid ed25519 public key (on curve)
- * @since 1.3.0
- */
-export declare function isOnCurve(point: Uint8Array): boolean;
-/**
- * @description Result of a PDA derivation.
- * @since 1.3.0
- */
-export interface DerivedPDA {
-    /** PDA address (base58). */
-    address: string;
-    /** Bump seed used (255 → 0). */
-    bump: number;
-    /** Raw 32-byte PDA address. */
-    bytes: Uint8Array;
-}
-/**
- * @description Derive the agent PDA address for a given wallet public key.
- *
- * Algorithm (Solana `findProgramAddress`):
- * 1. For bump = 255 → 0:
- *    - candidate = SHA-256(seed_prefix + wallet_bytes + [bump] + program_id + "ProgramDerivedAddress")
- *    - If candidate is NOT on the ed25519 curve → return (candidate, bump)
- *
- * @param {string} walletPubkey - Agent's wallet pubkey (base58)
- * @param {string} programId - SAP program ID (base58)
- * @returns {DerivedPDA} The derived PDA address and bump seed
- * @throws {Error} If no valid PDA can be found (theoretically impossible)
- *
- * @example
- * ```ts
- * const pda = deriveAgentPDA('7xKX...wallet', 'SAPAgnt1...');
- * console.log(pda.address); // base58 PDA address
- * console.log(pda.bump);    // 254
- * ```
- *
- * @since 1.3.0
- */
-export declare function deriveAgentPDA(walletPubkey: string, programId: string): DerivedPDA;
-/**
- * @description Minimal Borsh-compatible binary reader for deserializing
- * agent PDA account data from the Solana blockchain.
- * @since 1.3.0
- */
-export declare class BorshReader {
-    private readonly data;
-    private offset;
-    /**
-     * @param {Buffer | Uint8Array} data - Raw account data bytes
-     */
-    constructor(data: Buffer | Uint8Array);
-    /** Current read position. */
-    get position(): number;
-    /** Remaining unread bytes. */
-    get remaining(): number;
-    /**
-     * @description Read a single unsigned byte.
-     * @returns {number} u8 value
-     */
-    readU8(): number;
-    /**
-     * @description Read a 32-bit unsigned integer (little-endian).
-     * @returns {number} u32 value
-     */
-    readU32(): number;
-    /**
-     * @description Read a 64-bit signed integer (little-endian) as bigint.
-     * @returns {bigint} i64 value
-     */
-    readI64(): bigint;
-    /**
-     * @description Read a 64-bit unsigned integer (little-endian) as bigint.
-     * @returns {bigint} u64 value
-     */
-    readU64(): bigint;
-    /**
-     * @description Read a fixed-length byte array.
-     * @param {number} len - Number of bytes to read
-     * @returns {Uint8Array} Raw bytes
-     */
-    readBytes(len: number): Uint8Array;
-    /**
-     * @description Read a Borsh-encoded string (u32 length prefix + UTF-8 bytes).
-     * @returns {string} Decoded string
-     */
-    readString(): string;
-    /**
-     * @description Read an optional value (1 byte flag + value if present).
-     * @param {() => T} readFn - Reader function for the inner value
-     * @returns {T | undefined}
-     */
-    readOption<T>(readFn: () => T): T | undefined;
-    /**
-     * @description Read a Borsh-encoded Vec (u32 length prefix + elements).
-     * @param {() => T} readFn - Reader function for each element
-     * @returns {T[]} Array of decoded elements
-     */
-    readVec<T>(readFn: () => T): T[];
-}
-/**
- * @description Minimal Borsh-compatible binary writer for serializing
- * instruction data to send to the SAP program.
- * @since 1.3.0
- */
-export declare class BorshWriter {
-    private buf;
-    /** Get the serialized bytes. */
-    toBytes(): Uint8Array;
-    /** @description Write a single unsigned byte. */
-    writeU8(val: number): this;
-    /** @description Write a 32-bit unsigned integer (little-endian). */
-    writeU32(val: number): this;
-    /** @description Write a 64-bit signed integer (little-endian) as bigint. */
-    writeI64(val: bigint): this;
-    /** @description Write a 64-bit unsigned integer (little-endian) as bigint. */
-    writeU64(val: bigint): this;
-    /** @description Write raw bytes. */
-    writeBytes(bytes: Uint8Array): this;
-    /** @description Write a Borsh-encoded string (u32 length + UTF-8 bytes). */
-    writeString(str: string): this;
-    /** @description Write an optional value (1-byte flag + value). */
-    writeOption<T>(val: T | undefined, writeFn: (v: T) => void): this;
-    /** @description Write a Borsh-encoded Vec (u32 length + elements). */
-    writeVec<T>(items: T[], writeFn: (v: T) => void): this;
-}
-/**
- * @description Deserialize raw account bytes into an {@link AgentPDAAccount}.
- *
- * @param {string} address - PDA address (base58)
- * @param {Buffer | Uint8Array} data - Raw account data from `getAccountInfo`
- * @returns {AgentPDAAccount} Fully deserialized agent account
- * @throws {Error} If discriminator doesn't match or data is malformed
- *
- * @example
- * ```ts
- * const raw = await transport.request('getAccountInfo', [pdaAddress, { encoding: 'base64' }]);
- * const decoded = Buffer.from(raw.value.data[0], 'base64');
- * const agent = deserializeAgentAccount(pdaAddress, decoded);
- * ```
- *
- * @since 1.3.0
- */
-export declare function deserializeAgentAccount(address: string, data: Buffer | Uint8Array): AgentPDAAccount;
-/**
- * @description Serialize agent data into instruction data for the `register` instruction.
- * Does NOT include the instruction discriminator — that is prepended by
- * {@link SAPInstructionBuilder}.
- *
- * @param {RegisterAgentParams} params - Registration parameters
- * @returns {Uint8Array} Borsh-serialized instruction data (without discriminator)
- *
- * @since 1.3.0
- */
-export declare function serializeRegisterData(params: import('./types').RegisterAgentParams): Uint8Array;
-/**
- * @description Serialize update data for the `update` instruction.
- * Uses Option encoding for each field — `None` means "don't change".
- *
- * @param {UpdateAgentParams} params - Fields to update
- * @returns {Uint8Array} Borsh-serialized instruction data (without discriminator)
- *
- * @since 1.4.0
- */
-export declare function serializeUpdateData(params: import('./types').UpdateAgentParams): Uint8Array;
-//# sourceMappingURL=pda.d.ts.map

package/dist/esm/ai/sap/pda.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pda.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/pda.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAgE,MAAM,SAAS,CAAC;AAS7G;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuBtD;AASD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAWpD;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CA2BlF;AAMD;;;;GAIG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,MAAM,CAAK;IAEnB;;OAEG;gBAC0B,IAAI,EAAE,MAAM,GAAG,UAAU;IAEtD,6BAA6B;IAC7B,IAAI,QAAQ,IAAI,MAAM,CAAwB;IAE9C,8BAA8B;IAC9B,IAAI,SAAS,IAAI,MAAM,CAA2C;IAElE;;;OAGG;IACH,MAAM,IAAI,MAAM;IAMhB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAUjB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAMjB;;;OAGG;IACH,OAAO,IAAI,MAAM;IAMjB;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAMlC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAMpB;;;;OAIG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;IAK7C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;CAMjC;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAgB;IAE3B,gCAAgC;IAChC,OAAO,IAAI,UAAU;IAIrB,iDAAiD;IACjD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3B,oCAAoC;IACpC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKnC,4EAA4E;IAC5E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO9B,kEAAkE;IAClE,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAUjE,sEAAsE;IACtE,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;CAKvD;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAyGnG;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,mBAAmB,GAAG,UAAU,CA6C/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,iBAAiB,GAAG,UAAU,CAgD3F"}