Skip to content

SIP: Finalized State Contexts for RPC - #74

Draft
davidrotari19 wants to merge 1 commit into
sui-foundation:mainfrom
davidrotari19:sip/finalized_state_contexts
Draft

SIP: Finalized State Contexts for RPC#74
davidrotari19 wants to merge 1 commit into
sui-foundation:mainfrom
davidrotari19:sip/finalized_state_contexts

Conversation

@davidrotari19

@davidrotari19 davidrotari19 commented Sep 3, 2026

Copy link
Copy Markdown

Summary

This proposal introduces Finalized State Contexts, a Protobuf value that lets clients carry a lower bound on finalized state visibility across RPC requests before checkpoint processing completes. A context contains a certified checkpoint anchor and a frontier of finalized transaction digests. A service that accepts a context must either evaluate the operation against state containing its finalized effects or Return a structured error. It must never silently use older state.

Motivation

Sui can finalize transaction effects before those effects become visible through checkpoint based reads. Clients currently address this gap through checkpoint waiting, retries, or affinity to one node. Those mechanisms add latency or do not provide a portable consistency guarantee. This matters when a successor transaction must be constructed after observing a finalized predecessor, when another party must authorize the next step, when parallel transaction branches must be joined, or when a newly published package must be used immediately.

@davidrotari19 davidrotari19 changed the title Add finalized state contexts SIP draft SIP: Add finalized state contexts Sep 3, 2026
@davidrotari19 davidrotari19 changed the title SIP: Add finalized state contexts SIP: Finalized State Contexts for RPC Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant