v0.5.3-pre.004

This commit is contained in:
2026-08-12 14:31:48 +02:00
parent 400ced4832
commit b6583bd9fb
47 changed files with 2978 additions and 291 deletions

View File

@@ -1,5 +1,5 @@
// file: ks-store/src/contracts.rs
// version: 7
// version: 8
//! Backend-neutral storage contracts used by pipeline crates.
@@ -11,8 +11,16 @@ mod pagination;
mod replay;
mod repository;
/// Stable processing stage used for generic account-state normalization.
pub use self::dto::ACCOUNT_STATE_NORMALIZATION_STAGE;
/// Generic account acquisition observation insert contract.
pub use self::dto::AccountObservationInsert;
/// Failed generic account-state normalization attempt.
pub use self::dto::AccountStateNormalizationFailure;
/// Atomic generic account-state persistence bundle.
pub use self::dto::AccountStatePersistenceBundle;
/// Bounded generic account-state selection filter.
pub use self::dto::AccountStateSelectionFilter;
/// Transaction acquisition observation origin.
pub use self::dto::AcquisitionObservationOrigin;
/// Generic account acquisition observation status.
@@ -43,6 +51,8 @@ pub use self::dto::CoreInstructionLifecycleMark;
pub use self::dto::CoreInstructionProcessingState;
/// Core instruction replay filter contract.
pub use self::dto::CoreInstructionReplayFilter;
/// Logical Core instruction scope.
pub use self::dto::CoreInstructionScope;
/// Core log insert contract.
pub use self::dto::CoreLogInsert;
/// Core return-data insert contract.
@@ -61,11 +71,18 @@ pub use self::dto::DecodeFailure;
pub use self::dto::DecodeObservationInsert;
/// Atomic persistence bundle for one decoder and one contextual input.
pub use self::dto::DecodePersistenceBundle;
/// Source-neutral external decode schema provenance.
pub use self::dto::DecodeSchemaProvenance;
/// Bounded contextual instruction selection filter for decode campaigns.
pub use self::dto::DecodeSelectionFilter;
/// Insert or upsert result contract returned by repositories.
pub use self::dto::InsertOutcome;
/// Maximum number of account observations selected by one normalization query.
pub use self::dto::MAX_ACCOUNT_STATE_SELECTION_ROWS;
/// Maximum canonical transactions selected by one Core extraction batch.
pub use self::dto::MAX_CORE_EXTRACTION_SELECTION_ROWS;
/// Maximum contextual inputs selected by one decode processing batch.
pub use self::dto::MAX_DECODE_SELECTION_ROWS;
/// Maximum number of materialized rows returned by one bounded query.
pub use self::dto::MAX_MATERIALIZED_OUTPUT_QUERY_ROWS;
/// Atomic persistence bundle for one materializer and one decoded observation.
@@ -116,7 +133,6 @@ pub use self::dto::StoreResourceStatistics;
pub use self::dto::StoreRuntimeSummary;
/// Transaction acquisition observation insert contract.
pub use self::dto::TransactionObservationInsert;
/// Transaction acquisition observation status.
/// Generic account acquisition observation SQL-like row contract.
pub use self::entity::AccountObservationRow;
/// Core account key SQL-like row contract.
@@ -127,6 +143,8 @@ pub use self::entity::CoreAccountStateRow;
pub use self::entity::CoreBalanceChangeRow;
/// Core inner instruction SQL-like row contract.
pub use self::entity::CoreInnerInstructionRow;
/// Logical top-level or CPI instruction SQL-like replay row.
pub use self::entity::CoreInstructionReplayRow;
/// Core instruction SQL-like row contract.
pub use self::entity::CoreInstructionRow;
/// Core log SQL-like row contract.
@@ -147,10 +165,14 @@ pub use self::health::StoreHealthSnapshot;
pub use self::health::StoreHealthStatus;
/// Default repository page size.
pub use self::pagination::DEFAULT_PAGE_SIZE;
/// Maximum encoded cursor size.
pub use self::pagination::MAX_PAGE_CURSOR_LENGTH;
/// Maximum repository page size.
pub use self::pagination::MAX_PAGE_SIZE;
/// Page request contract for repository list operations.
pub use self::pagination::PageRequest;
/// One bounded page and its continuation cursor.
pub use self::pagination::PageSlice;
/// Sort direction for repository list operations.
pub use self::pagination::SortDirection;
/// Maximum number of rows returned by one replay candidate query.
@@ -171,6 +193,8 @@ pub use self::replay::ReplayProgramSummary;
pub use self::replay::ReplayTransactionCandidate;
/// Bounded read-only filter for transaction replay candidates.
pub use self::replay::ReplayTransactionFilter;
/// Generic account observation to Core account-state storage behavior.
pub use self::repository::AccountStateStore;
/// Canonical transaction to core extraction storage behavior.
pub use self::repository::CoreExtractionStore;
/// Core Solana storage behavior.