@agirails/sdk 2.5.2 → 2.5.4

package/src/index.ts

@@ -1,364 +0,0 @@
-/**
- * AGIRAILS SDK - Agent Commerce Transaction Protocol
- *
- * This is the main entry point for the AGIRAILS SDK.
- * The recommended way to use this SDK is through the ACTPClient class.
- *
- * @packageDocumentation
- *
- * @example
- * ```typescript
- * import { ACTPClient } from '@agirails/sdk';
- *
- * // Create client in mock mode
- * const client = await ACTPClient.create({
- *   mode: 'mock',
- *   requesterAddress: '0x1234...',
- * });
- *
- * // Mint some tokens for testing
- * await client.mintTokens(client.getAddress(), '10000000000');
- *
- * // Create a payment
- * const result = await client.basic.pay({
- *   to: '0xProvider...',
- *   amount: '100',
- * });
- *
- * console.log('Transaction ID:', result.txId);
- * ```
- */
-
-// =============================================================================
-// Primary API - ACTPClient
-// =============================================================================
-
-export {
-  ACTPClient,
-  ACTPClientConfig,
-  ACTPClientMode,
-  ACTPClientInfo,
-} from './ACTPClient';
-
-// =============================================================================
-// Adapter Layer - Three-Level API
-// =============================================================================
-
-export {
-  BaseAdapter,
-  DEFAULT_DISPUTE_WINDOW_SECONDS,
-  DEFAULT_DEADLINE_SECONDS,
-  MIN_AMOUNT_WEI,
-  MAX_DEADLINE_HOURS,
-  MAX_DEADLINE_DAYS,
-} from './adapters/BaseAdapter';
-
-export {
-  BasicAdapter,
-  BasicPayParams,
-  BasicPayResult,
-} from './adapters/BasicAdapter';
-
-export {
-  StandardAdapter,
-  StandardTransactionParams,
-} from './adapters/StandardAdapter';
-
-export {
-  X402Adapter,
-  X402AdapterConfig,
-  X402PayParams,
-} from './adapters/X402Adapter';
-
-export { AdapterRegistry } from './adapters/AdapterRegistry';
-
-export {
-  AdapterRouter,
-  AdapterSelectionResult,
-} from './adapters/AdapterRouter';
-
-export {
-  IAdapter,
-  TransactionStatus,
-  AdapterTransactionState,
-  isAdapter,
-} from './adapters/IAdapter';
-
-// =============================================================================
-// Runtime Layer - Protocol Implementation
-// =============================================================================
-
-// Runtime interfaces
-export {
-  IACTPRuntime,
-  IMockRuntime,
-  CreateTransactionParams,
-} from './runtime/IACTPRuntime';
-
-// MockRuntime (for local development)
-export {
-  MockRuntime,
-  InsufficientBalanceError,
-  EscrowNotFoundError,
-  DeadlinePassedError,
-  ContractPausedError,
-  DisputeWindowActiveError,
-} from './runtime/MockRuntime';
-
-// MockStateManager (for custom state management)
-export {
-  MockStateManager,
-  MockStateCorruptedError,
-  MockStateVersionError,
-  MockStateLockError,
-} from './runtime/MockStateManager';
-
-// BlockchainRuntime (for testnet/mainnet)
-export {
-  BlockchainRuntime,
-  BlockchainRuntimeConfig,
-} from './runtime/BlockchainRuntime';
-
-// =============================================================================
-// Type Exports
-// =============================================================================
-
-export {
-  MockState,
-  MockTransaction,
-  MockEscrow,
-  MockAccount,
-  MockBlockchain,
-  MockEvent,
-  TransactionState,
-  TransactionStateValue,
-  MOCK_STATE_DEFAULTS,
-} from './runtime/types/MockState';
-
-// =============================================================================
-// Protocol Layer (from sdk-js merge)
-// =============================================================================
-
-// Protocol modules
-export { ACTPKernel } from './protocol/ACTPKernel';
-export { EscrowVault } from './protocol/EscrowVault';
-export { EventMonitor } from './protocol/EventMonitor';
-export { MessageSigner } from './protocol/MessageSigner';
-export { ProofGenerator, URLValidationConfig } from './protocol/ProofGenerator';
-export { EASHelper, EASConfig } from './protocol/EASHelper';
-export { AgentRegistry } from './protocol/AgentRegistry';
-export { DIDManager } from './protocol/DIDManager';
-export { DIDResolver } from './protocol/DIDResolver';
-
-// Builders
-export { QuoteBuilder } from './builders/QuoteBuilder';
-export { DeliveryProofBuilder } from './builders/DeliveryProofBuilder';
-
-// Config
-export { getNetwork } from './config/networks';
-export type { NetworkConfig } from './config/networks';
-
-// Protocol types
-export type {
-  State,
-  Transaction,
-  CreateTransactionParams as ProtocolCreateParams,
-  DisputeResolution,
-  EconomicParams,
-} from './types';
-
-// Utils
-export { NonceManager, InMemoryNonceManager } from './utils/NonceManager';
-export { IReceivedNonceTracker, InMemoryReceivedNonceTracker } from './utils/ReceivedNonceTracker';
-// Note: IPFSClient is not exported from main index to avoid ESM compatibility issues
-// Import directly from '@agirails/sdk/utils/IPFSClient' if needed
-export type { IPFSClient, IPFSClientConfig } from './utils/IPFSClient';
-export { generateSecureNonce, isValidNonce, generateSecureNonces } from './utils/SecureNonce';
-export { Semaphore, RateLimiter } from './utils/Semaphore';
-export {
-  IUsedAttestationTracker,
-  InMemoryUsedAttestationTracker,
-  FileBasedUsedAttestationTracker,
-  createUsedAttestationTracker,
-} from './utils/UsedAttestationTracker';
-
-// Wallet
-export { resolvePrivateKey, getCachedAddress } from './wallet/keystore';
-export type {
-  IWalletProvider,
-  TransactionRequest as WalletTransactionRequest,
-  TransactionReceipt as WalletTransactionReceipt,
-  WalletInfo,
-  WalletTier,
-  BatchedPayParams,
-  BatchedPayResult,
-} from './wallet/IWalletProvider';
-export { EOAWalletProvider } from './wallet/EOAWalletProvider';
-export { AutoWalletProvider } from './wallet/AutoWalletProvider';
-export type { AutoWalletConfig } from './wallet/AutoWalletProvider';
-
-// Helper utilities
-export {
-  USDC,
-  Deadline,
-  Address,
-  Bytes32,
-  State as StateHelpers,
-  DisputeWindow,
-  parseUSDC,
-  formatUSDC,
-  shortenAddress,
-  ServiceHash,
-  hashServiceMetadata,
-} from './utils/Helpers';
-export type { ServiceMetadata } from './utils/Helpers';
-
-// =============================================================================
-// Basic API - Simple provide/request interface
-// =============================================================================
-
-export { provide, request, serviceDirectory } from './level0';
-export type {
-  Provider,
-  ProviderStatus,
-  ProviderStats,
-  ProviderBalance,
-} from './level0';
-
-// =============================================================================
-// Standard API - Agent-based interface
-// =============================================================================
-
-export { Agent, calculatePrice, DEFAULT_PRICING_STRATEGY } from './level1';
-export type {
-  AgentConfig,
-  AgentStatus,
-  AgentStats,
-  AgentBalance,
-  ServiceConfig,
-  Job,
-  JobHandler,
-  JobContext,
-  ProvideOptions,
-  RequestOptions,
-  RequestResult,
-  RequestStatus,
-  WalletOption,
-  NetworkOption,
-  PricingStrategy,
-  ServiceCost,
-  BelowPriceBehavior,
-  BelowCostBehavior,
-  PriceCalculation,
-} from './level1';
-
-// =============================================================================
-// Storage Layer (AIP-7 §4) - Hybrid IPFS + Arweave
-// =============================================================================
-
-// Storage clients
-export { FilebaseClient } from './storage/FilebaseClient';
-export { ArweaveClient } from './storage/ArweaveClient';
-
-// Archive bundle builder
-export {
-  ArchiveBundleBuilder,
-  computeContentHash,
-  validateArchiveBundle,
-} from './storage/ArchiveBundleBuilder';
-
-// Storage types
-export type {
-  FilebaseConfig,
-  ArweaveConfig,
-  IrysCurrency,
-  IrysNetwork,
-  ArchiveBundle,
-  ArchiveChainId,
-  ArchiveFinalState,
-  ArchiveParticipants,
-  ArchiveReferences,
-  ArchiveHashes,
-  ArchiveSignatures,
-  ArchiveAttestation,
-  ArchiveSettlement,
-  EscrowRelease,
-  ArchiveTags,
-  IPFSUploadResult,
-  ArweaveUploadResult,
-  DownloadResult,
-} from './storage/types';
-
-// Storage constants
-export { ARCHIVE_BUNDLE_TYPE } from './storage/types';
-
-// =============================================================================
-// ERC-8004 Integration
-// =============================================================================
-
-export {
-  ERC8004Bridge,
-  ReputationReporter,
-  ERC8004Error,
-  ERC8004ErrorCode,
-  ERC8004_IDENTITY_REGISTRY,
-  ERC8004_REPUTATION_REGISTRY,
-  ERC8004_DEFAULT_RPC,
-  ACTP_FEEDBACK_TAGS,
-} from './erc8004';
-
-export type {
-  ERC8004BridgeConfig,
-  ReputationReporterConfig,
-  ReportSettlementParams,
-  ReportDisputeParams,
-  ReportResult,
-  ERC8004Network,
-  ERC8004Agent,
-  ERC8004AgentMetadata,
-  ReputationFeedback,
-  ReputationSummary,
-  ACTPFeedbackTag,
-} from './erc8004';
-
-// =============================================================================
-// Enhanced Error Exports
-// =============================================================================
-
-export {
-  ACTPError,
-  InsufficientFundsError,
-  TransactionNotFoundError,
-  DeadlineExpiredError,
-  InvalidStateTransitionError,
-  SignatureVerificationError,
-  TransactionRevertedError,
-  NetworkError,
-  ValidationError,
-  InvalidAddressError,
-  InvalidAmountError,
-  // Basic/Standard API errors
-  NoProviderFoundError,
-  TimeoutError,
-  ProviderRejectedError,
-  DeliveryFailedError,
-  DisputeRaisedError,
-  ServiceConfigError,
-  AgentLifecycleError,
-  // Storage errors (AIP-7)
-  StorageError,
-  StorageAuthenticationError,
-  StorageRateLimitError,
-  UploadTimeoutError,
-  DownloadTimeoutError,
-  ContentNotFoundError,
-  FileSizeLimitExceededError,
-  InvalidCIDError,
-  ArweaveUploadError,
-  ArweaveDownloadError,
-  ArweaveTimeoutError,
-  InvalidArweaveTxIdError,
-  InsufficientBalanceError as StorageInsufficientBalanceError,
-  SwapExecutionError,
-  QueryCapExceededError,
-} from './errors';

