@agirails/sdk 2.2.0 → 2.2.2

package/dist/types/adapter.d.ts

@@ -0,0 +1,359 @@
+/**
+ * Adapter types for the ACTP SDK adapter routing system.
+ *
+ * This module defines types and Zod schemas for:
+ * - AdapterMetadata: Capabilities and configuration for each adapter
+ * - PaymentMetadata: Request-level hints for adapter selection
+ * - UnifiedPayParams: Common payment parameters across adapters
+ * - UnifiedPayResult: Common result type for all adapters
+ *
+ * @module types/adapter
+ */
+import { z } from 'zod';
+/**
+ * Metadata describing an adapter's capabilities.
+ *
+ * CRITICAL: All adapters must respect ACTP state machine:
+ * - No skipping IN_PROGRESS state
+ * - DELIVERED requires proof
+ * - releaseEscrow must be called explicitly (NO auto-settle)
+ */
+export interface AdapterMetadata {
+    /** Unique adapter identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Whether adapter uses escrow */
+    usesEscrow: boolean;
+    /** Whether adapter supports dispute resolution */
+    supportsDisputes: boolean;
+    /** Whether adapter requires on-chain identity */
+    requiresIdentity: boolean;
+    /** Supported identity types (erc8004, did, ens) */
+    supportedIdentityTypes?: string[];
+    /**
+     * Settlement mode:
+     * - 'explicit': caller must call releaseEscrow (REQUIRED for ACTP compliance)
+     * - 'timed': auto-release after dispute window (future, not Phase 1)
+     * - 'atomic': instant settlement, no escrow (x402 protocol)
+     */
+    settlementMode: 'explicit' | 'timed' | 'atomic';
+    /** Priority for auto-selection (higher = preferred) */
+    priority: number;
+}
+/**
+ * Zod schema for AdapterMetadata runtime validation.
+ */
+export declare const AdapterMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    usesEscrow: z.ZodBoolean;
+    supportsDisputes: z.ZodBoolean;
+    requiresIdentity: z.ZodBoolean;
+    supportedIdentityTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    settlementMode: z.ZodEnum<["explicit", "timed", "atomic"]>;
+    priority: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    usesEscrow: boolean;
+    supportsDisputes: boolean;
+    requiresIdentity: boolean;
+    settlementMode: "explicit" | "timed" | "atomic";
+    priority: number;
+    supportedIdentityTypes?: string[] | undefined;
+}, {
+    id: string;
+    name: string;
+    usesEscrow: boolean;
+    supportsDisputes: boolean;
+    requiresIdentity: boolean;
+    settlementMode: "explicit" | "timed" | "atomic";
+    priority: number;
+    supportedIdentityTypes?: string[] | undefined;
+}>;
+/**
+ * Identity information for adapter selection.
+ */
+export interface PaymentIdentity {
+    type: 'erc8004' | 'did' | 'ens' | 'address';
+    value: string;
+}
+/**
+ * Payment request metadata for adapter selection.
+ */
+export interface PaymentMetadata {
+    /** Explicitly request specific adapter */
+    preferredAdapter?: string;
+    /** Require escrow protection */
+    requiresEscrow?: boolean;
+    /** Require dispute resolution capability */
+    requiresDispute?: boolean;
+    /** Identity information */
+    identity?: PaymentIdentity;
+    /** x402 specific: payment method hint */
+    paymentMethod?: 'x402' | 'actp' | 'auto';
+}
+/**
+ * Zod schema for PaymentIdentity runtime validation.
+ */
+export declare const PaymentIdentitySchema: z.ZodObject<{
+    type: z.ZodEnum<["erc8004", "did", "ens", "address"]>;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "address" | "erc8004" | "did" | "ens";
+    value: string;
+}, {
+    type: "address" | "erc8004" | "did" | "ens";
+    value: string;
+}>;
+/**
+ * Zod schema for PaymentMetadata runtime validation.
+ */
+export declare const PaymentMetadataSchema: z.ZodObject<{
+    preferredAdapter: z.ZodOptional<z.ZodString>;
+    requiresEscrow: z.ZodOptional<z.ZodBoolean>;
+    requiresDispute: z.ZodOptional<z.ZodBoolean>;
+    identity: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["erc8004", "did", "ens", "address"]>;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "address" | "erc8004" | "did" | "ens";
+        value: string;
+    }, {
+        type: "address" | "erc8004" | "did" | "ens";
+        value: string;
+    }>>;
+    paymentMethod: z.ZodOptional<z.ZodEnum<["x402", "actp", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    preferredAdapter?: string | undefined;
+    requiresEscrow?: boolean | undefined;
+    requiresDispute?: boolean | undefined;
+    identity?: {
+        type: "address" | "erc8004" | "did" | "ens";
+        value: string;
+    } | undefined;
+    paymentMethod?: "x402" | "actp" | "auto" | undefined;
+}, {
+    preferredAdapter?: string | undefined;
+    requiresEscrow?: boolean | undefined;
+    requiresDispute?: boolean | undefined;
+    identity?: {
+        type: "address" | "erc8004" | "did" | "ens";
+        value: string;
+    } | undefined;
+    paymentMethod?: "x402" | "actp" | "auto" | undefined;
+}>;
+/**
+ * Unified payment parameters accepted by all adapters.
+ */
+export interface UnifiedPayParams {
+    /** Recipient - address, HTTP endpoint, or ERC-8004 agent ID */
+    to: string;
+    /** Amount in human-readable format */
+    amount: string | number;
+    /** Deadline (relative like '+24h' or unix timestamp) */
+    deadline?: string | number;
+    /** Dispute window in seconds (min 3600, max 30 days) */
+    disputeWindow?: number;
+    /** Service description */
+    description?: string;
+    /** Adapter selection metadata */
+    metadata?: PaymentMetadata;
+    /**
+     * ERC-8004 agent ID (populated when 'to' was resolved from agentId).
+     * Set by AdapterRouter when resolving agent ID to wallet address.
+     * Used for reputation reporting after settlement.
+     */
+    erc8004AgentId?: string;
+}
+/**
+ * Zod schema for UnifiedPayParams with strict validation.
+ */
+export declare const UnifiedPayParamsSchema: z.ZodObject<{
+    to: z.ZodString;
+    amount: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    deadline: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    disputeWindow: z.ZodOptional<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        preferredAdapter: z.ZodOptional<z.ZodString>;
+        requiresEscrow: z.ZodOptional<z.ZodBoolean>;
+        requiresDispute: z.ZodOptional<z.ZodBoolean>;
+        identity: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["erc8004", "did", "ens", "address"]>;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        }, {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        }>>;
+        paymentMethod: z.ZodOptional<z.ZodEnum<["x402", "actp", "auto"]>>;
+    }, "strip", z.ZodTypeAny, {
+        preferredAdapter?: string | undefined;
+        requiresEscrow?: boolean | undefined;
+        requiresDispute?: boolean | undefined;
+        identity?: {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        } | undefined;
+        paymentMethod?: "x402" | "actp" | "auto" | undefined;
+    }, {
+        preferredAdapter?: string | undefined;
+        requiresEscrow?: boolean | undefined;
+        requiresDispute?: boolean | undefined;
+        identity?: {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        } | undefined;
+        paymentMethod?: "x402" | "actp" | "auto" | undefined;
+    }>>;
+    erc8004AgentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string | number;
+    to: string;
+    deadline?: string | number | undefined;
+    disputeWindow?: number | undefined;
+    description?: string | undefined;
+    metadata?: {
+        preferredAdapter?: string | undefined;
+        requiresEscrow?: boolean | undefined;
+        requiresDispute?: boolean | undefined;
+        identity?: {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        } | undefined;
+        paymentMethod?: "x402" | "actp" | "auto" | undefined;
+    } | undefined;
+    erc8004AgentId?: string | undefined;
+}, {
+    amount: string | number;
+    to: string;
+    deadline?: string | number | undefined;
+    disputeWindow?: number | undefined;
+    description?: string | undefined;
+    metadata?: {
+        preferredAdapter?: string | undefined;
+        requiresEscrow?: boolean | undefined;
+        requiresDispute?: boolean | undefined;
+        identity?: {
+            type: "address" | "erc8004" | "did" | "ens";
+            value: string;
+        } | undefined;
+        paymentMethod?: "x402" | "actp" | "auto" | undefined;
+    } | undefined;
+    erc8004AgentId?: string | undefined;
+}>;
+/**
+ * Transaction state after payment initiation.
+ *
+ * Note: 'COMMITTED' means funds are locked but work hasn't started.
+ * 'IN_PROGRESS' means provider has acknowledged and started work.
+ */
+export type InitialTransactionState = 'COMMITTED' | 'IN_PROGRESS';
+/**
+ * Unified payment result returned by all adapters.
+ *
+ * NOTE: success=true means payment INITIATED, not settled.
+ * Caller must call releaseEscrow() after delivery verification.
+ */
+export interface UnifiedPayResult {
+    /** ACTP transaction ID */
+    txId: string;
+    /** Escrow ID (for release) - null for non-escrow adapters */
+    escrowId: string | null;
+    /** Adapter that handled the payment */
+    adapter: string;
+    /** Current state (COMMITTED, not SETTLED) */
+    state: InitialTransactionState;
+    /** Whether payment initiation succeeded */
+    success: boolean;
+    /** Amount locked (formatted) */
+    amount: string;
+    /** For x402: the HTTP response */
+    response?: Response;
+    /** Error message if failed */
+    error?: string;
+    /**
+     * IMPORTANT: Payment is NOT complete until you call:
+     * await client.release(result.escrowId)
+     *
+     * Always true for ACTP-compliant adapters.
+     */
+    releaseRequired: boolean;
+    /** Provider address (normalized to lowercase) */
+    provider: string;
+    /** Requester address (normalized to lowercase) */
+    requester: string;
+    /** Deadline as ISO 8601 timestamp */
+    deadline: string;
+    /**
+     * ERC-8004 agent ID (if transaction involved ERC-8004 agent).
+     * Use with ReputationReporter.reportSettlement() after release.
+     */
+    erc8004AgentId?: string;
+}
+/**
+ * Zod schema for UnifiedPayResult validation.
+ */
+export declare const UnifiedPayResultSchema: z.ZodObject<{
+    txId: z.ZodString;
+    escrowId: z.ZodNullable<z.ZodString>;
+    adapter: z.ZodString;
+    state: z.ZodEnum<["COMMITTED", "IN_PROGRESS"]>;
+    success: z.ZodBoolean;
+    amount: z.ZodString;
+    response: z.ZodOptional<z.ZodAny>;
+    error: z.ZodOptional<z.ZodString>;
+    releaseRequired: z.ZodBoolean;
+    provider: z.ZodString;
+    requester: z.ZodString;
+    deadline: z.ZodString;
+    erc8004AgentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    txId: string;
+    requester: string;
+    provider: string;
+    amount: string;
+    deadline: string;
+    escrowId: string | null;
+    adapter: string;
+    state: "COMMITTED" | "IN_PROGRESS";
+    success: boolean;
+    releaseRequired: boolean;
+    response?: any;
+    error?: string | undefined;
+    erc8004AgentId?: string | undefined;
+}, {
+    txId: string;
+    requester: string;
+    provider: string;
+    amount: string;
+    deadline: string;
+    escrowId: string | null;
+    adapter: string;
+    state: "COMMITTED" | "IN_PROGRESS";
+    success: boolean;
+    releaseRequired: boolean;
+    response?: any;
+    error?: string | undefined;
+    erc8004AgentId?: string | undefined;
+}>;
+/**
+ * Validates UnifiedPayParams at runtime.
+ *
+ * @param params - Parameters to validate
+ * @returns Validated params
+ * @throws {z.ZodError} If validation fails
+ */
+export declare function validatePayParams(params: unknown): UnifiedPayParams;
+/**
+ * Safe parse for UnifiedPayParams (doesn't throw).
+ *
+ * @param params - Parameters to validate
+ * @returns Result with success flag and data or error
+ */
+export declare function safeValidatePayParams(params: unknown): z.SafeParseReturnType<unknown, UnifiedPayParams>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/adapter.d.ts.map

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

