Struct orao_fuel_vrf::Vrf

pub struct Vrf<T: Account> {
    pub abi: Vrf<T>,
    pub methods: VrfMethods<T>,
    /* private fields */
}

Fields

abi: Vrf<T>

methods: VrfMethods<T>

Implementations

impl<A: Account> Vrf<A>

pub fn new(contract_id: Bech32ContractId, wallet: A) -> Self

pub fn get_network_base_asset(&self) -> AssetId

Returns the base asset of the network.

It is a part of the network’s consensus config.

pub fn request(&self, seed: Bits256) -> ContractCallHandler<A, u64>

Performs the randomness request.

Client is able to pay fees with the base asset or with an additional asset, if it is configured and enabled. Transfer amount must be equal to the fee, configured for the asset being used.

// Let's try to pay with additional asset with fallback to the base asset
let network_base_asset = instance.get_network_base_asset();
let asset = instance.get_asset().await?;
let fee = instance.get_fee(asset).await?;

let (asset, fee) = if asset == network_base_asset {
    eprintln!("Additional asset is not configured. Paying with base asset");
    (asset, fee)
} else {
    if fee == 0 {
        eprintln!("Additional asset is disabled. Paying with base asset");
        // We need to load the base asset fee
        let fee = instance.get_fee(network_base_asset).await?;
        (network_base_asset, fee)
    } else {
        eprintln!("Paying with additional asset");
        (asset, fee)
    }
};

instance.request(Bits256([1_u8; 32]))
    .call_params(CallParameters::default().with_amount(fee).with_asset_id(asset))?
    .call()
    .await?;

pub async fn get_authority(&self) -> Result<Option<Identity>>

Returns the configured authority.

Note

None means that the contract instance is not yet configured.

pub async fn get_fee(&self, asset: AssetId) -> Result<u64>

Returns the configured fee for the given asset.

Use AssetId::BASE to get base asset fee.

pub async fn get_asset(&self) -> Result<AssetId>

Returns the additional asset to pay fee with.

Note that it returns the base asset if additional asset is not configured.

pub async fn get_fulfillment_authorities(&self) -> Result<Vec<Address>>

Returns configured fulfillment authorities.

pub async fn get_balance(&self, asset: AssetId) -> Result<u64>

Returns collected fees amount for the given asset.

pub async fn get_request_by_num(&self, num: u64) -> Result<Option<Randomness>>

Returns request by its number.

pub async fn get_request_by_seed( &self, seed: Bits256, ) -> Result<Option<Randomness>>

Returns request by its seed.

pub async fn get_num_requests(&self) -> Result<u64>

Returns the number of performed requests.

pub async fn get_status(&self) -> Result<Status>

Convenience method that returns on-chain VRF status.

Trait Implementations

impl<T: Debug + Account> Debug for Vrf<T>

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

Formats the value using the given formatter.