@q00bs/agent-sdk 1.0.0

package/dist/erc8004.js

@@ -0,0 +1,824 @@
+"use strict";
+/**
+ * @q00bs/agent-sdk — ERC-8004 Trustless Agents Manager
+ *
+ * This module integrates the ERC-8004 standard (Trustless Agents) into the
+ * Q00bs agent platform. ERC-8004 defines three on-chain registries that give
+ * agents interoperable identity, reputation, and validation across the
+ * broader ecosystem — not just within Q00bs.
+ *
+ * WHY ERC-8004?
+ *   Q00bs agents already have identity via AgentRegistry (ERC-721) and trust
+ *   via the q00b graph. ERC-8004 adds a PORTABLE layer:
+ *     - Identity that other agent platforms can read and verify
+ *     - Reputation that follows an agent across ecosystems
+ *     - Validation from third-party auditors (compliance, capabilities)
+ *
+ *   Base is already implementing ERC-8004, making it the canonical standard
+ *   for agent identity on L2. Integrating now gives Q00bs agents first-mover
+ *   advantage in the interoperable agent economy.
+ *
+ * ARCHITECTURE:
+ *   ┌──────────────────┐     ┌────────────────────────────────────┐
+ *   │  Q00bs            │     │  ERC-8004 Registries (Base)         │
+ *   │  AgentRegistry    │────▶│  IdentityRegistry (0x8004...432)   │
+ *   │  (your agents)    │     │  ReputationRegistry (0x8004...b63) │
+ *   │                   │     │  ValidationRegistry (TBD)           │
+ *   └──────────────────┘     └────────────────────────────────────┘
+ *
+ *   Q00bs agents register in BOTH registries:
+ *     1. AgentRegistry (Q00bs-specific: trust scores, q00b graph, escrow)
+ *     2. ERC-8004 IdentityRegistry (ecosystem-wide: portable identity)
+ *
+ *   The ERC-8004 identity links back to the Q00bs agent via:
+ *     - agentWallet (same wallet address)
+ *     - agentURI (points to registration file with Q00bs metadata)
+ *     - Metadata keys (e.g. "q00bs_agent_id", "q00bs_trust_score")
+ *
+ * THREE REGISTRIES:
+ *
+ *   1. IDENTITY REGISTRY (ERC-721)
+ *      - Mint agent identity NFTs
+ *      - Set agentURI (registration file)
+ *      - Bind agent wallet with EIP-712/ERC-1271 proof
+ *      - Store extensible key-value metadata
+ *
+ *   2. REPUTATION REGISTRY
+ *      - Give signed fixed-point feedback to other agents
+ *      - Read aggregate reputation summaries
+ *      - Respond to feedback received
+ *      - Self-feedback is prevented on-chain
+ *
+ *   3. VALIDATION REGISTRY (evolving)
+ *      - Request validation from third-party validators
+ *      - Read validation results and summaries
+ *
+ * REFERENCE: https://www.8004.org/build
+ *
+ * USAGE:
+ *   ```ts
+ *   const manager = new ERC8004Manager(publicClient, walletClient, logger);
+ *
+ *   // Register an ERC-8004 identity
+ *   const identity = await manager.registerIdentity('0xOwnerAddress');
+ *
+ *   // Set the agent URI
+ *   await manager.setAgentURI(identity.agentId, 'https://q00bs.com/agents/42.json');
+ *
+ *   // Give feedback to another agent
+ *   await manager.giveFeedback({
+ *     subjectAgentId: 7,
+ *     value: 4.5,
+ *     decimals: 2,
+ *   }, myAgentId);
+ *
+ *   // Read reputation
+ *   const summary = await manager.getReputationSummary(7);
+ *   console.log(`Average: ${summary.average}`);
+ *   ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERC8004Manager = void 0;
+const ERC8004Identity_1 = require("./abis/ERC8004Identity");
+const ERC8004Reputation_1 = require("./abis/ERC8004Reputation");
+const ERC8004Validation_1 = require("./abis/ERC8004Validation");
+const errors_1 = require("./errors");
+const constants_1 = require("./constants");
+// ─────────────────────────────────────────────────────────────
+// ERC-8004 MANAGER
+// ─────────────────────────────────────────────────────────────
+class ERC8004Manager {
+    publicClient;
+    walletClient;
+    logger;
+    // Registry addresses
+    identityRegistry;
+    reputationRegistry;
+    validationRegistry;
+    // Cached ERC-8004 identity for this agent
+    _erc8004AgentId;
+    /** The agent's ERC-8004 agentId (if registered). */
+    get erc8004AgentId() {
+        return this._erc8004AgentId;
+    }
+    /** The IdentityRegistry address being used. */
+    get identityRegistryAddress() {
+        return this.identityRegistry;
+    }
+    /** The ReputationRegistry address being used. */
+    get reputationRegistryAddress() {
+        return this.reputationRegistry;
+    }
+    constructor(publicClient, logger, walletClient, config) {
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.logger = logger;
+        // Use configured addresses or canonical Base mainnet defaults
+        this.identityRegistry = (config?.identityRegistryAddress || constants_1.ERC8004_IDENTITY_REGISTRY_ADDRESS);
+        this.reputationRegistry = (config?.reputationRegistryAddress || constants_1.ERC8004_REPUTATION_REGISTRY_ADDRESS);
+        this.validationRegistry = (config?.validationRegistryAddress || constants_1.ERC8004_VALIDATION_REGISTRY_ADDRESS);
+        this.logger.info(`ERC-8004 Manager initialized | Identity: ${this.identityRegistry} | Reputation: ${this.reputationRegistry}`);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // IDENTITY REGISTRY
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Register a new ERC-8004 agent identity.
+     *
+     * Mints an ERC-721 token in the IdentityRegistry. The tokenId becomes
+     * the agent's ERC-8004 agentId.
+     *
+     * @param ownerAddress - Address to mint the identity NFT to.
+     * @returns The new ERC-8004 identity.
+     * @throws ERC8004RegistryError if the transaction fails.
+     *
+     * @example
+     * ```ts
+     * const identity = await erc8004.registerIdentity('0xYourAddress');
+     * console.log(`ERC-8004 ID: ${identity.agentId}`);
+     * console.log(`Identifier: ${identity.identifier}`);
+     * ```
+     */
+    async registerIdentity(ownerAddress) {
+        this.ensureWalletClient();
+        this.logger.info(`Registering ERC-8004 identity for ${ownerAddress}...`);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'register',
+                args: [ownerAddress],
+            });
+            const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`ERC-8004 registration tx confirmed in block ${receipt.blockNumber}`);
+            // Parse agentId from Transfer event (ERC-721 mint: from=0x0, to=owner)
+            let agentId;
+            for (const log of receipt.logs) {
+                if (log.address?.toLowerCase() === this.identityRegistry.toLowerCase() &&
+                    log.topics &&
+                    log.topics.length >= 4) {
+                    // Transfer event: topics[3] is the tokenId
+                    agentId = Number(BigInt(log.topics[3]));
+                    if (agentId > 0)
+                        break;
+                }
+            }
+            if (!agentId) {
+                // Fallback: try to find from AgentRegistered event
+                for (const log of receipt.logs) {
+                    if (log.topics && log.topics.length >= 3) {
+                        const possibleId = Number(BigInt(log.topics[2]));
+                        if (possibleId > 0) {
+                            agentId = possibleId;
+                            break;
+                        }
+                    }
+                }
+            }
+            if (!agentId) {
+                throw new errors_1.ERC8004Error('Registration succeeded but could not determine ERC-8004 agentId');
+            }
+            this._erc8004AgentId = agentId;
+            const identifier = this.buildIdentifier(agentId);
+            this.logger.info(`ERC-8004 identity registered: ${identifier} (agentId: ${agentId})`);
+            return {
+                agentId,
+                owner: ownerAddress,
+                agentURI: '',
+                agentWallet: '',
+                identifier,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ERC8004Error)
+                throw error;
+            throw new errors_1.ERC8004RegistryError(this.identityRegistry, 'register', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get an ERC-8004 identity by agentId.
+     *
+     * @param agentId - The ERC-8004 agentId (tokenId).
+     * @returns The identity, or null if not found.
+     */
+    async getIdentity(agentId) {
+        try {
+            // Get owner
+            const owner = await this.publicClient.readContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'ownerOf',
+                args: [BigInt(agentId)],
+            });
+            if (!owner || owner === '0x0000000000000000000000000000000000000000') {
+                return null;
+            }
+            // Get agentURI and agentWallet in parallel
+            const [agentURI, agentWallet] = await Promise.all([
+                this.publicClient.readContract({
+                    address: this.identityRegistry,
+                    abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                    functionName: 'tokenURI',
+                    args: [BigInt(agentId)],
+                }).catch(() => ''),
+                this.publicClient.readContract({
+                    address: this.identityRegistry,
+                    abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                    functionName: 'getAgentWallet',
+                    args: [BigInt(agentId)],
+                }).catch(() => '0x0000000000000000000000000000000000000000'),
+            ]);
+            return {
+                agentId,
+                owner,
+                agentURI,
+                agentWallet,
+                identifier: this.buildIdentifier(agentId),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Set the agentURI (tokenURI) for an ERC-8004 identity.
+     *
+     * The agentURI should point to a JSON file describing the agent
+     * (name, capabilities, endpoints, etc.).
+     *
+     * @param agentId - The ERC-8004 agentId.
+     * @param uri - The URI to set (IPFS, HTTPS, etc.).
+     *
+     * @example
+     * ```ts
+     * await erc8004.setAgentURI(42, 'ipfs://Qm.../agent.json');
+     * ```
+     */
+    async setAgentURI(agentId, uri) {
+        this.ensureWalletClient();
+        this.logger.info(`Setting agentURI for ERC-8004 agent ${agentId}: ${uri}`);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'setAgentURI',
+                args: [BigInt(agentId), uri],
+            });
+            await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`AgentURI set for agent ${agentId}`);
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.identityRegistry, 'setAgentURI', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get metadata for an ERC-8004 identity.
+     *
+     * @param agentId - The ERC-8004 agentId.
+     * @param key - The metadata key to read.
+     * @returns The metadata value (empty string if not set).
+     */
+    async getMetadata(agentId, key) {
+        try {
+            return await this.publicClient.readContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'getMetadata',
+                args: [BigInt(agentId), key],
+            });
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Set metadata on an ERC-8004 identity.
+     *
+     * Use this to store Q00bs-specific data on the ERC-8004 identity,
+     * making it discoverable by other platforms.
+     *
+     * @param agentId - The ERC-8004 agentId.
+     * @param key - The metadata key (cannot be "agentWallet" — use setAgentWallet).
+     * @param value - The metadata value.
+     *
+     * @example
+     * ```ts
+     * await erc8004.setMetadata(42, 'q00bs_agent_id', '7');
+     * await erc8004.setMetadata(42, 'q00bs_trust_score', '8500');
+     * await erc8004.setMetadata(42, 'capabilities', 'data_analysis,web_scraping');
+     * ```
+     */
+    async setMetadata(agentId, key, value) {
+        this.ensureWalletClient();
+        if (key === 'agentWallet') {
+            throw new errors_1.ERC8004Error('The "agentWallet" metadata key is reserved. Use setAgentWallet() instead.');
+        }
+        this.logger.info(`Setting metadata for ERC-8004 agent ${agentId}: ${key}=${value}`);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'setMetadata',
+                args: [BigInt(agentId), key, value],
+            });
+            await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`Metadata set for agent ${agentId}: ${key}`);
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.identityRegistry, 'setMetadata', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the agent wallet address for an ERC-8004 identity.
+     *
+     * @param agentId - The ERC-8004 agentId.
+     * @returns The wallet address, or null if not set.
+     */
+    async getAgentWallet(agentId) {
+        try {
+            const wallet = await this.publicClient.readContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'getAgentWallet',
+                args: [BigInt(agentId)],
+            });
+            if (wallet === '0x0000000000000000000000000000000000000000') {
+                return null;
+            }
+            return wallet;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Set the agent wallet for an ERC-8004 identity with EIP-712/ERC-1271 proof.
+     *
+     * The proof ensures the wallet owner has consented to being linked
+     * to this identity. In practice, this means the agent wallet signs
+     * a typed-data message proving ownership.
+     *
+     * @param agentId - The ERC-8004 agentId.
+     * @param wallet - The wallet address to bind.
+     * @param proof - The EIP-712 or ERC-1271 proof bytes.
+     */
+    async setAgentWallet(agentId, wallet, proof) {
+        this.ensureWalletClient();
+        this.logger.info(`Setting agentWallet for ERC-8004 agent ${agentId}: ${wallet}`);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'setAgentWallet',
+                args: [BigInt(agentId), wallet, proof],
+            });
+            await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`AgentWallet set for agent ${agentId}: ${wallet}`);
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.identityRegistry, 'setAgentWallet', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the total number of ERC-8004 identities registered.
+     */
+    async getIdentityCount() {
+        try {
+            const total = await this.publicClient.readContract({
+                address: this.identityRegistry,
+                abi: ERC8004Identity_1.ERC8004_IDENTITY_ABI,
+                functionName: 'totalSupply',
+            });
+            return Number(total);
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // REPUTATION REGISTRY
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Give feedback to another agent via the ERC-8004 ReputationRegistry.
+     *
+     * Feedback is a signed fixed-point number (e.g. 4.5 → value=450, decimals=2).
+     * Self-feedback is prevented at the contract level.
+     *
+     * @param params - Feedback parameters (subject, value, decimals).
+     * @param fromAgentId - The ERC-8004 agentId of the feedback giver (your agent).
+     * @param fromIdentityRegistry - Override sender's identity registry (default: this one).
+     * @returns The feedback index.
+     *
+     * @example
+     * ```ts
+     * const index = await erc8004.giveFeedback({
+     *   subjectAgentId: 7,
+     *   value: 4.5,
+     *   decimals: 2,
+     * }, myERC8004AgentId);
+     * ```
+     */
+    async giveFeedback(params, fromAgentId, fromIdentityRegistry) {
+        this.ensureWalletClient();
+        // Prevent self-feedback at SDK level
+        if (params.subjectAgentId === fromAgentId &&
+            (!params.subjectIdentityRegistry ||
+                params.subjectIdentityRegistry.toLowerCase() === this.identityRegistry.toLowerCase())) {
+            throw new errors_1.ERC8004SelfFeedbackError();
+        }
+        const decimals = params.decimals ?? 2;
+        const scaledValue = Math.round(params.value * Math.pow(10, decimals));
+        this.logger.info(`Giving feedback: agent ${fromAgentId} → agent ${params.subjectAgentId} ` +
+            `(value: ${params.value}, scaled: ${scaledValue}, decimals: ${decimals})`);
+        const subjectRegistry = (params.subjectIdentityRegistry || this.identityRegistry);
+        const senderRegistry = (fromIdentityRegistry || this.identityRegistry);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'giveFeedback',
+                args: [
+                    subjectRegistry,
+                    BigInt(params.subjectAgentId),
+                    senderRegistry,
+                    BigInt(fromAgentId),
+                    BigInt(scaledValue),
+                    decimals,
+                ],
+            });
+            const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`Feedback given in block ${receipt.blockNumber}`);
+            // Parse feedback index from FeedbackGiven event
+            for (const log of receipt.logs) {
+                if (log.address?.toLowerCase() === this.reputationRegistry.toLowerCase()) {
+                    // Try to get feedbackIndex from event data
+                    if (log.data && log.data.length > 2) {
+                        // feedbackIndex is typically the last uint256 in the event data
+                        const dataHex = log.data.slice(2); // remove 0x prefix
+                        // Each uint256 is 64 hex chars; feedbackIndex is the last one
+                        if (dataHex.length >= 64) {
+                            const lastWord = dataHex.slice(-64);
+                            return Number(BigInt('0x' + lastWord));
+                        }
+                    }
+                }
+            }
+            // Fallback: use getLastIndex
+            return await this.getLastFeedbackIndex(params.subjectAgentId, subjectRegistry);
+        }
+        catch (error) {
+            if (error instanceof errors_1.ERC8004SelfFeedbackError)
+                throw error;
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'giveFeedback', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Revoke previously given feedback.
+     *
+     * @param subjectAgentId - The agent that received the feedback.
+     * @param fromAgentId - Your agent's ERC-8004 ID.
+     * @param feedbackIndex - The index of the feedback to revoke.
+     * @param subjectIdentityRegistry - Override subject's registry.
+     * @param fromIdentityRegistry - Override sender's registry.
+     */
+    async revokeFeedback(subjectAgentId, fromAgentId, feedbackIndex, subjectIdentityRegistry, fromIdentityRegistry) {
+        this.ensureWalletClient();
+        this.logger.info(`Revoking feedback index ${feedbackIndex} on agent ${subjectAgentId}`);
+        const subjectRegistry = (subjectIdentityRegistry || this.identityRegistry);
+        const senderRegistry = (fromIdentityRegistry || this.identityRegistry);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'revokeFeedback',
+                args: [
+                    subjectRegistry,
+                    BigInt(subjectAgentId),
+                    senderRegistry,
+                    BigInt(fromAgentId),
+                    BigInt(feedbackIndex),
+                ],
+            });
+            await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`Feedback ${feedbackIndex} revoked for agent ${subjectAgentId}`);
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'revokeFeedback', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Append a response to feedback your agent received.
+     *
+     * @param agentId - Your agent's ERC-8004 ID.
+     * @param fromAgentId - The feedback giver's ERC-8004 ID.
+     * @param feedbackIndex - The index of the feedback to respond to.
+     * @param response - The response text.
+     * @param fromIdentityRegistry - Override feedback giver's registry.
+     */
+    async respondToFeedback(agentId, fromAgentId, feedbackIndex, response, fromIdentityRegistry) {
+        this.ensureWalletClient();
+        this.logger.info(`Responding to feedback ${feedbackIndex} on agent ${agentId}`);
+        const senderRegistry = (fromIdentityRegistry || this.identityRegistry);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'appendResponse',
+                args: [
+                    this.identityRegistry,
+                    BigInt(agentId),
+                    senderRegistry,
+                    BigInt(fromAgentId),
+                    BigInt(feedbackIndex),
+                    response,
+                ],
+            });
+            await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`Response appended to feedback ${feedbackIndex}`);
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'appendResponse', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Read a specific feedback entry.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @param index - The feedback index.
+     * @param identityRegistry - Override identity registry.
+     * @returns The feedback entry.
+     */
+    async readFeedback(agentId, index, identityRegistry) {
+        const registry = (identityRegistry || this.identityRegistry);
+        try {
+            const raw = await this.publicClient.readContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'readFeedback',
+                args: [registry, BigInt(agentId), BigInt(index)],
+            });
+            return {
+                fromIdentityRegistry: raw.fromIdentityRegistry,
+                fromAgentId: Number(raw.fromAgentId),
+                value: Number(raw.value),
+                valueDecimals: Number(raw.valueDecimals),
+                timestamp: Number(raw.timestamp),
+                revoked: raw.revoked,
+                response: raw.response,
+            };
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'readFeedback', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Read all feedback entries for an agent.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @param identityRegistry - Override identity registry.
+     * @returns Array of all feedback entries.
+     */
+    async readAllFeedback(agentId, identityRegistry) {
+        const registry = (identityRegistry || this.identityRegistry);
+        try {
+            const rawArray = await this.publicClient.readContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'readAllFeedback',
+                args: [registry, BigInt(agentId)],
+            });
+            return rawArray.map((raw) => ({
+                fromIdentityRegistry: raw.fromIdentityRegistry,
+                fromAgentId: Number(raw.fromAgentId),
+                value: Number(raw.value),
+                valueDecimals: Number(raw.valueDecimals),
+                timestamp: Number(raw.timestamp),
+                revoked: raw.revoked,
+                response: raw.response,
+            }));
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'readAllFeedback', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the reputation summary for an agent.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @param identityRegistry - Override identity registry.
+     * @returns Aggregate reputation summary.
+     *
+     * @example
+     * ```ts
+     * const rep = await erc8004.getReputationSummary(42);
+     * console.log(`${rep.count} ratings, average: ${rep.average.toFixed(2)}`);
+     * ```
+     */
+    async getReputationSummary(agentId, identityRegistry) {
+        const registry = (identityRegistry || this.identityRegistry);
+        try {
+            const [count, sum, decimals] = await this.publicClient.readContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'getSummary',
+                args: [registry, BigInt(agentId)],
+            });
+            const countNum = Number(count);
+            const sumNum = Number(sum);
+            const decNum = Number(decimals);
+            return {
+                count: countNum,
+                sum: sumNum,
+                decimals: decNum,
+                average: countNum > 0
+                    ? sumNum / Math.pow(10, decNum) / countNum
+                    : 0,
+            };
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.reputationRegistry, 'getSummary', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the last feedback index for an agent.
+     */
+    async getLastFeedbackIndex(agentId, identityRegistry) {
+        const registry = (identityRegistry || this.identityRegistry);
+        try {
+            const index = await this.publicClient.readContract({
+                address: this.reputationRegistry,
+                abi: ERC8004Reputation_1.ERC8004_REPUTATION_ABI,
+                functionName: 'getLastIndex',
+                args: [registry, BigInt(agentId)],
+            });
+            return Number(index);
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // VALIDATION REGISTRY
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Request validation from a validator contract.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @param validatorContract - The validator contract address.
+     * @returns The validation request ID.
+     */
+    async requestValidation(agentId, validatorContract) {
+        this.ensureWalletClient();
+        this.ensureValidationRegistry();
+        this.logger.info(`Requesting validation for agent ${agentId} from validator ${validatorContract}`);
+        try {
+            const hash = await this.walletClient.writeContract({
+                address: this.validationRegistry,
+                abi: ERC8004Validation_1.ERC8004_VALIDATION_ABI,
+                functionName: 'validationRequest',
+                args: [
+                    this.identityRegistry,
+                    BigInt(agentId),
+                    validatorContract,
+                ],
+            });
+            const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+            this.logger.info(`Validation request sent in block ${receipt.blockNumber}`);
+            // Parse requestId from event
+            for (const log of receipt.logs) {
+                if (log.data && log.data.length > 2) {
+                    const dataHex = log.data.slice(2);
+                    if (dataHex.length >= 64) {
+                        return Number(BigInt('0x' + dataHex.slice(0, 64)));
+                    }
+                }
+            }
+            return 0;
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.validationRegistry, 'validationRequest', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the status of a validation request.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @param requestId - The validation request ID.
+     * @returns The validation result.
+     */
+    async getValidationStatus(agentId, requestId) {
+        this.ensureValidationRegistry();
+        try {
+            const raw = await this.publicClient.readContract({
+                address: this.validationRegistry,
+                abi: ERC8004Validation_1.ERC8004_VALIDATION_ABI,
+                functionName: 'getValidationStatus',
+                args: [this.identityRegistry, BigInt(agentId), BigInt(requestId)],
+            });
+            return {
+                validatorContract: raw.validatorContract,
+                requestedAt: Number(raw.requestedAt),
+                respondedAt: Number(raw.respondedAt),
+                responded: raw.responded,
+                passed: raw.passed,
+                details: raw.details,
+            };
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.validationRegistry, 'getValidationStatus', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Get the validation summary for an agent.
+     *
+     * @param agentId - The agent's ERC-8004 ID.
+     * @returns Validation summary with counts.
+     */
+    async getValidationSummary(agentId) {
+        this.ensureValidationRegistry();
+        try {
+            const [totalRequests, totalPassed, totalFailed, totalPending] = await this.publicClient.readContract({
+                address: this.validationRegistry,
+                abi: ERC8004Validation_1.ERC8004_VALIDATION_ABI,
+                functionName: 'getSummary',
+                args: [this.identityRegistry, BigInt(agentId)],
+            });
+            return {
+                totalRequests: Number(totalRequests),
+                totalPassed: Number(totalPassed),
+                totalFailed: Number(totalFailed),
+                totalPending: Number(totalPending),
+            };
+        }
+        catch (error) {
+            throw new errors_1.ERC8004RegistryError(this.validationRegistry, 'getSummary', error instanceof Error ? error.message : String(error));
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Q00BS ↔ ERC-8004 BRIDGE UTILITIES
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Sync a Q00bs agent's trust score to ERC-8004 metadata.
+     *
+     * This writes the Q00bs trust score as metadata on the ERC-8004 identity,
+     * making it visible to other agent platforms that read ERC-8004.
+     *
+     * @param erc8004AgentId - The agent's ERC-8004 ID.
+     * @param q00bsAgentId - The agent's Q00bs AgentRegistry ID.
+     * @param trustScore - The Q00bs trust score (0-10000).
+     */
+    async syncTrustToMetadata(erc8004AgentId, q00bsAgentId, trustScore) {
+        this.ensureWalletClient();
+        this.logger.info(`Syncing Q00bs trust to ERC-8004: agent ${erc8004AgentId} ← Q00bs #${q00bsAgentId} (trust: ${trustScore})`);
+        // Write Q00bs-specific metadata keys
+        await this.setMetadata(erc8004AgentId, 'q00bs_agent_id', String(q00bsAgentId));
+        await this.setMetadata(erc8004AgentId, 'q00bs_trust_score', String(trustScore));
+        await this.setMetadata(erc8004AgentId, 'q00bs_trust_percent', (trustScore / 100).toFixed(2) + '%');
+        this.logger.info(`Trust metadata synced: q00bs_agent_id=${q00bsAgentId}, q00bs_trust_score=${trustScore}`);
+    }
+    /**
+     * Build the full ERC-8004 agent identifier string.
+     *
+     * Format: {namespace}:{chainId}:{identityRegistry}:{agentId}
+     */
+    buildIdentifier(agentId) {
+        return `${constants_1.ERC8004_NAMESPACE}:${constants_1.BASE_CHAIN_ID}:${this.identityRegistry}:${agentId}`;
+    }
+    /**
+     * Parse an ERC-8004 agent identifier string.
+     *
+     * @param identifier - The identifier string.
+     * @returns Parsed components.
+     */
+    static parseIdentifier(identifier) {
+        const parts = identifier.split(':');
+        if (parts.length !== 4) {
+            throw new errors_1.ERC8004Error(`Invalid ERC-8004 identifier format: "${identifier}". ` +
+                'Expected: {namespace}:{chainId}:{identityRegistry}:{agentId}');
+        }
+        return {
+            namespace: parts[0],
+            chainId: parseInt(parts[1], 10),
+            identityRegistry: parts[2],
+            agentId: parseInt(parts[3], 10),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // PRIVATE GUARDS
+    // ─────────────────────────────────────────────────────────────
+    ensureWalletClient() {
+        if (!this.walletClient) {
+            throw new errors_1.ERC8004Error('Write operations require a walletClient (Mode 1 — privateKey). ' +
+                'In Privy mode (Mode 2), use the API server endpoints for ERC-8004 operations.');
+        }
+    }
+    ensureValidationRegistry() {
+        if (this.validationRegistry === '0x0000000000000000000000000000000000000000') {
+            throw new errors_1.ERC8004Error('ValidationRegistry is not configured. The ERC-8004 ValidationRegistry ' +
+                'spec is still evolving. Set validationRegistryAddress in ERC8004Config ' +
+                'once the canonical deployment is confirmed.');
+        }
+    }
+}
+exports.ERC8004Manager = ERC8004Manager;
+//# sourceMappingURL=erc8004.js.map