use super::*; use serde::{Deserialize, Serialize}; use strum::EnumString; use superstruct::superstruct; use types::{ Blob, EthSpec, ExecutionBlockHash, FixedVector, KzgCommitment, Transaction, Unsigned, VariableList, Withdrawal, }; use types::{ ExecutionPayload, ExecutionPayloadCapella, ExecutionPayloadEip4844, ExecutionPayloadMerge, }; #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonRequestBody<'a> { pub jsonrpc: &'a str, pub method: &'a str, pub params: serde_json::Value, pub id: serde_json::Value, } #[derive(Debug, PartialEq, Serialize, Deserialize)] pub struct JsonError { pub code: i64, pub message: String, } #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonResponseBody { pub jsonrpc: String, #[serde(default)] pub error: Option, #[serde(default)] pub result: serde_json::Value, pub id: serde_json::Value, } #[derive(Debug, PartialEq, Clone, Serialize, Deserialize)] #[serde(transparent)] pub struct TransparentJsonPayloadId(#[serde(with = "eth2_serde_utils::bytes_8_hex")] pub PayloadId); impl From for TransparentJsonPayloadId { fn from(id: PayloadId) -> Self { Self(id) } } impl From for PayloadId { fn from(wrapper: TransparentJsonPayloadId) -> Self { wrapper.0 } } /// On the request, use a transparent wrapper. pub type JsonPayloadIdRequest = TransparentJsonPayloadId; /// On the response, expect without the object wrapper (non-transparent). #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonPayloadIdResponse { #[serde(with = "eth2_serde_utils::bytes_8_hex")] pub payload_id: PayloadId, } #[superstruct( variants(V1, V2, V3), variant_attributes( derive(Debug, PartialEq, Default, Serialize, Deserialize,), serde(bound = "T: EthSpec", rename_all = "camelCase"), ), cast_error(ty = "Error", expr = "Error::IncorrectStateVariant"), partial_getter_error(ty = "Error", expr = "Error::IncorrectStateVariant") )] #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(bound = "T: EthSpec", rename_all = "camelCase", untagged)] pub struct JsonExecutionPayload { pub parent_hash: ExecutionBlockHash, pub fee_recipient: Address, pub state_root: Hash256, pub receipts_root: Hash256, #[serde(with = "serde_logs_bloom")] pub logs_bloom: FixedVector, pub prev_randao: Hash256, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub block_number: u64, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub gas_limit: u64, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub gas_used: u64, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub timestamp: u64, #[serde(with = "ssz_types::serde_utils::hex_var_list")] pub extra_data: VariableList, #[serde(with = "eth2_serde_utils::u256_hex_be")] pub base_fee_per_gas: Uint256, #[superstruct(only(V3))] #[serde(with = "eth2_serde_utils::u256_hex_be")] pub excess_data_gas: Uint256, pub block_hash: ExecutionBlockHash, #[serde(with = "ssz_types::serde_utils::list_of_hex_var_list")] pub transactions: VariableList, T::MaxTransactionsPerPayload>, #[superstruct(only(V2, V3))] pub withdrawals: VariableList, } impl From> for JsonExecutionPayloadV1 { fn from(payload: ExecutionPayloadMerge) -> Self { JsonExecutionPayloadV1 { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, block_hash: payload.block_hash, transactions: payload.transactions, } } } impl From> for JsonExecutionPayloadV2 { fn from(payload: ExecutionPayloadCapella) -> Self { JsonExecutionPayloadV2 { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, block_hash: payload.block_hash, transactions: payload.transactions, withdrawals: payload .withdrawals .into_iter() .map(Into::into) .collect::>() .into(), } } } impl From> for JsonExecutionPayloadV3 { fn from(payload: ExecutionPayloadEip4844) -> Self { JsonExecutionPayloadV3 { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, excess_data_gas: payload.excess_data_gas, block_hash: payload.block_hash, transactions: payload.transactions, withdrawals: payload .withdrawals .into_iter() .map(Into::into) .collect::>() .into(), } } } impl From> for JsonExecutionPayload { fn from(execution_payload: ExecutionPayload) -> Self { match execution_payload { ExecutionPayload::Merge(payload) => JsonExecutionPayload::V1(payload.into()), ExecutionPayload::Capella(payload) => JsonExecutionPayload::V2(payload.into()), ExecutionPayload::Eip4844(payload) => JsonExecutionPayload::V3(payload.into()), } } } impl From> for ExecutionPayloadMerge { fn from(payload: JsonExecutionPayloadV1) -> Self { ExecutionPayloadMerge { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, block_hash: payload.block_hash, transactions: payload.transactions, } } } impl From> for ExecutionPayloadCapella { fn from(payload: JsonExecutionPayloadV2) -> Self { ExecutionPayloadCapella { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, block_hash: payload.block_hash, transactions: payload.transactions, withdrawals: payload .withdrawals .into_iter() .map(Into::into) .collect::>() .into(), } } } impl From> for ExecutionPayloadEip4844 { fn from(payload: JsonExecutionPayloadV3) -> Self { ExecutionPayloadEip4844 { parent_hash: payload.parent_hash, fee_recipient: payload.fee_recipient, state_root: payload.state_root, receipts_root: payload.receipts_root, logs_bloom: payload.logs_bloom, prev_randao: payload.prev_randao, block_number: payload.block_number, gas_limit: payload.gas_limit, gas_used: payload.gas_used, timestamp: payload.timestamp, extra_data: payload.extra_data, base_fee_per_gas: payload.base_fee_per_gas, excess_data_gas: payload.excess_data_gas, block_hash: payload.block_hash, transactions: payload.transactions, withdrawals: payload .withdrawals .into_iter() .map(Into::into) .collect::>() .into(), } } } impl From> for ExecutionPayload { fn from(json_execution_payload: JsonExecutionPayload) -> Self { match json_execution_payload { JsonExecutionPayload::V1(payload) => ExecutionPayload::Merge(payload.into()), JsonExecutionPayload::V2(payload) => ExecutionPayload::Capella(payload.into()), JsonExecutionPayload::V3(payload) => ExecutionPayload::Eip4844(payload.into()), } } } #[superstruct( variants(V1, V2, V3), variant_attributes( derive(Debug, PartialEq, Serialize, Deserialize), serde(bound = "T: EthSpec", rename_all = "camelCase") ), cast_error(ty = "Error", expr = "Error::IncorrectStateVariant"), partial_getter_error(ty = "Error", expr = "Error::IncorrectStateVariant") )] #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(untagged)] pub struct JsonGetPayloadResponse { #[superstruct(only(V1), partial_getter(rename = "execution_payload_v1"))] pub execution_payload: JsonExecutionPayloadV1, #[superstruct(only(V2), partial_getter(rename = "execution_payload_v2"))] pub execution_payload: JsonExecutionPayloadV2, #[superstruct(only(V3), partial_getter(rename = "execution_payload_v3"))] pub execution_payload: JsonExecutionPayloadV3, #[serde(with = "eth2_serde_utils::u256_hex_be")] pub block_value: Uint256, } impl From> for GetPayloadResponse { fn from(json_get_payload_response: JsonGetPayloadResponse) -> Self { match json_get_payload_response { JsonGetPayloadResponse::V1(response) => { GetPayloadResponse::Merge(GetPayloadResponseMerge { execution_payload: response.execution_payload.into(), block_value: response.block_value, }) } JsonGetPayloadResponse::V2(response) => { GetPayloadResponse::Capella(GetPayloadResponseCapella { execution_payload: response.execution_payload.into(), block_value: response.block_value, }) } JsonGetPayloadResponse::V3(response) => { GetPayloadResponse::Eip4844(GetPayloadResponseEip4844 { execution_payload: response.execution_payload.into(), block_value: response.block_value, }) } } } } #[derive(Debug, PartialEq, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonWithdrawal { #[serde(with = "eth2_serde_utils::u64_hex_be")] pub index: u64, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub validator_index: u64, pub address: Address, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub amount: u64, } impl From for JsonWithdrawal { fn from(withdrawal: Withdrawal) -> Self { Self { index: withdrawal.index, validator_index: withdrawal.validator_index, address: withdrawal.address, amount: withdrawal.amount, } } } impl From for Withdrawal { fn from(jw: JsonWithdrawal) -> Self { Self { index: jw.index, validator_index: jw.validator_index, address: jw.address, amount: jw.amount, } } } #[superstruct( variants(V1, V2), variant_attributes( derive(Debug, Clone, PartialEq, Serialize, Deserialize), serde(rename_all = "camelCase") ), cast_error(ty = "Error", expr = "Error::IncorrectStateVariant"), partial_getter_error(ty = "Error", expr = "Error::IncorrectStateVariant") )] #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)] #[serde(untagged)] pub struct JsonPayloadAttributes { #[serde(with = "eth2_serde_utils::u64_hex_be")] pub timestamp: u64, pub prev_randao: Hash256, pub suggested_fee_recipient: Address, #[superstruct(only(V2))] pub withdrawals: Vec, } impl From for JsonPayloadAttributes { fn from(payload_atributes: PayloadAttributes) -> Self { match payload_atributes { PayloadAttributes::V1(pa) => Self::V1(JsonPayloadAttributesV1 { timestamp: pa.timestamp, prev_randao: pa.prev_randao, suggested_fee_recipient: pa.suggested_fee_recipient, }), PayloadAttributes::V2(pa) => Self::V2(JsonPayloadAttributesV2 { timestamp: pa.timestamp, prev_randao: pa.prev_randao, suggested_fee_recipient: pa.suggested_fee_recipient, withdrawals: pa.withdrawals.into_iter().map(Into::into).collect(), }), } } } impl From for PayloadAttributes { fn from(json_payload_attributes: JsonPayloadAttributes) -> Self { match json_payload_attributes { JsonPayloadAttributes::V1(jpa) => Self::V1(PayloadAttributesV1 { timestamp: jpa.timestamp, prev_randao: jpa.prev_randao, suggested_fee_recipient: jpa.suggested_fee_recipient, }), JsonPayloadAttributes::V2(jpa) => Self::V2(PayloadAttributesV2 { timestamp: jpa.timestamp, prev_randao: jpa.prev_randao, suggested_fee_recipient: jpa.suggested_fee_recipient, withdrawals: jpa.withdrawals.into_iter().map(Into::into).collect(), }), } } } #[derive(Debug, PartialEq, Serialize, Deserialize)] #[serde(bound = "T: EthSpec", rename_all = "camelCase")] pub struct JsonBlobBundles { pub block_hash: ExecutionBlockHash, pub kzgs: Vec, pub blobs: Vec>, } #[derive(Debug, PartialEq, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonForkchoiceStateV1 { pub head_block_hash: ExecutionBlockHash, pub safe_block_hash: ExecutionBlockHash, pub finalized_block_hash: ExecutionBlockHash, } impl From for JsonForkchoiceStateV1 { fn from(f: ForkchoiceState) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let ForkchoiceState { head_block_hash, safe_block_hash, finalized_block_hash, } = f; Self { head_block_hash, safe_block_hash, finalized_block_hash, } } } impl From for ForkchoiceState { fn from(j: JsonForkchoiceStateV1) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let JsonForkchoiceStateV1 { head_block_hash, safe_block_hash, finalized_block_hash, } = j; Self { head_block_hash, safe_block_hash, finalized_block_hash, } } } #[derive(Debug, Clone, Copy, PartialEq, Serialize, Deserialize, EnumString)] #[serde(rename_all = "SCREAMING_SNAKE_CASE")] #[strum(serialize_all = "SCREAMING_SNAKE_CASE")] pub enum JsonPayloadStatusV1Status { Valid, Invalid, Syncing, Accepted, InvalidBlockHash, } #[derive(Debug, PartialEq, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonPayloadStatusV1 { pub status: JsonPayloadStatusV1Status, pub latest_valid_hash: Option, pub validation_error: Option, } impl From for JsonPayloadStatusV1Status { fn from(e: PayloadStatusV1Status) -> Self { match e { PayloadStatusV1Status::Valid => JsonPayloadStatusV1Status::Valid, PayloadStatusV1Status::Invalid => JsonPayloadStatusV1Status::Invalid, PayloadStatusV1Status::Syncing => JsonPayloadStatusV1Status::Syncing, PayloadStatusV1Status::Accepted => JsonPayloadStatusV1Status::Accepted, PayloadStatusV1Status::InvalidBlockHash => JsonPayloadStatusV1Status::InvalidBlockHash, } } } impl From for PayloadStatusV1Status { fn from(j: JsonPayloadStatusV1Status) -> Self { match j { JsonPayloadStatusV1Status::Valid => PayloadStatusV1Status::Valid, JsonPayloadStatusV1Status::Invalid => PayloadStatusV1Status::Invalid, JsonPayloadStatusV1Status::Syncing => PayloadStatusV1Status::Syncing, JsonPayloadStatusV1Status::Accepted => PayloadStatusV1Status::Accepted, JsonPayloadStatusV1Status::InvalidBlockHash => PayloadStatusV1Status::InvalidBlockHash, } } } impl From for JsonPayloadStatusV1 { fn from(p: PayloadStatusV1) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let PayloadStatusV1 { status, latest_valid_hash, validation_error, } = p; Self { status: status.into(), latest_valid_hash, validation_error, } } } impl From for PayloadStatusV1 { fn from(j: JsonPayloadStatusV1) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let JsonPayloadStatusV1 { status, latest_valid_hash, validation_error, } = j; Self { status: status.into(), latest_valid_hash, validation_error, } } } #[derive(Debug, PartialEq, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct JsonForkchoiceUpdatedV1Response { pub payload_status: JsonPayloadStatusV1, pub payload_id: Option, } impl From for ForkchoiceUpdatedResponse { fn from(j: JsonForkchoiceUpdatedV1Response) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let JsonForkchoiceUpdatedV1Response { payload_status: status, payload_id, } = j; Self { payload_status: status.into(), payload_id: payload_id.map(Into::into), } } } impl From for JsonForkchoiceUpdatedV1Response { fn from(f: ForkchoiceUpdatedResponse) -> Self { // Use this verbose deconstruction pattern to ensure no field is left unused. let ForkchoiceUpdatedResponse { payload_status: status, payload_id, } = f; Self { payload_status: status.into(), payload_id: payload_id.map(Into::into), } } } #[derive(Clone, Copy, Debug, PartialEq, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct TransitionConfigurationV1 { #[serde(with = "eth2_serde_utils::u256_hex_be")] pub terminal_total_difficulty: Uint256, pub terminal_block_hash: ExecutionBlockHash, #[serde(with = "eth2_serde_utils::u64_hex_be")] pub terminal_block_number: u64, } /// Serializes the `logs_bloom` field of an `ExecutionPayload`. pub mod serde_logs_bloom { use super::*; use eth2_serde_utils::hex::PrefixedHexVisitor; use serde::{Deserializer, Serializer}; pub fn serialize(bytes: &FixedVector, serializer: S) -> Result where S: Serializer, U: Unsigned, { let mut hex_string: String = "0x".to_string(); hex_string.push_str(&hex::encode(&bytes[..])); serializer.serialize_str(&hex_string) } pub fn deserialize<'de, D, U>(deserializer: D) -> Result, D::Error> where D: Deserializer<'de>, U: Unsigned, { let vec = deserializer.deserialize_string(PrefixedHexVisitor)?; FixedVector::new(vec) .map_err(|e| serde::de::Error::custom(format!("invalid logs bloom: {:?}", e))) } }