Error reference

TypeScript SDK: 47 error classes · Python SDK: 47 error classes · Manifest generated: 2026-05-26 12:27:57 UTC

Every error in both SDKs extends from a common ACTPError (TS) / ACTPError (Python) base. The code column is the stable string identifier you can pattern-match against in catch blocks — preferred over instanceof checks for forward-compat. Errors without a code are abstract base classes that aren't thrown directly.

TypeScript SDK errors

Class	Parent	Code	Source
`ACTPError`	`Error`	(abstract)	`src/errors/ACTPError.ts`
`AgentLifecycleError`	`ACTPError`	`AGENT_LIFECYCLE_ERROR`	`src/errors/index.ts`
`ArweaveDownloadError`	`StorageError`	(abstract)	`src/errors/index.ts`
`ArweaveTimeoutError`	`StorageError`	(abstract)	`src/errors/index.ts`
`ArweaveUploadError`	`StorageError`	(abstract)	`src/errors/index.ts`
`ContentNotFoundError`	`StorageError`	(abstract)	`src/errors/index.ts`
`ContractPausedError`	`Error`	(abstract)	`src/runtime/MockRuntime.ts`
`DeadlineExpiredError`	`ACTPError`	`DEADLINE_EXPIRED`	`src/errors/index.ts`
`DeadlinePassedError`	`Error`	(abstract)	`src/runtime/MockRuntime.ts`
`DeliveryFailedError`	`ACTPError`	`DELIVERY_FAILED`	`src/errors/index.ts`
`DisputeRaisedError`	`ACTPError`	`DISPUTE_RAISED`	`src/errors/index.ts`
`DisputeWindowActiveError`	`Error`	(abstract)	`src/runtime/MockRuntime.ts`
`DownloadTimeoutError`	`StorageError`	(abstract)	`src/errors/index.ts`
`EscrowNotFoundError`	`Error`	(abstract)	`src/runtime/MockRuntime.ts`
`FileSizeLimitExceededError`	`StorageError`	(abstract)	`src/errors/index.ts`
`InsufficientBalanceError`	`StorageError`	(abstract)	`src/errors/index.ts`
`InsufficientFundsError`	`ACTPError`	`INSUFFICIENT_FUNDS`	`src/errors/index.ts`
`InvalidAddressError`	`ValidationError`	(abstract)	`src/errors/index.ts`
`InvalidAmountError`	`ValidationError`	(abstract)	`src/errors/index.ts`
`InvalidArweaveTxIdError`	`ValidationError`	(abstract)	`src/errors/index.ts`
`InvalidCIDError`	`ValidationError`	(abstract)	`src/errors/index.ts`
`InvalidStateTransitionError`	`ACTPError`	`INVALID_STATE_TRANSITION`	`src/errors/index.ts`
`NetworkError`	`ACTPError`	`NETWORK_ERROR`	`src/errors/index.ts`
`NoProviderFoundError`	`ACTPError`	`NO_PROVIDER_FOUND`	`src/errors/index.ts`
`ProviderRejectedError`	`ACTPError`	`PROVIDER_REJECTED`	`src/errors/index.ts`
`QueryCapExceededError`	`ACTPError`	`QUERY_CAP_EXCEEDED`	`src/errors/index.ts`
`ServiceConfigError`	`ACTPError`	`SERVICE_CONFIG_ERROR`	`src/errors/index.ts`
`SignatureVerificationError`	`ACTPError`	`SIGNATURE_VERIFICATION_FAILED`	`src/errors/index.ts`
`StorageAuthenticationError`	`StorageError`	(abstract)	`src/errors/index.ts`
`StorageError`	`ACTPError`	`STORAGE_ERROR`	`src/errors/index.ts`
`StorageRateLimitError`	`StorageError`	(abstract)	`src/errors/index.ts`
`SwapExecutionError`	`StorageError`	(abstract)	`src/errors/index.ts`
`TimeoutError`	`ACTPError`	`TIMEOUT`	`src/errors/index.ts`
`TransactionNotFoundError`	`ACTPError`	`TRANSACTION_NOT_FOUND`	`src/errors/index.ts`
`TransactionRevertedError`	`ACTPError`	`TRANSACTION_REVERTED`	`src/errors/index.ts`
`UploadTimeoutError`	`StorageError`	(abstract)	`src/errors/index.ts`
`ValidationError`	`ACTPError`	`VALIDATION_ERROR`	`src/errors/index.ts`
`X402AmountExceededError`	`X402Error`	`X402_AMOUNT_EXCEEDED`	`src/errors/X402Errors.ts`
`X402ApprovalFailedError`	`X402Error`	`X402_APPROVAL_FAILED`	`src/errors/X402Errors.ts`
`X402ConfigError`	`X402Error`	`X402_CONFIG_ERROR`	`src/errors/X402Errors.ts`
`X402Error`	`ACTPError`	(abstract)	`src/errors/X402Errors.ts`
`X402NetworkNotAllowedError`	`X402Error`	`X402_NETWORK_NOT_ALLOWED`	`src/errors/X402Errors.ts`
`X402PaymentFailedError`	`X402Error`	`X402_PAYMENT_FAILED`	`src/errors/X402Errors.ts`
`X402PublishRequiredError`	`X402Error`	`X402_PUBLISH_REQUIRED`	`src/errors/X402Errors.ts`
`X402SettlementProofMissingError`	`X402Error`	`X402_SETTLEMENT_PROOF_MISSING`	`src/errors/X402Errors.ts`
`X402SignatureFailedError`	`X402Error`	`X402_SIGNATURE_FAILED`	`src/errors/X402Errors.ts`
`X402UnsupportedWalletError`	`X402Error`	`X402_UNSUPPORTED_WALLET`	`src/errors/X402Errors.ts`