package/src/level0/Provider.ts

@@ -1,117 +0,0 @@
-/**
- * Provider - Return type of provide() function
- *
- * Provides control and observability for a running service provider.
- *
- * @packageDocumentation
- */
-
-import { Job } from '../level1/types/Job';
-
-/**
- * Provider status
- */
-export type ProviderStatus = 'starting' | 'running' | 'paused' | 'stopped';
-
-/**
- * Provider statistics
- */
-export interface ProviderStats {
-  jobsCompleted: number;
-  jobsFailed: number;
-  totalEarned: number;
-  averageJobTime: number;
-}
-
-/**
- * Provider balance
- */
-export interface ProviderBalance {
-  eth: string;
-  usdc: string;
-}
-
-/**
- * Provider interface
- *
- * Returned by provide() to control the provider lifecycle.
- *
- * @example
- * ```typescript
- * const provider = provide('echo', async (job) => job.input);
- *
- * // Monitor events
- * provider.on('job:received', (job) => {
- *   console.log(`Received job: ${job.id}`);
- * });
- *
- * provider.on('payment:received', (amount) => {
- *   console.log(`Earned ${amount} USDC`);
- * });
- *
- * // Control lifecycle
- * provider.pause();  // Stop accepting new jobs
- * provider.resume(); // Resume
- * await provider.stop(); // Graceful shutdown
- *
- * // Check statistics
- * console.log(`Completed: ${provider.stats.jobsCompleted}`);
- * console.log(`Earned: $${provider.stats.totalEarned}`);
- * ```
- */
-export interface Provider {
-  /**
-   * Current status
-   */
-  status: ProviderStatus;
-
-  /**
-   * Provider's Ethereum address
-   */
-  address: string;
-
-  /**
-   * Balance information
-   */
-  balance: ProviderBalance;
-
-  /**
-   * Pause the provider
-   *
-   * Stops accepting new jobs but keeps running jobs active.
-   */
-  pause(): void;
-
-  /**
-   * Resume the provider
-   *
-   * Resumes accepting new jobs after pause.
-   */
-  resume(): void;
-
-  /**
-   * Stop the provider
-   *
-   * Gracefully shuts down, waiting for active jobs to complete.
-   */
-  stop(): Promise<void>;
-
-  /**
-   * Register event listener
-   *
-   * Supported events:
-   * - 'job:received': (job: Job) => void
-   * - 'job:completed': (job: Job, result: any) => void
-   * - 'job:failed': (job: Job, error: Error) => void
-   * - 'payment:received': (amount: number) => void
-   */
-  on(event: 'job:received', handler: (job: Job) => void): void;
-  on(event: 'job:completed', handler: (job: Job, result: any) => void): void;
-  on(event: 'job:failed', handler: (job: Job, error: Error) => void): void;
-  on(event: 'payment:received', handler: (amount: number) => void): void;
-
-  /**
-   * Statistics
-   */
-  stats: ProviderStats;
-}

