Enum OpCode 

pub enum OpCode {
    AbortIfNullKey {
        key: Register,
        is_account_event: bool,
    },
    LoadEventField {
        path: FieldPath,
        dest: Register,
        default: Option<Value>,
    },
    LoadConstant {
        value: Value,
        dest: Register,
    },
    CopyRegister {
        source: Register,
        dest: Register,
    },
    CopyRegisterIfNull {
        source: Register,
        dest: Register,
    },
    GetEventType {
        dest: Register,
    },
    CreateObject {
        dest: Register,
    },
    SetField {
        object: Register,
        path: String,
        value: Register,
    },
    SetFields {
        object: Register,
        fields: Vec<(String, Register)>,
    },
    GetField {
        object: Register,
        path: String,
        dest: Register,
    },
    ReadOrInitState {
        state_id: u32,
        key: Register,
        default: Value,
        dest: Register,
    },
    UpdateState {
        state_id: u32,
        key: Register,
        value: Register,
    },
    AppendToArray {
        object: Register,
        path: String,
        value: Register,
    },
    GetCurrentTimestamp {
        dest: Register,
    },
    CreateEvent {
        dest: Register,
        event_value: Register,
    },
    CreateCapture {
        dest: Register,
        capture_value: Register,
    },
    Transform {
        source: Register,
        dest: Register,
        transformation: Transformation,
    },
    EmitMutation {
        entity_name: String,
        key: Register,
        state: Register,
    },
    SetFieldIfNull {
        object: Register,
        path: String,
        value: Register,
    },
    SetFieldMax {
        object: Register,
        path: String,
        value: Register,
    },
    UpdateTemporalIndex {
        state_id: u32,
        index_name: String,
        lookup_value: Register,
        primary_key: Register,
        timestamp: Register,
    },
    LookupTemporalIndex {
        state_id: u32,
        index_name: String,
        lookup_value: Register,
        timestamp: Register,
        dest: Register,
    },
    UpdateLookupIndex {
        state_id: u32,
        index_name: String,
        lookup_value: Register,
        primary_key: Register,
    },
    LookupIndex {
        state_id: u32,
        index_name: String,
        lookup_value: Register,
        dest: Register,
    },
    SetFieldSum {
        object: Register,
        path: String,
        value: Register,
    },
    SetFieldIncrement {
        object: Register,
        path: String,
    },
    SetFieldMin {
        object: Register,
        path: String,
        value: Register,
    },
    SetFieldWhen {
        object: Register,
        path: String,
        value: Register,
        when_instruction: String,
        entity_name: String,
        key_reg: Register,
        condition_field: Option<FieldPath>,
        condition_op: Option<ComparisonOp>,
        condition_value: Option<Value>,
    },
    SetFieldUnlessStopped {
        object: Register,
        path: String,
        value: Register,
        stop_field: String,
        stop_instruction: String,
        entity_name: String,
        key_reg: Register,
    },
    AddToUniqueSet {
        state_id: u32,
        set_name: String,
        value: Register,
        count_object: Register,
        count_path: String,
    },
    ConditionalSetField {
        object: Register,
        path: String,
        value: Register,
        condition_field: FieldPath,
        condition_op: ComparisonOp,
        condition_value: Value,
    },
    ConditionalIncrement {
        object: Register,
        path: String,
        condition_field: FieldPath,
        condition_op: ComparisonOp,
        condition_value: Value,
    },
    EvaluateComputedFields {
        state: Register,
        computed_paths: Vec<String>,
    },
    QueueResolver {
        state_id: u32,
        entity_name: String,
        resolver: ResolverType,
        input_path: Option<String>,
        input_value: Option<Value>,
        url_template: Option<Vec<UrlTemplatePart>>,
        strategy: ResolveStrategy,
        extracts: Vec<ResolverExtractSpec>,
        condition: Option<ResolverCondition>,
        schedule_at: Option<String>,
        state: Register,
        key: Register,
    },
    UpdatePdaReverseLookup {
        state_id: u32,
        lookup_name: String,
        pda_address: Register,
        primary_key: Register,
    },
    SegmentBoundary,
}

Variants

AbortIfNullKey

Abort the handler with empty mutations when the key register is null and the event is an account-state update (not IxState / CpiEvent). Placed immediately after key resolution so that downstream opcodes (index updates, field mappings, resolvers, emit) never execute with a garbage key. The null-key event is then eligible for queueing by process_event’s miss-handling logic.

Fields

key: Register

is_account_event: bool

LoadEventField

Fields

path: FieldPath

dest: Register

default: Option<Value>

LoadConstant

Fields

value: Value

dest: Register

CopyRegister

Fields

