@elizaos/plugin-wallet 2.0.0-beta.1 → 2.0.3-beta.5

package/dist/sdk/identity/erc8004.d.ts

@@ -0,0 +1,304 @@
+/**
+ * ERC-8004: Trustless Agents — Identity Registry Integration
+ *
+ * Implements the Identity Registry component of ERC-8004, which provides every
+ * AI agent with a portable, censorship-resistant on-chain identifier using ERC-721
+ * with URIStorage extension.
+ *
+ * Spec: https://eips.ethereum.org/EIPS/eip-8004
+ * Status: DRAFT (August 2025). No official mainnet singleton deployed yet.
+ * Key Principle: Non-custodial. All signing happens locally via WalletClient.
+ */
+import { type Address, type Hash, type Hex, type WalletClient } from "viem";
+export declare const ERC8004IdentityRegistryAbi: readonly [{
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentURI";
+        readonly type: "string";
+    }, {
+        readonly name: "metadata";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly name: "metadataKey";
+            readonly type: "string";
+        }, {
+            readonly name: "metadataValue";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "setAgentURI";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "tokenURI";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+}, {
+    readonly name: "getMetadata";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly name: "setMetadata";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+    }, {
+        readonly name: "metadataValue";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "getAgentWallet";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "setAgentWallet";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newWallet";
+        readonly type: "address";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "unsetAgentWallet";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "Registered";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "URIUpdated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "newURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "updatedBy";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly name: "MetadataSet";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "indexedMetadataKey";
+        readonly type: "string";
+        readonly indexed: true;
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "metadataValue";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }];
+}];
+export interface AgentServiceEndpoint {
+    name: string;
+    endpoint: string;
+    version?: string;
+    skills?: string[];
+    domains?: string[];
+}
+export type SupportedTrustMechanism = "reputation" | "crypto-economic" | "tee-attestation" | "zkml" | string;
+export interface AgentRegistrationRef {
+    agentId: number;
+    agentRegistry: string;
+}
+export interface AgentRegistrationFile {
+    type: string;
+    name: string;
+    description: string;
+    image?: string;
+    services?: AgentServiceEndpoint[];
+    x402Support?: boolean;
+    active?: boolean;
+    registrations?: AgentRegistrationRef[];
+    supportedTrust?: SupportedTrustMechanism[];
+    [key: string]: unknown;
+}
+export interface AgentModelMetadata {
+    model?: string;
+    provider?: string;
+    version?: string;
+    capabilities?: string[];
+    framework?: string;
+}
+export interface AgentIdentity {
+    agentId: bigint;
+    owner: Address;
+    agentURI: string;
+    agentWallet: Address;
+    registrationFile: AgentRegistrationFile | null;
+    modelMetadata: AgentModelMetadata | null;
+}
+export interface MetadataEntry {
+    metadataKey: string;
+    metadataValue: Hex;
+}
+export type SupportedChain = "base" | "base-sepolia" | "ethereum" | "arbitrum" | "polygon" | "arbitrum-sepolia";
+export interface ERC8004ClientConfig {
+    registryAddress?: Address;
+    chain: SupportedChain;
+    rpcUrl?: string;
+}
+export interface RegistrationResult {
+    txHash: Hash;
+    agentId: bigint | null;
+}
+export declare const METADATA_KEYS: {
+    readonly AGENT_WALLET: "agentWallet";
+    readonly MODEL: "agentModel";
+    readonly MODEL_PROVIDER: "agentModelProvider";
+    readonly VERSION: "agentVersion";
+    readonly CAPABILITIES: "agentCapabilities";
+    readonly FRAMEWORK: "agentFramework";
+};
+export declare const REGISTRATION_FILE_TYPE = "https://eips.ethereum.org/EIPS/eip-8004#registration-v1";
+export declare const KNOWN_REGISTRY_ADDRESSES: Record<string, {
+    identity: Address;
+    reputation: Address;
+    validation?: Address;
+}>;
+export declare class ERC8004Client {
+    private readonly publicClient;
+    private readonly config;
+    private readonly chain;
+    constructor(config: ERC8004ClientConfig);
+    private getReadContract;
+    private getWriteContract;
+    registerAgent(walletClient: WalletClient, metadata: Omit<AgentRegistrationFile, "type">, agentURI?: string, onChainMetadata?: Record<string, string>): Promise<RegistrationResult>;
+    lookupAgentIdentity(agentId: bigint): Promise<AgentIdentity>;
+    lookupAgentByOwner(ownerAddress: Address, fromBlock?: bigint): Promise<AgentIdentity | null>;
+    updateAgentURI(walletClient: WalletClient, agentId: bigint, newURI: string): Promise<Hash>;
+    getOnChainMetadata(agentId: bigint, key: string): Promise<Hex | null>;
+    setOnChainMetadata(walletClient: WalletClient, agentId: bigint, key: string, value: string): Promise<Hash>;
+    setModelMetadata(walletClient: WalletClient, agentId: bigint, model: AgentModelMetadata): Promise<Hash[]>;
+    readModelMetadata(agentId: bigint): Promise<AgentModelMetadata | null>;
+    getAgentWallet(agentId: bigint): Promise<Address>;
+    setAgentWallet(walletClient: WalletClient, agentId: bigint, newWallet: Address, deadline: bigint, signature: Hex): Promise<Hash>;
+    unsetAgentWallet(walletClient: WalletClient, agentId: bigint): Promise<Hash>;
+}
+export declare function buildDataURI(registrationFile: AgentRegistrationFile): string;
+export declare function parseDataURI(uri: string): AgentRegistrationFile;
+export declare function resolveAgentURI(uri: string): Promise<AgentRegistrationFile>;
+export declare function validateRegistrationFile(file: AgentRegistrationFile): string[];
+export declare function formatAgentRegistry(chainId: number, registryAddress: Address): string;

