@jinn-network/client 0.1.2 → 0.1.3-canary.262e5cda

package/dist/erc8004/reputation.js

@@ -0,0 +1,464 @@
+/**
+ * ERC-8004 ReputationRegistry surface.
+ *
+ * Wraps the deployed canonical ReputationRegistry (vanity 0x8004…) for
+ * Jinn's evaluator-delivery feedback flow.
+ *
+ * Per DR §4.3 (`docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md`):
+ *
+ *   At evaluator-delivery settlement, the evaluator calls
+ *   `giveFeedback(restorerAgentId, ...)` with a body naming the specific
+ *   manifest CID / `evidenceHash` the verdict pertains to. Reputation
+ *   accrues to the operator's `agentId`; the body anchors which execution
+ *   the feedback is about.
+ *
+ * Canonical body convention (this module enforces it):
+ *
+ *   - `feedbackURI = "manifest:<cid>"`     — names the manifest being evaluated.
+ *   - `feedbackHash = manifestHash`        — bytes32 binds to a specific execution.
+ *
+ * The on-chain function signature uses `value: int128 / valueDecimals: uint8`
+ * (a signed fixed-point), not `score: uint8`. We expose a numeric-friendly
+ * `score` parameter on the higher-level surface and forward it as `value` here.
+ *
+ * Self-feedback guard: the contract reverts on self-feedback (caller cannot
+ * be the agent owner / approved / operator). For Jinn's typical deployment
+ * the evaluator is a different operator from the restorer, so this is a no-op;
+ * but in single-operator dev/test setups the same Safe may evaluate its own
+ * restoration. Callers are expected to catch the revert and log gracefully —
+ * the evaluator's `claimDelivery` is the authoritative settlement, so a failed
+ * `giveFeedback` is non-fatal.
+ *
+ * Two layers live here:
+ *
+ *   1. `ReputationRegistryClient` — the typed wire-level wrapper.
+ *   2. `submitEvaluatorFeedback` + `mapVerdictToScore` — the engine-side
+ *      hook that maps an evaluator's verdict to a score and submits feedback.
+ *
+ * ── Restorer-agentId resolution ─────────────────────────────────────────────
+ *
+ * Resolving the restorer's `agentId` from the evaluator's perspective is
+ * deferred to `resolveAgentIdForManifest` in `./identity.js`. The hook here
+ * takes `restorerAgentId` as a direct input. The two natural resolution paths:
+ *
+ *   (b) subgraph query: `Operator { agentId } where executions_some: { manifestHash: <evidenceHash> }`
+ *   (c) on-chain scan of `IdentityRegistry.Registered` events for the
+ *       restorer's Safe (`getAgentByWallet` is not exposed on-chain).
+ *
+ * Subgraph (b) is the cheapest and aligns with the rest of the discovery
+ * surface; (c) is the fallback when the subgraph is unavailable.
+ *
+ * ── Score-mapping policy ─────────────────────────────────────────────────────
+ *
+ * The portfolio.v0 evaluator emits a `verdict ∈ {PASS, FAIL, INDETERMINATE,
+ * REJECTED}` plus a numeric Calmar score (string). The reputation registry
+ * takes a signed fixed-point. The mapping policy below is intentionally
+ * conservative:
+ *
+ *   - PASS         → score = 100, scoreDecimals = 2 (= 1.00)  → submit feedback.
+ *   - FAIL         → score =   0, scoreDecimals = 2 (= 0.00)  → submit feedback.
+ *   - REJECTED     → no feedback. The restorer was not eligible to attempt
+ *                    this intent (e.g. minClosedTrades unmet); a 0-score
+ *                    feedback would unfairly tarnish their reputation for a
+ *                    structural mismatch, not a quality failure.
+ *   - INDETERMINATE → no feedback. The evaluator could not rederive
+ *                    (HL unreachable, post-snapshot funding accrual not
+ *                    settled). Not a verdict on the restorer.
+ *
+ * If the impl emits a numeric score in `[0, 1]` separate from verdict, the
+ * caller should pre-multiply it by 100 and pass `scoreDecimals=2`.
+ *
+ * Address constants (cross-checked against `subgraph/networks.json` and
+ * `client/src/earning/contracts.ts` IdentityRegistry entries):
+ *
+ *   Base mainnet  0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
+ *   Base Sepolia  0x8004B663056A597Dffe9eCcC1965A193B7388713
+ *   Ethereum      0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
+ *   Sepolia       0x8004B663056A597Dffe9eCcC1965A193B7388713
+ */
+import { encodeFunctionData, } from 'viem';
+import { executeSafeTransaction } from '../adapters/mech/safe.js';
+import { waitForTransactionReceiptWithRetry } from '../tx-retry.js';
+import { REPUTATION_REGISTRY_ABI } from './abis.js';
+import { REPUTATION_REGISTRY_ADDRESSES, getReputationRegistryAddress, } from './addresses.js';
+// Re-exports so callers that imported these directly from the reputation
+// module continue to work without touching `./abis.js` / `./addresses.js`.
+export { REPUTATION_REGISTRY_ABI, REPUTATION_REGISTRY_ADDRESSES, getReputationRegistryAddress, };
+// ── Helpers ─────────────────────────────────────────────────────────────────
+const ZERO_HASH = '0x0000000000000000000000000000000000000000000000000000000000000000';
+function toInt128(value) {
+    const v = typeof value === 'bigint' ? value : BigInt(Math.trunc(value));
+    // `int128` range: [-2^127, 2^127-1]. The contract additionally bounds
+    // |value| <= 1e38 (well inside int128). We don't enforce 1e38 here — the
+    // contract reverts on overflow with "value too large" and the caller can
+    // handle that uniformly with other reverts.
+    return v;
+}
+// ── ReputationRegistryClient ────────────────────────────────────────────────
+export class ReputationRegistryClient {
+    publicClient;
+    walletClient;
+    contractAddress;
+    safeAddress;
+    constructor(config) {
+        this.publicClient = config.publicClient;
+        this.walletClient = config.walletClient;
+        this.contractAddress = config.reputationRegistryAddress;
+        this.safeAddress = config.safeAddress;
+    }
+    // ── Write paths ──────────────────────────────────────────────────────────
+    /**
+     * Submit feedback on a restorer's agent NFT. The body identifies the
+     * manifest being evaluated via `feedbackURI = "manifest:<cid>"` and
+     * `feedbackHash = manifestHash` (the evidenceHash committed in
+     * `claimDelivery`).
+     *
+     * Reverts (caught upstream and logged):
+     *   - "Self-feedback not allowed" — caller is owner/approved/operator of agentId.
+     *   - "ERC721NonexistentToken"   — agentId does not exist.
+     *   - "value too large"          — |score| > 1e38.
+     *   - "too many decimals"        — scoreDecimals > 18.
+     */
+    async giveFeedback(args) {
+        if (!this.walletClient) {
+            throw new Error('giveFeedback: walletClient required for write operations');
+        }
+        const value = toInt128(args.score);
+        const calldata = encodeFunctionData({
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'giveFeedback',
+            args: [
+                args.restorerAgentId,
+                value,
+                args.scoreDecimals,
+                args.tag1 ?? '',
+                args.tag2 ?? '',
+                args.endpoint ?? '',
+                args.manifestRef,
+                args.manifestHash,
+            ],
+        });
+        return this.sendWrite(calldata);
+    }
+    /**
+     * Operator-facing: respond to a feedback on your own agent NFT.
+     * `msg.sender` becomes the responder; any address may call (the contract
+     * does not gate by ownership — multiple parties can append responses).
+     */
+    async respondToFeedback(args) {
+        if (!this.walletClient) {
+            throw new Error('respondToFeedback: walletClient required for write operations');
+        }
+        const calldata = encodeFunctionData({
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'appendResponse',
+            args: [
+                args.feedbackId.agentId,
+                args.feedbackId.client,
+                args.feedbackId.feedbackIndex,
+                args.responseURI,
+                args.responseHash,
+            ],
+        });
+        return this.sendWrite(calldata);
+    }
+    /**
+     * Revoke previously-given feedback. The contract only allows the original
+     * caller (`msg.sender` on the original `giveFeedback`) to revoke; mirrored
+     * here by the routing decision in `sendWrite` (Safe vs EOA).
+     */
+    async revokeFeedback(args) {
+        if (!this.walletClient) {
+            throw new Error('revokeFeedback: walletClient required for write operations');
+        }
+        const calldata = encodeFunctionData({
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'revokeFeedback',
+            args: [args.agentId, args.feedbackIndex],
+        });
+        return this.sendWrite(calldata);
+    }
+    // ── Read paths ───────────────────────────────────────────────────────────
+    async readFeedback(args) {
+        try {
+            const result = (await this.publicClient.readContract({
+                address: this.contractAddress,
+                abi: REPUTATION_REGISTRY_ABI,
+                functionName: 'readFeedback',
+                args: [args.agentId, args.clientAddress, args.feedbackIndex],
+            }));
+            const [value, valueDecimals, tag1, tag2, isRevoked] = result;
+            return {
+                agentId: args.agentId,
+                client: args.clientAddress,
+                feedbackIndex: args.feedbackIndex,
+                score: value,
+                scoreDecimals: valueDecimals,
+                tag1: tag1 || undefined,
+                tag2: tag2 || undefined,
+                revoked: isRevoked,
+            };
+        }
+        catch (err) {
+            // The contract reverts with "index out of bounds" / "index must be > 0"
+            // when the row does not exist; surface as null rather than throwing.
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('out of bounds') || msg.includes('index must be > 0')) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Read all feedback for an agentId. By default, queries every known client
+     * (the contract walks `_clients[agentId]` when `clientAddresses=[]` is
+     * passed — confirmed in the .sol, line ~268). Pass an explicit
+     * `clientAddresses` filter to narrow.
+     */
+    async readAllFeedback(agentId, opts = {}) {
+        const result = (await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'readAllFeedback',
+            args: [
+                agentId,
+                opts.clientAddresses ?? [],
+                opts.tag1Filter ?? '',
+                opts.tag2Filter ?? '',
+                opts.includeRevoked ?? false,
+            ],
+        }));
+        const [clients, feedbackIndexes, values, valueDecimals, tag1s, tag2s, revokedStatuses] = result;
+        const records = [];
+        for (let i = 0; i < clients.length; i++) {
+            records.push({
+                agentId,
+                client: clients[i],
+                feedbackIndex: feedbackIndexes[i],
+                score: values[i],
+                scoreDecimals: valueDecimals[i],
+                tag1: tag1s[i] || undefined,
+                tag2: tag2s[i] || undefined,
+                revoked: revokedStatuses[i],
+            });
+        }
+        return records;
+    }
+    /**
+     * Compute a summary across the supplied client addresses (or fail loudly —
+     * the on-chain `getSummary` reverts when called with an empty list, by
+     * design, to force callers to be explicit about which feedback sources
+     * they trust).
+     *
+     * Pass the result of `getClients(agentId)` to get a "summary across all
+     * known clients" — Jinn's typical surface.
+     */
+    async getSummary(agentId, opts) {
+        if (opts.clientAddresses.length === 0) {
+            throw new Error('getSummary: clientAddresses must be non-empty (contract reverts otherwise)');
+        }
+        const result = (await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'getSummary',
+            args: [agentId, opts.clientAddresses, opts.tag1Filter ?? '', opts.tag2Filter ?? ''],
+        }));
+        const [count, summaryValue, summaryValueDecimals] = result;
+        return { count, summaryValue, summaryValueDecimals };
+    }
+    /** All addresses that have ever submitted feedback for this agentId. */
+    async getClients(agentId) {
+        const result = (await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'getClients',
+            args: [agentId],
+        }));
+        return [...result];
+    }
+    /** Latest feedback index this client has submitted for `agentId`, or 0. */
+    async getLastIndex(agentId, clientAddress) {
+        const result = (await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: REPUTATION_REGISTRY_ABI,
+            functionName: 'getLastIndex',
+            args: [agentId, clientAddress],
+        }));
+        // result is uint64; widening to bigint is safe.
+        return result;
+    }
+    // ── Internal ─────────────────────────────────────────────────────────────
+    /**
+     * Send a write tx, routing through the Safe when configured.
+     *
+     * Mirrors `ClaimRegistryClient` and `mech/contracts.ts`: production calls
+     * route through the Safe so `msg.sender` is the operator's canonical
+     * identity (matching the OLAS staking + 8004 IdentityRegistry agent NFT
+     * binding). Tests and one-off scripts can omit `safeAddress` and write
+     * directly from the EOA.
+     *
+     * `_unused` is reserved for value-bearing writes if any are added later;
+     * none of the Reputation surfaces are payable, so we always send 0.
+     */
+    async sendWrite(calldata) {
+        const walletClient = this.walletClient;
+        if (this.safeAddress) {
+            return executeSafeTransaction(this.publicClient, walletClient, {
+                safeAddress: this.safeAddress,
+                to: this.contractAddress,
+                value: 0n,
+                data: calldata,
+            });
+        }
+        const account = walletClient.account;
+        if (!account) {
+            throw new Error('sendWrite: walletClient has no account (and no safeAddress configured)');
+        }
+        // Direct EOA path — used by tests and ad-hoc scripts. Production wires
+        // safeAddress so this branch is rarely hit on real chains.
+        const txHash = await walletClient.sendTransaction({
+            account,
+            to: this.contractAddress,
+            data: calldata,
+            value: 0n,
+            // viem requires the chain to be specified; we resolve it from the
+            // public client's configured chain to avoid double-config drift.
+            chain: walletClient.chain ?? null,
+        });
+        await waitForTransactionReceiptWithRetry(this.publicClient, txHash);
+        return txHash;
+    }
+}
+// Re-export ZERO_HASH for callers that need a sentinel filehash. Marked
+// `as const` is unnecessary — the type is already a literal Hex.
+export { ZERO_HASH };
+/**
+ * Pure function: map a verdict to (score, scoreDecimals). Returns `null` for
+ * verdicts that should not produce on-chain feedback (REJECTED, INDETERMINATE)
+ * — see policy comment at the top of the module.
+ *
+ * Exported so tests pin the policy directly.
+ */
+export function mapVerdictToScore(verdict) {
+    switch (verdict) {
+        case 'PASS':
+            // 1.00 — full pass.
+            return { score: 100, scoreDecimals: 2 };
+        case 'FAIL':
+            // 0.00 — quality failure; tarnishes the operator's reputation.
+            return { score: 0, scoreDecimals: 2 };
+        case 'REJECTED':
+        case 'INDETERMINATE':
+            // No feedback — see top-of-module policy comment.
+            return null;
+        default: {
+            // Defensive: unrecognised verdict → no feedback. Future verdicts that
+            // should emit feedback need an explicit case here; defaulting to "no
+            // feedback" is the safe path so we never silently apply a wrong score.
+            const exhaustive = verdict;
+            void exhaustive;
+            return null;
+        }
+    }
+}
+/**
+ * Submit feedback on the restorer's agent NFT. The body is the canonical
+ * `manifest:<cid>` URI + `evidenceHash` — the subgraph parses these to
+ * synthesize an `Execution` row joined to the operator.
+ *
+ * Errors are caught and returned as `{ kind: 'failed', ... }` — callers
+ * (the engine's deliver path) should log the outcome but never let it
+ * propagate. The on-chain `claimDelivery` already settled.
+ *
+ * Self-feedback (caller is owner/approved/operator of `restorerAgentId`)
+ * reverts on chain with a known string; we surface that as a graceful
+ * `{ kind: 'skipped', reason: 'self-feedback' }`.
+ */
+export async function submitEvaluatorFeedback(args) {
+    const { registry, ref, verdict } = args;
+    const log = args.log ?? defaultLog;
+    const mapped = mapVerdictToScore(verdict.verdict);
+    if (!mapped) {
+        log({
+            level: 'info',
+            msg: `[reputation] skipping giveFeedback for verdict=${verdict.verdict} (policy: no on-chain feedback)`,
+            data: { restorerAgentId: ref.restorerAgentId.toString(), verdict: verdict.verdict },
+        });
+        return { kind: 'skipped', reason: 'verdict-not-eligible' };
+    }
+    const giveArgs = {
+        restorerAgentId: ref.restorerAgentId,
+        score: mapped.score,
+        scoreDecimals: mapped.scoreDecimals,
+        manifestRef: `manifest:${ref.restorerManifestCid}`,
+        manifestHash: ref.restorerEvidenceHash,
+        ...(verdict.kind ? { tag1: verdict.kind } : {}),
+        ...(verdict.tag2 ? { tag2: verdict.tag2 } : {}),
+    };
+    try {
+        const txHash = await registry.giveFeedback(giveArgs);
+        log({
+            level: 'info',
+            msg: '[reputation] giveFeedback submitted',
+            data: {
+                restorerAgentId: ref.restorerAgentId.toString(),
+                verdict: verdict.verdict,
+                score: mapped.score,
+                scoreDecimals: mapped.scoreDecimals,
+                manifestCid: ref.restorerManifestCid,
+                txHash,
+            },
+        });
+        return { kind: 'submitted', txHash };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // Self-feedback guard: contract reverts with "Self-feedback not allowed"
+        // when the evaluator EOA/Safe is the owner/approved/operator of the
+        // restorer's agentId. This is structurally possible in single-operator
+        // dev setups; treat as a graceful skip.
+        if (msg.includes('Self-feedback not allowed')) {
+            log({
+                level: 'warn',
+                msg: '[reputation] giveFeedback skipped: evaluator is the restorer (self-feedback guard)',
+                data: { restorerAgentId: ref.restorerAgentId.toString() },
+            });
+            return { kind: 'skipped', reason: 'self-feedback' };
+        }
+        // Agent doesn't exist on chain. The contract reverts with the canonical
+        // ERC-721 error; surface as a graceful skip — the restorer hasn't yet
+        // minted (or we're querying the wrong chain).
+        if (msg.includes('ERC721NonexistentToken') || msg.includes('nonexistent')) {
+            log({
+                level: 'warn',
+                msg: '[reputation] giveFeedback skipped: restorer agentId not minted',
+                data: { restorerAgentId: ref.restorerAgentId.toString() },
+            });
+            return { kind: 'skipped', reason: 'agent-not-found' };
+        }
+        // Anything else: log warn (NOT error — the evaluator's claimDelivery
+        // already landed), surface as `failed` for tests/observability.
+        log({
+            level: 'warn',
+            msg: '[reputation] giveFeedback failed (non-fatal); claimDelivery already authoritative',
+            data: {
+                restorerAgentId: ref.restorerAgentId.toString(),
+                error: msg,
+            },
+        });
+        return { kind: 'failed', error: msg };
+    }
+}
+// ── Local helpers ───────────────────────────────────────────────────────────
+function defaultLog(entry) {
+    if (entry.level === 'error') {
+        console.error(entry.msg, entry.data ?? '');
+    }
+    else if (entry.level === 'warn') {
+        console.warn(entry.msg, entry.data ?? '');
+    }
+    else {
+        console.log(entry.msg, entry.data ?? '');
+    }
+}
+//# sourceMappingURL=reputation.js.map

