feat(sync): add StateSyncClient and SyncBlock

Cargo.toml

@@ -48,6 +48,7 @@ members = [
   "crates/starknet_sequencer_infra",
   "crates/starknet_sequencer_node",
   "crates/starknet_sierra_compile",
+  "crates/starknet_state_sync_types",
   "crates/starknet_task_executor",
   "workspace_tests",
 ]

crates/starknet_state_sync_types/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "starknet_state_sync_types"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[lints]
+workspace = true
+
+[dependencies]
+async-trait.workspace = true
+serde = { workspace = true, features = ["derive"] }
+starknet_api.workspace = true
+starknet_sequencer_infra.workspace = true
+thiserror.workspace = true

crates/starknet_state_sync_types/src/communication.rs

@@ -0,0 +1,28 @@
+use async_trait::async_trait;
+use starknet_api::block::BlockNumber;
+use starknet_sequencer_infra::component_client::ClientError;
+use thiserror::Error;
+
+use crate::errors::StateSyncError;
+use crate::state_sync_types::SyncBlock;
+
+#[async_trait]
+pub trait StateSyncClient: Send + Sync {
+    async fn get_block(
+        &self,
+        block_number: BlockNumber,
+    ) -> StateSyncClientResult<Option<SyncBlock>>;
+
+    // TODO: Add state reader methods for gateway.
+}
+
+#[derive(Clone, Debug, Error)]
+pub enum StateSyncClientError {
+    #[error(transparent)]
+    ClientError(#[from] ClientError),
+    #[error(transparent)]
+    StateSyncError(#[from] StateSyncError),
+}
+pub type StateSyncClientResult<T> = Result<T, StateSyncClientError>;
+
+// TODO: Add client types and request/response enums

crates/starknet_state_sync_types/src/errors.rs

@@ -0,0 +1,6 @@
+use serde::{Deserialize, Serialize};
+use thiserror::Error;
+
+// This error is defined even though it's empty to be compatible with the other components.
+#[derive(Debug, Error, Serialize, Deserialize, Clone)]
+pub enum StateSyncError {}

crates/starknet_state_sync_types/src/lib.rs

@@ -0,0 +1,3 @@
+pub mod communication;
+pub mod errors;
+pub mod state_sync_types;

crates/starknet_state_sync_types/src/state_sync_types.rs

@@ -0,0 +1,21 @@
+use std::collections::HashMap;
+
+use starknet_api::block::BlockHash;
+use starknet_api::core::ClassHash;
+use starknet_api::deprecated_contract_class::ContractClass as DeprecatedContractClass;
+use starknet_api::state::{ContractClass, ThinStateDiff};
+use starknet_api::transaction::TransactionHash;
+
+use crate::errors::StateSyncError;
+
+pub type StateSyncResult<T> = Result<T, StateSyncError>;
+
+pub struct SyncBlock {
+    pub block_hash: BlockHash,
+    pub parent_block_hash: BlockHash,
+    pub state_diff: ThinStateDiff,
+    pub classes: HashMap<ClassHash, ContractClass>,
+    // TODO: Consider removing deprecated classes.
+    pub deprecated_classes: HashMap<ClassHash, DeprecatedContractClass>,
+    pub transaction_hashes: Vec<TransactionHash>,
+}