package/dist/types/adapter.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Adapter types for the ACTP SDK adapter routing system.
+ *
+ * This module defines types and Zod schemas for:
+ * - AdapterMetadata: Capabilities and configuration for each adapter
+ * - PaymentMetadata: Request-level hints for adapter selection
+ * - UnifiedPayParams: Common payment parameters across adapters
+ * - UnifiedPayResult: Common result type for all adapters
+ *
+ * @module types/adapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeValidatePayParams = exports.validatePayParams = exports.UnifiedPayResultSchema = exports.UnifiedPayParamsSchema = exports.PaymentMetadataSchema = exports.PaymentIdentitySchema = exports.AdapterMetadataSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema for AdapterMetadata runtime validation.
+ */
+exports.AdapterMetadataSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    usesEscrow: zod_1.z.boolean(),
+    supportsDisputes: zod_1.z.boolean(),
+    requiresIdentity: zod_1.z.boolean(),
+    supportedIdentityTypes: zod_1.z.array(zod_1.z.string()).optional(),
+    settlementMode: zod_1.z.enum(['explicit', 'timed', 'atomic']),
+    priority: zod_1.z.number().int().min(0).max(100),
+});
+/**
+ * Zod schema for PaymentIdentity runtime validation.
+ */
+exports.PaymentIdentitySchema = zod_1.z.object({
+    type: zod_1.z.enum(['erc8004', 'did', 'ens', 'address']),
+    value: zod_1.z.string().min(1),
+});
+/**
+ * Zod schema for PaymentMetadata runtime validation.
+ */
+exports.PaymentMetadataSchema = zod_1.z.object({
+    preferredAdapter: zod_1.z.string().optional(),
+    requiresEscrow: zod_1.z.boolean().optional(),
+    requiresDispute: zod_1.z.boolean().optional(),
+    identity: exports.PaymentIdentitySchema.optional(),
+    paymentMethod: zod_1.z.enum(['x402', 'actp', 'auto']).optional(),
+});
+/**
+ * Minimum dispute window in seconds (1 hour).
+ * Ensures requesters have reasonable time to dispute.
+ */
+const MIN_DISPUTE_WINDOW = 3600;
+/**
+ * Maximum dispute window in seconds (30 days).
+ * Prevents excessively long fund locks.
+ */
+const MAX_DISPUTE_WINDOW = 30 * 24 * 3600;
+/**
+ * Zod schema for UnifiedPayParams with strict validation.
+ */
+exports.UnifiedPayParamsSchema = zod_1.z.object({
+    to: zod_1.z.string().min(1),
+    amount: zod_1.z.union([zod_1.z.string().min(1), zod_1.z.number().positive()]),
+    deadline: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
+    disputeWindow: zod_1.z
+        .number()
+        .int()
+        .min(MIN_DISPUTE_WINDOW)
+        .max(MAX_DISPUTE_WINDOW)
+        .optional(),
+    description: zod_1.z.string().optional(),
+    metadata: exports.PaymentMetadataSchema.optional(),
+    erc8004AgentId: zod_1.z.string().optional(),
+});
+/**
+ * Zod schema for UnifiedPayResult validation.
+ */
+exports.UnifiedPayResultSchema = zod_1.z.object({
+    txId: zod_1.z.string().min(1),
+    escrowId: zod_1.z.string().nullable(),
+    adapter: zod_1.z.string().min(1),
+    state: zod_1.z.enum(['COMMITTED', 'IN_PROGRESS']),
+    success: zod_1.z.boolean(),
+    amount: zod_1.z.string().min(1),
+    response: zod_1.z.any().optional(),
+    error: zod_1.z.string().optional(),
+    releaseRequired: zod_1.z.boolean(),
+    provider: zod_1.z.string().min(1),
+    requester: zod_1.z.string().min(1),
+    deadline: zod_1.z.string().min(1),
+    erc8004AgentId: zod_1.z.string().optional(),
+});
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validates UnifiedPayParams at runtime.
+ *
+ * @param params - Parameters to validate
+ * @returns Validated params
+ * @throws {z.ZodError} If validation fails
+ */
+function validatePayParams(params) {
+    return exports.UnifiedPayParamsSchema.parse(params);
+}
+exports.validatePayParams = validatePayParams;
+/**
+ * Safe parse for UnifiedPayParams (doesn't throw).
+ *
+ * @param params - Parameters to validate
+ * @returns Result with success flag and data or error
+ */
+function safeValidatePayParams(params) {
+    return exports.UnifiedPayParamsSchema.safeParse(params);
+}
+exports.safeValidatePayParams = safeValidatePayParams;
+//# sourceMappingURL=adapter.js.map

