@agirails/sdk 2.2.0 → 2.2.2

package/dist/adapters/StandardAdapter.js

@@ -59,6 +59,18 @@ class StandardAdapter extends BaseAdapter_1.BaseAdapter {
         super(requesterAddress);
         this.runtime = runtime;
         this.easHelper = easHelper;
+        /**
+         * Adapter metadata for router selection.
+         */
+        this.metadata = {
+            id: 'standard',
+            name: 'Standard Adapter',
+            usesEscrow: true,
+            supportsDisputes: true,
+            requiresIdentity: false,
+            settlementMode: 'timed', // Auto-release after dispute window
+            priority: 60, // Higher priority than basic (preferred when escrow required)
+        };
     }
     /**
      * Create a transaction (INITIATED state, no escrow yet).
@@ -109,6 +121,7 @@ class StandardAdapter extends BaseAdapter_1.BaseAdapter {
             deadline,
             disputeWindow,
             serviceDescription: params.serviceDescription,
+            agentId: params.agentId, // ERC-8004 agent ID for reputation reporting
         });
     }
     /**
@@ -268,6 +281,177 @@ class StandardAdapter extends BaseAdapter_1.BaseAdapter {
     async getTransaction(txId) {
         return this.runtime.getTransaction(txId);
     }
+    // ==========================================================================
+    // IAdapter Implementation
+    // ==========================================================================
+    /**
+     * Unified pay method for IAdapter interface.
+     *
+     * Creates transaction AND links escrow in one call.
+     *
+     * @param params - Unified payment parameters
+     * @returns Promise resolving to unified payment result
+     */
+    async pay(params) {
+        // Validate using IAdapter validate()
+        this.validate(params);
+        // Map to StandardTransactionParams
+        const standardParams = {
+            provider: params.to,
+            amount: params.amount,
+            deadline: params.deadline,
+            disputeWindow: params.disputeWindow,
+            serviceDescription: params.description,
+            agentId: params.erc8004AgentId, // Pass ERC-8004 agent ID
+        };
+        // Create transaction
+        const txId = await this.createTransaction(standardParams);
+        // Link escrow (auto-transitions to COMMITTED)
+        await this.linkEscrow(txId);
+        // Fetch transaction for response
+        const tx = await this.runtime.getTransaction(txId);
+        if (!tx) {
+            throw new Error(`Transaction ${txId} not found after creation`);
+        }
+        const provider = this.validateAddress(params.to, 'to');
+        const deadline = tx.deadline;
+        return {
+            txId,
+            escrowId: txId,
+            adapter: this.metadata.id,
+            state: 'COMMITTED',
+            success: true,
+            amount: this.formatAmount(tx.amount),
+            releaseRequired: true, // ACTP requires explicit release()
+            provider,
+            requester: this.requesterAddress,
+            deadline: new Date(deadline * 1000).toISOString(),
+            erc8004AgentId: params.erc8004AgentId, // Return agent ID
+        };
+    }
+    /**
+     * Check if this adapter can handle the given parameters.
+     *
+     * StandardAdapter can handle any Ethereum address recipient.
+     *
+     * @param params - Payment parameters to check
+     * @returns True if params have a valid Ethereum address
+     */
+    canHandle(params) {
+        // StandardAdapter handles Ethereum addresses only
+        if (typeof params.to !== 'string') {
+            return false;
+        }
+        // Check if it's an Ethereum address (0x-prefixed hex)
+        return /^0x[a-fA-F0-9]{40}$/.test(params.to);
+    }
+    /**
+     * Validate parameters before execution.
+     *
+     * @param params - Parameters to validate
+     * @throws {ValidationError} If params are invalid
+     */
+    validate(params) {
+        // Validate address
+        this.validateAddress(params.to, 'to');
+        // Validate amount (will throw if invalid)
+        this.parseAmount(params.amount);
+        // Validate deadline if provided
+        if (params.deadline !== undefined) {
+            this.parseDeadline(params.deadline);
+        }
+        // Validate dispute window if provided
+        if (params.disputeWindow !== undefined) {
+            this.validateDisputeWindow(params.disputeWindow);
+        }
+    }
+    /**
+     * Get transaction status by ID.
+     *
+     * Returns TransactionStatus with action hints.
+     *
+     * @param txId - Transaction ID
+     * @returns Promise resolving to transaction status
+     */
+    async getStatus(txId) {
+        const tx = await this.runtime.getTransaction(txId);
+        if (!tx) {
+            throw new Error(`Transaction ${txId} not found`);
+        }
+        const now = this.runtime.time.now();
+        const disputeWindowEnds = tx.completedAt
+            ? tx.completedAt + tx.disputeWindow
+            : undefined;
+        return {
+            state: tx.state,
+            canStartWork: tx.state === 'COMMITTED',
+            canDeliver: tx.state === 'IN_PROGRESS',
+            canRelease: tx.state === 'DELIVERED' &&
+                disputeWindowEnds !== undefined &&
+                now >= disputeWindowEnds,
+            canDispute: tx.state === 'DELIVERED' &&
+                disputeWindowEnds !== undefined &&
+                now < disputeWindowEnds,
+            amount: this.formatAmount(tx.amount),
+            deadline: new Date(tx.deadline * 1000).toISOString(),
+            disputeWindowEnds: disputeWindowEnds
+                ? new Date(disputeWindowEnds * 1000).toISOString()
+                : undefined,
+            provider: tx.provider,
+            requester: tx.requester,
+        };
+    }
+    /**
+     * Transition to IN_PROGRESS state (provider starts work).
+     *
+     * @param txId - Transaction ID
+     */
+    async startWork(txId) {
+        await this.runtime.transitionState(txId, 'IN_PROGRESS');
+    }
+    /**
+     * Transition to DELIVERED state (provider completes work).
+     *
+     * When no proof is provided, fetches the transaction's actual disputeWindow
+     * and encodes it as proof. This ensures consistency with the dispute window
+     * specified at transaction creation time.
+     *
+     * @param txId - Transaction ID
+     * @param proof - Optional delivery proof (ABI-encoded dispute window).
+     *                If not provided, uses transaction's disputeWindow.
+     */
+    async deliver(txId, proof) {
+        let deliveryProof = proof;
+        if (!deliveryProof) {
+            // Fetch transaction to get its actual disputeWindow
+            const tx = await this.runtime.getTransaction(txId);
+            if (!tx) {
+                throw new Error(`Transaction ${txId} not found`);
+            }
+            // Use transaction's disputeWindow, not a default
+            deliveryProof = this.encodeDisputeWindowProof(tx.disputeWindow);
+        }
+        await this.runtime.transitionState(txId, 'DELIVERED', deliveryProof);
+    }
+    /**
+     * Release escrow funds (EXPLICIT settlement).
+     *
+     * Wrapper around releaseEscrow() for IAdapter interface.
+     *
+     * @param escrowId - Escrow ID (usually same as txId)
+     * @param attestationUID - Optional attestation UID for verification
+     */
+    async release(escrowId, attestationUID) {
+        // Find txId from escrowId (they're usually the same)
+        const legacyMatch = escrowId.match(/^escrow-(.+)-\d+$/);
+        const txId = legacyMatch ? legacyMatch[1] : escrowId;
+        if (attestationUID) {
+            await this.releaseEscrow(escrowId, { txId, attestationUID });
+        }
+        else {
+            await this.releaseEscrow(escrowId);
+        }
+    }
 }
 exports.StandardAdapter = StandardAdapter;
 //# sourceMappingURL=StandardAdapter.js.map

