miden-node-rpc 0.17.2

Miden node's front-end RPC server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use miden_node_proto::generated as proto;
use miden_node_tracing::{debug, error, miden_instrument};
use miden_protocol::block::{BlockNumber, SignedBlock};
use miden_protocol::vm::ExecutionProof;

use super::error_codes::internal_error;
use super::{RpcService, database_error_to_status};
use crate::{COMPONENT, LOG_TARGET};

#[tonic::async_trait]
impl proto::server::miden_node_v1_node_service::GetBlockByNumber for RpcService {
    type Input = proto::miden::node::v1::GetBlockByNumberRequest;
    type Output = proto::miden::node::v1::GetBlockByNumberResponse;

    fn decode(
        request: proto::miden::node::v1::GetBlockByNumberRequest,
    ) -> tonic::Result<Self::Input> {
        Ok(request)
    }

    fn encode(
        output: Self::Output,
    ) -> tonic::Result<proto::miden::node::v1::GetBlockByNumberResponse> {
        Ok(output)
    }

    #[miden_instrument(
        target = COMPONENT,
        name = "get_block_by_number",
        fields(
            block.number = request.block_num,
            request.include_proof = request.include_proof.unwrap_or_default(),
        ),
        err,
    )]
    async fn handle(
        &self,
        request: Self::Input,
        _metadata: &tonic::metadata::MetadataMap,
        _extensions: &tonic::codegen::http::Extensions,
    ) -> tonic::Result<Self::Output> {
        debug!(
            target: LOG_TARGET,
            "Getting block by number",
            block.number = request.block_num,
            request.include_proof = request.include_proof.unwrap_or_default()
        );

        let block_num = BlockNumber::from(request.block_num);
        let block = self
            .state
            .load_block(block_num)
            .await
            .map_err(|err| database_error_to_status(&err))?
            .map(|bytes| {
                miden_node_persistence::decode::<SignedBlock>(&bytes).map(Into::into).map_err(
                    |err| {
                        error!(
                            err,
                            target: LOG_TARGET,
                            "Failed to decode stored block",
                            block.number = block_num
                        );
                        internal_error(format!("Failed to decode stored block {block_num}."))
                    },
                )
            })
            .transpose()?;
        let proof = if request.include_proof.unwrap_or_default() {
            self.state
                .load_proof(block_num)
                .await
                .map_err(|err| database_error_to_status(&err))?
                .map(|bytes| {
                    ExecutionProof::read_from_bytes(&bytes)
                        .map(Into::into)
                        .map_err(|err| internal_error(format!("invalid stored proof: {err}")))
                })
                .transpose()?
        } else {
            None
        };

        Ok(proto::miden::node::v1::GetBlockByNumberResponse { block, proof })
    }
}