Struct InvokeFlag 

#[repr(transparent)]
pub struct InvokeFlag(pub i32);

Flags that modify the behavior of a contract invocation.

These flags are used with the Invoke syscall to control how a subinvocation executes. They are combined using bitwise OR.

Note: InvokeFlagSet is NOT part of the Invocation struct itself, but is instead a parameter to the Invoke syscall. The root transaction invocation always has no flags set (equivalent to None).

Tuple Fields

0: i32

Implementations

impl InvokeFlag

pub const None: InvokeFlag

No special behavior (default).

pub const TryInvoke: InvokeFlag

Enable early conflict detection for parallel execution.

Thruput executes transactions in parallel without observing other transactions’ writes. After execution, a two-phase commit process commits writes to the database. If there’s a conflict, the entire transaction aborts.

TryInvoke pulls this conflict detection earlier: when a try_invoke frame finishes, it performs two-phase commit lock acquisition immediately. If any lock fails, the subinvocation frame reverts (but the caller can handle this gracefully).

This is nondeterministic, so the two-phase commit result (a boolean) is appended to the nondeterministic_bits in NondeterministicProposalData for deterministic re-execution by validators.

pub const ReadOnly: InvokeFlag

Prevent all state modifications in the subinvocation.

The subinvocation can read storage but cannot write, deploy contracts, or perform any other state-modifying operations.

pub const DelegateCall: InvokeFlag

Execute the target contract’s code in the caller’s context.

Similar to Ethereum’s DELEGATECALL: the invoked code runs with the caller’s storage and address context, allowing library-like code reuse.

TODO: This flag is not yet implemented. When implementing, provide a comprehensive specification of what changes and what doesn’t change in a delegatecall frame. For example, GetMsgSender and GetCurrentAddress should NOT change (they return the original caller and current address), but storage operations should operate on the caller’s storage. Document the behavior of all syscalls in a delegatecall context.

Trait Implementations

impl Clone for InvokeFlag

fn clone(&self) -> InvokeFlag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConstMaxSize for InvokeFlag

const MAX_SIZE: Option<usize>

Worst-case CXS encoded size in bytes, or None if unbounded.

impl ConstMaxSize for InvokeFlag

const MAX_SIZE: Option<usize>

Worst-case TXS encoded size in bytes, or None if unbounded.

impl Copy for InvokeFlag

impl Debug for InvokeFlag

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

Formats the value using the given formatter.

impl Display for InvokeFlag

Available on crate feature std only.

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

Formats the value using the given formatter.

impl EncodesAs<InvokeFlag> for InvokeFlag

impl Eq for InvokeFlag

impl From<i32> for InvokeFlag

fn from(v: i32) -> InvokeFlag

Converts to this type from the input type.

impl Hash for InvokeFlag

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for InvokeFlag

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Ord for InvokeFlag

fn cmp(&self, other: &InvokeFlag) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for InvokeFlag

fn eq(&self, other: &InvokeFlag) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for InvokeFlag

fn partial_cmp(&self, other: &InvokeFlag) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'_r> ReadXDR<'_r> for InvokeFlag

fn read_xdr<R>(r: &mut R) -> Result<InvokeFlag, ReadError>

where R: Reader<'_r>,

Reads an XDR value from the reader.

fn read_xdr_in_place<R, '__xdrs_s>( r: &mut R, __xdrs_slot: Slot<'__xdrs_s, InvokeFlag>, ) -> Result<Init<'__xdrs_s, InvokeFlag>, ReadError>

where R: Reader<'_r>,

Reads an XDR value directly into slot, without first building it on the stack.

impl StructuralPartialEq for InvokeFlag

impl WriteXDR for InvokeFlag

fn write_xdr<F, W>(&self, w: &mut W) -> Result<(), WriteError>

where W: Writer<F>,

Writes this value as XDR data to the writer.

unsafe fn write_xdr_unchecked<F, W>(&self, w: &mut W)

where W: WriterUnchecked<F>,

Writes this value as XDR data to the writer, without runtime checks.