Skip to content

feat: adds top level engine crate for global orchestration#24

Open
bmuddha wants to merge 1 commit into
programsfrom
engine
Open

feat: adds top level engine crate for global orchestration#24
bmuddha wants to merge 1 commit into
programsfrom
engine

Conversation

@bmuddha

@bmuddha bmuddha commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

What changed

Added the top-level magicblock-engine crate that wires durable state (keeper =
accountsdb + ledger) to the transaction sequencer (processor).

Why

The stack needs a single consumer-facing entry point that owns the signing
authority, the shared Keeper, and a sequencer handle, and rebuilds volatile
state on restart.

Part of #4.

Impact

  • Engine exposes account() (account CRUD as privileged MagicRoot instruction
    sequences) and transaction() (execute / schedule / simulate).
  • IntoTransactionView signs and sanitizes a Message, &[Instruction], or an
    existing view with the engine authority and latest blockhash.
  • Startup replays retained ledger entries from the accountsdb slot to the ledger
    tip to rebuild volatile state.

Reviewer notes

At each sealed superblock replay is quiesced and the reconstructed account checksum
is compared against the sealed value; divergence is ReplayError::StateMismatch,
catching silent state corruption on restart.

Follow-up

Nothing else in the workspace depends on this crate; it is the top of the stack.

@bmuddha bmuddha force-pushed the engine branch 2 times, most recently from 1e5ae15 to 3775c49 Compare June 24, 2026 16:22
@bmuddha bmuddha force-pushed the engine branch 2 times, most recently from a656426 to f9d750c Compare June 30, 2026 13:19
@bmuddha bmuddha force-pushed the programs branch 2 times, most recently from 11b31fc to ffefa44 Compare July 1, 2026 20:03
@bmuddha bmuddha force-pushed the engine branch 2 times, most recently from 11fe1af to c20d652 Compare July 2, 2026 15:08
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