Python SDK errors

Class	Parent	Code	Source
`ACTPError`	`Exception`	`TX_FAILED`	`src/agirails/errors/base.py`
`AgentLifecycleError`	`ACTPError`	`AGENT_LIFECYCLE_ERROR`	`src/agirails/errors/agent.py`
`ArchiveBundleValidationError`	`StorageError`	`ARCHIVE_BUNDLE_VALIDATION_ERROR`	`src/agirails/errors/storage.py`
`ArweaveDownloadError`	`ArweaveError`	`ARWEAVE_DOWNLOAD_ERROR`	`src/agirails/errors/storage.py`
`ArweaveError`	`StorageError`	`ARWEAVE_ERROR`	`src/agirails/errors/storage.py`
`ArweaveUploadError`	`ArweaveError`	`ARWEAVE_UPLOAD_ERROR`	`src/agirails/errors/storage.py`
`CircuitBreakerOpenError`	`StorageError`	`CIRCUIT_BREAKER_OPEN`	`src/agirails/errors/storage.py`
`ContentNotFoundError`	`StorageError`	`CONTENT_NOT_FOUND`	`src/agirails/errors/storage.py`
`ContractPausedError`	`ACTPError`	`CONTRACT_PAUSED`	`src/agirails/errors/transaction.py`
`DeadlinePassedError`	`ACTPError`	`DEADLINE_PASSED`	`src/agirails/errors/transaction.py`
`DeliveryFailedError`	`ACTPError`	`DELIVERY_FAILED`	`src/agirails/errors/agent.py`
`DisputeRaisedError`	`ACTPError`	`DISPUTE_RAISED`	`src/agirails/errors/agent.py`
`DisputeWindowActiveError`	`ACTPError`	`DISPUTE_WINDOW_ACTIVE`	`src/agirails/errors/transaction.py`
`DownloadTimeoutError`	`StorageError`	`DOWNLOAD_TIMEOUT`	`src/agirails/errors/storage.py`
`EscrowError`	`ACTPError`	`ESCROW_ERROR`	`src/agirails/errors/transaction.py`
`EscrowNotFoundError`	`ACTPError`	`ESCROW_NOT_FOUND`	`src/agirails/errors/transaction.py`
`FilebaseDownloadError`	`FilebaseError`	`FILEBASE_DOWNLOAD_ERROR`	`src/agirails/errors/storage.py`
`FilebaseError`	`StorageError`	`FILEBASE_ERROR`	`src/agirails/errors/storage.py`
`FilebaseUploadError`	`FilebaseError`	`FILEBASE_UPLOAD_ERROR`	`src/agirails/errors/storage.py`
`FileSizeLimitError`	`StorageError`	`FILE_SIZE_LIMIT`	`src/agirails/errors/storage.py`
`FileSizeLimitExceededError`	`StorageError`	`FILE_SIZE_LIMIT_EXCEEDED`	`src/agirails/errors/storage.py`
`InsufficientBalanceError`	`ACTPError`	`INSUFFICIENT_BALANCE`	`src/agirails/errors/transaction.py`
`InsufficientFundsError`	`ArweaveError`	`INSUFFICIENT_FUNDS`	`src/agirails/errors/storage.py`
`InvalidAddressError`	`ValidationError`	`INVALID_ADDRESS`	`src/agirails/errors/validation.py`
`InvalidAmountError`	`ValidationError`	`INVALID_AMOUNT`	`src/agirails/errors/validation.py`
`InvalidCIDError`	`StorageError`	`INVALID_CID`	`src/agirails/errors/storage.py`
`InvalidStateTransitionError`	`ACTPError`	`INVALID_STATE_TRANSITION`	`src/agirails/errors/transaction.py`
`MockStateCorruptedError`	`ACTPError`	`MOCK_STATE_CORRUPTED`	`src/agirails/errors/mock.py`
`MockStateLockError`	`ACTPError`	`MOCK_STATE_LOCK_ERROR`	`src/agirails/errors/mock.py`
`MockStateVersionError`	`ACTPError`	`MOCK_STATE_VERSION_ERROR`	`src/agirails/errors/mock.py`
`NetworkError`	`ACTPError`	`NETWORK_ERROR`	`src/agirails/errors/network.py`
`NoProviderFoundError`	`ACTPError`	`NO_PROVIDER_FOUND`	`src/agirails/errors/agent.py`
`ProviderRejectedError`	`ACTPError`	`PROVIDER_REJECTED`	`src/agirails/errors/agent.py`
`QueryCapExceededError`	`ACTPError`	`QUERY_CAP_EXCEEDED`	`src/agirails/errors/agent.py`
`ServiceConfigError`	`ACTPError`	`SERVICE_CONFIG_ERROR`	`src/agirails/errors/agent.py`
`SignatureVerificationError`	`ACTPError`	`SIGNATURE_VERIFICATION_FAILED`	`src/agirails/errors/network.py`
`SSRFProtectionError`	`StorageError`	`SSRF_PROTECTION_ERROR`	`src/agirails/errors/storage.py`
`StorageAuthenticationError`	`StorageError`	`STORAGE_AUTH_ERROR`	`src/agirails/errors/storage.py`
`StorageError`	`ACTPError`	`STORAGE_ERROR`	`src/agirails/errors/storage.py`
`StorageRateLimitError`	`StorageError`	`STORAGE_RATE_LIMIT`	`src/agirails/errors/storage.py`
`TimeoutError`	`ACTPError`	`TIMEOUT`	`src/agirails/errors/agent.py`
`TransactionError`	`ACTPError`	`TRANSACTION_ERROR`	`src/agirails/errors/transaction.py`
`TransactionNotFoundError`	`ACTPError`	`TRANSACTION_NOT_FOUND`	`src/agirails/errors/transaction.py`
`TransactionRevertedError`	`ACTPError`	`TRANSACTION_REVERTED`	`src/agirails/errors/network.py`
`TransientRPCError`	`NetworkError`	`TRANSIENT_RPC_ERROR`	`src/agirails/errors/network.py`
`UploadTimeoutError`	`StorageError`	`UPLOAD_TIMEOUT`	`src/agirails/errors/storage.py`
`ValidationError`	`ACTPError`	`VALIDATION_ERROR`	`src/agirails/errors/validation.py`

Cross-SDK divergences

Errors that exist in one SDK but not the other. Some are intentional (TypeScript-side x402 payment integration errors don't apply to Python; Python-side circuit-breaker + Filebase + Arweave errors are runtime concerns the TS SDK doesn't share), others are gaps the parity sprint tracks.

TypeScript-only (14):

ArweaveTimeoutError, DeadlineExpiredError, InvalidArweaveTxIdError, SwapExecutionError, X402AmountExceededError, X402ApprovalFailedError, X402ConfigError, X402Error, X402NetworkNotAllowedError, X402PaymentFailedError, X402PublishRequiredError, X402SettlementProofMissingError, X402SignatureFailedError, X402UnsupportedWalletError

Python-only (14):

ArchiveBundleValidationError, ArweaveError, CircuitBreakerOpenError, EscrowError, FileSizeLimitError, FilebaseDownloadError, FilebaseError, FilebaseUploadError, MockStateCorruptedError, MockStateLockError, MockStateVersionError, SSRFProtectionError, TransactionError, TransientRPCError

TypeScript SDK errors​

Python SDK errors​

Cross-SDK divergences​

See also​

TypeScript SDK errors

Python SDK errors

Cross-SDK divergences

See also