package/dist/types/adapter.js.map

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

package/dist/types/erc8004.d.ts

@@ -0,0 +1,184 @@
+/**
+ * ERC-8004 Trustless Agents - SDK Types
+ *
+ * Types and constants for ERC-8004 integration.
+ *
+ * SECURITY NOTES:
+ * - Identity Registry is read-only (safe, no gas)
+ * - Reputation Registry writes require gas (requester pays)
+ * - Replay protection via feedbackHash = keccak256(txId)
+ * - ERC-8004 restriction: feedback submitter ≠ agent owner
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-8004
+ * @module types/erc8004
+ */
+/**
+ * Networks with ERC-8004 registry deployments.
+ */
+export type ERC8004Network = 'ethereum' | 'base' | 'base-sepolia';
+/**
+ * Agent identity resolved from ERC-8004 Identity Registry.
+ */
+export interface ERC8004Agent {
+    /** ERC-8004 agent ID (uint256 as string) */
+    agentId: string;
+    /** Owner address (EOA that controls the NFT) */
+    owner: string;
+    /** Payment wallet address (checksummed) */
+    wallet: string;
+    /** Agent URI (IPFS or HTTPS, points to metadata JSON) */
+    agentURI: string;
+    /** Parsed metadata from agentURI (may be undefined if fetch fails) */
+    metadata?: ERC8004AgentMetadata;
+    /** Network where agent is registered */
+    network: ERC8004Network;
+}
+/**
+ * Agent metadata schema from ERC-8004 agentURI.
+ *
+ * Standard fields defined by ERC-8004, plus arbitrary extensions.
+ */
+export interface ERC8004AgentMetadata {
+    /** Human-readable agent name */
+    name?: string;
+    /** Agent description */
+    description?: string;
+    /** Agent avatar/logo URL */
+    image?: string;
+    /** Wallet address for receiving payments (overrides owner) */
+    paymentAddress?: string;
+    /** Alternative field name for payment address */
+    wallet?: string;
+    /** List of agent capabilities */
+    capabilities?: string[];
+    /** Service endpoints */
+    endpoints?: {
+        api?: string;
+        webhook?: string;
+    };
+    /** Allow arbitrary extensions */
+    [key: string]: unknown;
+}
+/**
+ * Feedback entry for ERC-8004 Reputation Registry.
+ *
+ * For ACTP settlements, we use binary values:
+ * - value: 1 (success) or -1 (dispute lost)
+ * - valueDecimals: 0 (no fractional part)
+ */
+export interface ReputationFeedback {
+    /** ERC-8004 agent ID */
+    agentId: string;
+    /**
+     * Feedback value.
+     * For ACTP: 1 = successful settlement, -1 = dispute lost
+     */
+    value: number;
+    /**
+     * Decimal precision for value.
+     * For ACTP: always 0 (binary)
+     */
+    valueDecimals: number;
+    /**
+     * Primary tag for categorization.
+     * ACTP uses: 'actp_settled', 'actp_dispute_won', 'actp_dispute_lost'
+     */
+    tag1: string;
+    /**
+     * Secondary tag for filtering.
+     * ACTP uses: capability (e.g., 'code_generation', 'data_analysis')
+     */
+    tag2: string;
+    /** Service endpoint (optional) */
+    endpoint?: string;
+    /** Link to detailed feedback (optional, IPFS or HTTPS) */
+    feedbackURI?: string;
+    /**
+     * Hash for replay protection.
+     * ACTP uses: keccak256(txId)
+     */
+    feedbackHash: string;
+}
+/**
+ * Aggregated reputation summary for an agent.
+ */
+export interface ReputationSummary {
+    /** ERC-8004 agent ID */
+    agentId: string;
+    /** Total feedback count */
+    feedbackCount: number;
+    /** Count of positive feedback (value > 0) */
+    positiveCount: number;
+    /** Count of negative feedback (value < 0) */
+    negativeCount: number;
+    /** Aggregated score (sum of values) */
+    score: number;
+}
+/**
+ * ERC-8004 error codes.
+ */
+export declare enum ERC8004ErrorCode {
+    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
+    INVALID_AGENT_ID = "INVALID_AGENT_ID",
+    WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
+    METADATA_FETCH_FAILED = "METADATA_FETCH_FAILED",
+    REPORT_FAILED = "REPORT_FAILED",
+    ALREADY_REPORTED = "ALREADY_REPORTED",
+    NOT_AUTHORIZED = "NOT_AUTHORIZED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    INVALID_NETWORK = "INVALID_NETWORK"
+}
+/**
+ * Custom error for ERC-8004 operations.
+ */
+export declare class ERC8004Error extends Error {
+    readonly code: ERC8004ErrorCode;
+    readonly agentId?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: ERC8004ErrorCode, agentId?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * ERC-8004 Identity Registry addresses per network.
+ *
+ * Canonical CREATE2 addresses from: https://github.com/erc-8004/erc-8004-contracts
+ * Vanity prefix 0x8004 ensures same address across all EVM chains.
+ */
+export declare const ERC8004_IDENTITY_REGISTRY: Record<ERC8004Network, string>;
+/**
+ * ERC-8004 Reputation Registry addresses per network.
+ *
+ * Canonical CREATE2 addresses from: https://github.com/erc-8004/erc-8004-contracts
+ * Vanity prefix 0x8004 ensures same address across all EVM chains.
+ */
+export declare const ERC8004_REPUTATION_REGISTRY: Record<ERC8004Network, string>;
+/**
+ * Minimal ABI for ERC-8004 Identity Registry.
+ * Only includes view functions needed by ERC8004Bridge.
+ */
+export declare const ERC8004_IDENTITY_ABI: readonly ["function ownerOf(uint256 agentId) view returns (address)", "function getAgentURI(uint256 agentId) view returns (string)", "function balanceOf(address owner) view returns (uint256)", "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)"];
+/**
+ * Minimal ABI for ERC-8004 Reputation Registry.
+ * Includes both read and write functions.
+ */
+export declare const ERC8004_REPUTATION_ABI: readonly ["function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash) external", "function revokeLatest(uint256 agentId, uint64 feedbackIndex) external", "function getSummary(uint256 agentId, address[] clientAddresses, string tag1, string tag2) view returns (uint256 count, int256 summaryValue, uint8 summaryValueDecimals)", "function readFeedback(uint256 agentId, uint64 feedbackIndex) view returns (tuple(int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked, uint64 feedbackIndex))"];
+/**
+ * Default RPC URLs for each network.
+ * Used when no custom RPC is provided.
+ */
+export declare const ERC8004_DEFAULT_RPC: Record<ERC8004Network, string>;
+/**
+ * ACTP feedback tags for ERC-8004 Reputation.
+ */
+export declare const ACTP_FEEDBACK_TAGS: {
+    /** Successful settlement */
+    readonly SETTLED: "actp_settled";
+    /** Agent won dispute */
+    readonly DISPUTE_WON: "actp_dispute_won";
+    /** Agent lost dispute (requester won) */
+    readonly DISPUTE_LOST: "actp_dispute_lost";
+};
+/**
+ * Type for ACTP feedback tags.
+ */
+export type ACTPFeedbackTag = (typeof ACTP_FEEDBACK_TAGS)[keyof typeof ACTP_FEEDBACK_TAGS];
+//# sourceMappingURL=erc8004.d.ts.map

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

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