Struct UpdateContext 

pub struct UpdateContext {
    pub slot: Option<u64>,
    pub signature: Option<String>,
    pub timestamp: Option<i64>,
    pub write_version: Option<u64>,
    pub txn_index: Option<u64>,
    pub skip_resolvers: bool,
    pub metadata: HashMap<String, Value>,
}

Context metadata for blockchain updates (accounts and instructions) This structure is designed to be extended over time with additional metadata

Fields

slot: Option<u64>

Blockchain slot number

signature: Option<String>

Transaction signature

timestamp: Option<i64>

Unix timestamp (seconds since epoch) If not provided, will default to current system time when accessed

write_version: Option<u64>

Write version for account updates (monotonically increasing per account within a slot) Used for staleness detection to reject out-of-order updates

txn_index: Option<u64>

Transaction index for instruction updates (orders transactions within a slot) Used for staleness detection to reject out-of-order updates

skip_resolvers: bool

When true, QueueResolver opcodes are skipped during handler execution. Set for reprocessed cached data from PDA mapping changes to prevent stale data from triggering resolvers or locking in wrong values via SetOnce.

metadata: HashMap<String, Value>

Additional custom metadata that can be added without breaking changes

Implementations

impl UpdateContext

pub fn new(slot: u64, signature: String) -> Self

Create a new UpdateContext with slot and signature

pub fn with_timestamp(slot: u64, signature: String, timestamp: i64) -> Self

Create a new UpdateContext with slot, signature, and timestamp

pub fn new_account(slot: u64, signature: String, write_version: u64) -> Self

Create context for account updates with write_version for staleness detection

pub fn new_instruction(slot: u64, signature: String, txn_index: u64) -> Self

Create context for instruction updates with txn_index for staleness detection

pub fn new_reprocessed(slot: u64, write_version: u64) -> Self

Create context for reprocessed cached account data from PDA mapping changes. Uses empty signature to prevent when guards from matching stale instructions, and sets skip_resolvers to prevent stale scheduling/SetOnce lock-in.

pub fn timestamp(&self) -> i64

Get the timestamp, falling back to current system time if not set

pub fn empty() -> Self

Create an empty context (for testing or when context is not available)

pub fn is_account_update(&self) -> bool

Add custom metadata Returns true if this is an account update context (has write_version, no txn_index)

pub fn is_instruction_update(&self) -> bool

Returns true if this is an instruction update context (has txn_index, no write_version)

pub fn with_metadata(self, key: String, value: Value) -> Self

pub fn get_metadata(&self, key: &str) -> Option<&Value>

Get metadata value

pub fn to_value(&self) -> Value

Convert context to JSON value for injection into event data

Trait Implementations

impl Clone for UpdateContext

fn clone(&self) -> UpdateContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateContext

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

Formats the value using the given formatter.

impl Default for UpdateContext

fn default() -> UpdateContext

Returns the “default value” for a type.