package/dist/erc8004/reputation.js.map

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

package/dist/erc8004/subgraph.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Subgraph client — stub.
+ *
+ * The real Jinn-specific subgraph (operator-rooted ERC-8004, synthesized
+ * `Operator`/`Execution` entities) is rebuilt under bead `jinn-mono-fud` per
+ * docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md. The
+ * previous V1 schema (`Intent`, `ExecutionEnvelope`, `SourceBundle`,
+ * `Artifact`, `KnowledgeTree`, etc.) was a category error against the deployed
+ * `0x8004…` registries — see the design record §2.
+ *
+ * This stub keeps the surface that `daemon.ts` calls during peer-discovery /
+ * remote-artifact backfill so the daemon compiles and runs without ERC-8004
+ * registration. All queries return empty results until the new subgraph
+ * lands. No new ABIs are introduced here.
+ */
+export interface SubgraphConfig {
+    url: string;
+}
+export interface SubgraphResult {
+    id: string;
+    agentURI: string;
+    owner: string;
+    metadata: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * Parse a metadata value from a SubgraphResult by key. Retained for
+ * backward compatibility with daemon.ts.
+ */
+export declare function getMetadataValue(result: SubgraphResult, key: string): string | undefined;
+/**
+ * Stubbed artifact discovery query. Returns no rows until the rebuilt
+ * Jinn subgraph (jinn-mono-fud) ships.
+ */
+export declare function queryArtifacts(_config: SubgraphConfig, _filters?: {
+    outcome?: string;
+    owner?: string;
+    limit?: number;
+}): Promise<SubgraphResult[]>;
+/**
+ * Stubbed peer-node discovery query. Returns no rows until the rebuilt
+ * Jinn subgraph (jinn-mono-fud) ships.
+ */
+export declare function queryNodes(_config: SubgraphConfig, _limit?: number): Promise<SubgraphResult[]>;

package/dist/erc8004/subgraph.js

@@ -0,0 +1,37 @@
+/**
+ * Subgraph client — stub.
+ *
+ * The real Jinn-specific subgraph (operator-rooted ERC-8004, synthesized
+ * `Operator`/`Execution` entities) is rebuilt under bead `jinn-mono-fud` per
+ * docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md. The
+ * previous V1 schema (`Intent`, `ExecutionEnvelope`, `SourceBundle`,
+ * `Artifact`, `KnowledgeTree`, etc.) was a category error against the deployed
+ * `0x8004…` registries — see the design record §2.
+ *
+ * This stub keeps the surface that `daemon.ts` calls during peer-discovery /
+ * remote-artifact backfill so the daemon compiles and runs without ERC-8004
+ * registration. All queries return empty results until the new subgraph
+ * lands. No new ABIs are introduced here.
+ */
+/**
+ * Parse a metadata value from a SubgraphResult by key. Retained for
+ * backward compatibility with daemon.ts.
+ */
+export function getMetadataValue(result, key) {
+    return result.metadata.find((m) => m.key === key)?.value;
+}
+/**
+ * Stubbed artifact discovery query. Returns no rows until the rebuilt
+ * Jinn subgraph (jinn-mono-fud) ships.
+ */
+export async function queryArtifacts(_config, _filters) {
+    return [];
+}
+/**
+ * Stubbed peer-node discovery query. Returns no rows until the rebuilt
+ * Jinn subgraph (jinn-mono-fud) ships.
+ */
+export async function queryNodes(_config, _limit) {
+    return [];
+}
+//# sourceMappingURL=subgraph.js.map

package/dist/erc8004/subgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.js","sourceRoot":"","sources":["../../src/erc8004/subgraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB,EAAE,GAAW;IAClE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,QAA+D;IAE/D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAuB,EACvB,MAAe;IAEf,OAAO,EAAE,CAAC;AACZ,CAAC"}