v0.5.3-pre.004

ks-store/src/lib.rs

@@ -1,5 +1,5 @@
 // file: ks-store/src/lib.rs
-// version: 12
+// version: 13
 
 //! Backend-agnostic Solana storage contracts and store facade.
 #![warn(missing_docs)]
@@ -67,10 +67,14 @@ pub(crate) use self::postgres::decode_store_schema_statements;
 pub(crate) use self::postgres::decode_store_table_diagnostic_specs;
 /// Crate-internal expected PostgreSQL index inventory shared through the crate-root facade.
 pub(crate) use self::postgres::expected_postgres_index_names;
+/// Crate-internal account-observation key lookup shared through the crate-root facade.
+pub(crate) use self::postgres::has_account_observation_key;
 /// Crate-internal storage symbol `has_raw_transaction_signature` shared through the crate-root facade.
 pub(crate) use self::postgres::has_raw_transaction_signature;
 /// Crate-internal storage symbol `has_transaction_observation_key` shared through the crate-root facade.
 pub(crate) use self::postgres::has_transaction_observation_key;
+/// Crate-internal account-observation insert shared through the crate-root facade.
+pub(crate) use self::postgres::insert_account_observation;
 /// Crate-internal storage symbol `insert_core_account_keys` shared through the crate-root facade.
 pub(crate) use self::postgres::insert_core_account_keys;
 /// Crate-internal storage symbol `insert_core_balance_changes` shared through the crate-root facade.
@@ -87,10 +91,18 @@ pub(crate) use self::postgres::insert_core_transaction;
 pub(crate) use self::postgres::insert_raw_transaction;
 /// Crate-internal storage symbol `insert_transaction_observation` shared through the crate-root facade.
 pub(crate) use self::postgres::insert_transaction_observation;
+/// Crate-internal Core descendant invalidation shared through the crate-root facade.
+pub(crate) use self::postgres::invalidate_core_descendants_in_transaction;
+/// Crate-internal decode descendant invalidation shared through the crate-root facade.
+pub(crate) use self::postgres::invalidate_decode_descendants_in_transaction;
+/// Crate-internal account-state currentness lookup shared through the crate-root facade.
+pub(crate) use self::postgres::is_account_state_current;
 /// Crate-internal storage symbol `is_core_extraction_current` shared through the crate-root facade.
 pub(crate) use self::postgres::is_core_extraction_current;
 /// Crate-internal storage symbol `is_decode_current` shared through the crate-root facade.
 pub(crate) use self::postgres::is_decode_current;
+/// Crate-internal account-observation normalization selection shared through the crate-root facade.
+pub(crate) use self::postgres::list_account_observations_for_normalization;
 /// Crate-internal storage symbol `list_core_instruction_replay_inputs` shared through the crate-root facade.
 pub(crate) use self::postgres::list_core_instruction_replay_inputs;
 /// Crate-internal storage symbol `list_core_instructions_for_replay` shared through the crate-root facade.
@@ -119,10 +131,14 @@ pub(crate) use self::postgres::load_expected_index_counts;
 pub(crate) use self::postgres::load_server_version;
 /// Crate-internal storage symbol `load_table_statistics` shared through the crate-root facade.
 pub(crate) use self::postgres::load_table_statistics;
+/// Crate-internal account-state failure persistence shared through the crate-root facade.
+pub(crate) use self::postgres::mark_account_state_failed;
 /// Crate-internal storage symbol `mark_core_extraction_failed` shared through the crate-root facade.
 pub(crate) use self::postgres::mark_core_extraction_failed;
 /// Crate-internal storage symbol `mark_decode_failed` shared through the crate-root facade.
 pub(crate) use self::postgres::mark_decode_failed;
+/// Crate-internal account-state persistence shared through the crate-root facade.
+pub(crate) use self::postgres::persist_account_state;
 /// Crate-internal storage symbol `persist_core_extraction` shared through the crate-root facade.
 pub(crate) use self::postgres::persist_core_extraction;
 /// Crate-internal storage symbol `persist_decode_coverage_declarations` shared through the crate-root facade.
