v0.1.0-pre.020

This commit is contained in:
2026-07-24 22:01:07 +02:00
parent fa2d9d8ecd
commit 4190b2c0ce
84 changed files with 3314 additions and 274 deletions

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/admin.rs
// version: 5
// version: 6
//! `admin` materializer family.
@@ -16,4 +16,4 @@ pub use self::core::materializer_admin_materialize_token2022_state_snapshots;
/// Canonical processor name for the native and SPL administration materializer.
pub(crate) use self::constants::MT_ADMIN_PROCESSOR_NAME;
/// Canonical tracing target for the native and SPL administration materializer.
pub(crate) use self::constants::MT_ADMIN_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_ADMIN;

View File

@@ -1,9 +1,9 @@
// file: kb-lib/src/materializer/admin/constants.rs
// version: 1
// version: 2
//! Local constants for the native and SPL administration materializer.
/// Canonical processor name for this component.
pub(crate) const MT_ADMIN_PROCESSOR_NAME: &str = "solana_native_admin";
/// Canonical tracing target for this component.
pub(crate) const MT_ADMIN_TRACING_TARGET: &str = "kb-lib.materializer.admin";
pub(crate) const TRACING_TARGET_MATERIALIZER_ADMIN: &str = "kb-lib.materializer.admin";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/admin/core.rs
// version: 16
// version: 17
//! Stable administrative projections derived from exact committed observations.
@@ -155,7 +155,7 @@ impl crate::MtApiEventMaterializer for crate::MtAdminMaterializer {
std::option::Option::Some(value) => value,
std::option::Option::None => {
tracing::debug!(
target: crate::MT_ADMIN_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_ADMIN,
action = "materialize_admin",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -173,7 +173,7 @@ impl crate::MtApiEventMaterializer for crate::MtAdminMaterializer {
}
if observation.transaction_failed || !observation.observation_committed {
tracing::debug!(
target: crate::MT_ADMIN_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_ADMIN,
action = "materialize_admin",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -223,7 +223,7 @@ impl crate::MtApiEventMaterializer for crate::MtAdminMaterializer {
}),
};
tracing::debug!(
target: crate::MT_ADMIN_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_ADMIN,
action = "materialize_admin",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/compliance.rs
// version: 3
// version: 4
//! `compliance` materializer family.
@@ -10,4 +10,4 @@ mod constants;
pub use self::audit::MtComplianceAuditMaterializer;
/// Canonical tracing target for the native compliance audit materializer.
pub(crate) use self::constants::MT_COMPLIANCE_AUDIT_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT;

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/compliance/audit.rs
// version: 7
// version: 8
//! Stable compliance-audit projections for committed native bytecode mutations and execution profiles.
@@ -113,7 +113,7 @@ impl crate::MtApiEventMaterializer for crate::MtComplianceAuditMaterializer {
std::option::Option::Some(value) => value,
std::option::Option::None => {
tracing::debug!(
target: crate::MT_COMPLIANCE_AUDIT_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT,
action = "materialize_compliance_audit",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -130,7 +130,7 @@ impl crate::MtApiEventMaterializer for crate::MtComplianceAuditMaterializer {
&& (observation.transaction_failed || !observation.observation_committed)
{
tracing::debug!(
target: crate::MT_COMPLIANCE_AUDIT_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT,
action = "materialize_compliance_audit",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -178,7 +178,7 @@ impl crate::MtApiEventMaterializer for crate::MtComplianceAuditMaterializer {
}),
};
tracing::debug!(
target: crate::MT_COMPLIANCE_AUDIT_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT,
action = "materialize_compliance_audit",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -225,7 +225,7 @@ fn materialize_compute_budget_profile(
}),
};
tracing::debug!(
target: crate::MT_COMPLIANCE_AUDIT_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT,
action = "materialize_compute_budget_profile",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),

View File

@@ -1,7 +1,8 @@
// file: kb-lib/src/materializer/compliance/constants.rs
// version: 1
// version: 2
//! Local constants for the native compliance audit materializer.
/// Canonical tracing target for this component.
pub(crate) const MT_COMPLIANCE_AUDIT_TRACING_TARGET: &str = "kb-lib.materializer.compliance";
pub(crate) const TRACING_TARGET_MATERIALIZER_COMPLIANCE_AUDIT: &str =
"kb-lib.materializer.compliance";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/lifecycle.rs
// version: 3
// version: 4
//! `lifecycle` materializer family.
@@ -10,4 +10,4 @@ mod core;
pub use self::core::MtLifecycleMaterializer;
/// Canonical tracing target for the native lifecycle materializer.
pub(crate) use self::constants::MT_LIFECYCLE_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_LIFECYCLE;

View File

@@ -1,7 +1,7 @@
// file: kb-lib/src/materializer/lifecycle/constants.rs
// version: 1
// version: 2
//! Local constants for the native lifecycle materializer.
/// Canonical tracing target for this component.
pub(crate) const MT_LIFECYCLE_TRACING_TARGET: &str = "kb-lib.materializer.lifecycle";
pub(crate) const TRACING_TARGET_MATERIALIZER_LIFECYCLE: &str = "kb-lib.materializer.lifecycle";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/lifecycle/core.rs
// version: 14
// version: 15
//! Stable lifecycle projections derived from exact decoded observations.
@@ -181,7 +181,7 @@ impl crate::MtApiEventMaterializer for crate::MtLifecycleMaterializer {
std::option::Option::Some(value) => value,
std::option::Option::None => {
tracing::debug!(
target: crate::MT_LIFECYCLE_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_LIFECYCLE,
action = "materialize_lifecycle",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -193,7 +193,7 @@ impl crate::MtApiEventMaterializer for crate::MtLifecycleMaterializer {
};
if observation.transaction_failed || !observation.observation_committed {
tracing::debug!(
target: crate::MT_LIFECYCLE_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_LIFECYCLE,
action = "materialize_lifecycle",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -225,7 +225,7 @@ impl crate::MtApiEventMaterializer for crate::MtLifecycleMaterializer {
let projection_details =
projection_details(projection, &accounts, &parameters, operation.as_str());
tracing::debug!(
target: crate::MT_LIFECYCLE_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_LIFECYCLE,
action = "materialize_lifecycle",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/risk.rs
// version: 2
// version: 3
//! `risk` materializer family.
@@ -14,4 +14,4 @@ pub(crate) use self::constants::MT_RISK_PROCESSOR_NAME;
/// Stable projection contract version for SPL Token and ATA risk facts.
pub(crate) use self::constants::MT_RISK_PROJECTION_VERSION;
/// Canonical tracing target for SPL Token and ATA risk facts.
pub(crate) use self::constants::MT_RISK_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_RISK;

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/risk/constants.rs
// version: 1
// version: 2
//! Local constants for fact-only risk projections.
@@ -8,4 +8,4 @@ pub(crate) const MT_RISK_PROCESSOR_NAME: &str = "spl_token_risk";
/// Stable projection payload contract version.
pub(crate) const MT_RISK_PROJECTION_VERSION: u32 = 2;
/// Canonical tracing target for this component.
pub(crate) const MT_RISK_TRACING_TARGET: &str = "kb-lib.materializer.risk";
pub(crate) const TRACING_TARGET_MATERIALIZER_RISK: &str = "kb-lib.materializer.risk";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/risk/core.rs
// version: 2
// version: 3
//! Stable fact-only risk projections for committed SPL Token and ATA observations.
@@ -157,7 +157,7 @@ impl crate::MtApiEventMaterializer for crate::MtRiskMaterializer {
}
}),
};
tracing::debug!(target: crate::MT_RISK_TRACING_TARGET, action = "materialize_token_risk_fact", risk_kind, operation, ata, "materialize committed SPL Token or ATA risk fact");
tracing::debug!(target: crate::TRACING_TARGET_MATERIALIZER_RISK, action = "materialize_token_risk_fact", risk_kind, operation, ata, "materialize committed SPL Token or ATA risk fact");
return crate::MtApiMaterializerExecutionResult {
status: crate::MtApiMaterializerOutcomeStatus::Inserted,
outputs: std::vec![output],

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/staking.rs
// version: 3
// version: 4
//! `staking` materializer family.
@@ -10,4 +10,4 @@ mod core;
pub use self::core::MtStakingMaterializer;
/// Canonical tracing target for the native stake and vote materializer.
pub(crate) use self::constants::MT_STAKING_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_STAKING;

View File

@@ -1,7 +1,7 @@
// file: kb-lib/src/materializer/staking/constants.rs
// version: 1
// version: 2
//! Local constants for the native stake and vote materializer.
/// Canonical tracing target for this component.
pub(crate) const MT_STAKING_TRACING_TARGET: &str = "kb-lib.materializer.staking";
pub(crate) const TRACING_TARGET_MATERIALIZER_STAKING: &str = "kb-lib.materializer.staking";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/staking/core.rs
// version: 7
// version: 8
//! Instruction-level staking projections for native Stake and Vote observations.
@@ -162,7 +162,7 @@ impl crate::MtApiEventMaterializer for crate::MtStakingMaterializer {
std::option::Option::Some(value) => value,
std::option::Option::None => {
tracing::debug!(
target: crate::MT_STAKING_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_STAKING,
action = "materialize_staking",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -177,7 +177,7 @@ impl crate::MtApiEventMaterializer for crate::MtStakingMaterializer {
}
if observation.transaction_failed || !observation.observation_committed {
tracing::debug!(
target: crate::MT_STAKING_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_STAKING,
action = "materialize_staking",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),
@@ -225,7 +225,7 @@ impl crate::MtApiEventMaterializer for crate::MtStakingMaterializer {
}),
};
tracing::debug!(
target: crate::MT_STAKING_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_STAKING,
action = "materialize_staking",
surface_code = %observation.event.surface_code.0.as_str(),
entry_code = %observation.event.event_name.0.as_str(),

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/token.rs
// version: 4
// version: 5
//! `token` materializer family.
@@ -19,4 +19,4 @@ pub(crate) use self::constants::MT_TOKEN_ACCOUNTS_PROCESSOR_NAME;
/// Stable projection contract version for Token, ATA and Token-2022 account projections.
pub(crate) use self::constants::MT_TOKEN_ACCOUNTS_PROJECTION_VERSION;
/// Canonical tracing target for Token, ATA and Token-2022 account projections.
pub(crate) use self::constants::MT_TOKEN_ACCOUNTS_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_TOKEN_ACCOUNTS;

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/token/accounts.rs
// version: 3
// version: 4
//! Stable committed SPL Token mutation and ATA lifecycle projections.
@@ -157,7 +157,7 @@ impl crate::MtApiEventMaterializer for crate::MtTokenAccountsMaterializer {
}),
};
tracing::debug!(
target: crate::MT_TOKEN_ACCOUNTS_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_TOKEN_ACCOUNTS,
action = "materialize_token_account_mutation",
signature = %observation.event.signature.0,
instruction_path = %observation.event.instruction_path.0,
@@ -285,7 +285,7 @@ fn materialize_ata(
}),
};
tracing::debug!(
target: crate::MT_TOKEN_ACCOUNTS_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_TOKEN_ACCOUNTS,
action = "materialize_ata_lifecycle",
signature = %observation.event.signature.0,
instruction_path = %observation.event.instruction_path.0,

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/token/constants.rs
// version: 1
// version: 2
//! Local constants for classic SPL Token account projections.
@@ -8,4 +8,4 @@ pub(crate) const MT_TOKEN_ACCOUNTS_PROCESSOR_NAME: &str = "spl_token_accounts";
/// Stable projection payload contract version.
pub(crate) const MT_TOKEN_ACCOUNTS_PROJECTION_VERSION: u32 = 3;
/// Canonical tracing target for this component.
pub(crate) const MT_TOKEN_ACCOUNTS_TRACING_TARGET: &str = "kb-lib.materializer.token";
pub(crate) const TRACING_TARGET_MATERIALIZER_TOKEN_ACCOUNTS: &str = "kb-lib.materializer.token";

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/transaction.rs
// version: 2
// version: 3
//! `transaction` materializer family.
@@ -16,4 +16,4 @@ pub(crate) use self::constants::MT_TRANSACTION_ANNOTATIONS_PROCESSOR_NAME;
/// Stable projection contract version for transaction annotations.
pub(crate) use self::constants::MT_TRANSACTION_ANNOTATIONS_PROJECTION_VERSION;
/// Canonical tracing target for transaction annotations.
pub(crate) use self::constants::MT_TRANSACTION_ANNOTATIONS_TRACING_TARGET;
pub(crate) use self::constants::TRACING_TARGET_MATERIALIZER_TRANSACTION_ANNOTATIONS;

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/transaction/annotations.rs
// version: 3
// version: 4
//! Exact committed SPL Memo transaction annotation projection.
@@ -179,7 +179,7 @@ impl crate::MtApiEventMaterializer for crate::MtTransactionAnnotationMaterialize
}),
};
tracing::debug!(
target: crate::MT_TRANSACTION_ANNOTATIONS_TRACING_TARGET,
target: crate::TRACING_TARGET_MATERIALIZER_TRANSACTION_ANNOTATIONS,
action = "materialize_transaction_annotation",
signature = %observation.event.signature.0,
instruction_path = %observation.event.instruction_path.0,

View File

@@ -1,5 +1,5 @@
// file: kb-lib/src/materializer/transaction/constants.rs
// version: 1
// version: 2
//! Local constants for the transaction annotation materializer.
@@ -10,5 +10,5 @@ pub(crate) const MT_TRANSACTION_ANNOTATIONS_PROCESSOR_NAME: &str = "transaction_
/// Stable projection contract version.
pub(crate) const MT_TRANSACTION_ANNOTATIONS_PROJECTION_VERSION: u32 = 1;
/// Canonical tracing target for this component.
pub(crate) const MT_TRANSACTION_ANNOTATIONS_TRACING_TARGET: &str =
pub(crate) const TRACING_TARGET_MATERIALIZER_TRANSACTION_ANNOTATIONS: &str =
"kb-lib.materializer.transaction";