Skip to content

feat: implements keeper crate - state orchestrator#17

Open
bmuddha wants to merge 1 commit into
ledgerfrom
keeper
Open

feat: implements keeper crate - state orchestrator#17
bmuddha wants to merge 1 commit into
ledgerfrom
keeper

Conversation

@bmuddha

@bmuddha bmuddha commented May 7, 2026

Copy link
Copy Markdown
Collaborator

What changed

Added the keeper crate as the orchestration layer over accountsdb, ledger, caches, subscriptions, sysvar seeding, and account snapshot archival.

Why

Runtime code needs one consistency boundary that keeps account state, ledger records, cache state, and subscription updates aligned around execution and slot progress.

Closes #12.

Impact

  • Introduces Keeper, KeeperBuilder, storage directory parameters, and keeper-level errors.
  • Initializes ledger services and account storage together, restoring accounts from archived snapshots when needed.
  • Seeds clock, rent, and slot-hashes sysvars and maintains slot-based caches for signatures and blocks.

Reviewer notes

finalize seals the next superblock and archives the matching account snapshot. Restore keeps a backup before unpacking archived state so failed recovery can roll back.

Follow-up

Transaction processor and runtime integration can build on the keeper API.

bmuddha commented May 7, 2026

Copy link
Copy Markdown
Collaborator Author

@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 4f5ee62 to e964aa5 Compare May 12, 2026 14:26
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from a50733f to ec356b3 Compare May 14, 2026 14:46
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 5507317 to cc10928 Compare May 15, 2026 14:37
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from 6f820ed to 4f97612 Compare May 15, 2026 14:52
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from b2f67ae to c472d84 Compare May 28, 2026 14:38
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from a37d381 to 2233308 Compare May 28, 2026 14:42
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from 26a195d to b4d07e5 Compare June 24, 2026 16:22
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 682b276 to 2b9a523 Compare June 26, 2026 10:36
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 4e77f6c to dfef7ee Compare June 30, 2026 13:19
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from c8e3a23 to d17dabf Compare June 30, 2026 15:56
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 02e0c7b to 6460a11 Compare July 2, 2026 15:08
@bmuddha bmuddha force-pushed the ledger branch 2 times, most recently from 3b30018 to d8fdf2c Compare July 3, 2026 22:01
@bmuddha bmuddha force-pushed the keeper branch 2 times, most recently from 81e789d to 8d9b940 Compare July 6, 2026 09:01
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