v0.1.0-pre.011-fix-01

This commit is contained in:
2026-07-24 15:06:27 +02:00
parent 42e8a203ec
commit 60660ca555
161 changed files with 10665 additions and 977 deletions

View File

@@ -1,5 +1,5 @@
// file: kb-store/src/contracts.rs
// version: 1
// version: 2
//! Backend-neutral storage contracts used by pipeline crates.
@@ -11,142 +11,142 @@ mod pagination;
mod repository;
/// Core account key insert contract.
pub use crate::contracts::dto::CoreAccountKeyInsert;
pub use self::dto::CoreAccountKeyInsert;
/// Core account key source category.
pub use crate::contracts::dto::CoreAccountKeySource;
pub use self::dto::CoreAccountKeySource;
/// Core balance change insert contract.
pub use crate::contracts::dto::CoreBalanceChangeInsert;
pub use self::dto::CoreBalanceChangeInsert;
/// Core balance change kind.
pub use crate::contracts::dto::CoreBalanceChangeKind;
pub use self::dto::CoreBalanceChangeKind;
/// Complete normalized core extraction write bundle.
pub use crate::contracts::dto::CoreExtractionBundle;
pub use self::dto::CoreExtractionBundle;
/// Failure details persisted for one canonical to core extraction attempt.
pub use crate::contracts::dto::CoreExtractionFailure;
pub use self::dto::CoreExtractionFailure;
/// Bounded canonical transaction selection filter for core extraction.
pub use crate::contracts::dto::CoreExtractionSelectionFilter;
pub use self::dto::CoreExtractionSelectionFilter;
/// Core inner instruction insert contract.
pub use crate::contracts::dto::CoreInnerInstructionInsert;
pub use self::dto::CoreInnerInstructionInsert;
/// Core instruction insert contract.
pub use crate::contracts::dto::CoreInstructionInsert;
pub use self::dto::CoreInstructionInsert;
/// Core instruction lifecycle mark request.
pub use crate::contracts::dto::CoreInstructionLifecycleMark;
pub use self::dto::CoreInstructionLifecycleMark;
/// Core instruction processing state.
pub use crate::contracts::dto::CoreInstructionProcessingState;
pub use self::dto::CoreInstructionProcessingState;
/// Core instruction replay filter contract.
pub use crate::contracts::dto::CoreInstructionReplayFilter;
pub use self::dto::CoreInstructionReplayFilter;
/// Core log insert contract.
pub use crate::contracts::dto::CoreLogInsert;
pub use self::dto::CoreLogInsert;
/// Core transaction insert contract.
pub use crate::contracts::dto::CoreTransactionInsert;
pub use self::dto::CoreTransactionInsert;
/// One machine-readable decoder coverage declaration row.
pub use crate::contracts::dto::DecodeCoverageDeclarationInsert;
pub use self::dto::DecodeCoverageDeclarationInsert;
/// One observed coverage classification row owned by one decode attempt.
pub use crate::contracts::dto::DecodeCoverageObservationInsert;
pub use self::dto::DecodeCoverageObservationInsert;
/// One row of aggregated decoder coverage diagnostics.
pub use crate::contracts::dto::DecodeCoverageSummaryRow;
pub use self::dto::DecodeCoverageSummaryRow;
/// Failed decode attempt persisted in the common ledger.
pub use crate::contracts::dto::DecodeFailure;
pub use self::dto::DecodeFailure;
/// One processor-owned decoded observation row.
pub use crate::contracts::dto::DecodeObservationInsert;
pub use self::dto::DecodeObservationInsert;
/// Atomic persistence bundle for one decoder and one contextual input.
pub use crate::contracts::dto::DecodePersistenceBundle;
pub use self::dto::DecodePersistenceBundle;
/// Bounded contextual instruction selection filter for decode campaigns.
pub use crate::contracts::dto::DecodeSelectionFilter;
pub use self::dto::DecodeSelectionFilter;
/// Decoded event insert contract.
pub use crate::contracts::dto::DecodedEventInsert;
pub use self::dto::DecodedEventInsert;
/// Insert or upsert result contract returned by repositories.
pub use crate::contracts::dto::InsertOutcome;
pub use self::dto::InsertOutcome;
/// Maximum number of materialized rows returned by one bounded query.
pub use crate::contracts::dto::MAX_MATERIALIZED_EVENT_QUERY_ROWS;
pub use self::dto::MAX_MATERIALIZED_EVENT_QUERY_ROWS;
/// Atomic persistence bundle for one materializer and one decoded observation.
pub use crate::contracts::dto::MaterializationPersistenceBundle;
pub use self::dto::MaterializationPersistenceBundle;
/// Bounded read-only materialized event selection.
pub use crate::contracts::dto::MaterializedEventFilter;
pub use self::dto::MaterializedEventFilter;
/// Materialized event insert contract.
pub use crate::contracts::dto::MaterializedEventInsert;
pub use self::dto::MaterializedEventInsert;
/// One materialized output returned by a bounded query.
pub use crate::contracts::dto::MaterializedEventQueryRow;
pub use self::dto::MaterializedEventQueryRow;
/// One processor-owned materialized output row.
pub use crate::contracts::dto::MaterializedOutputInsert;
pub use self::dto::MaterializedOutputInsert;
/// Stable processing ledger identity.
pub use crate::contracts::dto::ProcessingLedgerIdentity;
pub use self::dto::ProcessingLedgerIdentity;
/// Processing ledger mark request contract.
pub use crate::contracts::dto::ProcessingLedgerMark;
pub use self::dto::ProcessingLedgerMark;
/// Stable processing ledger status.
pub use crate::contracts::dto::ProcessingLedgerStatus;
pub use self::dto::ProcessingLedgerStatus;
/// Raw payload lifecycle mark request.
pub use crate::contracts::dto::RawPayloadLifecycleMark;
pub use self::dto::RawPayloadLifecycleMark;
/// Raw payload processing state.
pub use crate::contracts::dto::RawPayloadProcessingState;
pub use self::dto::RawPayloadProcessingState;
/// Raw payload retention state.
pub use crate::contracts::dto::RawPayloadRetentionState;
pub use self::dto::RawPayloadRetentionState;
/// Canonical raw Solana transaction insert contract.
pub use crate::contracts::dto::RawTransactionInsert;
pub use self::dto::RawTransactionInsert;
/// Store backend diagnostic contract.
pub use crate::contracts::dto::StoreBackendDescriptor;
pub use self::dto::StoreBackendDescriptor;
/// Store backend kind contract.
pub use crate::contracts::dto::StoreBackendKind;
pub use self::dto::StoreBackendKind;
/// Store migration diagnostic snapshot contract.
pub use crate::contracts::dto::StoreMigrationSnapshot;
pub use self::dto::StoreMigrationSnapshot;
/// Store migration status contract.
pub use crate::contracts::dto::StoreMigrationStatus;
pub use self::dto::StoreMigrationStatus;
/// Transaction acquisition observation insert contract.
pub use crate::contracts::dto::TransactionObservationInsert;
pub use self::dto::TransactionObservationInsert;
/// Transaction acquisition observation origin.
pub use crate::contracts::dto::TransactionObservationOrigin;
pub use self::dto::TransactionObservationOrigin;
/// Transaction acquisition observation status.
pub use crate::contracts::dto::TransactionObservationStatus;
pub use self::dto::TransactionObservationStatus;
/// Core account key SQL-like row contract.
pub use crate::contracts::entity::CoreAccountKeyRow;
pub use self::entity::CoreAccountKeyRow;
/// Core balance change SQL-like row contract.
pub use crate::contracts::entity::CoreBalanceChangeRow;
pub use self::entity::CoreBalanceChangeRow;
/// Core inner instruction SQL-like row contract.
pub use crate::contracts::entity::CoreInnerInstructionRow;
pub use self::entity::CoreInnerInstructionRow;
/// Core instruction SQL-like row contract.
pub use crate::contracts::entity::CoreInstructionRow;
pub use self::entity::CoreInstructionRow;
/// Core log SQL-like row contract.
pub use crate::contracts::entity::CoreLogRow;
pub use self::entity::CoreLogRow;
/// Core transaction SQL-like row contract.
pub use crate::contracts::entity::CoreTransactionRow;
pub use self::entity::CoreTransactionRow;
/// Decoded event SQL-like row contract.
pub use crate::contracts::entity::DecodedEventRow;
pub use self::entity::DecodedEventRow;
/// Materialized event SQL-like row contract.
pub use crate::contracts::entity::MaterializedEventRow;
pub use self::entity::MaterializedEventRow;
/// Processing ledger SQL-like row contract.
pub use crate::contracts::entity::ProcessingLedgerRow;
pub use self::entity::ProcessingLedgerRow;
/// Canonical raw Solana transaction SQL-like row contract.
pub use crate::contracts::entity::RawTransactionRow;
pub use self::entity::RawTransactionRow;
/// Transaction acquisition observation SQL-like row contract.
pub use crate::contracts::entity::TransactionObservationRow;
pub use self::entity::TransactionObservationRow;
/// Storage error helper functions.
pub use crate::contracts::error::storage_contract_error;
pub use self::error::storage_contract_error;
/// Store backend health snapshot.
pub use crate::contracts::health::StoreHealthSnapshot;
pub use self::health::StoreHealthSnapshot;
/// Store backend health status.
pub use crate::contracts::health::StoreHealthStatus;
pub use self::health::StoreHealthStatus;
/// Default repository page size.
pub use crate::contracts::pagination::DEFAULT_PAGE_SIZE;
pub use self::pagination::DEFAULT_PAGE_SIZE;
/// Maximum repository page size.
pub use crate::contracts::pagination::MAX_PAGE_SIZE;
pub use self::pagination::MAX_PAGE_SIZE;
/// Page request contract for repository list operations.
pub use crate::contracts::pagination::PageRequest;
pub use self::pagination::PageRequest;
/// Sort direction for repository list operations.
pub use crate::contracts::pagination::SortDirection;
pub use self::pagination::SortDirection;
/// Canonical transaction to core extraction storage behavior.
pub use crate::contracts::repository::CoreExtractionStore;
pub use self::repository::CoreExtractionStore;
/// Core Solana storage behavior.
pub use crate::contracts::repository::CoreTransactionStore;
pub use self::repository::CoreTransactionStore;
/// Contextual instruction decode and materialization storage behavior.
pub use crate::contracts::repository::DecodePipelineStore;
pub use self::repository::DecodePipelineStore;
/// Decoded event storage behavior.
pub use crate::contracts::repository::DecodedEventStore;
pub use self::repository::DecodedEventStore;
/// Materialized event storage behavior.
pub use crate::contracts::repository::MaterializedEventStore;
pub use self::repository::MaterializedEventStore;
/// Processing ledger storage behavior.
pub use crate::contracts::repository::ProcessingLedgerStore;
pub use self::repository::ProcessingLedgerStore;
/// Program observation storage behavior.
pub use crate::contracts::repository::ProgramObservationStore;
pub use self::repository::ProgramObservationStore;
/// Raw transaction storage behavior.
pub use crate::contracts::repository::RawTransactionStore;
pub use self::repository::RawTransactionStore;
/// Store health storage behavior.
pub use crate::contracts::repository::StoreHealthStore;
pub use self::repository::StoreHealthStore;