v0.1.0-pre.011

kb-lib/src/materializer.rs

@@ -1,28 +1,116 @@
 // file: kb-lib/src/materializer.rs
-// version: 1
+// version: 2
 
 //! Consolidated materializer modules.
 
-pub mod admin;
-pub mod api;
-pub mod bridge;
-pub mod compliance;
-pub mod fees;
-pub mod governance;
-pub mod lending;
-pub mod lifecycle;
-pub mod liquidity;
-pub mod metadata;
-pub mod nft;
-pub mod oracle;
-pub mod orderbook;
-pub mod perpetuals;
-pub mod pool;
-pub mod rewards;
-pub mod risk;
-pub mod routing;
-pub mod staking;
-pub mod token;
-pub mod trades;
-pub mod transaction;
-pub mod vault;
+mod admin;
+mod api;
+mod bridge;
+mod compliance;
+mod fees;
+mod governance;
+mod lending;
+mod lifecycle;
+mod liquidity;
+mod metadata;
+mod nft;
+mod oracle;
+mod orderbook;
+mod perpetuals;
+mod pool;
+mod rewards;
+mod risk;
+mod routing;
+mod staking;
+mod token;
+mod trades;
+mod transaction;
+mod vault;
+
+/// Canonical processor name for the native and SPL administration materializer.
+pub(crate) use self::admin::MT_ADMIN_PROCESSOR_NAME;
+/// Canonical tracing target for the native and SPL administration materializer.
+pub(crate) use self::admin::MT_ADMIN_TRACING_TARGET;
+/// Canonical tracing target for the native compliance audit materializer.
+pub(crate) use self::compliance::MT_COMPLIANCE_AUDIT_TRACING_TARGET;
+/// Canonical tracing target for the native lifecycle materializer.
+pub(crate) use self::lifecycle::MT_LIFECYCLE_TRACING_TARGET;
+/// Stable processor name for SPL Token and ATA risk facts.
+pub(crate) use self::risk::MT_RISK_PROCESSOR_NAME;
+/// Stable projection contract version for SPL Token and ATA risk facts.
+pub(crate) use self::risk::MT_RISK_PROJECTION_VERSION;
+/// Canonical tracing target for SPL Token and ATA risk facts.
+pub(crate) use self::risk::MT_RISK_TRACING_TARGET;
+/// Canonical tracing target for the native stake and vote materializer.
+pub(crate) use self::staking::MT_STAKING_TRACING_TARGET;
+/// Stable processor name for Token, ATA and Token-2022 account projections.
+pub(crate) use self::token::MT_TOKEN_ACCOUNTS_PROCESSOR_NAME;
+/// Stable projection contract version for Token, ATA and Token-2022 account projections.
+pub(crate) use self::token::MT_TOKEN_ACCOUNTS_PROJECTION_VERSION;
+/// Canonical tracing target for Token, ATA and Token-2022 account projections.
+pub(crate) use self::token::MT_TOKEN_ACCOUNTS_TRACING_TARGET;
+/// Maximum Memo payload accepted by transaction annotations.
+pub(crate) use self::transaction::MT_TRANSACTION_ANNOTATIONS_MAX_MEMO_PAYLOAD_BYTES;
+/// Stable processor name for transaction annotations.
+pub(crate) use self::transaction::MT_TRANSACTION_ANNOTATIONS_PROCESSOR_NAME;
+/// Stable projection contract version for transaction annotations.
+pub(crate) use self::transaction::MT_TRANSACTION_ANNOTATIONS_PROJECTION_VERSION;
+/// Canonical tracing target for transaction annotations.
+pub(crate) use self::transaction::MT_TRANSACTION_ANNOTATIONS_TRACING_TARGET;
+
+/// Stable native and SPL administration materializer.
+pub use self::admin::MtAdminMaterializer;
+/// Materializes exact Token-2022 administration account snapshots.
+pub use self::admin::materialize_token2022_admin_state_snapshots;
+/// Materializes one exact SPL ElGamal registry account snapshot.
+pub use self::admin::materializer_admin_materialize_elgamal_registry_state_snapshot;
+/// Stable decoded observation materializer contract used by the common pipeline.
+pub use self::api::MtApiEventMaterializer;
+/// Explicit policy applied to successful and failed source transactions.
+pub use self::api::MtApiMaterializationTransactionPolicy;
+/// Stable processor-owned business output derived from one decoded observation.
+pub use self::api::MtApiMaterializedOutput;
+/// Structured materializer diagnostic without generic error wrappers.
+pub use self::api::MtApiMaterializerDiagnostic;
+/// Complete explicit result produced by one materializer invocation.
+pub use self::api::MtApiMaterializerExecutionResult;
+/// Stable identity of one decoded event materializer.
+pub use self::api::MtApiMaterializerIdentity;
+/// Terminal materializer result status.
+pub use self::api::MtApiMaterializerOutcomeStatus;
+/// Exposes the legacy common business materializer trait.
+pub use self::api::MtMaterializer;
+/// Returns true when a materializer explicitly accepts one decoded family.
+pub use self::api::materializer_api_accepts_family;
+/// Returns true when a materializer accepts one exact decoded observation.
+pub use self::api::materializer_api_accepts_observation;
+/// Applies the mandatory source transaction policy before materialization.
+pub use self::api::materializer_api_validate_materialization_policy;
+/// Rejects mutable business outputs derived from failed or uncommitted observations.
+pub use self::api::materializer_api_validate_materialized_output_policy;
+/// Stable native compliance audit materializer.
+pub use self::compliance::MtComplianceAuditMaterializer;
+/// Fee materializer for committed Token-2022 fee observations.
+pub use self::fees::MtFeesMaterializer;
+/// Materializes authoritative Token-2022 fee extension snapshots.
+pub use self::fees::materialize_token2022_fee_state_snapshots;
+/// Stable native lifecycle materializer.
+pub use self::lifecycle::MtLifecycleMaterializer;
+/// Token-2022 and Metaplex metadata snapshot materializer.
+pub use self::metadata::MtMetadataMaterializer;
+/// Materializes one canonical non-Metadata Metaplex account snapshot.
+pub use self::metadata::materialize_metaplex_account_snapshot;
+/// Materializes one canonical Metaplex Metadata account snapshot.
+pub use self::metadata::materialize_metaplex_metadata_snapshot;
+/// Materializes Token-2022 embedded metadata and group snapshots.
+pub use self::metadata::materialize_token2022_metadata_snapshot;
+/// Stable SPL Token and ATA risk materializer.
+pub use self::risk::MtRiskMaterializer;
+/// Stable native stake and vote materializer.
+pub use self::staking::MtStakingMaterializer;
+/// Stable Token, ATA and Token-2022 account materializer.
+pub use self::token::MtTokenAccountsMaterializer;
+/// Materializes one bounded Token-2022 account state snapshot.
+pub use self::token::materialize_token2022_state_snapshot;
+/// Stable committed Memo transaction annotation materializer.
+pub use self::transaction::MtTransactionAnnotationMaterializer;