Enum Query 

pub enum Query {
    GetStoreQuote {
        key: NetworkAddress,
        data_type: u32,
        data_size: usize,
        nonce: Option<Nonce>,
        difficulty: usize,
    },
    GetReplicatedRecord {
        requester: NetworkAddress,
        key: NetworkAddress,
    },
    GetChunkExistenceProof {
        key: NetworkAddress,
        nonce: Nonce,
        difficulty: usize,
    },
    CheckNodeInProblem(NetworkAddress),
    GetClosestPeers {
        key: NetworkAddress,
        num_of_peers: Option<usize>,
        range: Option<[u8; 32]>,
        sign_result: bool,
    },
    GetVersion(NetworkAddress),
    PutRecord {
        holder: NetworkAddress,
        serialized_record: Vec<u8>,
        address: NetworkAddress,
    },
}

Data queries - retrieving data and inspecting their structure.

See the protocol module documentation for more details of the types supported by the Safe Network, and their semantics.

Variants

GetStoreQuote

Retrieve the quote to store a record at the given address. The storage verification is optional to be undertaken

Fields

key: NetworkAddress

The Address of the record to be stored.

data_type: u32

DataTypes as represented as its index

data_size: usize

Data size of the record

nonce: Option<Nonce>

The random nonce that nodes use to produce the Proof (i.e., hash(record+nonce)) Set to None if no need to carry out storage check.

difficulty: usize

Defines the expected number of answers to the challenge. Node shall try their best to fulfill the number, based on their capacity. Set to 0 to indicate not carry out any verification.

GetReplicatedRecord

Retrieve a specific record from a specific peer.

This should eventually lead to a GetReplicatedRecord response.

Fields

requester: NetworkAddress

Sender of the query

key: NetworkAddress

Key of the record to be fetched

GetChunkExistenceProof

Get the proof that the chunk with the given NetworkAddress exists with the requested node.

Fields

key: NetworkAddress

The Address of the chunk that we are trying to verify.

nonce: Nonce

The random nonce that the node uses to produce the Proof (i.e., hash(record+nonce))

difficulty: usize

Defines the expected number of answers to the challenge. For client publish verification, use 1 for efficiency. Node shall try their best to fulfill the number, based on their capacity.

CheckNodeInProblem(NetworkAddress)

Queries close_group peers whether the target peer is a bad_node

GetClosestPeers

Query the peers in range to the target address, from the receiver’s perspective. In case none of the parameters provided, returns nothing. In case both of the parameters provided, range is preferred to be replied.

Fields

key: NetworkAddress

num_of_peers: Option<usize>

range: Option<[u8; 32]>

sign_result: bool

GetVersion(NetworkAddress)

*** From now on, the order of variants shall be retained to be backward compatible Query peer’s cargo package version.

PutRecord

Write operation to upload a record.

Fields

holder: NetworkAddress

Holder of the record.

serialized_record: Vec<u8>

serialized record.

address: NetworkAddress

Address of the record.

Implementations

impl Query

pub fn dst(&self) -> NetworkAddress

Used to send a query to the close group of the address.

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Query

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Query

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Query

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Query

fn eq(&self, other: &Query) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Query

fn partial_cmp(&self, other: &Query) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Query

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Query

impl StructuralPartialEq for Query