Struct Query

pub struct Query<'a, T> { /* private fields */ }

Query object allows creating queries into the network of our choice. This object is usually given from making calls from other functions such as view_state.

Implementations

impl<'a, T> Query<'a, T>

pub fn block_height(self, height: BlockHeight) -> Self

Specify at which block height to query from. Note that only archival networks will have the full history while networks like mainnet or testnet will only have the history from 5 or less epochs ago.

pub fn block_hash(self, hash: CryptoHash) -> Self

Specify at which block hash to query from. Note that only archival networks will have the full history while networks like mainnet or testnet will only have the history from 5 or less epochs ago.

impl<'a, T> Query<'a, T>

where T: ProcessQuery<Method = RpcQueryRequest>,

pub fn finality(self, value: Finality) -> Self

Specify at which block Finality to query from.

impl Query<'_, ViewFunction>

pub fn args(self, args: Vec<u8>) -> Self

Provide the arguments for the call. These args are serialized bytes from either a JSON or Borsh serializable set of arguments. To use the more specific versions with better quality of life, use args_json or args_borsh.

pub fn args_json<U: Serialize>(self, args: U) -> Self

Similar to args, specify an argument that is JSON serializable and can be accepted by the equivalent contract. Recommend to use something like serde_json::json! macro to easily serialize the arguments.

pub fn args_borsh<U: BorshSerialize>(self, args: U) -> Self

Similar to args, specify an argument that is borsh serializable and can be accepted by the equivalent contract.

impl<'a> Query<'a, ViewState>

pub fn prefix(self, value: &[u8]) -> Self

Set the prefix for viewing the state.

Trait Implementations

impl<'a, T, R> IntoFuture for Query<'a, T>

where T: ProcessQuery<Output = R> + Send + Sync + 'static, <T as ProcessQuery>::Method: RpcMethod + Debug + Send + Sync, <<T as ProcessQuery>::Method as RpcMethod>::Response: Debug + Send + Sync, <<T as ProcessQuery>::Method as RpcMethod>::Error: Debug + Display + Send + Sync,

type Output = Result<R, Error>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <Query<'a, T> as IntoFuture>::Output> + Send + 'a>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.