agentwallet-sdk 5.0.0 → 5.0.2

package/dist/identity/erc8004.d.ts

@@ -0,0 +1,305 @@
+/**
+ * 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;
+//# sourceMappingURL=erc8004.d.ts.map

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

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