Struct SimulationResult 

pub struct SimulationResult { /* private fields */ }

Result of a transaction simulation.

Contains detailed information about what would happen if the transaction were submitted to the network.

Implementations

impl SimulationResult

pub fn from_response(response: Vec<Value>) -> AptosResult<Self>

Parses a simulation result from the API response.

Errors

Returns an error if the response is empty or if parsing the JSON fails.

pub fn from_json(data: Value) -> AptosResult<Self>

Parses a simulation result from JSON.

Errors

Returns an error if the JSON structure is invalid or missing required fields.

pub fn success(&self) -> bool

Returns whether the transaction would succeed.

pub fn failed(&self) -> bool

Returns whether the transaction would fail.

pub fn vm_status(&self) -> &str

Returns the VM status message.

pub fn gas_used(&self) -> u64

Returns the gas that would be used.

pub fn max_gas_amount(&self) -> u64

Returns the maximum gas amount specified.

pub fn gas_unit_price(&self) -> u64

Returns the gas unit price.

pub fn gas_cost(&self) -> u64

Returns the total gas cost in octas.

pub fn safe_gas_estimate(&self) -> u64

Returns the estimated gas cost with a safety margin.

Adds 20% to the simulated gas to account for variations.

pub fn changes(&self) -> &[StateChange]

Returns the state changes that would be made.

pub fn events(&self) -> &[SimulatedEvent]

Returns the events that would be emitted.

pub fn hash(&self) -> &str

Returns the transaction hash (would be this if submitted).

pub fn vm_error(&self) -> Option<&VmError>

Returns detailed VM error information if the simulation failed.

pub fn raw(&self) -> &Value

Returns the raw JSON response for advanced use.

pub fn is_insufficient_balance(&self) -> bool

Checks if the failure is due to insufficient balance.

pub fn is_sequence_number_error(&self) -> bool

Checks if the failure is due to sequence number issues.

pub fn is_out_of_gas(&self) -> bool

Checks if the failure is due to out of gas.

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

Returns a user-friendly error message if the simulation failed.

Trait Implementations

impl Clone for SimulationResult

fn clone(&self) -> SimulationResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SimulationResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SimulationResult

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SimulationResult

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.