fabric-sdk 0.5.1

Interact and program chaincode for the Hyperledger Fabric blockchain network
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

use prost::{DecodeError, Message};

use crate::{
    error::SubmitError,
    fabric::{
        common::{Envelope, Payload},
        gateway::{CommitStatusResponse, SubmitRequest},
    },
    implement::crypto::{generate_nonce, generate_transaction_id},
};

impl Envelope {
    /// Submits the envelope to the network. This will update the ledger and fill the signature of the envelope.
    pub async fn submit(
        &mut self,
        client: &crate::gateway::client::Client,
    ) -> Result<&mut Self, SubmitError> {
        if client.tonic_connection.channel.is_none() {
            return Err(SubmitError::NotConnected);
        }
        //Generate random bytes for transaction id and signature header
        let nonce = generate_nonce();

        self.signature = client.identity.sign_message(&self.payload);

        //Create transaction id
        let transaction_id = generate_transaction_id(
            &nonce,
            client
                .identity
                .get_certificate_bytes()
                .encode_to_vec()
                .as_slice(),
        );

        let submit_request = SubmitRequest {
            transaction_id: transaction_id.clone(),
            channel_id: self
                .get_payload()
                .map_err(|_| SubmitError::DecodeError("Invalid payload"))?
                .get_header()
                .expect("Expected header in payload")
                .get_channel_header()
                .map_err(|_| SubmitError::DecodeError("Invalid header"))?
                .channel_id
                .to_string(),
            prepared_transaction: Some(self.clone()),
        };

        let mut gateway_client = client.create_gateway();

        match gateway_client.submit(submit_request).await {
            Ok(_) => Ok(self),
            Err(err) => Err(SubmitError::NodeError(
                crate::implement::grpc_error::format_grpc_error(&err),
            )),
        }
    }

    /// Waits for commit and returns the commit status
    ///
    /// This method will run until the commit will occur if it hasn’t already committed. So only run this immidentialy after [`submit`](submit).
    pub async fn wait_for_commit(
        &self,
        client: &crate::gateway::client::Client,
    ) -> Result<CommitStatusResponse, SubmitError> {
        let header = self
            .get_payload()
            .map_err(|_| SubmitError::DecodeError("Invalid payload"))?
            .get_header()
            .expect("No header in payload")
            .get_channel_header()
            .map_err(|_| SubmitError::DecodeError("Invalid Channel header in payload header"))?;
        client.commit_status(header.tx_id, header.channel_id).await
    }

    /// Decodes the payload from the envelope
    pub fn get_payload(&self) -> Result<Payload, DecodeError> {
        Payload::decode(self.payload.as_slice())
    }
}