package/src/level0/ServiceDirectory.ts

@@ -1,131 +0,0 @@
-/**
- * ServiceDirectory - Hardcoded provider mapping for MVP
- *
- * In MVP, we use hardcoded service-to-provider mapping.
- * In V2+, this will be replaced by on-chain AgentRegistry queries.
- *
- * @packageDocumentation
- */
-
-import { validateServiceName, isValidAddress } from '../utils/security';
-
-/**
- * In-memory service directory
- *
- * Maps service names to provider addresses.
- * This is a singleton that can be updated by provide() calls.
- *
- * SECURITY FIXES:
- * - H-5: Address validation to prevent poisoning
- * - H-2: Service name validation
- */
-class ServiceDirectory {
-  /**
-   * Service -> Provider address mapping
-   */
-  private directory = new Map<string, Set<string>>();
-
-  /**
-   * Register a provider for a service
-   *
-   * SECURITY FIX (H-5): Validate address format before registration
-   * SECURITY FIX (H-2): Validate service name
-   *
-   * @param service - Service name
-   * @param provider - Provider address
-   * @throws Error if service name or provider address is invalid
-   */
-  register(service: string, provider: string): void {
-    // SECURITY FIX (H-2): Validate service name
-    const validatedService = validateServiceName(service);
-
-    // SECURITY FIX (H-5): Validate Ethereum address format
-    if (!isValidAddress(provider)) {
-      throw new Error(
-        `Invalid provider address: "${provider}". Must be a valid Ethereum address (0x followed by 40 hex characters).`
-      );
-    }
-
-    if (!this.directory.has(validatedService)) {
-      this.directory.set(validatedService, new Set());
-    }
-
-    this.directory.get(validatedService)!.add(provider);
-  }
-
-  /**
-   * Unregister a provider from a service
-   *
-   * SECURITY FIX (H-5): Validate address format
-   * SECURITY FIX (H-2): Validate service name
-   *
-   * @param service - Service name
-   * @param provider - Provider address
-   */
-  unregister(service: string, provider: string): void {
-    // SECURITY FIX (H-2): Validate service name
-    const validatedService = validateServiceName(service);
-
-    // SECURITY FIX (H-5): Validate address format
-    if (!isValidAddress(provider)) {
-      throw new Error(`Invalid provider address: "${provider}"`);
-    }
-
-    const providers = this.directory.get(validatedService);
-    if (providers) {
-      providers.delete(provider);
-      if (providers.size === 0) {
-        this.directory.delete(validatedService);
-      }
-    }
-  }
-
-  /**
-   * Find providers for a service
-   *
-   * SECURITY FIX (H-2): Validate service name
-   *
-   * @param service - Service name
-   * @returns Array of provider addresses
-   */
-  findProviders(service: string): string[] {
-    // SECURITY FIX (H-2): Validate service name
-    try {
-      const validatedService = validateServiceName(service);
-      const providers = this.directory.get(validatedService);
-      return providers ? Array.from(providers) : [];
-    } catch (error) {
-      // If service name is invalid, return empty array instead of throwing
-      // This allows graceful degradation in search scenarios
-      return [];
-    }
-  }
-
-  /**
-   * Get all registered services
-   *
-   * @returns Array of service names
-   */
-  getServices(): string[] {
-    return Array.from(this.directory.keys());
-  }
-
-  /**
-   * Clear all registrations
-   */
-  clear(): void {
-    this.directory.clear();
-  }
-
-  /**
-   * Get directory size (for debugging)
-   */
-  get size(): number {
-    return this.directory.size;
-  }
-}
-
-/**
- * Singleton instance
- */
-export const serviceDirectory = new ServiceDirectory();

package/src/level0/index.ts

@@ -1,10 +0,0 @@
-/**
- * Basic API - Simple service provision and requests
- *
- * @packageDocumentation
- */
-
-export { provide } from './provide';
-export { request } from './request';
-export { Provider, ProviderStatus, ProviderStats, ProviderBalance } from './Provider';
-export { serviceDirectory } from './ServiceDirectory';