@agether/sdk 1.6.0 → 1.6.2

package/dist/clients/AgentIdentityClient.js

@@ -0,0 +1,333 @@
+/**
+ * AgentIdentityClient - Integration with ag0 (ERC-8004)
+ *
+ * ERC-8004 Contract Addresses:
+ * - Sepolia IdentityRegistry: 0x8004A818BFB912233c491871b3d84c89A494BD9e
+ * - Sepolia ReputationRegistry: 0x8004B663056A597Dffe9eCcC1965A193B7388713
+ *
+ * SDKs:
+ * - TypeScript: https://github.com/agent0lab/agent0-ts
+ * - Python: https://github.com/agent0lab/agent0-py
+ *
+ * Docs: https://sdk.ag0.xyz/docs
+ */
+import { ethers } from 'ethers';
+// ERC-8004 ABI fragments
+const ERC8004_IDENTITY_ABI = [
+    // Registration
+    'function register() returns (uint256)',
+    'function register(string agentURI) returns (uint256)',
+    'function register(string agentURI, tuple(string key, bytes value)[] metadata) returns (uint256)',
+    // Management
+    'function setAgentURI(uint256 agentId, string newURI)',
+    'function setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)',
+    'function getMetadata(uint256 agentId, string metadataKey) view returns (bytes)',
+    // ERC-721 standard
+    'function ownerOf(uint256 tokenId) view returns (address)',
+    'function balanceOf(address owner) view returns (uint256)',
+    'function tokenURI(uint256 tokenId) view returns (string)',
+    'function transferFrom(address from, address to, uint256 tokenId)',
+    'function approve(address to, uint256 tokenId)',
+    'function getApproved(uint256 tokenId) view returns (address)',
+    // Events
+    'event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)',
+];
+const ERC8004_REPUTATION_ABI = [
+    // Feedback
+    'function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash)',
+    'function revokeFeedback(uint256 agentId, uint64 feedbackIndex)',
+    // Queries
+    'function readFeedback(uint256 agentId, address clientAddress, uint64 feedbackIndex) view returns (int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked)',
+    'function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals)',
+    'function getClients(uint256 agentId) view returns (address[])',
+    'function getLastIndex(uint256 agentId, address clientAddress) view returns (uint64)',
+    // Registry
+    'function getIdentityRegistry() view returns (address)',
+];
+// ERC-8004 Sepolia addresses
+export const ERC8004_SEPOLIA = {
+    identityRegistry: '0x8004A818BFB912233c491871b3d84c89A494BD9e',
+    reputationRegistry: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+};
+export class AgentIdentityClient {
+    constructor(options) {
+        this.config = options.config;
+        this.signer = options.signer;
+        // Get registry addresses (prefer config, fallback to Sepolia)
+        const identityAddr = options.config.contracts?.identityRegistry || ERC8004_SEPOLIA.identityRegistry;
+        const reputationAddr = options.config.contracts?.reputationRegistry || ERC8004_SEPOLIA.reputationRegistry;
+        this.identityRegistry = new ethers.Contract(identityAddr, ERC8004_IDENTITY_ABI, this.signer);
+        this.reputationRegistry = new ethers.Contract(reputationAddr, ERC8004_REPUTATION_ABI, this.signer);
+    }
+    // ============ Identity Functions ============
+    /**
+     * Register a new agent (minimal - no metadata)
+     */
+    async register() {
+        const tx = await this.identityRegistry['register()']();
+        const receipt = await tx.wait();
+        const agentId = this.parseAgentIdFromReceipt(receipt);
+        return { agentId, txHash: receipt.hash };
+    }
+    /**
+     * Register agent with IPFS/HTTP URI to metadata JSON
+     * @param agentURI URI pointing to agent metadata (ipfs:// or https://)
+     */
+    async registerWithURI(agentURI) {
+        const tx = await this.identityRegistry['register(string)'](agentURI);
+        const receipt = await tx.wait();
+        const agentId = this.parseAgentIdFromReceipt(receipt);
+        return { agentId, txHash: receipt.hash };
+    }
+    /**
+     * Check if the signer already owns an ERC-8004 identity token.
+     * Returns true if balanceOf > 0, false otherwise.
+     * Note: Cannot determine the specific agentId without enumeration —
+     * use agether init <pk> --agent-id <id> if you know your agentId.
+     */
+    async hasExistingIdentity() {
+        try {
+            const address = await this.signer.getAddress();
+            const balance = await this.identityRegistry.balanceOf(address);
+            return balance > 0n;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Register only if no identity exists; otherwise throw.
+     * Prevents accidental double-registration.
+     */
+    async registerOrGet() {
+        const hasIdentity = await this.hasExistingIdentity();
+        if (hasIdentity) {
+            throw new Error('Wallet already owns an ERC-8004 identity. Use agether init <pk> --agent-id <id> to set it.');
+        }
+        const result = await this.register();
+        return { ...result, existing: false };
+    }
+    /**
+     * Register with URI only if no identity exists; otherwise throw.
+     * Prevents accidental double-registration.
+     */
+    async registerOrGetWithURI(agentURI) {
+        const hasIdentity = await this.hasExistingIdentity();
+        if (hasIdentity) {
+            throw new Error('Wallet already owns an ERC-8004 identity. Use agether init <pk> --agent-id <id> to set it.');
+        }
+        const result = await this.registerWithURI(agentURI);
+        return { ...result, existing: false };
+    }
+    /**
+     * Register agent with URI and on-chain metadata
+     */
+    async registerWithMetadata(agentURI, metadata) {
+        const metadataEntries = metadata.map(m => ({
+            key: m.key,
+            value: ethers.toUtf8Bytes(m.value),
+        }));
+        const tx = await this.identityRegistry['register(string,tuple(string,bytes)[])'](agentURI, metadataEntries);
+        const receipt = await tx.wait();
+        const agentId = this.parseAgentIdFromReceipt(receipt);
+        return { agentId, txHash: receipt.hash };
+    }
+    /**
+     * Get agent owner address
+     */
+    async getOwner(agentId) {
+        return await this.identityRegistry.ownerOf(agentId);
+    }
+    /**
+     * Get agent URI (metadata JSON location)
+     */
+    async getAgentURI(agentId) {
+        return await this.identityRegistry.tokenURI(agentId);
+    }
+    /**
+     * Update agent URI
+     */
+    async setAgentURI(agentId, newURI) {
+        const tx = await this.identityRegistry.setAgentURI(agentId, newURI);
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    /**
+     * Set on-chain metadata (key-value)
+     */
+    async setMetadata(agentId, key, value) {
+        const tx = await this.identityRegistry.setMetadata(agentId, key, ethers.toUtf8Bytes(value));
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    /**
+     * Get on-chain metadata
+     */
+    async getMetadata(agentId, key) {
+        const value = await this.identityRegistry.getMetadata(agentId, key);
+        return ethers.toUtf8String(value);
+    }
+    /**
+     * Transfer agent to new owner
+     */
+    async transfer(agentId, to) {
+        const from = await this.signer.getAddress();
+        const tx = await this.identityRegistry.transferFrom(from, to, agentId);
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    /**
+     * Fetch and parse agent metadata from URI
+     */
+    async fetchAgentMetadata(agentId) {
+        try {
+            const uri = await this.getAgentURI(agentId);
+            // Handle IPFS URIs
+            let fetchUrl = uri;
+            if (uri.startsWith('ipfs://')) {
+                const cid = uri.replace('ipfs://', '');
+                fetchUrl = `https://ipfs.io/ipfs/${cid}`;
+            }
+            const response = await fetch(fetchUrl);
+            if (!response.ok)
+                return null;
+            return await response.json();
+        }
+        catch {
+            return null;
+        }
+    }
+    // ============ Reputation Functions ============
+    /**
+     * Give feedback to an agent
+     */
+    async giveFeedback(input) {
+        const feedbackHash = ethers.keccak256(ethers.AbiCoder.defaultAbiCoder().encode(['uint256', 'int128', 'uint256'], [input.agentId, input.value, Date.now()]));
+        const tx = await this.reputationRegistry.giveFeedback(input.agentId, input.value, input.decimals || 0, input.tag1 || '', input.tag2 || '', input.endpoint || '', input.feedbackURI || '', feedbackHash);
+        const receipt = await tx.wait();
+        return receipt.hash;
+    }
+    /**
+     * Give positive feedback (shorthand)
+     */
+    async givePosisitiveFeedback(agentId, value = 100, tags = {}) {
+        return this.giveFeedback({
+            agentId,
+            value: Math.abs(value),
+            ...tags,
+        });
+    }
+    /**
+     * Give negative feedback (e.g., for defaults)
+     */
+    async giveNegativeFeedback(agentId, value = -100, tags = {}) {
+        return this.giveFeedback({
+            agentId,
+            value: -Math.abs(value),
+            ...tags,
+        });
+    }
+    /**
+     * Record credit default in reputation system
+     */
+    async recordCreditDefault(agentId, creditLineId) {
+        return this.giveFeedback({
+            agentId,
+            value: -100,
+            tag1: 'credit',
+            tag2: 'default',
+            feedbackURI: `agether://default/${creditLineId}`,
+        });
+    }
+    /**
+     * Get reputation summary for an agent
+     */
+    async getReputation(agentId, tag1 = '', tag2 = '') {
+        const clients = await this.reputationRegistry.getClients(agentId);
+        if (clients.length === 0) {
+            return {
+                count: 0,
+                totalValue: 0,
+                averageValue: 0,
+                clients: [],
+            };
+        }
+        const [count, summaryValue, decimals] = await this.reputationRegistry.getSummary(agentId, clients, tag1, tag2);
+        // Convert from fixed-point
+        const divisor = 10 ** Number(decimals);
+        const total = Number(summaryValue) / divisor;
+        return {
+            count: Number(count),
+            totalValue: total,
+            averageValue: Number(count) > 0 ? total / Number(count) : 0,
+            clients: clients.map((c) => c),
+        };
+    }
+    /**
+     * Check if agent has negative credit reputation
+     */
+    async hasNegativeCreditReputation(agentId) {
+        const rep = await this.getReputation(agentId, 'credit', '');
+        return rep.count > 0 && rep.averageValue < 0;
+    }
+    // ============ Agether Integration ============
+    /**
+     * Verify agent is eligible for Agether credit
+     * Checks:
+     * 1. Agent exists in ERC-8004 registry
+     * 2. Agent has no negative credit reputation
+     */
+    async verifyForCredit(agentId) {
+        // Check agent exists
+        let owner;
+        try {
+            owner = await this.getOwner(agentId);
+        }
+        catch {
+            return { eligible: false, reason: 'Agent not found in ERC-8004 registry' };
+        }
+        // Check credit reputation
+        const reputation = await this.getReputation(agentId, 'credit', '');
+        if (reputation.count > 0 && reputation.averageValue < 0) {
+            return {
+                eligible: false,
+                reason: 'Agent has negative credit reputation',
+                owner,
+                reputation,
+            };
+        }
+        return {
+            eligible: true,
+            owner,
+            reputation,
+        };
+    }
+    // ============ Helpers ============
+    parseAgentIdFromReceipt(receipt) {
+        // Find Transfer event (ERC-721)
+        for (const log of receipt.logs) {
+            try {
+                const parsed = this.identityRegistry.interface.parseLog({
+                    topics: log.topics,
+                    data: log.data,
+                });
+                if (parsed?.name === 'Transfer') {
+                    return parsed.args[2]; // tokenId
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return 0n;
+    }
+    /**
+     * Get contract addresses
+     */
+    getContractAddresses() {
+        return {
+            identity: this.identityRegistry.target,
+            reputation: this.reputationRegistry.target,
+        };
+    }
+}

package/dist/clients/AgetherClient.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AgetherClient — Account management & identity for AI agents
+ *
+ * Flow:
+ * 1. Agent registers via ERC-8004 → gets agentId
+ * 2. AccountFactory.createAccount(agentId) → AgentAccount (KYA-gated smart wallet)
+ * 3. Use MorphoClient for lending, ScoringClient for scores, X402Client for payments
+ */
+import { Signer } from 'ethers';
+import { AgetherConfig, TransactionResult, ChainId } from '../types';
+export interface AgetherClientOptions {
+    config: AgetherConfig;
+    signer: Signer;
+    agentId: bigint;
+}
+export declare class AgetherClient {
+    private config;
+    private signer;
+    private agentId;
+    private accountFactory;
+    private identityRegistry;
+    private validationRegistry;
+    private agentReputation;
+    private accountAddress?;
+    constructor(options: AgetherClientOptions);
+    static fromPrivateKey(privateKey: string, agentId: bigint, chainIdOrConfig: ChainId | AgetherConfig): AgetherClient;
+    createAccount(): Promise<string>;
+    getAccountAddress(): Promise<string>;
+    accountExists(): Promise<boolean>;
+    predictAddress(): Promise<string>;
+    getBalances(): Promise<{
+        eoa: {
+            eth: string;
+            usdc: string;
+        };
+        account?: {
+            address: string;
+            eth: string;
+            usdc: string;
+        };
+    }>;
+    fundAccount(usdcAmount: string): Promise<TransactionResult>;
+    withdrawUsdc(usdcAmount: string): Promise<TransactionResult>;
+    withdrawEth(ethAmount: string): Promise<TransactionResult>;
+    isKyaApproved(): Promise<boolean>;
+    identityExists(): Promise<boolean>;
+    getIdentityOwner(): Promise<string>;
+    getCreditScore(): Promise<bigint>;
+    isScoreFresh(): Promise<{
+        fresh: boolean;
+        age: bigint;
+    }>;
+    isEligible(minScore?: bigint): Promise<{
+        eligible: boolean;
+        currentScore: bigint;
+    }>;
+    get chainId(): ChainId;
+    get contracts(): import("..").ContractAddresses;
+    get currentAccountAddress(): string | undefined;
+    getSigner(): Signer;
+    getAgentId(): bigint;
+}
+//# sourceMappingURL=AgetherClient.d.ts.map

package/dist/clients/AgetherClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgetherClient.d.ts","sourceRoot":"","sources":["../../src/clients/AgetherClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAU,MAAM,EAAY,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,aAAa,EACb,iBAAiB,EAEjB,OAAO,EACR,MAAM,UAAU,CAAC;AAWlB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,kBAAkB,CAAW;IACrC,OAAO,CAAC,eAAe,CAAW;IAElC,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEpB,OAAO,EAAE,oBAAoB;IAgCzC,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,OAAO,GAAG,aAAa,GACvC,aAAa;IAYV,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBhC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUpC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAMjC,WAAW,IAAI,OAAO,CAAC;QAC3B,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1D,CAAC;IA0BI,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc3D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe5D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiB1D,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAMnC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAKxD,UAAU,CAAC,QAAQ,GAAE,MAAa,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAO/F,IAAI,OAAO,IAAI,OAAO,CAAgC;IACtD,IAAI,SAAS,mCAAoC;IACjD,IAAI,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAAgC;IAC/E,SAAS,IAAI,MAAM;IACnB,UAAU,IAAI,MAAM;CACrB"}

package/dist/clients/AgetherClient.js

@@ -0,0 +1,171 @@
+/**
+ * AgetherClient — Account management & identity for AI agents
+ *
+ * Flow:
+ * 1. Agent registers via ERC-8004 → gets agentId
+ * 2. AccountFactory.createAccount(agentId) → AgentAccount (KYA-gated smart wallet)
+ * 3. Use MorphoClient for lending, ScoringClient for scores, X402Client for payments
+ */
+import { ethers, Contract } from 'ethers';
+import { AgetherError, } from '../types';
+import { ACCOUNT_FACTORY_ABI, AGENT_ACCOUNT_ABI, IDENTITY_REGISTRY_ABI, VALIDATION_REGISTRY_ABI, AGENT_REPUTATION_ABI, ERC20_ABI, } from '../utils/abis';
+import { getDefaultConfig } from '../utils/config';
+export class AgetherClient {
+    constructor(options) {
+        this.config = options.config;
+        this.signer = options.signer;
+        this.agentId = options.agentId;
+        const provider = options.signer.provider;
+        if (!provider)
+            throw new AgetherError('Signer must have a provider', 'NO_PROVIDER');
+        this.accountFactory = new Contract(options.config.contracts.accountFactory, ACCOUNT_FACTORY_ABI, options.signer);
+        this.identityRegistry = new Contract(options.config.contracts.identityRegistry, IDENTITY_REGISTRY_ABI, provider);
+        this.validationRegistry = new Contract(options.config.contracts.validationRegistry, VALIDATION_REGISTRY_ABI, provider);
+        this.agentReputation = new Contract(options.config.contracts.agentReputation, AGENT_REPUTATION_ABI, provider);
+    }
+    // Static Factory
+    static fromPrivateKey(privateKey, agentId, chainIdOrConfig) {
+        const config = typeof chainIdOrConfig === 'number'
+            ? getDefaultConfig(chainIdOrConfig)
+            : chainIdOrConfig;
+        const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+        const signer = new ethers.Wallet(privateKey, provider);
+        return new AgetherClient({ config, signer, agentId });
+    }
+    // Account Management
+    async createAccount() {
+        const tx = await this.accountFactory.createAccount(this.agentId);
+        const receipt = await tx.wait();
+        const event = receipt.logs
+            .map((log) => {
+            try {
+                return this.accountFactory.interface.parseLog(log);
+            }
+            catch {
+                return null;
+            }
+        })
+            .find((e) => e?.name === 'AccountCreated');
+        if (event) {
+            this.accountAddress = event.args.account;
+        }
+        else {
+            this.accountAddress = await this.accountFactory.getAccount(this.agentId);
+        }
+        return this.accountAddress;
+    }
+    async getAccountAddress() {
+        if (this.accountAddress)
+            return this.accountAddress;
+        const addr = await this.accountFactory.getAccount(this.agentId);
+        if (addr === ethers.ZeroAddress) {
+            throw new AgetherError('No account found. Create one with createAccount().', 'NO_ACCOUNT');
+        }
+        this.accountAddress = addr;
+        return addr;
+    }
+    async accountExists() {
+        return this.accountFactory.accountExists(this.agentId);
+    }
+    async predictAddress() {
+        return this.accountFactory.predictAddress(this.agentId);
+    }
+    // Balances
+    async getBalances() {
+        const provider = this.signer.provider;
+        const eoaAddr = await this.signer.getAddress();
+        const usdc = new Contract(this.config.contracts.usdc, ERC20_ABI, provider);
+        const ethBal = await provider.getBalance(eoaAddr);
+        const usdcBal = await usdc.balanceOf(eoaAddr);
+        const result = {
+            eoa: { eth: ethers.formatEther(ethBal), usdc: ethers.formatUnits(usdcBal, 6) },
+        };
+        try {
+            const acctAddr = await this.getAccountAddress();
+            const acctEth = await provider.getBalance(acctAddr);
+            const acctUsdc = await usdc.balanceOf(acctAddr);
+            result.account = {
+                address: acctAddr,
+                eth: ethers.formatEther(acctEth),
+                usdc: ethers.formatUnits(acctUsdc, 6),
+            };
+        }
+        catch { /* no account */ }
+        return result;
+    }
+    async fundAccount(usdcAmount) {
+        const acctAddr = await this.getAccountAddress();
+        const usdc = new Contract(this.config.contracts.usdc, ERC20_ABI, this.signer);
+        const amount = ethers.parseUnits(usdcAmount, 6);
+        const tx = await usdc.transfer(acctAddr, amount);
+        const receipt = await tx.wait();
+        return {
+            txHash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+            status: receipt.status === 1 ? 'success' : 'failed',
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    async withdrawUsdc(usdcAmount) {
+        const acctAddr = await this.getAccountAddress();
+        const account = new Contract(acctAddr, AGENT_ACCOUNT_ABI, this.signer);
+        const amount = ethers.parseUnits(usdcAmount, 6);
+        const eoaAddr = await this.signer.getAddress();
+        const tx = await account.withdraw(this.config.contracts.usdc, amount, eoaAddr);
+        const receipt = await tx.wait();
+        return {
+            txHash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+            status: receipt.status === 1 ? 'success' : 'failed',
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    async withdrawEth(ethAmount) {
+        const acctAddr = await this.getAccountAddress();
+        const account = new Contract(acctAddr, AGENT_ACCOUNT_ABI, this.signer);
+        const amount = ethers.parseEther(ethAmount);
+        const eoaAddr = await this.signer.getAddress();
+        const tx = await account.withdrawETH(amount, eoaAddr);
+        const receipt = await tx.wait();
+        return {
+            txHash: receipt.hash,
+            blockNumber: receipt.blockNumber,
+            status: receipt.status === 1 ? 'success' : 'failed',
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    // Identity & Validation
+    async isKyaApproved() {
+        return this.validationRegistry.isAgentCodeApproved(this.agentId);
+    }
+    async identityExists() {
+        try {
+            await this.identityRegistry.ownerOf(this.agentId);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getIdentityOwner() {
+        return this.identityRegistry.ownerOf(this.agentId);
+    }
+    // Reputation
+    async getCreditScore() {
+        return this.agentReputation.getCreditScore(this.agentId);
+    }
+    async isScoreFresh() {
+        const [fresh, age] = await this.agentReputation.isScoreFresh(this.agentId);
+        return { fresh, age };
+    }
+    async isEligible(minScore = 500n) {
+        const [eligible, currentScore] = await this.agentReputation.isEligible(this.agentId, minScore);
+        return { eligible, currentScore };
+    }
+    // Getters
+    get chainId() { return this.config.chainId; }
+    get contracts() { return this.config.contracts; }
+    get currentAccountAddress() { return this.accountAddress; }
+    getSigner() { return this.signer; }
+    getAgentId() { return this.agentId; }
+}