celestia-types 1.0.0

Core types, traits and constants for working with the Celestia ecosystem
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
87
88
89
90

use celestia_proto::cosmos::base::tendermint::v1beta1::{
    AbciQueryResponse as RawAbciQueryResponse, ProofOps,
};
use serde::{Deserialize, Serialize};
#[cfg(all(target_arch = "wasm32", feature = "wasm-bindgen"))]
use wasm_bindgen::prelude::*;

use crate::state::ErrorCode;
use crate::{Error, Height, validation_error};

/// Response to a tx query
#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "uniffi", derive(uniffi::Record))]
#[cfg_attr(
    all(target_arch = "wasm32", feature = "wasm-bindgen"),
    wasm_bindgen(getter_with_clone)
)]
pub struct AbciQueryResponse {
    /// The block height from which data was derived.
    ///
    /// Note that this is the height of the block containing the application's Merkle root hash,
    /// which represents the state as it was after committing the block at height - 1.
    #[cfg_attr(
        all(target_arch = "wasm32", feature = "wasm-bindgen"),
        wasm_bindgen(skip)
    )]
    pub height: Height,

    /// Response code.
    pub code: ErrorCode,

    /// Namespace for the Code.
    pub codespace: String,

    /// The index of the key in the tree.
    pub index: u64,

    /// The key of the matching data.
    pub key: Vec<u8>,

    /// The value of the matching data.
    pub value: Vec<u8>,

    /// Serialized proof for the value data, if requested,
    /// to be verified against the [`AppHash`] for the given [`Height`].
    ///
    /// [`AppHash`]: tendermint::hash::AppHash
    pub proof_ops: Option<ProofOps>,

    /// The output of the application's logger (raw string). May be
    /// non-deterministic.
    pub log: String,

    /// Additional information. May be non-deterministic.
    pub info: String,
}

#[cfg(all(target_arch = "wasm32", feature = "wasm-bindgen"))]
#[wasm_bindgen]
impl AbciQueryResponse {
    /// The block height from which data was derived.
    ///
    /// Note that this is the height of the block containing the application's Merkle root hash,
    /// which represents the state as it was after committing the block at height - 1.
    #[wasm_bindgen(getter)]
    pub fn height(&self) -> u64 {
        self.height.value()
    }
}

impl TryFrom<RawAbciQueryResponse> for AbciQueryResponse {
    type Error = Error;

    fn try_from(response: RawAbciQueryResponse) -> Result<AbciQueryResponse, Self::Error> {
        Ok(AbciQueryResponse {
            height: response.height.try_into()?,
            code: response.code.try_into()?,
            codespace: response.codespace,
            index: response
                .index
                .try_into()
                .map_err(|_| validation_error!("Negative index"))?,
            key: response.key,
            value: response.value,
            proof_ops: response.proof_ops,
            log: response.log,
            info: response.info,
        })
    }
}