package/dist/adapters/StandardAdapter.js.map

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

package/dist/adapters/X402Adapter.d.ts

@@ -0,0 +1,208 @@
+/**
+ * X402Adapter - HTTP 402 Payment Required Protocol (Atomic Payments)
+ *
+ * Implements the x402 protocol for atomic, instant API payments.
+ * NO escrow, NO state machine, NO disputes - just pay and receive.
+ *
+ * This is fundamentally different from ACTP:
+ * - ACTP: escrow → state machine → disputes → explicit release
+ * - x402: atomic payment → instant settlement → done
+ *
+ * Use x402 for:
+ * - Simple API calls (pay-per-request)
+ * - Instant delivery (response IS the delivery)
+ * - Low-value, high-frequency transactions
+ *
+ * Use ACTP for:
+ * - Complex services requiring verification
+ * - High-value transactions needing dispute protection
+ * - Multi-step deliveries
+ *
+ * @module adapters/X402Adapter
+ */
+import { BaseAdapter } from './BaseAdapter';
+import { IAdapter, TransactionStatus } from './IAdapter';
+import { AdapterMetadata, UnifiedPayParams, UnifiedPayResult } from '../types/adapter';
+import { X402Network } from '../types/x402';
+/** Type for fetch function (cross-platform compatible) */
+export type FetchFunction = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Transfer function for atomic payments.
+ *
+ * @param to - Recipient address
+ * @param amount - Amount in USDC wei (string)
+ * @returns Transaction hash as proof
+ */
+export type TransferFunction = (to: string, amount: string) => Promise<string>;
+/** Supported HTTP methods for x402 requests */
+export type X402HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * Extended payment parameters for x402 with full HTTP support.
+ */
+export interface X402PayParams extends UnifiedPayParams {
+    /** HTTP method (default: GET) */
+    method?: X402HttpMethod;
+    /** Custom request headers */
+    headers?: Record<string, string>;
+    /** Request body (string or object, will be JSON.stringify'd if object) */
+    body?: string | Record<string, unknown>;
+    /** Content-Type header (default: application/json for POST/PUT/PATCH with body) */
+    contentType?: string;
+}
+/**
+ * Configuration options for X402Adapter.
+ */
+export interface X402AdapterConfig {
+    /** Expected network for validation (must match server's X-Payment-Network) */
+    expectedNetwork: X402Network;
+    /** Transfer function for atomic payments (required) */
+    transferFn: TransferFunction;
+    /** Request timeout in milliseconds (default: 30000) */
+    requestTimeout?: number;
+    /** Custom fetch function for testing (default: global fetch) */
+    fetchFn?: FetchFunction;
+    /** Default headers to include in all requests */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * X402Adapter - Atomic HTTP payment protocol.
+ *
+ * Key characteristics:
+ * - usesEscrow: false (direct payment)
+ * - supportsDisputes: false (atomic = final)
+ * - settlementMode: 'atomic' (instant)
+ * - releaseRequired: false (no escrow to release)
+ *
+ * @example
+ * ```typescript
+ * const adapter = new X402Adapter(requesterAddress, {
+ *   expectedNetwork: 'base-sepolia',
+ *   transferFn: async (to, amount) => {
+ *     const tx = await usdcContract.transfer(to, amount);
+ *     return tx.hash;
+ *   },
+ * });
+ *
+ * const result = await adapter.pay({
+ *   to: 'https://api.provider.com/service',
+ *   amount: '10', // Hint only, actual amount from 402
+ * });
+ *
+ * // That's it! No release() needed.
+ * console.log(result.response?.status); // 200
+ * console.log(result.releaseRequired);  // false
+ * ```
+ */
+export declare class X402Adapter extends BaseAdapter implements IAdapter {
+    private config;
+    /**
+     * Adapter metadata - atomic, no escrow.
+     */
+    readonly metadata: AdapterMetadata;
+    private readonly timeout;
+    private readonly fetchFn;
+    private readonly defaultHeaders;
+    private readonly transferFn;
+    /** Local cache of payments for status lookups */
+    private readonly payments;
+    /**
+     * Creates a new X402Adapter instance.
+     *
+     * @param requesterAddress - The requester's Ethereum address
+     * @param config - X402-specific configuration
+     */
+    constructor(requesterAddress: string, config: X402AdapterConfig);
+    /**
+     * Check if this adapter can handle the given parameters.
+     *
+     * X402Adapter handles HTTPS URLs only (security requirement).
+     */
+    canHandle(params: UnifiedPayParams): boolean;
+    /**
+     * Validate parameters before execution.
+     */
+    validate(params: UnifiedPayParams): void;
+    /**
+     * Execute atomic x402 payment flow with full HTTP support.
+     *
+     * 1. Request endpoint → get 402
+     * 2. Parse payment headers
+     * 3. Execute atomic USDC transfer
+     * 4. Retry with tx hash as proof (same method/headers/body)
+     * 5. Return response (settlement complete!)
+     *
+     * @param params - Payment parameters with optional HTTP method, headers, body
+     */
+    pay(params: UnifiedPayParams | X402PayParams): Promise<UnifiedPayResult>;
+    /**
+     * Serialize request body to string.
+     */
+    private serializeBody;
+    /**
+     * Get payment status by transaction hash.
+     *
+     * For atomic payments, status is simple:
+     * - If tx exists → SETTLED (atomic = instant settlement)
+     */
+    getStatus(txId: string): Promise<TransactionStatus>;
+    /**
+     * Not applicable for atomic payments.
+     * @throws {Error} Always - x402 has no lifecycle
+     */
+    startWork(_txId: string): Promise<void>;
+    /**
+     * Not applicable for atomic payments.
+     * @throws {Error} Always - x402 has no lifecycle
+     */
+    deliver(_txId: string, _proof?: string): Promise<void>;
+    /**
+     * Not applicable for atomic payments.
+     * @throws {Error} Always - x402 has no escrow
+     */
+    release(_escrowId: string, _attestationUID?: string): Promise<void>;
+    /**
+     * Make an HTTP request with full options support.
+     *
+     * @param url - Request URL
+     * @param method - HTTP method
+     * @param customHeaders - Custom headers from request params
+     * @param body - Request body (optional)
+     * @param contentType - Content-Type header (optional)
+     * @param proofHeaders - Payment proof headers for retry (optional)
+     */
+    private makeRequest;
+    /**
+     * Parse X-Payment-* headers from 402 response.
+     */
+    private parsePaymentHeaders;
+    /**
+     * Validate payment address from header.
+     */
+    private validatePaymentAddress;
+    /**
+     * Execute atomic payment - direct transfer to provider.
+     *
+     * This is the key difference from ACTP:
+     * - No escrow
+     * - No state machine
+     * - Just transfer and done
+     */
+    private executeAtomicPayment;
+    /**
+     * Retry request with payment proof (tx hash).
+     * Uses the same HTTP method, headers, and body as the original request.
+     *
+     * @param endpoint - Request URL
+     * @param txHash - Payment transaction hash as proof
+     * @param method - Original HTTP method
+     * @param customHeaders - Original custom headers
+     * @param body - Original request body
+     * @param contentType - Original content-type
+     */
+    private retryWithProof;
+    /**
+     * Create result for free services (200 on initial request).
+     */
+    private createFreeServiceResult;
+}
+//# sourceMappingURL=X402Adapter.d.ts.map

package/dist/adapters/X402Adapter.d.ts.map

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