Skip to content

Commit

Permalink
feat(network): add macro for impl TryFrom<Vec<u8>> and Into<Vec<u8>> …
Browse files Browse the repository at this point in the history
…and use it in query
  • Loading branch information
ShahakShama committed May 27, 2024
1 parent 76dec5d commit b250c85
Show file tree
Hide file tree
Showing 5 changed files with 123 additions and 22 deletions.
40 changes: 30 additions & 10 deletions crates/papyrus_protobuf/src/converters/header.rs
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
#[path = "header_test.rs"]
mod header_test;

use prost::Message;
use starknet_api::block::{
BlockHash,
BlockHeader,
Expand All @@ -21,8 +22,8 @@ use starknet_api::crypto::Signature;

use super::common::{enum_int_to_l1_data_availability_mode, l1_data_availability_mode_to_enum_int};
use super::ProtobufConversionError;
use crate::protobuf;
use crate::sync::{Query, SignedBlockHeader};
use crate::sync::{HeaderQuery, Query, SignedBlockHeader};
use crate::{auto_impl_into_and_try_from_vec_u8, protobuf};

impl TryFrom<protobuf::BlockHeadersResponse> for Option<SignedBlockHeader> {
type Error = ProtobufConversionError;
Expand Down Expand Up @@ -83,7 +84,7 @@ impl TryFrom<protobuf::SignedBlockHeader> for SignedBlockHeader {
let transaction_commitment = value
.transactions
.map(|transactions| {
Ok(TransactionCommitment(
Ok::<_, ProtobufConversionError>(TransactionCommitment(
transactions
.root
.ok_or(ProtobufConversionError::MissingField {
Expand All @@ -102,7 +103,7 @@ impl TryFrom<protobuf::SignedBlockHeader> for SignedBlockHeader {
let event_commitment = value
.events
.map(|events| {
Ok(EventCommitment(
Ok::<_, ProtobufConversionError>(EventCommitment(
events
.root
.ok_or(ProtobufConversionError::MissingField {
Expand Down Expand Up @@ -286,20 +287,39 @@ impl From<Option<SignedBlockHeader>> for protobuf::BlockHeadersResponse {
}
}

// TODO(shahak): Erase this once network stops using it.
impl TryFrom<protobuf::BlockHeadersRequest> for Query {
type Error = ProtobufConversionError;
fn try_from(value: protobuf::BlockHeadersRequest) -> Result<Self, Self::Error> {
value
.iteration
.ok_or(ProtobufConversionError::MissingField {
field_description: "BlockHeadersRequest::iteration",
})?
.try_into()
Ok(HeaderQuery::try_from(value)?.0)
}
}

impl TryFrom<protobuf::BlockHeadersRequest> for HeaderQuery {
type Error = ProtobufConversionError;
fn try_from(value: protobuf::BlockHeadersRequest) -> Result<Self, Self::Error> {
Ok(HeaderQuery(
value
.iteration
.ok_or(ProtobufConversionError::MissingField {
field_description: "BlockHeadersRequest::iteration",
})?
.try_into()?,
))
}
}

// TODO(shahak): Erase this once network stops using it.
impl From<Query> for protobuf::BlockHeadersRequest {
fn from(value: Query) -> Self {
protobuf::BlockHeadersRequest { iteration: Some(value.into()) }
}
}

impl From<HeaderQuery> for protobuf::BlockHeadersRequest {
fn from(value: HeaderQuery) -> Self {
protobuf::BlockHeadersRequest { iteration: Some(value.0.into()) }
}
}

auto_impl_into_and_try_from_vec_u8!(HeaderQuery, protobuf::BlockHeadersRequest);
18 changes: 16 additions & 2 deletions crates/papyrus_protobuf/src/converters/header_test.rs
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
use starknet_api::block::BlockHeader;
use starknet_api::block::{BlockHeader, BlockNumber};

use crate::protobuf;
use crate::sync::SignedBlockHeader;
use crate::sync::{BlockHashOrNumber, Direction, HeaderQuery, Query, SignedBlockHeader};

#[test]
fn block_header_to_protobuf_and_back() {
Expand All @@ -25,3 +25,17 @@ fn fin_to_protobuf_and_back() {
let res_data = Option::<SignedBlockHeader>::try_from(proto_data).unwrap();
assert!(res_data.is_none());
}

#[test]
fn header_query_to_bytes_and_back() {
let query = HeaderQuery(Query {
start_block: BlockHashOrNumber::Number(BlockNumber(0)),
direction: Direction::Forward,
limit: 1,
step: 1,
});

let bytes = Vec::<u8>::from(query.clone());
let res_query = HeaderQuery::try_from(bytes).unwrap();
assert_eq!(query, res_query);
}
31 changes: 31 additions & 0 deletions crates/papyrus_protobuf/src/converters/mod.rs
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ mod receipt;
pub mod state_diff;
mod transaction;

use prost::DecodeError;

#[derive(thiserror::Error, Debug)]
pub enum ProtobufConversionError {
#[error("Type `{type_description}` got out of range value {value_as_str}")]
Expand All @@ -14,4 +16,33 @@ pub enum ProtobufConversionError {
MissingField { field_description: &'static str },
#[error("Type `{type_description}` should be {num_expected} bytes but it got {value:?}.")]
BytesDataLengthMismatch { type_description: &'static str, num_expected: usize, value: Vec<u8> },
#[error(transparent)]
DecodeError(#[from] DecodeError),
}

#[macro_export]
macro_rules! auto_impl_into_and_try_from_vec_u8 {
($T:ty, $ProtobufT:ty) => {
impl From<$T> for Vec<u8> {
fn from(value: $T) -> Self {
let protobuf_value = <$ProtobufT>::from(value);
protobuf_value.encode_to_vec()
}
}
$crate::auto_impl_try_from_vec_u8!($T, $ProtobufT);
};
}

// TODO(shahak): Remove this macro once all types implement both directions.
#[macro_export]
macro_rules! auto_impl_try_from_vec_u8 {
($T:ty, $ProtobufT:ty) => {
impl TryFrom<Vec<u8>> for $T {
type Error = ProtobufConversionError;
fn try_from(value: Vec<u8>) -> Result<Self, Self::Error> {
let protobuf_value = <$ProtobufT>::decode(&value[..])?;
<$T>::try_from(protobuf_value)
}
}
};
}
50 changes: 40 additions & 10 deletions crates/papyrus_protobuf/src/converters/state_diff.rs
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
use indexmap::IndexMap;
use prost::Message;
use starknet_api::core::{ClassHash, CompiledClassHash, Nonce};
use starknet_api::data_availability::DataAvailabilityMode;
use starknet_api::hash::StarkFelt;
use starknet_api::state::{StorageKey, ThinStateDiff};

use super::ProtobufConversionError;
use crate::protobuf;
use crate::sync::Query;
use crate::sync::{Query, StateDiffQuery};
use crate::{auto_impl_into_and_try_from_vec_u8, protobuf};

pub const DOMAIN: DataAvailabilityMode = DataAvailabilityMode::L1;

Expand Down Expand Up @@ -40,7 +41,12 @@ impl TryFrom<protobuf::ContractDiff> for ThinStateDiff {

let deployed_contracts = value
.class_hash
.map(|hash| Ok(IndexMap::from_iter([(contract_address, ClassHash(hash.try_into()?))])))
.map(|hash| {
Ok::<_, ProtobufConversionError>(IndexMap::from_iter([(
contract_address,
ClassHash(hash.try_into()?),
)]))
})
.transpose()?
.unwrap_or_default();

Expand All @@ -57,7 +63,12 @@ impl TryFrom<protobuf::ContractDiff> for ThinStateDiff {

let nonces = value
.nonce
.map(|nonce| Ok(IndexMap::from_iter([(contract_address, Nonce(nonce.try_into()?))])))
.map(|nonce| {
Ok::<_, ProtobufConversionError>(IndexMap::from_iter([(
contract_address,
Nonce(nonce.try_into()?),
)]))
})
.transpose()?
.unwrap_or_default();

Expand Down Expand Up @@ -132,20 +143,39 @@ impl TryFrom<protobuf::ContractStoredValue> for (StorageKey, StarkFelt) {
}
}

// TODO(shahak): Erase this once network stops using it.
impl TryFrom<protobuf::StateDiffsRequest> for Query {
type Error = ProtobufConversionError;
fn try_from(value: protobuf::StateDiffsRequest) -> Result<Self, Self::Error> {
value
.iteration
.ok_or(ProtobufConversionError::MissingField {
field_description: "StateDiffsRequest::iteration",
})?
.try_into()
Ok(StateDiffQuery::try_from(value)?.0)
}
}

impl TryFrom<protobuf::StateDiffsRequest> for StateDiffQuery {
type Error = ProtobufConversionError;
fn try_from(value: protobuf::StateDiffsRequest) -> Result<Self, Self::Error> {
Ok(StateDiffQuery(
value
.iteration
.ok_or(ProtobufConversionError::MissingField {
field_description: "StateDiffsRequest::iteration",
})?
.try_into()?,
))
}
}

// TODO(shahak): Erase this once network stops using it.
impl From<Query> for protobuf::StateDiffsRequest {
fn from(value: Query) -> Self {
protobuf::StateDiffsRequest { iteration: Some(value.into()) }
}
}

impl From<StateDiffQuery> for protobuf::StateDiffsRequest {
fn from(value: StateDiffQuery) -> Self {
protobuf::StateDiffsRequest { iteration: Some(value.0.into()) }
}
}

auto_impl_into_and_try_from_vec_u8!(StateDiffQuery, protobuf::StateDiffsRequest);
6 changes: 6 additions & 0 deletions crates/papyrus_protobuf/src/sync.rs
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,12 @@ impl Default for BlockHashOrNumber {
}
}

#[derive(Default, Clone, Debug, PartialEq, Eq, Hash)]
pub struct HeaderQuery(pub Query);

#[derive(Default, Clone, Debug, PartialEq, Eq, Hash)]
pub struct StateDiffQuery(pub Query);

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct SignedBlockHeader {
pub block_header: BlockHeader,
Expand Down

0 comments on commit b250c85

Please sign in to comment.