Package com.privatechain.core.exception

Class TransactionValidationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.privatechain.core.exception.BlockchainException

com.privatechain.core.exception.TransactionValidationException

All Implemented Interfaces:

Serializable

public final class TransactionValidationException
extends BlockchainException

Thrown when a Transaction fails one or more TransactionValidator checks before entering the mempool or being included in a block.

The exception carries the full ValidationResult so that callers can inspect the specific failure reason and the list of error messages without parsing the exception message string.

Since:

1.0.0

See Also:

• TransactionValidator
• ValidationResult
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TransactionValidationException(String message, ValidationResult validationResult, Transaction transaction)	Constructs a TransactionValidationException.

Method Summary

Modifier and Type	Method	Description
Transaction	getTransaction()	Returns the transaction that failed validation.
ValidationResult	getValidationResult()	Returns the full ValidationResult that caused this exception.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

TransactionValidationException

public TransactionValidationException(String message,
 ValidationResult validationResult,
 Transaction transaction)

Constructs a TransactionValidationException.

Parameters:

message - human-readable summary of the validation failure

validationResult - the full result from the validator (non-null)

transaction - the rejected transaction (maybe null)

Method Details

getValidationResult

public ValidationResult getValidationResult()

Returns the full ValidationResult that caused this exception.

Returns:

the validation result (non-null)

getTransaction

public Transaction getTransaction()

Returns the transaction that failed validation.

Returns:

the rejected transaction, or null if not available