Skip to main content

Crate punkgo_kernel

Crate punkgo_kernel 

Source
Expand description

PunkGo sovereignty engine — cryptographic audit trails for AI agent accountability.

This crate combines the full kernel stack:

  • audit — Merkle tree proofs and C2SP checkpoints (RFC 6962)
  • state — SQLite persistence: event log, energy ledger, actor store, envelopes
  • runtime — 7-step submit pipeline, energy production, actor lifecycle
  • testkit — test utilities (temp directories, request builders)

The kernel is a committer, not a judge — it provides a single linearization point for actions and ensures the 7 invariants defined in the whitepaper §3.

Re-exports§

pub use audit::AuditCheckpoint;
pub use audit::AuditError;
pub use audit::AuditLog;
pub use runtime::EnergyProducer;
pub use runtime::Kernel;
pub use runtime::KernelConfig;
pub use runtime::SubmitReceipt;
pub use state::ActorStore;
pub use state::BlobStore;
pub use state::EnergyLedger;
pub use state::EnergyReservation;
pub use state::EnvelopeStore;
pub use state::EventLog;
pub use state::EventRecord;
pub use state::NewHoldRequest;
pub use state::StatePaths;
pub use state::StateStore;

Modules§

audit
PunkGo cryptographic audit trail — Merkle tree proofs and checkpoints.
runtime
PunkGo kernel runtime — the 7-step submit pipeline and energy production.
state
PunkGo persistence layer — SQLite-backed state stores.
testkit
PunkGo test utilities — helpers for integration and unit tests.