@t402/erc8004 2.7.0

package/dist/cjs/index.d.ts

@@ -0,0 +1,978 @@
+import { Network, ResourceServerExtension, PaymentRequired, A2ATask } from '@t402/core/types';
+import { BeforePaymentCreationHook } from '@t402/core/client';
+import { BeforeVerifyHook, AfterSettleHook } from '@t402/core/server';
+
+/** Ethereum address (0x-prefixed hex string) */
+type Address = `0x${string}`;
+/** Hex-encoded bytes (0x-prefixed) */
+type Hex = `0x${string}`;
+/** 32-byte hash (0x-prefixed, 66 chars) */
+type Bytes32 = `0x${string}`;
+/** ERC-8004 agent registry identifier: {namespace}:{chainId}:{contractAddress} */
+type AgentRegistryId = `${string}:${string}:${string}`;
+/** Parsed agent registry identifier */
+interface AgentRegistry {
+    namespace: string;
+    chainId: string;
+    address: Address;
+    /** Full registry string */
+    id: AgentRegistryId;
+}
+/** Metadata entry for agent registration */
+interface MetadataEntry {
+    metadataKey: string;
+    metadataValue: Hex;
+}
+/** On-chain agent identity from Identity Registry */
+interface AgentIdentity {
+    agentId: bigint;
+    owner: Address;
+    agentURI: string;
+    agentWallet: Address;
+    registry: AgentRegistry;
+}
+/** Resolved agent = on-chain identity + fetched registration file */
+interface ResolvedAgent extends AgentIdentity {
+    registration: RegistrationFile;
+}
+/** ERC-8004 Registration File (off-chain JSON at agentURI) */
+interface RegistrationFile {
+    type: string;
+    name: string;
+    description?: string;
+    image?: string;
+    services: ServiceEntry[];
+    x402Support: boolean;
+    active: boolean;
+    registrations: RegistrationEntry[];
+    supportedTrust?: string[];
+}
+interface ServiceEntry {
+    name: string;
+    endpoint: string;
+    version?: string;
+    skills?: string[];
+    domains?: string[];
+}
+interface RegistrationEntry {
+    agentId: number;
+    agentRegistry: AgentRegistryId;
+}
+/** On-chain feedback record */
+interface FeedbackRecord {
+    value: bigint;
+    valueDecimals: number;
+    tag1: string;
+    tag2: string;
+    isRevoked: boolean;
+    feedbackIndex: bigint;
+    clientAddress: Address;
+}
+/** Aggregated reputation summary */
+interface ReputationSummary {
+    agentId: bigint;
+    count: bigint;
+    summaryValue: bigint;
+    summaryValueDecimals: number;
+    /** Normalized 0-100 score derived from summaryValue/summaryValueDecimals */
+    normalizedScore: number;
+}
+/** Parameters for submitting feedback */
+interface FeedbackParams {
+    agentId: bigint;
+    value: bigint;
+    valueDecimals: number;
+    tag1: string;
+    tag2: string;
+    endpoint?: string;
+    feedbackURI?: string;
+    feedbackHash?: Bytes32;
+}
+/** Off-chain feedback file structure */
+interface FeedbackFile {
+    agentRegistry: AgentRegistryId;
+    agentId: number;
+    clientAddress: string;
+    createdAt: string;
+    value: number;
+    valueDecimals: number;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    proofOfPayment?: ProofOfPayment;
+}
+interface ProofOfPayment {
+    fromAddress: string;
+    toAddress: string;
+    chainId: string;
+    txHash: string;
+}
+/** Validation request parameters */
+interface ValidationRequestParams {
+    validatorAddress: Address;
+    agentId: bigint;
+    requestURI: string;
+    requestHash: Bytes32;
+}
+/** Validation response */
+interface ValidationStatus {
+    validatorAddress: Address;
+    agentId: bigint;
+    response: number;
+    responseHash: Bytes32;
+    tag: string;
+    lastUpdate: bigint;
+}
+/** Validation summary */
+interface ValidationSummary {
+    count: bigint;
+    averageResponse: number;
+}
+/** ERC-8004 extension data in PaymentRequired.extensions */
+interface ERC8004Extension {
+    /** Agent's ERC-8004 identity */
+    agentId: number;
+    /** Registry identifier: {namespace}:{chainId}:{address} */
+    agentRegistry: AgentRegistryId;
+    /** Agent's verified wallet (should match payTo) */
+    agentWallet?: string;
+    /** Reputation score (0-100, from trusted reviewers) */
+    reputationScore?: number;
+    /** Number of feedback records */
+    feedbackCount?: number;
+    /** Validation status (0-100 average) */
+    validationScore?: number;
+}
+/** ERC-8004 extension data echoed in PaymentPayload.extensions */
+interface ERC8004PayloadExtension {
+    /** Whether client verified the agent identity */
+    identityVerified: boolean;
+    /** Agent ID that was verified */
+    agentId: number;
+    /** Registry used for verification */
+    agentRegistry: AgentRegistryId;
+}
+/** Minimal read-only client interface for ERC-8004 registry interactions */
+interface ERC8004ReadClient {
+    readContract(args: {
+        address: Address;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+}
+/** Write-capable client for submitting feedback and validation */
+interface ERC8004WriteClient extends ERC8004ReadClient {
+    writeContract(args: {
+        address: Address;
+        abi: readonly unknown[];
+        functionName: string;
+        args: readonly unknown[];
+    }): Promise<Hex>;
+    waitForTransactionReceipt(args: {
+        hash: Hex;
+    }): Promise<{
+        status: string;
+    }>;
+}
+/** Configuration for ERC-8004 integration */
+interface ERC8004Config {
+    /** Network for registry interactions (CAIP-2) */
+    network: Network;
+    /** Identity Registry contract address */
+    identityRegistry: Address;
+    /** Reputation Registry contract address */
+    reputationRegistry?: Address;
+    /** Validation Registry contract address */
+    validationRegistry?: Address;
+    /** Client for reading registry state */
+    client: ERC8004ReadClient;
+    /** Client for writing to registries (optional, needed for feedback/validation) */
+    writeClient?: ERC8004WriteClient;
+}
+/** Reputation check configuration */
+interface ReputationCheckConfig {
+    /** Minimum normalized score (0-100) required to proceed */
+    minScore: number;
+    /** Addresses whose feedback is trusted for Sybil-resistance */
+    trustedReviewers: Address[];
+    /** Tags to filter on (optional) */
+    tag1?: string;
+    tag2?: string;
+    /** Action on score below threshold: "reject" | "warn" */
+    onBelowThreshold?: "reject" | "warn";
+}
+/** Feedback submission configuration */
+interface FeedbackSubmissionConfig {
+    /** Default tag1 for payment-related feedback */
+    tag1?: string;
+    /** Default tag2 for additional classification */
+    tag2?: string;
+    /** Whether to include proofOfPayment from SettleResponse */
+    includeProofOfPayment?: boolean;
+    /** Base URI for hosting feedback files (optional, for off-chain data) */
+    feedbackBaseURI?: string;
+}
+
+/**
+ * Known Identity Registry addresses per network.
+ * Populated as ERC-8004 deploys to each chain.
+ * Empty until mainnet deployments exist (spec is in Draft status).
+ */
+declare const IDENTITY_REGISTRIES: Partial<Record<Network, Address>>;
+declare const REPUTATION_REGISTRIES: Partial<Record<Network, Address>>;
+declare const VALIDATION_REGISTRIES: Partial<Record<Network, Address>>;
+/** Extension key for t402 PaymentRequired/PaymentPayload.extensions */
+declare const ERC8004_EXTENSION_KEY = "erc8004";
+/** Standard feedback tags for t402 payment interactions */
+declare const FEEDBACK_TAGS: {
+    /** tag1: Payment completed successfully */
+    readonly PAYMENT_SUCCESS: "paymentSuccess";
+    /** tag1: Payment verification failed */
+    readonly PAYMENT_FAILED: "paymentFailed";
+    /** tag1: Service quality rating */
+    readonly SERVICE_QUALITY: "starred";
+    /** tag2: Response time measurement */
+    readonly RESPONSE_TIME: "responseTime";
+    /** tag2: Uptime measurement */
+    readonly UPTIME: "uptime";
+};
+/** EIP-712 domain for setAgentWallet signature verification */
+declare const IDENTITY_REGISTRY_DOMAIN: {
+    readonly name: "IdentityRegistry";
+    readonly version: "1";
+};
+/** EIP-712 typed data for setAgentWallet */
+declare const SET_AGENT_WALLET_TYPES: {
+    readonly SetAgentWallet: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newWallet";
+        readonly type: "address";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }];
+};
+
+declare const identityRegistryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "register";
+    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 type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getAgentWallet";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tokenURI";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "ownerOf";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getMetadata";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadataKey";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bytes";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "setAgentWallet";
+    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 stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "Registered";
+    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;
+    }];
+}];
+declare const reputationRegistryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "giveFeedback";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "value";
+        readonly type: "int128";
+    }, {
+        readonly name: "valueDecimals";
+        readonly type: "uint8";
+    }, {
+        readonly name: "tag1";
+        readonly type: "string";
+    }, {
+        readonly name: "tag2";
+        readonly type: "string";
+    }, {
+        readonly name: "endpoint";
+        readonly type: "string";
+    }, {
+        readonly name: "feedbackURI";
+        readonly type: "string";
+    }, {
+        readonly name: "feedbackHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getSummary";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "clientAddresses";
+        readonly type: "address[]";
+    }, {
+        readonly name: "tag1";
+        readonly type: "string";
+    }, {
+        readonly name: "tag2";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "count";
+        readonly type: "uint64";
+    }, {
+        readonly name: "summaryValue";
+        readonly type: "int128";
+    }, {
+        readonly name: "summaryValueDecimals";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "revokeFeedback";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "feedbackIndex";
+        readonly type: "uint64";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getClients";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "NewFeedback";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "clientAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "feedbackIndex";
+        readonly type: "uint64";
+        readonly indexed: false;
+    }, {
+        readonly name: "value";
+        readonly type: "int128";
+        readonly indexed: false;
+    }, {
+        readonly name: "valueDecimals";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "indexedTag1";
+        readonly type: "string";
+        readonly indexed: true;
+    }, {
+        readonly name: "tag1";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "tag2";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "endpoint";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "feedbackURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "feedbackHash";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }];
+}];
+declare const validationRegistryAbi: readonly [{
+    readonly type: "function";
+    readonly name: "validationRequest";
+    readonly inputs: readonly [{
+        readonly name: "validatorAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "requestURI";
+        readonly type: "string";
+    }, {
+        readonly name: "requestHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "validationResponse";
+    readonly inputs: readonly [{
+        readonly name: "requestHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "response";
+        readonly type: "uint8";
+    }, {
+        readonly name: "responseURI";
+        readonly type: "string";
+    }, {
+        readonly name: "responseHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "tag";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getValidationStatus";
+    readonly inputs: readonly [{
+        readonly name: "requestHash";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "validatorAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "response";
+        readonly type: "uint8";
+    }, {
+        readonly name: "responseHash";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "tag";
+        readonly type: "string";
+    }, {
+        readonly name: "lastUpdate";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getSummary";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validatorAddresses";
+        readonly type: "address[]";
+    }, {
+        readonly name: "tag";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "count";
+        readonly type: "uint64";
+    }, {
+        readonly name: "averageResponse";
+        readonly type: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "ValidationRequest";
+    readonly inputs: readonly [{
+        readonly name: "validatorAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "requestURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "requestHash";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "ValidationResponse";
+    readonly inputs: readonly [{
+        readonly name: "validatorAddress";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "requestHash";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "response";
+        readonly type: "uint8";
+        readonly indexed: false;
+    }, {
+        readonly name: "responseURI";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "responseHash";
+        readonly type: "bytes32";
+        readonly indexed: false;
+    }, {
+        readonly name: "tag";
+        readonly type: "string";
+        readonly indexed: false;
+    }];
+}];
+
+/**
+ * Parse an agent registry ID string into components.
+ *
+ * @param registryId - Format: "{namespace}:{chainId}:{address}"
+ * @returns Parsed AgentRegistry
+ *
+ * @example
+ * parseAgentRegistry("eip155:8453:0x742d35Cc...")
+ * // => { namespace: "eip155", chainId: "8453", address: "0x742d35Cc...", id: "eip155:8453:0x742d35Cc..." }
+ */
+declare function parseAgentRegistry(registryId: AgentRegistryId): AgentRegistry;
+/**
+ * Resolve an agent's on-chain identity from the Identity Registry.
+ *
+ * Reads agentWallet, owner, and tokenURI from the contract.
+ *
+ * @param client - Read-only client for contract calls
+ * @param identityRegistry - Identity Registry contract address
+ * @param agentId - Agent's NFT token ID
+ * @param registryId - Full agent registry identifier
+ * @returns Agent identity with wallet, owner, and URI
+ */
+declare function getAgentIdentity(client: ERC8004ReadClient, identityRegistry: Address, agentId: bigint, registryId: AgentRegistryId): Promise<AgentIdentity>;
+/**
+ * Fetch and parse the agent's registration file from their agentURI.
+ *
+ * @param agentURI - URI pointing to the registration JSON file
+ * @returns Parsed registration file
+ * @throws If the URI is not reachable or the file is malformed
+ */
+declare function fetchRegistrationFile(agentURI: string): Promise<RegistrationFile>;
+/**
+ * Resolve an agent: fetch on-chain identity + off-chain registration file.
+ *
+ * @param client - Read-only client for contract calls
+ * @param identityRegistry - Identity Registry contract address
+ * @param agentId - Agent's NFT token ID
+ * @param registryId - Full agent registry identifier
+ * @returns Fully resolved agent with registration file
+ *
+ * @example
+ * const agent = await resolveAgent(viemClient, registryAddr, 42n, "eip155:8453:0x...");
+ * if (agent.agentWallet !== paymentRequirements.payTo) {
+ *   throw new Error("Payment address mismatch");
+ * }
+ */
+declare function resolveAgent(client: ERC8004ReadClient, identityRegistry: Address, agentId: bigint, registryId: AgentRegistryId): Promise<ResolvedAgent>;
+/**
+ * Verify that a payTo address matches the on-chain agentWallet.
+ *
+ * @param client - Read-only client for contract calls
+ * @param identityRegistry - Identity Registry contract address
+ * @param agentId - Agent's NFT token ID
+ * @param payTo - Address from PaymentRequirements.payTo
+ * @returns Whether the payTo address matches the on-chain agentWallet
+ */
+declare function verifyPayToMatchesAgent(client: ERC8004ReadClient, identityRegistry: Address, agentId: bigint, payTo: string): Promise<boolean>;
+
+/**
+ * Get a reputation summary for an agent from trusted reviewers.
+ *
+ * Queries the on-chain Reputation Registry and normalizes the result
+ * to a 0-100 score. Requires explicit `trustedReviewers` for Sybil resistance.
+ *
+ * @param client - Read-only client for contract calls
+ * @param reputationRegistry - Reputation Registry contract address
+ * @param agentId - Agent's on-chain ID
+ * @param trustedReviewers - Addresses whose feedback is trusted
+ * @param tag1 - Optional primary tag filter
+ * @param tag2 - Optional secondary tag filter
+ * @returns Reputation summary with normalized 0-100 score
+ */
+declare function getReputationSummary(client: ERC8004ReadClient, reputationRegistry: Address, agentId: bigint, trustedReviewers: Address[], tag1?: string, tag2?: string): Promise<ReputationSummary>;
+/**
+ * Build an off-chain feedback file with optional proofOfPayment.
+ *
+ * Creates a structured feedback file object ready for JSON serialization
+ * and hosting at a feedbackURI. Used by the afterSettle hook to link
+ * on-chain feedback records to off-chain payment proof.
+ *
+ * @param agentId - Agent's numeric ID
+ * @param agentRegistry - Registry identifier
+ * @param clientAddress - Address of the feedback submitter
+ * @param value - Feedback value (e.g. 100 for positive)
+ * @param valueDecimals - Decimal precision for value
+ * @param tag1 - Primary classification tag
+ * @param tag2 - Secondary classification tag
+ * @param proofOfPayment - Optional payment proof from settlement
+ * @returns Feedback file object
+ */
+declare function buildFeedbackFile(agentId: number, agentRegistry: AgentRegistryId, clientAddress: string, value: number, valueDecimals: number, tag1: string, tag2: string, proofOfPayment?: ProofOfPayment): FeedbackFile;
+/**
+ * Submit feedback for an agent to the on-chain Reputation Registry.
+ *
+ * Calls `giveFeedback` on the Reputation Registry contract.
+ * Typically used after a successful payment settlement to record
+ * positive feedback linking the agent to the transaction.
+ *
+ * @param client - Write-capable client for submitting transactions
+ * @param reputationRegistry - Reputation Registry contract address
+ * @param params - Feedback parameters (agentId, value, tags, etc.)
+ * @returns Transaction hash
+ */
+declare function submitFeedback(client: ERC8004WriteClient, reputationRegistry: Address, params: FeedbackParams): Promise<Hex>;
+
+/**
+ * Submit a validation request for agent work.
+ *
+ * Calls `validationRequest` on the Validation Registry contract
+ * to request validation of an agent's output by a specific validator.
+ *
+ * @param client - Write-capable client
+ * @param validationRegistry - Validation Registry contract address
+ * @param params - Validation request parameters
+ * @returns Transaction hash
+ */
+declare function submitValidationRequest(client: ERC8004WriteClient, validationRegistry: Address, params: ValidationRequestParams): Promise<Hex>;
+/**
+ * Get validation status for a specific request.
+ *
+ * Queries the on-chain Validation Registry for the current status
+ * of a validation request identified by its request hash.
+ *
+ * @param client - Read-only client
+ * @param validationRegistry - Validation Registry contract address
+ * @param requestHash - Keccak256 hash of the validation request
+ * @returns Validation status
+ */
+declare function getValidationStatus(client: ERC8004ReadClient, validationRegistry: Address, requestHash: Bytes32): Promise<ValidationStatus>;
+/**
+ * Get aggregated validation summary for an agent.
+ *
+ * Queries the on-chain Validation Registry for the average validation
+ * score across trusted validators.
+ *
+ * @param client - Read-only client
+ * @param validationRegistry - Validation Registry contract address
+ * @param agentId - Agent's ID
+ * @param validatorAddresses - Addresses of trusted validators
+ * @param tag - Optional tag filter
+ * @returns Validation summary with count and average score
+ */
+declare function getValidationSummary(client: ERC8004ReadClient, validationRegistry: Address, agentId: bigint, validatorAddresses: Address[], tag?: string): Promise<ValidationSummary>;
+
+/**
+ * Declare an ERC-8004 extension for a PaymentRequired response.
+ *
+ * @param agentId - Agent's on-chain ID
+ * @param agentRegistry - Registry identifier
+ * @param agentWallet - Optional verified wallet address
+ * @returns Extension object to include in route config extensions
+ *
+ * @example
+ * const routes = {
+ *   "/api/data": {
+ *     accepts: [...],
+ *     extensions: {
+ *       erc8004: declareERC8004Extension(42, "eip155:8453:0x...")
+ *     }
+ *   }
+ * };
+ */
+declare function declareERC8004Extension(agentId: number, agentRegistry: AgentRegistryId, agentWallet?: string): ERC8004Extension;
+/**
+ * Extract ERC-8004 extension data from a PaymentRequired response.
+ *
+ * @param paymentRequired - The PaymentRequired response
+ * @returns ERC-8004 extension data or undefined
+ */
+declare function getERC8004Extension(paymentRequired: PaymentRequired): ERC8004Extension | undefined;
+/**
+ * Create a client-side ERC-8004 payload extension after verifying identity.
+ *
+ * @param agentId - Agent ID that was verified
+ * @param agentRegistry - Registry used
+ * @param verified - Whether verification passed
+ * @returns Payload extension to echo back
+ */
+declare function createERC8004PayloadExtension(agentId: number, agentRegistry: AgentRegistryId, verified: boolean): ERC8004PayloadExtension;
+/**
+ * Client-side: verify agent identity from PaymentRequired before paying.
+ *
+ * Checks that the payTo address in each PaymentRequirements entry matches
+ * the on-chain agentWallet for the declared agentId.
+ *
+ * @param client - Read-only client for contract calls
+ * @param paymentRequired - The PaymentRequired response with ERC-8004 extension
+ * @returns Whether all payTo addresses match the on-chain agent wallet
+ */
+declare function verifyAgentIdentity(client: ERC8004ReadClient, paymentRequired: PaymentRequired): Promise<boolean>;
+/**
+ * Create a ResourceServerExtension that enriches ERC-8004 declarations
+ * with live reputation data from the on-chain Reputation Registry.
+ *
+ * When registered on a t402ResourceServer, this extension fetches the
+ * agent's current reputation score and feedback count at response time,
+ * including them in the PaymentRequired response for client inspection.
+ *
+ * @param config - Configuration with client and optional reputation parameters
+ * @returns ResourceServerExtension for registration on t402ResourceServer
+ *
+ * @example
+ * ```typescript
+ * const server = new t402ResourceServer(facilitatorClient);
+ * server.registerExtension(erc8004ResourceServerExtension({
+ *   client: viemPublicClient,
+ *   reputationRegistry: "0x...",
+ *   trustedReviewers: ["0x..."],
+ * }));
+ * ```
+ */
+declare function erc8004ResourceServerExtension(config: {
+    client: ERC8004ReadClient;
+    reputationRegistry?: Address;
+    trustedReviewers?: Address[];
+    validationRegistry?: Address;
+    trustedValidators?: Address[];
+}): ResourceServerExtension;
+
+/**
+ * Options for the ERC-8004 identity check hook.
+ */
+interface IdentityCheckOptions {
+    /**
+     * Abort payment if identity verification fails.
+     * @default true
+     */
+    abortOnFailure?: boolean;
+    /**
+     * Abort payment if no ERC-8004 extension is present.
+     * When false (default), requests without the extension pass through silently.
+     * @default false
+     */
+    abortOnMissing?: boolean;
+}
+/**
+ * Create a BeforePaymentCreationHook that verifies agent identity
+ * before signing a payment.
+ *
+ * Works with `t402Client.onBeforePaymentCreation()`, which means it
+ * automatically applies to `@t402/fetch` and `@t402/axios` wrappers.
+ *
+ * @param client - Read-only client for on-chain contract calls
+ * @param options - Hook behavior options
+ * @returns A hook for registration on t402Client
+ *
+ * @example
+ * ```typescript
+ * import { createPublicClient, http } from "viem";
+ * import { base } from "viem/chains";
+ * import { erc8004IdentityCheck } from "@t402/erc8004";
+ *
+ * const viemClient = createPublicClient({ chain: base, transport: http() });
+ * const client = new t402Client()
+ *   .register("eip155:8453", evmScheme)
+ *   .onBeforePaymentCreation(erc8004IdentityCheck(viemClient));
+ *
+ * const fetchWithPay = wrapFetchWithPayment(fetch, client);
+ * ```
+ */
+declare function erc8004IdentityCheck(client: ERC8004ReadClient, options?: IdentityCheckOptions): BeforePaymentCreationHook;
+/**
+ * Verify agent identity from an A2A task's payment requirements.
+ *
+ * Convenience wrapper that extracts PaymentRequired from an A2A task
+ * and delegates to `verifyAgentIdentity()`.
+ *
+ * @param client - Read-only client for on-chain contract calls
+ * @param task - The A2A task containing payment requirements
+ * @returns Whether identity verification passed (false if no requirements or no extension)
+ *
+ * @example
+ * ```typescript
+ * const a2aClient = new A2APaymentClient({
+ *   onPaymentRequired: async (requirements) => {
+ *     const verified = await verifyAgentIdentityFromTask(viemClient, task);
+ *     if (!verified) throw new Error("Agent identity not verified");
+ *   },
+ * });
+ * ```
+ */
+declare function verifyAgentIdentityFromTask(client: ERC8004ReadClient, task: A2ATask): Promise<boolean>;
+/**
+ * Create a BeforeVerifyHook that checks agent reputation before verification.
+ *
+ * Queries the Reputation Registry for the agent's score from trusted
+ * reviewers. If below threshold, aborts or warns per config.
+ *
+ * @param client - Read-only client for contract calls
+ * @param reputationRegistry - Reputation Registry contract address
+ * @param config - Reputation check configuration
+ * @returns BeforeVerifyHook for registration on t402ResourceServer
+ *
+ * @example
+ * ```typescript
+ * const server = new t402ResourceServer(facilitatorClient);
+ * server.onBeforeVerify(erc8004ReputationCheck(viemClient, registryAddr, {
+ *   minScore: 70,
+ *   trustedReviewers: ["0x..."],
+ *   onBelowThreshold: "reject",
+ * }));
+ * ```
+ */
+declare function erc8004ReputationCheck(client: ERC8004ReadClient, reputationRegistry: Address, config: ReputationCheckConfig): BeforeVerifyHook;
+/**
+ * Create a BeforeVerifyHook that verifies payTo matches the agent's
+ * on-chain agentWallet.
+ *
+ * Server-side counterpart to the client-side `erc8004IdentityCheck`.
+ * Ensures the payment recipient address in the accepted requirements
+ * matches the registered agent wallet.
+ *
+ * @param client - Read-only client for contract calls
+ * @returns BeforeVerifyHook for registration on t402ResourceServer
+ *
+ * @example
+ * ```typescript
+ * server.onBeforeVerify(erc8004ServerIdentityCheck(viemClient));
+ * ```
+ */
+declare function erc8004ServerIdentityCheck(client: ERC8004ReadClient): BeforeVerifyHook;
+/**
+ * Create an AfterSettleHook that submits positive feedback to the
+ * Reputation Registry after a successful payment settlement.
+ *
+ * Uses fire-and-forget: the feedback submission runs asynchronously
+ * and never blocks the settlement flow. Errors are logged as warnings.
+ *
+ * @param writeClient - Write-capable client for submitting feedback tx
+ * @param reputationRegistry - Reputation Registry contract address
+ * @param config - Feedback submission configuration
+ * @returns AfterSettleHook for registration on t402ResourceServer
+ *
+ * @example
+ * ```typescript
+ * server.onAfterSettle(erc8004SubmitFeedback(viemWalletClient, registryAddr, {
+ *   tag1: "paymentSuccess",
+ *   includeProofOfPayment: true,
+ * }));
+ * ```
+ */
+declare function erc8004SubmitFeedback(writeClient: ERC8004WriteClient, reputationRegistry: Address, config?: FeedbackSubmissionConfig): AfterSettleHook;
+
+export { type Address, type AgentIdentity, type AgentRegistry, type AgentRegistryId, type Bytes32, type ERC8004Config, type ERC8004Extension, type ERC8004PayloadExtension, type ERC8004ReadClient, type ERC8004WriteClient, ERC8004_EXTENSION_KEY, FEEDBACK_TAGS, type FeedbackFile, type FeedbackParams, type FeedbackRecord, type FeedbackSubmissionConfig, type Hex, IDENTITY_REGISTRIES, IDENTITY_REGISTRY_DOMAIN, type IdentityCheckOptions, type MetadataEntry, type ProofOfPayment, REPUTATION_REGISTRIES, type RegistrationEntry, type RegistrationFile, type ReputationCheckConfig, type ReputationSummary, type ResolvedAgent, SET_AGENT_WALLET_TYPES, type ServiceEntry, VALIDATION_REGISTRIES, type ValidationRequestParams, type ValidationStatus, type ValidationSummary, buildFeedbackFile, createERC8004PayloadExtension, declareERC8004Extension, erc8004IdentityCheck, erc8004ReputationCheck, erc8004ResourceServerExtension, erc8004ServerIdentityCheck, erc8004SubmitFeedback, fetchRegistrationFile, getAgentIdentity, getERC8004Extension, getReputationSummary, getValidationStatus, getValidationSummary, identityRegistryAbi, parseAgentRegistry, reputationRegistryAbi, resolveAgent, submitFeedback, submitValidationRequest, validationRegistryAbi, verifyAgentIdentity, verifyAgentIdentityFromTask, verifyPayToMatchesAgent };