feat: add new ChainPoint entity

That represents a point on the Cardano chain.

Author: jpraynaud

mithril-common/src/entities/block_range.rs

@@ -8,12 +8,10 @@ use std::{
 
 use crate::{
     crypto_helper::{MKMapKey, MKTreeNode},
+    entities::BlockNumber,
     StdResult,
 };
 
-/// BlockNumber is the block number of a Cardano transaction.
-pub type BlockNumber = u64;
-
 /// BlockRangeLength is the length of a block range.
 pub type BlockRangeLength = u64;
 

mithril-common/src/entities/cardano_chain_point.rs

@@ -0,0 +1,23 @@
+use serde::{Deserialize, Serialize};
+
+/// [Cardano Slot number](https://docs.cardano.org/learn/cardano-node/#slotsandepochs)
+pub type SlotNumber = u64;
+
+/// BlockNumber is the block number of a Cardano transaction.
+pub type BlockNumber = u64;
+
+/// Hash of a Cardano Block
+pub type BlockHash = String;
+
+///The Cardano chain point which is used to identify a specific point in the Cardano chain.
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct ChainPoint {
+    /// The slot number
+    pub slot_number: SlotNumber,
+
+    ///  The block number
+    pub block_number: BlockNumber,
+
+    /// The hex encoded block hash
+    pub block_hash: BlockHash,
+}

mithril-common/src/entities/cardano_transaction.rs

@@ -1,13 +1,10 @@
-use crate::crypto_helper::MKTreeNode;
-
-use super::{BlockNumber, ImmutableFileNumber};
+use crate::{
+    crypto_helper::MKTreeNode,
+    entities::{BlockHash, BlockNumber, ImmutableFileNumber, SlotNumber},
+};
 
 /// TransactionHash is the unique identifier of a cardano transaction.
 pub type TransactionHash = String;
-/// Hash of a Cardano Block
-pub type BlockHash = String;
-/// [Cardano Slot number](https://docs.cardano.org/learn/cardano-node/#slotsandepochs)
-pub type SlotNumber = u64;
 
 #[derive(Debug, PartialEq, Clone)]
 /// Cardano transaction representation

mithril-common/src/entities/mod.rs

@@ -1,6 +1,7 @@
 //! The entities used by, and exchanged between, the aggregator, signers and client.
 
 mod block_range;
+mod cardano_chain_point;
 mod cardano_db_beacon;
 mod cardano_network;
 mod cardano_transaction;
@@ -23,10 +24,11 @@ mod snapshot;
 mod time_point;
 mod type_alias;
 
-pub use block_range::{BlockNumber, BlockRange, BlockRangeLength};
+pub use block_range::{BlockRange, BlockRangeLength};
+pub use cardano_chain_point::{BlockHash, BlockNumber, ChainPoint, SlotNumber};
 pub use cardano_db_beacon::CardanoDbBeacon;
 pub use cardano_network::CardanoNetwork;
-pub use cardano_transaction::{BlockHash, CardanoTransaction, SlotNumber, TransactionHash};
+pub use cardano_transaction::{CardanoTransaction, TransactionHash};
 pub use cardano_transactions_set_proof::CardanoTransactionsSetProof;
 pub use cardano_transactions_snapshot::CardanoTransactionsSnapshot;
 pub use certificate::{Certificate, CertificateSignature};