package/dist/sdk/identity/reputation.d.ts

@@ -0,0 +1,317 @@
+/**
+ * ERC-8004: Trustless Agents — Reputation Registry Client
+ *
+ * On-chain reputation system for AI agents. Clients can leave scored feedback,
+ * agents can respond, and anyone can query aggregated reputation summaries.
+ *
+ * Spec: https://eips.ethereum.org/EIPS/eip-8004
+ */
+import { type Address, type Hash, type Hex, type WalletClient } from "viem";
+import { type SupportedChain } from "./erc8004.js";
+export declare const ReputationRegistryAbi: readonly [{
+    readonly name: "giveFeedback";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "score";
+        readonly type: "int128";
+    }, {
+        readonly name: "category";
+        readonly type: "uint8";
+    }, {
+        readonly name: "comment";
+        readonly type: "string";
+    }, {
+        readonly name: "taskRef";
+        readonly type: "string";
+    }, {
+        readonly name: "verifierRef";
+        readonly type: "string";
+    }, {
+        readonly name: "clientRef";
+        readonly type: "string";
+    }, {
+        readonly name: "contentHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "readFeedback";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "client";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "score";
+        readonly type: "int128";
+    }, {
+        readonly name: "category";
+        readonly type: "uint8";
+    }, {
+        readonly name: "comment";
+        readonly type: "string";
+    }, {
+        readonly name: "taskRef";
+        readonly type: "string";
+    }, {
+        readonly name: "revoked";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "readAllFeedback";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "clients";
+        readonly type: "address[]";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "taskRef";
+        readonly type: "string";
+    }, {
+        readonly name: "includeRevoked";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "scores";
+        readonly type: "int128[]";
+    }, {
+        readonly name: "categories";
+        readonly type: "uint8[]";
+    }, {
+        readonly name: "comments";
+        readonly type: "string[]";
+    }, {
+        readonly name: "taskRefs";
+        readonly type: "string[]";
+    }, {
+        readonly name: "revoked";
+        readonly type: "bool[]";
+    }];
+}, {
+    readonly name: "getSummary";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "clients";
+        readonly type: "address[]";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "taskRef";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "count";
+        readonly type: "uint64";
+    }, {
+        readonly name: "totalScore";
+        readonly type: "int128";
+    }, {
+        readonly name: "avgCategory";
+        readonly type: "uint8";
+    }];
+}, {
+    readonly name: "getClients";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+}, {
+    readonly name: "getLastIndex";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "client";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+    }];
+}, {
+    readonly name: "appendResponse";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "client";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint64";
+    }, {
+        readonly name: "response";
+        readonly type: "string";
+    }, {
+        readonly name: "contentHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "revokeFeedback";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "index";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "getResponseCount";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "client";
+        readonly type: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint64";
+    }, {
+        readonly name: "responders";
+        readonly type: "address[]";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+    }];
+}, {
+    readonly name: "getIdentityRegistry";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}];
+export interface ReputationClientConfig {
+    reputationAddress?: Address;
+    chain: SupportedChain;
+    rpcUrl?: string;
+}
+export interface GiveFeedbackParams {
+    agentId: bigint;
+    score: bigint;
+    category: number;
+    comment: string;
+    taskRef: string;
+    verifierRef: string;
+    clientRef: string;
+    contentHash: Hex;
+}
+export interface FeedbackEntry {
+    score: bigint;
+    category: number;
+    comment: string;
+    taskRef: string;
+    revoked: boolean;
+}
+export interface AgentReputationSummary {
+    count: bigint;
+    totalScore: bigint;
+    avgCategory: number;
+    clients: Address[];
+}
+export interface FeedbackFilters {
+    clients?: Address[];
+    category?: string;
+    taskRef?: string;
+    includeRevoked?: boolean;
+}
+export interface RespondToFeedbackParams {
+    agentId: bigint;
+    client: Address;
+    index: bigint;
+    response: string;
+    contentHash: Hex;
+}
+export declare class ReputationClient {
+    private readonly publicClient;
+    private readonly reputationAddress;
+    private readonly chain;
+    constructor(config: ReputationClientConfig);
+    private getReadContract;
+    private getWriteContract;
+    /**
+     * Submit feedback for an agent.
+     */
+    giveFeedback(walletClient: WalletClient, params: GiveFeedbackParams): Promise<Hash>;
+    /**
+     * Read a specific feedback entry.
+     */
+    readFeedback(agentId: bigint, client: Address, index: bigint): Promise<FeedbackEntry>;
+    /**
+     * Get agent reputation summary: aggregated score + list of clients.
+     */
+    getAgentReputation(agentId: bigint, options?: {
+        clients?: Address[];
+        category?: string;
+        taskRef?: string;
+    }): Promise<AgentReputationSummary>;
+    /**
+     * Read all feedback for an agent with optional filters.
+     */
+    getAllFeedback(agentId: bigint, options?: FeedbackFilters): Promise<FeedbackEntry[]>;
+    /**
+     * Append a response to existing feedback.
+     */
+    respondToFeedback(walletClient: WalletClient, params: RespondToFeedbackParams): Promise<Hash>;
+    /**
+     * Revoke own feedback for an agent.
+     */
+    revokeFeedback(walletClient: WalletClient, agentId: bigint, index: bigint): Promise<Hash>;
+    /**
+     * Get the linked identity registry address.
+     */
+    getIdentityRegistry(): Promise<Address>;
+    /**
+     * Get the last feedback index for a client on an agent.
+     */
+    getLastIndex(agentId: bigint, client: Address): Promise<bigint>;
+    /**
+     * Get clients who have left feedback for an agent.
+     */
+    getClients(agentId: bigint): Promise<Address[]>;
+    /**
+     * Get the number of responses for a specific feedback entry.
+     */
+    getResponseCount(agentId: bigint, client: Address, index: bigint, responders: Address[]): Promise<bigint>;
+}