@agether/sdk 2.12.2 → 2.14.0

package/dist/clients/AgentIdentityClient.d.ts

@@ -0,0 +1,200 @@
+/**
+ * AgentIdentityClient - Integration with ag0 (ERC-8004)
+ *
+ * ERC-8004 is a per-chain singleton — different chain = different agentId.
+ *
+ * Contract Addresses:
+ * - Ethereum IdentityRegistry:  0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
+ * - Base IdentityRegistry:      0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
+ * - 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 { Signer } from 'ethers';
+import { AgetherConfig } from '../types';
+export declare const ERC8004_SEPOLIA: {
+    identityRegistry: string;
+    reputationRegistry: string;
+};
+export declare const ERC8004_MAINNET: {
+    identityRegistry: string;
+    reputationRegistry: string;
+};
+export declare const ERC8004_BASE: {
+    identityRegistry: string;
+    reputationRegistry: string;
+};
+export interface AgentIdentityClientOptions {
+    config: AgetherConfig;
+    signer: Signer;
+    /** Optional: Use ag0 TypeScript SDK instead of direct contracts */
+    useAg0SDK?: boolean;
+}
+export interface AgentMetadata {
+    name: string;
+    description: string;
+    image?: string;
+    endpoints?: {
+        name: string;
+        endpoint: string;
+        version?: string;
+    }[];
+    x402Support?: boolean;
+    active?: boolean;
+}
+export interface FeedbackInput {
+    agentId: bigint;
+    value: number;
+    decimals?: number;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    feedbackURI?: string;
+}
+export interface ReputationSummary {
+    count: number;
+    totalValue: number;
+    averageValue: number;
+    clients: string[];
+}
+export declare class AgentIdentityClient {
+    readonly config: AgetherConfig;
+    private signer;
+    private identityRegistry;
+    private reputationRegistry;
+    constructor(options: AgentIdentityClientOptions);
+    /**
+     * Register a new agent (minimal - no metadata)
+     */
+    register(): Promise<{
+        agentId: bigint;
+        txHash: string;
+    }>;
+    /**
+     * Register agent with IPFS/HTTP URI to metadata JSON
+     * @param agentURI URI pointing to agent metadata (ipfs:// or https://)
+     */
+    registerWithURI(agentURI: string): Promise<{
+        agentId: bigint;
+        txHash: string;
+    }>;
+    /**
+     * 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.
+     */
+    hasExistingIdentity(): Promise<boolean>;
+    /**
+     * Register only if no identity exists; otherwise throw.
+     * Prevents accidental double-registration.
+     */
+    registerOrGet(): Promise<{
+        agentId: bigint;
+        txHash: string | null;
+        existing: boolean;
+    }>;
+    /**
+     * Register with URI only if no identity exists; otherwise throw.
+     * Prevents accidental double-registration.
+     */
+    registerOrGetWithURI(agentURI: string): Promise<{
+        agentId: bigint;
+        txHash: string | null;
+        existing: boolean;
+    }>;
+    /**
+     * Register agent with URI and onchain metadata
+     */
+    registerWithMetadata(agentURI: string, metadata: {
+        key: string;
+        value: string;
+    }[]): Promise<{
+        agentId: bigint;
+        txHash: string;
+    }>;
+    /**
+     * Get agent owner address
+     */
+    getOwner(agentId: bigint): Promise<string>;
+    /**
+     * Get agent URI (metadata JSON location)
+     */
+    getAgentURI(agentId: bigint): Promise<string>;
+    /**
+     * Update agent URI
+     */
+    setAgentURI(agentId: bigint, newURI: string): Promise<string>;
+    /**
+     * Set onchain metadata (key-value)
+     */
+    setMetadata(agentId: bigint, key: string, value: string): Promise<string>;
+    /**
+     * Get onchain metadata
+     */
+    getMetadata(agentId: bigint, key: string): Promise<string>;
+    /**
+     * Transfer agent to new owner
+     */
+    transfer(agentId: bigint, to: string): Promise<string>;
+    /**
+     * Fetch and parse agent metadata from URI
+     */
+    fetchAgentMetadata(agentId: bigint): Promise<AgentMetadata | null>;
+    /**
+     * Give feedback to an agent
+     */
+    giveFeedback(input: FeedbackInput): Promise<string>;
+    /**
+     * Give positive feedback (shorthand)
+     */
+    givePosisitiveFeedback(agentId: bigint, value?: number, tags?: {
+        tag1?: string;
+        tag2?: string;
+    }): Promise<string>;
+    /**
+     * Give negative feedback (e.g., for defaults)
+     */
+    giveNegativeFeedback(agentId: bigint, value?: number, tags?: {
+        tag1?: string;
+        tag2?: string;
+    }): Promise<string>;
+    /**
+     * Record credit default in reputation system
+     */
+    recordCreditDefault(agentId: bigint, creditLineId: bigint): Promise<string>;
+    /**
+     * Get reputation summary for an agent
+     */
+    getReputation(agentId: bigint, tag1?: string, tag2?: string): Promise<ReputationSummary>;
+    /**
+     * Check if agent has negative credit reputation
+     */
+    hasNegativeCreditReputation(agentId: bigint): Promise<boolean>;
+    /**
+     * Verify agent is eligible for Agether credit
+     * Checks:
+     * 1. Agent exists in ERC-8004 registry
+     * 2. Agent has no negative credit reputation
+     */
+    verifyForCredit(agentId: bigint): Promise<{
+        eligible: boolean;
+        reason?: string;
+        owner?: string;
+        reputation?: ReputationSummary;
+    }>;
+    private parseAgentIdFromReceipt;
+    /**
+     * Get contract addresses
+     */
+    getContractAddresses(): {
+        identity: string;
+        reputation: string;
+    };
+}
+//# sourceMappingURL=AgentIdentityClient.d.ts.map

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

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

package/dist/clients/AgentIdentityClient.js

@@ -0,0 +1,351 @@
+/**
+ * AgentIdentityClient - Integration with ag0 (ERC-8004)
+ *
+ * ERC-8004 is a per-chain singleton — different chain = different agentId.
+ *
+ * Contract Addresses:
+ * - Ethereum IdentityRegistry:  0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
+ * - Base IdentityRegistry:      0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
+ * - 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',
+};
+// ERC-8004 Ethereum mainnet singleton
+export const ERC8004_MAINNET = {
+    identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+    reputationRegistry: '', // Not yet deployed on mainnet
+};
+// ERC-8004 Base mainnet singleton
+export const ERC8004_BASE = {
+    identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+    reputationRegistry: '', // Not yet deployed on Base
+};
+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 (e) {
+            console.warn('[agether] hasExistingIdentity check failed:', e instanceof Error ? e.message : e);
+            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 onchain 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 onchain 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 onchain 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 (e) {
+            console.warn('[agether] getMetadata fetch failed:', e instanceof Error ? e.message : e);
+            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 (e) {
+            console.warn('[agether] checkCreditEligibility: agent not found:', e instanceof Error ? e.message : e);
+            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 (e) {
+                console.warn('[agether] parseAgentIdFromReceipt parseLog skip:', e instanceof Error ? e.message : e);
+                continue;
+            }
+        }
+        return 0n;
+    }
+    /**
+     * Get contract addresses
+     */
+    getContractAddresses() {
+        return {
+            identity: this.identityRegistry.target,
+            reputation: this.reputationRegistry.target,
+        };
+    }
+}