Struct provwasm_std::ProvenanceQuerier

pub struct ProvenanceQuerier<'a> { /* fields omitted */ }

A type for simplifying provenance custom queries.

Implementations

impl<'a> ProvenanceQuerier<'a>

pub fn new(querier: &'a QuerierWrapper<'_>) -> Self

Creates a new provenance querier

pub fn resolve_name<S: Into<String>>(&self, name: S) -> StdResult<Name>

Resolve the address for a name.

Example

// Imports required
use cosmwasm_std::{Deps, QueryResponse, StdResult};
use provwasm_std::{Name, ProvenanceQuerier};

// Resolve the address for a name.
fn query_resolve_name(deps: Deps, name: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let name: Name = querier.resolve_name(&name)?;
    // Do something with name.address ...
    todo!()
}

pub fn lookup_names<H: Into<Addr>>(&self, address: H) -> StdResult<Names>

Lookup all names bound to the given address.

Example

// Imports required
use cosmwasm_std::{Addr, Deps, QueryResponse, StdResult};
use provwasm_std::{Names, ProvenanceQuerier};

// Lookup all names bound to an address.
fn query_lookup_names(deps: Deps, address: Addr) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let names: Names = querier.lookup_names(address)?;
    // Do something with names.records ...
    todo!()
}

pub fn get_attributes<H: Into<Addr>, S: Into<String>>(
    &self,
    address: H,
    name: Option<S>
) -> StdResult<Attributes>

Get attributes for an account. If the name parameter is None, all attributes are returned.

Example

// Imports required
use cosmwasm_std::{Addr, Deps, QueryResponse, StdResult};
use provwasm_std::{Attributes, ProvenanceQuerier};

// Query all attributes added to an account.
pub fn try_query_attributes(deps: Deps, address: Addr) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let none: Option<String> = None;
    let res: Attributes = querier.get_attributes(address, none)?;
    // Do something with res.attributes ...
    todo!()
}

pub fn get_json_attributes<H: Into<Addr>, S: Into<String>, T: DeserializeOwned>(
    &self,
    address: H,
    name: S
) -> StdResult<Vec<T>>

Get named JSON attributes from an account and deserialize the values. Attribute values with the same name must be able to be deserialized to the same type.

Example

// Imports required
use cosmwasm_std::{Addr, Deps, QueryResponse, StdResult};
use provwasm_std::ProvenanceQuerier;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

// Query all label attributes added to an account.
pub fn query_labels(deps: Deps, address: Addr) -> StdResult<QueryResponse> {
    let attr_name = String::from("label.my-contract.sc.pb");
    let querier = ProvenanceQuerier::new(&deps.querier);
    let labels: Vec<Label> = querier.get_json_attributes(address, &attr_name)?;
    // Do something with labels...
    todo!()
}

// Text with timestamp.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub struct Label {
    pub text: String,
    pub timestamp: u64,
}

pub fn get_marker_by_address<H: Into<Addr>>(
    &self,
    address: H
) -> StdResult<Marker>

Get a marker by address.

Example

// Imports required
use provwasm_std::{ProvenanceQuerier, Marker};
use cosmwasm_std::{Addr, Deps, QueryResponse, StdResult};

// Query a marker by address.
fn try_get_marker_by_address(deps: Deps, address: Addr) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let marker: Marker = querier.get_marker_by_address(address)?;
    // Do something with marker ...
    todo!()
}

pub fn get_marker_by_denom<S: Into<String>>(
    &self,
    denom: S
) -> StdResult<Marker>

Get a marker by denomination.

Example

// Imports required
use cosmwasm_std::{Deps, QueryResponse, StdResult};
use provwasm_std::{ProvenanceQuerier, Marker};

// Query a marker by denom.
fn try_get_marker_by_denom(deps: Deps, denom: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let marker: Marker = querier.get_marker_by_denom(&denom)?;
    // Do something with marker ...
    todo!()
}

pub fn get_scope<S: Into<String>>(&self, scope_id: S) -> StdResult<Scope>

Get a scope by metadata ID (bech32 address string).

Example

// Imports required
use provwasm_std::{ProvenanceQuerier, Scope};
use cosmwasm_std::{Deps, QueryResponse, StdResult};

// Query a scope by id.
fn try_get_scope(deps: Deps, scope_id: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let scope: Scope = querier.get_scope(scope_id)?;
    // Do something with scope ...
    todo!()
}

pub fn get_sessions<S: Into<String>>(&self, scope_id: S) -> StdResult<Sessions>

Get all scope sessions.

Example

// Imports required
use provwasm_std::{ProvenanceQuerier, Sessions};
use cosmwasm_std::{Deps, QueryResponse, StdResult};

// Query all sessions for a scope.
fn try_get_sessions(deps: Deps, scope_id: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let res: Sessions = querier.get_sessions(scope_id)?;
    // Do something with res.sessions ...
    todo!()
}

pub fn get_records<S: Into<String>>(&self, scope_id: S) -> StdResult<Records>

Get all scope records.

Example

// Imports required
use provwasm_std::{ProvenanceQuerier, Records};
use cosmwasm_std::{Deps, QueryResponse, StdResult};

// Query all records for a scope.
fn try_get_records(deps: Deps, scope_id: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let res: Records = querier.get_records(scope_id)?;
    // Do something with res.records ...
    todo!()
}

pub fn get_record_by_name<S: Into<String>, T: Into<String>>(
    &self,
    scope_id: S,
    name: T
) -> StdResult<Record>

Get a scope record with the given name.

Example

// Imports required
use provwasm_std::{ProvenanceQuerier, Record};
use cosmwasm_std::{Deps, QueryResponse, StdResult};

// Query a loan record for a scope.
fn try_get_loan_record(deps: Deps, scope_id: String) -> StdResult<QueryResponse> {
    let querier = ProvenanceQuerier::new(&deps.querier);
    let record: Record = querier.get_record_by_name(scope_id, "loan")?;
    // Do something with record ...
    todo!()
}