Struct TransactionResult 

pub struct TransactionResult { /* private fields */ }

Wrapper around LiteSVM’s TransactionMetadata with helper methods for testing

This struct provides convenient methods for analyzing transaction results, including log inspection, compute unit tracking, and success assertions.

Example

let result = svm.send_instruction(ix, &[&signer])?;
result.assert_success();
assert!(result.has_log("Transfer complete"));
println!("Used {} compute units", result.compute_units());

Implementations

impl TransactionResult

pub fn new( result: TransactionMetadata, instruction_name: Option<String>, ) -> Self

Create a new TransactionResult wrapper for successful transaction

Arguments

• result - The transaction metadata from LiteSVM
• instruction_name - Optional name of the instruction for debugging

pub fn new_failed( error: String, result: TransactionMetadata, instruction_name: Option<String>, ) -> Self

Create a new TransactionResult wrapper for failed transaction

Arguments

• error - The error message
• result - The transaction metadata from LiteSVM
• instruction_name - Optional name of the instruction for debugging

pub fn assert_success(&self) -> &Self

Assert that the transaction succeeded, panic with logs if it failed

Returns

Returns self for chaining

Example

result.assert_success();

pub fn is_success(&self) -> bool

Check if the transaction succeeded

Returns

true if the transaction succeeded, false otherwise

pub fn error(&self) -> Option<&String>

Get the error message if the transaction failed

Returns

The error message if the transaction failed, None otherwise

pub fn logs(&self) -> &[String]

Get the transaction logs

Returns

A slice of log messages

pub fn has_log(&self, message: &str) -> bool

Check if the logs contain a specific message

Arguments

• message - The message to search for

Returns

true if the message is found in the logs, false otherwise

pub fn find_log(&self, pattern: &str) -> Option<&String>

Find a log entry containing the specified text

Arguments

• pattern - The pattern to search for

Returns

The first matching log entry, or None

pub fn compute_units(&self) -> u64

Get the compute units consumed

Returns

The number of compute units consumed

pub fn print_logs(&self)

Print the transaction logs

pub fn inner(&self) -> &TransactionMetadata

Get the inner TransactionMetadata for direct access

pub fn assert_failure(&self) -> &Self

Assert that the transaction failed

Panics

Panics if the transaction succeeded

Returns

Returns self for chaining

Example

result.assert_failure();

pub fn assert_error(&self, expected_error: &str) -> &Self

Assert that the transaction failed with a specific error message

Arguments

• expected_error - The expected error message (substring match)

Panics

Panics if the transaction succeeded or failed with a different error

Returns

Returns self for chaining

Example

result.assert_error("insufficient funds");

pub fn assert_error_code(&self, error_code: u32) -> &Self

Assert that the transaction failed with a specific error code

This is useful for asserting Anchor custom errors.

Arguments

• error_code - The expected error code number

Panics

Panics if the transaction succeeded or failed with a different error code

Returns

Returns self for chaining

Example

// Assert that transaction failed with custom error code 6000
result.assert_error_code(6000);

pub fn assert_anchor_error(&self, error_name: &str) -> &Self

Assert that the transaction failed with a specific Anchor error

This checks for Anchor’s error code format in the logs.

Arguments

• error_name - The name of the Anchor error

Panics

Panics if the transaction succeeded or the error wasn’t found in logs

Returns

Returns self for chaining

Example

// Assert that transaction failed with Anchor error
result.assert_anchor_error("InsufficientFunds");

pub fn assert_log_error(&self, error_message: &str) -> &Self

Assert that the logs contain a specific error message

Unlike assert_error, this only checks the logs, not the error field.

Arguments

• error_message - The expected error message in logs

Panics

Panics if the error message is not found in logs

Returns

Returns self for chaining

Example

result.assert_log_error("Transfer amount exceeds balance");

Trait Implementations

impl Debug for TransactionResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.