@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/errors/index.d.ts

@@ -1,10 +1,16 @@
 import { State } from '../types';
+/**
+ * Base ACTP Error
+ */
 export declare class ACTPError extends Error {
     readonly code: string;
     readonly txHash?: string | undefined;
-    readonly details?: any | undefined;
-    constructor(message: string, code: string, txHash?: string | undefined, details?: any | undefined);
+    readonly details?: any;
+    constructor(message: string, code: string, txHash?: string | undefined, details?: any);
 }
+/**
+ * Transaction Errors
+ */
 export declare class InsufficientFundsError extends ACTPError {
     constructor(required: bigint, available: bigint);
 }
@@ -14,18 +20,30 @@ export declare class TransactionNotFoundError extends ACTPError {
 export declare class DeadlineExpiredError extends ACTPError {
     constructor(txId: string, deadline: number);
 }
+/**
+ * State Machine Errors
+ */
 export declare class InvalidStateTransitionError extends ACTPError {
     constructor(from: State, to: State, validTransitions: string[]);
 }
+/**
+ * Signature Errors
+ */
 export declare class SignatureVerificationError extends ACTPError {
     constructor(expectedSigner: string, recoveredSigner: string);
 }
+/**
+ * Blockchain Errors
+ */
 export declare class TransactionRevertedError extends ACTPError {
     constructor(txHash: string, reason?: string);
 }
 export declare class NetworkError extends ACTPError {
     constructor(network: string, message: string);
 }
+/**
+ * Validation Errors
+ */
 export declare class ValidationError extends ACTPError {
     constructor(field: string, message: string);
 }
@@ -35,4 +53,149 @@ export declare class InvalidAddressError extends ValidationError {
 export declare class InvalidAmountError extends ValidationError {
     constructor(amount: string);
 }
+/**
+ * Storage Errors (AIP-7)
+ */
+export declare class StorageError extends ACTPError {
+    constructor(operation: string, message: string, details?: any);
+}
+export declare class InvalidCIDError extends ValidationError {
+    constructor(cid: string, reason?: string);
+}
+export declare class UploadTimeoutError extends StorageError {
+    constructor(timeoutMs: number);
+}
+export declare class DownloadTimeoutError extends StorageError {
+    constructor(cid: string, timeoutMs: number);
+}
+export declare class FileSizeLimitExceededError extends StorageError {
+    constructor(size: number, maxSize: number);
+}
+export declare class StorageAuthenticationError extends StorageError {
+    constructor(provider: string);
+}
+export declare class StorageRateLimitError extends StorageError {
+    constructor(retryAfter?: number);
+}
+export declare class ContentNotFoundError extends StorageError {
+    constructor(cid: string);
+}
+export declare class ArweaveUploadError extends StorageError {
+    constructor(message: string, details?: any);
+}
+export declare class ArweaveDownloadError extends StorageError {
+    constructor(txId: string, message: string);
+}
+export declare class InsufficientBalanceError extends StorageError {
+    constructor(required: string, available: string, currency: string);
+}
+export declare class ArweaveTimeoutError extends StorageError {
+    constructor(operation: string, timeoutMs: number);
+}
+export declare class InvalidArweaveTxIdError extends ValidationError {
+    constructor(txId: string, reason?: string);
+}
+export declare class SwapExecutionError extends StorageError {
+    constructor(message: string, details?: any);
+}
+/**
+ * Registry Query Cap Exceeded Error (L-4)
+ *
+ * Thrown when AgentRegistry.queryAgentsByService() cannot complete because
+ * the registry contains more than MAX_QUERY_AGENTS (1000) agents.
+ *
+ * ## Resolution
+ *
+ * When this error is thrown, you must migrate to an off-chain indexer:
+ *
+ * 1. **The Graph**: Deploy a subgraph indexing AgentRegistered events
+ *    - https://thegraph.com/docs/en/developing/creating-a-subgraph/
+ *
+ * 2. **Goldsky**: Mirror-based indexing (faster deployment)
+ *    - https://docs.goldsky.com/
+ *
+ * 3. **Alchemy Subgraphs**: Managed Graph service
+ *    - https://docs.alchemy.com/docs/subgraphs-overview
+ *
+ * ## Events to Index
+ *
+ * - `AgentRegistered(address indexed agent, string did, string endpoint, uint256 timestamp)`
+ * - `ServiceTypeUpdated(address indexed agent, bytes32 serviceTypeHash, bool added, uint256 timestamp)`
+ * - `ActiveStatusUpdated(address indexed agent, bool isActive, uint256 timestamp)`
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const agents = await registry.queryAgentsByService({ ... });
+ * } catch (error) {
+ *   if (error instanceof QueryCapExceededError) {
+ *     // Switch to off-chain indexer
+ *     const agents = await myIndexer.queryAgents({ ... });
+ *   }
+ * }
+ * ```
+ */
+export declare class QueryCapExceededError extends ACTPError {
+    constructor(registrySize: number, maxQueryAgents?: number);
+}
+/**
+ * Agent/Job Errors (Basic & Standard API)
+ */
+/**
+ * No provider found for the requested service
+ *
+ * Thrown when request() cannot find any provider offering the service.
+ */
+export declare class NoProviderFoundError extends ACTPError {
+    constructor(service: string, details?: any);
+}
+/**
+ * Request timeout error
+ *
+ * Thrown when provider doesn't respond within the timeout period.
+ */
+export declare class TimeoutError extends ACTPError {
+    constructor(timeoutMs: number, operation?: string);
+}
+/**
+ * Provider rejected the job
+ *
+ * Thrown when provider explicitly rejects a job (e.g., budget too low).
+ */
+export declare class ProviderRejectedError extends ACTPError {
+    constructor(provider: string, reason?: string, details?: any);
+}
+/**
+ * Provider failed to deliver result
+ *
+ * Thrown when provider transitions to DELIVERED but doesn't provide valid result.
+ */
+export declare class DeliveryFailedError extends ACTPError {
+    constructor(txId: string, reason?: string);
+}
+/**
+ * Dispute raised on transaction
+ *
+ * Thrown when requester raises a dispute on a delivered result.
+ */
+export declare class DisputeRaisedError extends ACTPError {
+    constructor(txId: string, reason?: string);
+}
+/**
+ * Service configuration error
+ *
+ * Thrown when Agent.provide() is called with invalid service configuration.
+ */
+export declare class ServiceConfigError extends ACTPError {
+    constructor(field: string, message: string, details?: any);
+}
+/**
+ * Agent lifecycle error
+ *
+ * Thrown when invalid agent lifecycle operations are attempted
+ * (e.g., calling start() on already running agent).
+ */
+export declare class AgentLifecycleError extends ACTPError {
+    constructor(currentState: string, attemptedAction: string);
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAKjC,qBAAa,SAAU,SAAQ,KAAK;aAGhB,IAAI,EAAE,MAAM;aACZ,MAAM,CAAC,EAAE,MAAM;aACf,OAAO,CAAC,EAAE,GAAG;gBAH7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,GAAG,YAAA;CAMhC;AAKD,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAShD;AAED,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAS3C;AAKD,qBAAa,2BAA4B,SAAQ,SAAS;gBAC5C,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE;CAU/D;AAKD,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM;CAS5D;AAKD,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAS5C;AAED,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C;AAKD,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI3C;AAED,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,MAAM,EAAE,MAAM;CAI3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidAmountError = exports.InvalidAddressError = exports.ValidationError = exports.NetworkError = exports.TransactionRevertedError = exports.SignatureVerificationError = exports.InvalidStateTransitionError = exports.DeadlineExpiredError = exports.TransactionNotFoundError = exports.InsufficientFundsError = exports.ACTPError = void 0;
+exports.AgentLifecycleError = exports.ServiceConfigError = exports.DisputeRaisedError = exports.DeliveryFailedError = exports.ProviderRejectedError = exports.TimeoutError = exports.NoProviderFoundError = exports.QueryCapExceededError = exports.SwapExecutionError = exports.InvalidArweaveTxIdError = exports.ArweaveTimeoutError = exports.InsufficientBalanceError = exports.ArweaveDownloadError = exports.ArweaveUploadError = exports.ContentNotFoundError = exports.StorageRateLimitError = exports.StorageAuthenticationError = exports.FileSizeLimitExceededError = exports.DownloadTimeoutError = exports.UploadTimeoutError = exports.InvalidCIDError = exports.StorageError = exports.InvalidAmountError = exports.InvalidAddressError = exports.ValidationError = exports.NetworkError = exports.TransactionRevertedError = exports.SignatureVerificationError = exports.InvalidStateTransitionError = exports.DeadlineExpiredError = exports.TransactionNotFoundError = exports.InsufficientFundsError = exports.ACTPError = void 0;
 const types_1 = require("../types");
+/**
+ * Base ACTP Error
+ */
 class ACTPError extends Error {
     constructor(message, code, txHash, details) {
         super(message);
@@ -9,10 +12,14 @@ class ACTPError extends Error {
         this.txHash = txHash;
         this.details = details;
         this.name = 'ACTPError';
-        Object.setPrototypeOf(this, ACTPError.prototype);
+        // Ensure `instanceof` works for subclasses (TS + Error inheritance quirk)
+        Object.setPrototypeOf(this, new.target.prototype);
     }
 }
 exports.ACTPError = ACTPError;
+/**
+ * Transaction Errors
+ */
 class InsufficientFundsError extends ACTPError {
     constructor(required, available) {
         super(`Insufficient funds: need ${required.toString()} wei, have ${available.toString()} wei`, 'INSUFFICIENT_FUNDS', undefined, { required: required.toString(), available: available.toString() });
@@ -34,6 +41,9 @@ class DeadlineExpiredError extends ACTPError {
     }
 }
 exports.DeadlineExpiredError = DeadlineExpiredError;
+/**
+ * State Machine Errors
+ */
 class InvalidStateTransitionError extends ACTPError {
     constructor(from, to, validTransitions) {
         super(`Invalid state transition: ${types_1.State[from]} → ${types_1.State[to]}. ` +
@@ -42,6 +52,9 @@ class InvalidStateTransitionError extends ACTPError {
     }
 }
 exports.InvalidStateTransitionError = InvalidStateTransitionError;
+/**
+ * Signature Errors
+ */
 class SignatureVerificationError extends ACTPError {
     constructor(expectedSigner, recoveredSigner) {
         super(`Signature verification failed. Expected ${expectedSigner}, got ${recoveredSigner}`, 'SIGNATURE_VERIFICATION_FAILED', undefined, { expectedSigner, recoveredSigner });
@@ -49,6 +62,9 @@ class SignatureVerificationError extends ACTPError {
     }
 }
 exports.SignatureVerificationError = SignatureVerificationError;
+/**
+ * Blockchain Errors
+ */
 class TransactionRevertedError extends ACTPError {
     constructor(txHash, reason) {
         super(`Transaction reverted: ${reason || 'Unknown reason'}`, 'TRANSACTION_REVERTED', txHash, { reason });
@@ -63,6 +79,9 @@ class NetworkError extends ACTPError {
     }
 }
 exports.NetworkError = NetworkError;
+/**
+ * Validation Errors
+ */
 class ValidationError extends ACTPError {
     constructor(field, message) {
         super(`Validation error for ${field}: ${message}`, 'VALIDATION_ERROR', undefined, { field });
@@ -84,4 +103,243 @@ class InvalidAmountError extends ValidationError {
     }
 }
 exports.InvalidAmountError = InvalidAmountError;
+/**
+ * Storage Errors (AIP-7)
+ */
+class StorageError extends ACTPError {
+    constructor(operation, message, details) {
+        super(`Storage operation failed (${operation}): ${message}`, 'STORAGE_ERROR', undefined, { operation, ...details });
+        this.name = 'StorageError';
+    }
+}
+exports.StorageError = StorageError;
+class InvalidCIDError extends ValidationError {
+    constructor(cid, reason) {
+        super('cid', `Invalid IPFS CID: ${cid}${reason ? ` (${reason})` : ''}`);
+        this.name = 'InvalidCIDError';
+    }
+}
+exports.InvalidCIDError = InvalidCIDError;
+class UploadTimeoutError extends StorageError {
+    constructor(timeoutMs) {
+        super('upload', `Upload timed out after ${timeoutMs}ms`, { timeoutMs });
+        this.name = 'UploadTimeoutError';
+    }
+}
+exports.UploadTimeoutError = UploadTimeoutError;
+class DownloadTimeoutError extends StorageError {
+    constructor(cid, timeoutMs) {
+        super('download', `Download of ${cid} timed out after ${timeoutMs}ms`, { cid, timeoutMs });
+        this.name = 'DownloadTimeoutError';
+    }
+}
+exports.DownloadTimeoutError = DownloadTimeoutError;
+class FileSizeLimitExceededError extends StorageError {
+    constructor(size, maxSize) {
+        super('upload', `File size ${size} bytes exceeds maximum ${maxSize} bytes`, { size, maxSize });
+        this.name = 'FileSizeLimitExceededError';
+    }
+}
+exports.FileSizeLimitExceededError = FileSizeLimitExceededError;
+class StorageAuthenticationError extends StorageError {
+    constructor(provider) {
+        super('authentication', `Authentication failed for ${provider}`, { provider });
+        this.name = 'StorageAuthenticationError';
+    }
+}
+exports.StorageAuthenticationError = StorageAuthenticationError;
+class StorageRateLimitError extends StorageError {
+    constructor(retryAfter) {
+        super('rate-limit', `Rate limit exceeded${retryAfter ? `, retry after ${retryAfter}s` : ''}`, { retryAfter });
+        this.name = 'StorageRateLimitError';
+    }
+}
+exports.StorageRateLimitError = StorageRateLimitError;
+class ContentNotFoundError extends StorageError {
+    constructor(cid) {
+        super('download', `Content not found for CID: ${cid}`, { cid });
+        this.name = 'ContentNotFoundError';
+    }
+}
+exports.ContentNotFoundError = ContentNotFoundError;
+class ArweaveUploadError extends StorageError {
+    constructor(message, details) {
+        super('upload', `Arweave upload failed: ${message}`, details);
+        this.name = 'ArweaveUploadError';
+    }
+}
+exports.ArweaveUploadError = ArweaveUploadError;
+class ArweaveDownloadError extends StorageError {
+    constructor(txId, message) {
+        super('download', `Failed to download from Arweave (${txId}): ${message}`, { txId });
+        this.name = 'ArweaveDownloadError';
+    }
+}
+exports.ArweaveDownloadError = ArweaveDownloadError;
+class InsufficientBalanceError extends StorageError {
+    constructor(required, available, currency) {
+        super('funding', `Insufficient Irys balance: need ${required} ${currency}, have ${available} ${currency}`, { required, available, currency });
+        this.name = 'InsufficientBalanceError';
+    }
+}
+exports.InsufficientBalanceError = InsufficientBalanceError;
+class ArweaveTimeoutError extends StorageError {
+    constructor(operation, timeoutMs) {
+        super('timeout', `Arweave ${operation} timed out after ${timeoutMs}ms`, { operation, timeoutMs });
+        this.name = 'ArweaveTimeoutError';
+    }
+}
+exports.ArweaveTimeoutError = ArweaveTimeoutError;
+class InvalidArweaveTxIdError extends ValidationError {
+    constructor(txId, reason) {
+        super('txId', `Invalid Arweave transaction ID: ${txId}${reason ? ` (${reason})` : ''}`);
+        this.name = 'InvalidArweaveTxIdError';
+    }
+}
+exports.InvalidArweaveTxIdError = InvalidArweaveTxIdError;
+class SwapExecutionError extends StorageError {
+    constructor(message, details) {
+        super('swap', `Swap execution failed: ${message}`, details);
+        this.name = 'SwapExecutionError';
+    }
+}
+exports.SwapExecutionError = SwapExecutionError;
+/**
+ * Registry Query Cap Exceeded Error (L-4)
+ *
+ * Thrown when AgentRegistry.queryAgentsByService() cannot complete because
+ * the registry contains more than MAX_QUERY_AGENTS (1000) agents.
+ *
+ * ## Resolution
+ *
+ * When this error is thrown, you must migrate to an off-chain indexer:
+ *
+ * 1. **The Graph**: Deploy a subgraph indexing AgentRegistered events
+ *    - https://thegraph.com/docs/en/developing/creating-a-subgraph/
+ *
+ * 2. **Goldsky**: Mirror-based indexing (faster deployment)
+ *    - https://docs.goldsky.com/
+ *
+ * 3. **Alchemy Subgraphs**: Managed Graph service
+ *    - https://docs.alchemy.com/docs/subgraphs-overview
+ *
+ * ## Events to Index
+ *
+ * - `AgentRegistered(address indexed agent, string did, string endpoint, uint256 timestamp)`
+ * - `ServiceTypeUpdated(address indexed agent, bytes32 serviceTypeHash, bool added, uint256 timestamp)`
+ * - `ActiveStatusUpdated(address indexed agent, bool isActive, uint256 timestamp)`
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const agents = await registry.queryAgentsByService({ ... });
+ * } catch (error) {
+ *   if (error instanceof QueryCapExceededError) {
+ *     // Switch to off-chain indexer
+ *     const agents = await myIndexer.queryAgents({ ... });
+ *   }
+ * }
+ * ```
+ */
+class QueryCapExceededError extends ACTPError {
+    constructor(registrySize, maxQueryAgents = 1000) {
+        super(`Registry size (${registrySize}) exceeds query cap (${maxQueryAgents}). ` +
+            `On-chain queries are disabled to prevent DoS. Use an off-chain indexer instead.`, 'QUERY_CAP_EXCEEDED', undefined, {
+            registrySize,
+            maxQueryAgents,
+            solution: 'Migrate to off-chain indexer (The Graph, Goldsky, or Alchemy Subgraphs)'
+        });
+        this.name = 'QueryCapExceededError';
+    }
+}
+exports.QueryCapExceededError = QueryCapExceededError;
+/**
+ * Agent/Job Errors (Basic & Standard API)
+ */
+/**
+ * No provider found for the requested service
+ *
+ * Thrown when request() cannot find any provider offering the service.
+ */
+class NoProviderFoundError extends ACTPError {
+    constructor(service, details) {
+        super(`No provider found for service "${service}". ` +
+            `Ensure at least one agent is providing this service.`, 'NO_PROVIDER_FOUND', undefined, { service, ...details });
+        this.name = 'NoProviderFoundError';
+    }
+}
+exports.NoProviderFoundError = NoProviderFoundError;
+/**
+ * Request timeout error
+ *
+ * Thrown when provider doesn't respond within the timeout period.
+ */
+class TimeoutError extends ACTPError {
+    constructor(timeoutMs, operation) {
+        super(`Operation timed out after ${timeoutMs}ms${operation ? ` (${operation})` : ''}`, 'TIMEOUT', undefined, { timeoutMs, operation });
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Provider rejected the job
+ *
+ * Thrown when provider explicitly rejects a job (e.g., budget too low).
+ */
+class ProviderRejectedError extends ACTPError {
+    constructor(provider, reason, details) {
+        super(`Provider ${provider} rejected the job${reason ? `: ${reason}` : ''}`, 'PROVIDER_REJECTED', undefined, { provider, reason, ...details });
+        this.name = 'ProviderRejectedError';
+    }
+}
+exports.ProviderRejectedError = ProviderRejectedError;
+/**
+ * Provider failed to deliver result
+ *
+ * Thrown when provider transitions to DELIVERED but doesn't provide valid result.
+ */
+class DeliveryFailedError extends ACTPError {
+    constructor(txId, reason) {
+        super(`Delivery failed for transaction ${txId}${reason ? `: ${reason}` : ''}`, 'DELIVERY_FAILED', undefined, { txId, reason });
+        this.name = 'DeliveryFailedError';
+    }
+}
+exports.DeliveryFailedError = DeliveryFailedError;
+/**
+ * Dispute raised on transaction
+ *
+ * Thrown when requester raises a dispute on a delivered result.
+ */
+class DisputeRaisedError extends ACTPError {
+    constructor(txId, reason) {
+        super(`Dispute raised for transaction ${txId}${reason ? `: ${reason}` : ''}`, 'DISPUTE_RAISED', undefined, { txId, reason });
+        this.name = 'DisputeRaisedError';
+    }
+}
+exports.DisputeRaisedError = DisputeRaisedError;
+/**
+ * Service configuration error
+ *
+ * Thrown when Agent.provide() is called with invalid service configuration.
+ */
+class ServiceConfigError extends ACTPError {
+    constructor(field, message, details) {
+        super(`Service configuration error (${field}): ${message}`, 'SERVICE_CONFIG_ERROR', undefined, { field, ...details });
+        this.name = 'ServiceConfigError';
+    }
+}
+exports.ServiceConfigError = ServiceConfigError;
+/**
+ * Agent lifecycle error
+ *
+ * Thrown when invalid agent lifecycle operations are attempted
+ * (e.g., calling start() on already running agent).
+ */
+class AgentLifecycleError extends ACTPError {
+    constructor(currentState, attemptedAction) {
+        super(`Cannot ${attemptedAction} agent in ${currentState} state`, 'AGENT_LIFECYCLE_ERROR', undefined, { currentState, attemptedAction });
+        this.name = 'AgentLifecycleError';
+    }
+}
+exports.AgentLifecycleError = AgentLifecycleError;
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/index.d.ts

@@ -1,19 +1,67 @@
-export { ACTPClient, ACTPClientConfig } from './ACTPClient';
+/**
+ * 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.beginner.pay({
+ *   to: '0xProvider...',
+ *   amount: '100',
+ * });
+ *
+ * console.log('Transaction ID:', result.txId);
+ * ```
+ */
+export { ACTPClient, ACTPClientConfig, ACTPClientMode, ACTPClientInfo, } from './ACTPClient';
+export { BaseAdapter, DEFAULT_DISPUTE_WINDOW_SECONDS, DEFAULT_DEADLINE_SECONDS, MIN_AMOUNT_WEI, MAX_DEADLINE_HOURS, MAX_DEADLINE_DAYS, } from './adapters/BaseAdapter';
+export { BeginnerAdapter, BeginnerPayParams, BeginnerPayResult, } from './adapters/BeginnerAdapter';
+export { IntermediateAdapter, IntermediateTransactionParams, } from './adapters/IntermediateAdapter';
+export { IACTPRuntime, IMockRuntime, CreateTransactionParams, } from './runtime/IACTPRuntime';
+export { MockRuntime, InsufficientBalanceError, EscrowNotFoundError, DeadlinePassedError, ContractPausedError, DisputeWindowActiveError, } from './runtime/MockRuntime';
+export { MockStateManager, MockStateCorruptedError, MockStateVersionError, MockStateLockError, } from './runtime/MockStateManager';
+export { BlockchainRuntime, BlockchainRuntimeConfig, } from './runtime/BlockchainRuntime';
+export { MockState, MockTransaction, MockEscrow, MockAccount, MockBlockchain, MockEvent, TransactionState, TransactionStateValue, MOCK_STATE_DEFAULTS, } from './runtime/types/MockState';
 export { ACTPKernel } from './protocol/ACTPKernel';
 export { EscrowVault } from './protocol/EscrowVault';
 export { EventMonitor } from './protocol/EventMonitor';
-export { ProofGenerator } from './protocol/ProofGenerator';
 export { MessageSigner } from './protocol/MessageSigner';
+export { ProofGenerator, URLValidationConfig } from './protocol/ProofGenerator';
 export { EASHelper, EASConfig } from './protocol/EASHelper';
-export { QuoteBuilder, QuoteParams, QuoteMessage } from './protocol/QuoteBuilder';
-export { State, StateMachine, Transaction, CreateTransactionParams, DisputeResolution, EconomicParams, Escrow, ACTPMessage, QuoteRequest, QuoteResponse, DeliveryProof, DeliveryProofMessage, EASAttestationData } from './types';
-export { EIP712Domain, AIP4DeliveryProofTypes, AIP4DeliveryProofData, DeliveryProofTypes, DeliveryProofData, deliveryProofDataFromProof } from './types/eip712';
-export { DeliveryProofBuilder, DeliveryProofParams, AGIRAILS_DELIVERY_SCHEMA_UID } from './builders';
-export { canonicalJsonStringify, computeCanonicalHash, computeResultHash } from './utils/canonicalJson';
-export { IPFSClient, IPFSHTTPClientImpl, IPFSClientConfig, createIPFSClient, IPFS_CONFIGS } from './utils/IPFSClient';
-export { NonceManager, InMemoryNonceManager, DIDScopedNonceManager, createNonceManager } from './utils/NonceManager';
-export { IReceivedNonceTracker, InMemoryReceivedNonceTracker, SetBasedReceivedNonceTracker, createReceivedNonceTracker, NonceValidationResult } from './utils/ReceivedNonceTracker';
-export { validateAddress, validateAmount, validateDeadline, validateDisputeWindow, validateTxId } from './utils/validation';
-export { ACTPError, InsufficientFundsError, TransactionNotFoundError, DeadlineExpiredError, InvalidStateTransitionError, SignatureVerificationError, TransactionRevertedError, NetworkError, ValidationError, InvalidAddressError, InvalidAmountError } from './errors';
-export { NetworkConfig, NETWORKS, getNetwork, isValidNetwork } from './config/networks';
+export { AgentRegistry } from './protocol/AgentRegistry';
+export { DIDManager } from './protocol/DIDManager';
+export { DIDResolver } from './protocol/DIDResolver';
+export { QuoteBuilder } from './builders/QuoteBuilder';
+export { DeliveryProofBuilder } from './builders/DeliveryProofBuilder';
+export { getNetwork } from './config/networks';
+export type { NetworkConfig } from './config/networks';
+export type { State, Transaction, CreateTransactionParams as ProtocolCreateParams, DisputeResolution, EconomicParams, } from './types';
+export { NonceManager, InMemoryNonceManager } from './utils/NonceManager';
+export { IReceivedNonceTracker, InMemoryReceivedNonceTracker } from './utils/ReceivedNonceTracker';
+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';
+export { USDC, Deadline, Address, Bytes32, State as StateHelpers, DisputeWindow, parseUSDC, formatUSDC, shortenAddress, ServiceHash, hashServiceMetadata, } from './utils/Helpers';
+export type { ServiceMetadata } from './utils/Helpers';
+export { provide, request, serviceDirectory } from './level0';
+export type { Provider, ProviderStatus, ProviderStats, ProviderBalance, } from './level0';
+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';
+export { ACTPError, InsufficientFundsError, TransactionNotFoundError, DeadlineExpiredError, InvalidStateTransitionError, SignatureVerificationError, TransactionRevertedError, NetworkError, ValidationError, InvalidAddressError, InvalidAmountError, NoProviderFoundError, TimeoutError, ProviderRejectedError, DeliveryFailedError, DisputeRaisedError, ServiceConfigError, AgentLifecycleError, } from './errors';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGlF,OAAO,EACL,KAAK,EACL,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,MAAM,EACN,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}