extract poh-config crate

Cargo.toml

@@ -142,6 +142,7 @@ members = [
     "sdk/package-metadata",
     "sdk/package-metadata-macro",
     "sdk/packet",
+    "sdk/poh-config",
     "sdk/precompile-error",
     "sdk/precompiles",
     "sdk/presigner",
@@ -508,6 +509,7 @@ solana-package-metadata-macro = { path = "sdk/package-metadata-macro", version =
 solana-packet = { path = "sdk/packet", version = "=2.2.0" }
 solana-perf = { path = "perf", version = "=2.2.0" }
 solana-poh = { path = "poh", version = "=2.2.0" }
+solana-poh-config = { path = "sdk/poh-config", version = "=2.2.0" }
 solana-poseidon = { path = "poseidon", version = "=2.2.0" }
 solana-precompile-error = { path = "sdk/precompile-error", version = "=2.2.0" }
 solana-precompiles = { path = "sdk/precompiles", version = "=2.2.0" }

sdk/Cargo.toml

@@ -72,6 +72,7 @@ frozen-abi = [
     "solana-account/frozen-abi",
     "solana-cluster-type/frozen-abi",
     "solana-inflation/frozen-abi",
+    "solana-poh-config/frozen-abi",
     "solana-program/frozen-abi",
     "solana-reward-info/frozen-abi",
     "solana-short-vec/frozen-abi",
@@ -143,6 +144,7 @@ solana-keypair = { workspace = true, optional = true, features = [
 ] }
 solana-native-token = { workspace = true }
 solana-packet = { workspace = true, features = ["bincode", "serde"] }
+solana-poh-config = { workspace = true, features = ["serde"] }
 solana-precompile-error = { workspace = true, optional = true }
 solana-precompiles = { workspace = true, optional = true }
 solana-presigner = { workspace = true, optional = true }

sdk/poh-config/Cargo.toml

@@ -0,0 +1,39 @@
+[package]
+name = "solana-poh-config"
+description = "Definitions of Solana's proof of history."
+documentation = "https://docs.rs/solana-poh-config"
+version = { workspace = true }
+authors = { workspace = true }
+repository = { workspace = true }
+homepage = { workspace = true }
+license = { workspace = true }
+edition = { workspace = true }
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+all-features = true
+rustdoc-args = ["--cfg=docsrs"]
+
+[dependencies]
+serde = { workspace = true, optional = true }
+serde_derive = { workspace = true, optional = true }
+solana-frozen-abi = { workspace = true, optional = true, features = [
+    "frozen-abi",
+] }
+solana-frozen-abi-macro = { workspace = true, optional = true, features = [
+    "frozen-abi",
+] }
+
+[dev-dependencies]
+solana-clock = { workspace = true }
+static_assertions = { workspace = true }
+
+[features]
+frozen-abi = [
+    "dep:solana-frozen-abi",
+    "dep:solana-frozen-abi-macro",
+]
+serde = ["dep:serde", "dep:serde_derive"]
+
+[lints]
+workspace = true

sdk/poh-config/src/lib.rs

@@ -0,0 +1,53 @@
+//! Definitions of Solana's proof of history.
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(feature = "frozen-abi", feature(min_specialization))]
+
+use std::time::Duration;
+
+// inlined to avoid solana-clock dep
+const DEFAULT_TICKS_PER_SECOND: u64 = 160;
+#[cfg(test)]
+static_assertions::const_assert_eq!(
+    DEFAULT_TICKS_PER_SECOND,
+    solana_clock::DEFAULT_TICKS_PER_SECOND
+);
+
+#[cfg_attr(feature = "frozen-abi", derive(solana_frozen_abi_macro::AbiExample))]
+#[cfg_attr(
+    feature = "serde",
+    derive(serde_derive::Deserialize, serde_derive::Serialize)
+)]
+#[derive(Clone, Debug, Eq, PartialEq)]
+pub struct PohConfig {
+    /// The target tick rate of the cluster.
+    pub target_tick_duration: Duration,
+
+    /// The target total tick count to be produced; used for testing only
+    pub target_tick_count: Option<u64>,
+
+    /// How many hashes to roll before emitting the next tick entry.
+    /// None enables "Low power mode", which makes the validator sleep
+    /// for `target_tick_duration` instead of hashing
+    pub hashes_per_tick: Option<u64>,
+}
+
+impl PohConfig {
+    pub fn new_sleep(target_tick_duration: Duration) -> Self {
+        Self {
+            target_tick_duration,
+            hashes_per_tick: None,
+            target_tick_count: None,
+        }
+    }
+}
+
+// the !=0 check was previously done by the unchecked_div_by_const macro
+#[cfg(test)]
+static_assertions::const_assert!(DEFAULT_TICKS_PER_SECOND != 0);
+const DEFAULT_SLEEP_MICROS: u64 = (1000 * 1000) / DEFAULT_TICKS_PER_SECOND;
+
+impl Default for PohConfig {
+    fn default() -> Self {
+        Self::new_sleep(Duration::from_micros(DEFAULT_SLEEP_MICROS))
+    }
+}

sdk/src/lib.rs

@@ -78,7 +78,6 @@ pub mod native_loader;
 pub mod net;
 pub mod nonce_account;
 pub mod offchain_message;
-pub mod poh_config;
 pub mod precompiles;
 pub mod program_utils;
 pub mod pubkey;
@@ -132,6 +131,8 @@ pub use solana_fee_structure as fee;
 pub use solana_inflation as inflation;
 #[deprecated(since = "2.1.0", note = "Use `solana-packet` crate instead")]
 pub use solana_packet as packet;
+#[deprecated(since = "2.2.0", note = "Use `solana-poh-config` crate instead")]
+pub use solana_poh_config as poh_config;
 #[deprecated(since = "2.1.0", note = "Use `solana-program-memory` crate instead")]
 pub use solana_program_memory as program_memory;
 #[deprecated(since = "2.1.0", note = "Use `solana_pubkey::pubkey` instead")]