feat: initialize Kurdistan SDK - independent fork of Polkadot SDK

2025-12-13 15:44:15 +03:00
commit e4778b4576
6838 changed files with 1847450 additions and 0 deletions
@@ -0,0 +1,35 @@
+// Copyright (C) Parity Technologies (UK) Ltd.
+// This file is part of Pezkuwi.
+
+// Pezkuwi is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// Pezkuwi is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+
+// You should have received a copy of the GNU General Public License
+// along with Pezkuwi.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Runtime metric interface similar to native Prometheus metrics.
+//!
+//! This is intended to be used only for testing and debugging and **must never
+//! be used in production**. It requires the Substrate wasm tracing support
+//! and command line configuration: `--tracing-targets wasm_tracing=trace`.
+
+#![cfg_attr(not(feature = "std"), no_std)]
+
+extern crate alloc;
+
+#[cfg(feature = "runtime-metrics")]
+mod with_runtime_metrics;
+#[cfg(feature = "runtime-metrics")]
+pub use crate::with_runtime_metrics::*;
+
+#[cfg(not(feature = "runtime-metrics"))]
+mod without_runtime_metrics;
+#[cfg(not(feature = "runtime-metrics"))]
+pub use crate::without_runtime_metrics::*;
@@ -0,0 +1,146 @@
+// Copyright (C) Parity Technologies (UK) Ltd.
+// This file is part of Pezkuwi.
+
+// Pezkuwi is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// Pezkuwi is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+
+// You should have received a copy of the GNU General Public License
+// along with Pezkuwi.  If not, see <http://www.gnu.org/licenses/>.
+
+//! This module provides an implementation for the runtime metrics types: `Counter`,
+//! `CounterVec` and `Histogram`. These types expose a Prometheus like interface and
+//! same functionality. Each instance of a runtime metric is mapped to a Prometheus
+//! metric on the client side. The runtime metrics must be registered with the registry
+//! in the client, otherwise they will not be published.
+
+const TRACING_TARGET: &'static str = "metrics";
+
+use alloc::vec::Vec;
+use codec::Encode;
+use pezkuwi_primitives::{
+	metric_definitions::{CounterDefinition, CounterVecDefinition, HistogramDefinition},
+	RuntimeMetricLabelValues, RuntimeMetricOp, RuntimeMetricUpdate,
+};
+
+/// Holds a set of counters that have different values for their labels,
+/// like Prometheus `CounterVec`.
+pub struct CounterVec {
+	name: &'static str,
+}
+
+/// A counter metric.
+pub struct Counter {
+	name: &'static str,
+}
+
+pub struct Histogram {
+	name: &'static str,
+}
+
+/// Convenience trait implemented for all metric types.
+trait MetricEmitter {
+	fn emit(metric_op: &RuntimeMetricUpdate) {
+		sp_tracing::event!(
+			target: TRACING_TARGET,
+			sp_tracing::Level::TRACE,
+			update_op = bs58::encode(&metric_op.encode()).into_string().as_str()
+		);
+	}
+}
+
+///
+pub struct LabeledMetric {
+	name: &'static str,
+	label_values: RuntimeMetricLabelValues,
+}
+
+impl LabeledMetric {
+	/// Increment the counter by `value`.
+	pub fn inc_by(&self, value: u64) {
+		let metric_update = RuntimeMetricUpdate {
+			metric_name: Vec::from(self.name),
+			op: RuntimeMetricOp::IncrementCounterVec(value, self.label_values.clone()),
+		};
+
+		Self::emit(&metric_update);
+	}
+
+	/// Increment the counter value.
+	pub fn inc(&self) {
+		self.inc_by(1);
+	}
+}
+
+impl MetricEmitter for LabeledMetric {}
+impl MetricEmitter for Counter {}
+impl MetricEmitter for Histogram {}
+
+impl CounterVec {
+	/// Create a new counter as specified by `definition`. This metric needs to be registered
+	/// in the client before it can be used.
+	pub const fn new(definition: CounterVecDefinition) -> Self {
+		// No register op is emitted since the metric is supposed to be registered
+		// on the client by the time `inc()` is called.
+		CounterVec { name: definition.name }
+	}
+
+	/// Returns a `LabeledMetric` instance that provides an interface for incrementing
+	/// the metric.
+	pub fn with_label_values(&self, label_values: &[&'static str]) -> LabeledMetric {
+		LabeledMetric { name: self.name, label_values: label_values.into() }
+	}
+}
+
+impl Counter {
+	/// Create a new counter as specified by `definition`. This metric needs to be registered
+	/// in the client before it can be used.
+	pub const fn new(definition: CounterDefinition) -> Self {
+		Counter { name: definition.name }
+	}
+
+	/// Increment counter by `value`.
+	pub fn inc_by(&self, value: u64) {
+		let metric_update = RuntimeMetricUpdate {
+			metric_name: Vec::from(self.name),
+			op: RuntimeMetricOp::IncrementCounter(value),
+		};
+
+		Self::emit(&metric_update);
+	}
+
+	/// Increment counter.
+	pub fn inc(&self) {
+		self.inc_by(1);
+	}
+}
+
+impl Histogram {
+	/// Create a new histogram as specified by `definition`. This metric needs to be registered
+	/// in the client before it can be used.
+	pub const fn new(definition: HistogramDefinition) -> Self {
+		// No register op is emitted since the metric is supposed to be registered
+		// on the client by the time `inc()` is called.
+		Histogram { name: definition.name }
+	}
+
+	// Observe a value in the histogram
+	pub fn observe(&self, value: u128) {
+		let metric_update = RuntimeMetricUpdate {
+			metric_name: Vec::from(self.name),
+			op: RuntimeMetricOp::ObserveHistogram(value),
+		};
+		Self::emit(&metric_update);
+	}
+}
+
+/// Returns current time in ns
+pub fn get_current_time() -> u128 {
+	frame_benchmarking::current_time()
+}
@@ -0,0 +1,76 @@
+// Copyright (C) Parity Technologies (UK) Ltd.
+// This file is part of Pezkuwi.
+
+// Pezkuwi is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// Pezkuwi is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+
+// You should have received a copy of the GNU General Public License
+// along with Pezkuwi.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Runtime metrics are usable from the wasm runtime only. The purpose of this module is to
+//! provide a dummy implementation for the native runtime to avoid cluttering the runtime code
+//! with `#[cfg(feature = "runtime-metrics")]`.
+
+use pezkuwi_primitives::metric_definitions::{
+	CounterDefinition, CounterVecDefinition, HistogramDefinition,
+};
+
+/// A dummy `Counter`.
+pub struct Counter;
+/// A dummy `CounterVec`.
+pub struct CounterVec;
+
+/// A dummy `Histogram`
+pub struct Histogram;
+
+/// Dummy implementation.
+impl CounterVec {
+	/// Constructor.
+	pub const fn new(_definition: CounterVecDefinition) -> Self {
+		CounterVec
+	}
+	/// Sets label values, implementation is a `no op`.
+	pub fn with_label_values(&self, _label_values: &[&'static str]) -> &Self {
+		self
+	}
+	/// Increment counter by value, implementation is a `no op`.
+	pub fn inc_by(&self, _: u64) {}
+	/// Increment counter, implementation is a `no op`.
+	pub fn inc(&self) {}
+}
+
+/// Dummy implementation.
+impl Counter {
+	/// Constructor.
+	pub const fn new(_definition: CounterDefinition) -> Self {
+		Counter
+	}
+	/// Increment counter by value, implementation is a `no op`.
+	pub fn inc_by(&self, _: u64) {}
+	/// Increment counter, implementation is a `no op`.
+	pub fn inc(&self) {}
+}
+
+/// Dummy implementation
+impl Histogram {
+	/// Create a new histogram as specified by `definition`. This metric needs to be registered
+	/// in the client before it can be used.
+	pub const fn new(_definition: HistogramDefinition) -> Self {
+		Histogram
+	}
+
+	// Observe a value in the histogram
+	pub fn observe(&self, _value: u128) {}
+}
+
+/// Dummy implementation - always 0
+pub fn get_current_time() -> u128 {
+	0
+}