@@ -138,6 +154,8 @@ pub(crate) use self::postgres::postgres_test_guard;
 pub(crate) use self::postgres::raw_store_schema_statements;
 /// Crate-internal storage symbol `raw_store_table_diagnostic_specs` shared through the crate-root facade.
 pub(crate) use self::postgres::raw_store_table_diagnostic_specs;
+/// Crate-internal instruction lifecycle recomputation shared through the crate-root facade.
+pub(crate) use self::postgres::recompute_instruction_lifecycle_in_transaction;
 /// Crate-internal storage symbol `run_health_check` shared through the crate-root facade.
 pub(crate) use self::postgres::run_health_check;
 /// Crate-internal storage symbol `table_exists` shared through the crate-root facade.
@@ -183,10 +201,20 @@ pub(crate) use self::postgres::validate_postgres_sql_resources;
 
 /// Transitional logical schema contract identifier used until the `0.5.3-pre.3` rebuild.
 pub use self::constants::STORE_SCHEMA_CONTRACT_VERSION;
+/// Account-state normalization processing-stage identifier.
+pub use self::contracts::ACCOUNT_STATE_NORMALIZATION_STAGE;
 /// Generic account acquisition observation insert contract.
 pub use self::contracts::AccountObservationInsert;
 /// Generic account acquisition observation persisted row contract.
 pub use self::contracts::AccountObservationRow;
+/// Failed generic account-state normalization attempt.
+pub use self::contracts::AccountStateNormalizationFailure;
+/// Atomic persistence bundle for one generic Core account state.
+pub use self::contracts::AccountStatePersistenceBundle;
+/// Bounded generic account-observation selection for Core normalization.
+pub use self::contracts::AccountStateSelectionFilter;
+/// Generic account observation to Core account-state storage behavior.
+pub use self::contracts::AccountStateStore;
 /// Transaction acquisition observation origin.
 pub use self::contracts::AcquisitionObservationOrigin;
 /// Generic account acquisition observation status.
@@ -227,8 +255,12 @@ pub use self::contracts::CoreInstructionLifecycleMark;
 pub use self::contracts::CoreInstructionProcessingState;
 /// Core instruction replay filter contract.
 pub use self::contracts::CoreInstructionReplayFilter;
+/// Logical top-level or CPI instruction row selected for replay.
+pub use self::contracts::CoreInstructionReplayRow;
 /// Core instruction persisted row contract.
 pub use self::contracts::CoreInstructionRow;
+/// Logical scope of one replayable Core instruction.
+pub use self::contracts::CoreInstructionScope;
 /// Core log insert contract.
 pub use self::contracts::CoreLogInsert;
 /// Core log persisted row contract.
@@ -265,8 +297,16 @@ pub use self::contracts::DecodeSchemaProvenance;
 pub use self::contracts::DecodeSelectionFilter;
 /// Insert or upsert result contract returned by repositories.
 pub use self::contracts::InsertOutcome;
+/// Maximum number of account observations selected by one normalization query.
+pub use self::contracts::MAX_ACCOUNT_STATE_SELECTION_ROWS;
+/// Maximum canonical transactions selected by one Core extraction batch.
+pub use self::contracts::MAX_CORE_EXTRACTION_SELECTION_ROWS;
+/// Maximum contextual inputs selected by one decode processing batch.
+pub use self::contracts::MAX_DECODE_SELECTION_ROWS;
 /// Maximum number of materialized rows returned by one bounded query.
 pub use self::contracts::MAX_MATERIALIZED_OUTPUT_QUERY_ROWS;
+/// Maximum encoded opaque page-cursor length.
+pub use self::contracts::MAX_PAGE_CURSOR_LENGTH;
 /// Maximum repository page size.
 pub use self::contracts::MAX_PAGE_SIZE;
 /// Maximum number of rows returned by one replay candidate query.
@@ -281,6 +321,8 @@ pub use self::contracts::MaterializedOutputInsert;
 pub use self::contracts::MaterializedOutputQueryRow;
 /// Page request contract for repository list operations.
 pub use self::contracts::PageRequest;
+/// One bounded repository page and its optional continuation cursor.
+pub use self::contracts::PageSlice;
 /// Stable processing ledger identity.
 pub use self::contracts::ProcessingLedgerIdentity;
 /// Stable processing ledger status.