source: Register

dest: Register

CopyRegisterIfNull

Copy from source to dest only if dest is currently null

Fields

source: Register

dest: Register

GetEventType

Fields

dest: Register

CreateObject

Fields

dest: Register

SetField

Fields

object: Register

path: String

value: Register

SetFields

Fields

object: Register

fields: Vec<(String, Register)>

GetField

Fields

object: Register

path: String

dest: Register

ReadOrInitState

Fields

state_id: u32

key: Register

default: Value

dest: Register

UpdateState

Fields

state_id: u32

key: Register

value: Register

AppendToArray

Fields

object: Register

path: String

value: Register

GetCurrentTimestamp

Load the Unix-seconds timestamp of the update being processed (its UpdateContext timestamp, else the wall clock). It is the update’s time, not the processing time, so a replay reproduces it.

Fields

dest: Register

CreateEvent

Wrap an event as {timestamp, data, slot?, signature?, event_index?, ix_path?}, stamped with the update’s timestamp.

Fields

dest: Register

event_value: Register

CreateCapture

Wrap a captured account as {timestamp, account_address, data, slot?, signature?}, stamped with the update’s timestamp.

Fields

dest: Register

capture_value: Register

Transform

Fields

source: Register

dest: Register

transformation: Transformation

EmitMutation

Fields

entity_name: String

key: Register

state: Register

SetFieldIfNull

Fields

object: Register

path: String

value: Register

SetFieldMax

Fields

object: Register

path: String

value: Register

UpdateTemporalIndex

Fields

state_id: u32

index_name: String

lookup_value: Register

primary_key: Register

timestamp: Register

LookupTemporalIndex

Fields

state_id: u32

index_name: String

lookup_value: Register

timestamp: Register

dest: Register

UpdateLookupIndex

Fields

state_id: u32

index_name: String

lookup_value: Register

primary_key: Register

LookupIndex

Fields

state_id: u32

index_name: String

lookup_value: Register

dest: Register

SetFieldSum

Sum a numeric value to a field (accumulator)

Fields

object: Register

path: String

value: Register

SetFieldIncrement

Increment a counter field by 1

Fields

object: Register

path: String

SetFieldMin

Set field to minimum value

Fields

object: Register

path: String

value: Register

SetFieldWhen

Set field only if a specific instruction type was seen in the same transaction. If not seen yet, defers the operation for later completion.

Fields

object: Register

path: String

value: Register

when_instruction: String

entity_name: String

key_reg: Register

condition_field: Option<FieldPath>

condition_op: Option<ComparisonOp>

condition_value: Option<Value>

SetFieldUnlessStopped

Set field unless stopped by a specific instruction. Stop is tracked by a per-entity stop flag.

Fields

object: Register

path: String

value: Register

stop_field: String

stop_instruction: String

entity_name: String

key_reg: Register

AddToUniqueSet

Add value to unique set and update count Maintains internal Set, field stores count

Fields

state_id: u32

set_name: String

value: Register

count_object: Register

count_path: String

ConditionalSetField

Conditionally set a field based on a comparison

Fields

object: Register

path: String

value: Register

condition_field: FieldPath

condition_op: ComparisonOp

condition_value: Value

ConditionalIncrement

Conditionally increment a field based on a comparison

Fields

object: Register

path: String

condition_field: FieldPath

condition_op: ComparisonOp

condition_value: Value

EvaluateComputedFields

Evaluate computed fields (calls external hook if provided) computed_paths: List of paths that will be computed (for dirty tracking)

Fields

state: Register

computed_paths: Vec<String>

QueueResolver

Queue a resolver for asynchronous enrichment

Fields

state_id: u32

entity_name: String

resolver: ResolverType

input_path: Option<String>

input_value: Option<Value>

url_template: Option<Vec<UrlTemplatePart>>

strategy: ResolveStrategy

extracts: Vec<ResolverExtractSpec>

condition: Option<ResolverCondition>

schedule_at: Option<String>

state: Register

key: Register

UpdatePdaReverseLookup

Update PDA reverse lookup table Maps a PDA address to its primary key for reverse lookups

Fields

state_id: u32

lookup_name: String

pda_address: Register

primary_key: Register

SegmentBoundary

Separates independently keyed handler segments for one event type.

When one event updates the same entity through different keys (for example split_position touching both its first_position and its second_position), each key gets its own segment: its own key loading, state read, mappings, state write and mutation. The VM runs segments in order and isolates them, so an early exit in one segment never skips another. Handlers with a single key never contain a boundary.

Trait Implementations

impl Clone for OpCode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpCode

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

Formats the value using the given formatter.

impl Serialize for OpCode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.