Struct orao_solana_vrf::FulfillBuilder

pub struct FulfillBuilder { /* private fields */ }

Available on crate feature sdk only.

crate::Fulfill/crate::FulfillV2 instruction builder.

Note:

• prioritization fees here are handled automatically based on the recent prioritization fees — use FulfillBuilder::with_compute_unit_price to opt-out.
• this builder is added for convenience — use FulfillBuilder::into_raw_instruction to get the raw instruction, or build it yourself (see the FulfillBuilder::into_raw_instruction source)

Notes on account version:

This builder will analyze the randomness account version to properly choose the correct fulfill instruction, i.e. instruction::Fulfill will be called for [Randomness], and instruction::FulfillV2 will be called for [RandomnessV2]

Implementations

impl FulfillBuilder

pub fn new(seed: [u8; 32]) -> Self

Creates a new builder for the given seed.

pub fn with_compute_unit_price(self, compute_unit_price: u64) -> Self

Defines a prioritization fee in micro-lamports (applied per compute unit).

Adds ComputeBudgetInstruction::SetComputeUnitPrice to the request builder.

• if not specified, then median fee of the last 150 confirmed slots is used (this is by default)
• if zero, then compute unit price is not applied at all.

pub fn with_compute_unit_price_multiplier(self, multiplier: f64) -> Self

Defines a multiplier that is applied to a median compute unit price.

This is only applied if no compute_unit_price specified, i.e. if compute unit price is measured as a median fee of the last 150 confirmed slots.

• if not specified, then no multiplier is applied (this is by default)
• if specified, then applied as follows: compute_unit_price = median * multiplier

pub fn with_compute_unit_limit(self, compute_unit_limit: u32) -> Self

Defines a specific compute unit limit that the transaction is allowed to consume.

Adds ComputeBudgetInstruction::SetComputeUnitLimit to the request builder.

• if not specified, then compute unit limit is not applied at all (this is by default)
• if specified, then applied as is

pub fn into_raw_instruction( self, id: Pubkey, payer: Pubkey, client: Pubkey, version: RandomnessAccountVersion, fulfill_authority: &Keypair, ) -> [Instruction; 2]

Builds the raw crate::Fulfill or crate::FulfillV2 instruction based on this builder.

This is a low-level function, consider using FulfillBuilder::build.

• id — the VRF program id (usually the crate::id)
• payer — transaction fee payer that will sign the tx.
• fulfill_authority — is the authorized fulfill authority present in the effective configuration (see crate::get_network_state). ed25519_dalek::Keypair is required because it is required by the ed25519_instruction::new_ed25519_instruction.

Note that this function returns a pair of instructions and the order matters — in the transaction the first instruction (the ed25519 instruction) must go right before the second instruction (the Fulfill instruction). It is also possible to put multiple fulfills into the same tx — instructions must go in the following order:

1. ed25519_1
2. Fulfill_1
3. ed25519_2
4. Fulfill_2
5. …

Also note that you must give the proper RandomnessAccountVersion (see RandomnessAccountVersion::resolve).

Compute Budget Program configuration is ignored.

pub async fn build<'a, C: Deref<Target = impl Signer> + Clone>( self, orao_vrf: &'a Program<C>, fulfill_authority: &Keypair, ) -> Result<RequestBuilder<'a, C>, ClientError>

Builds the request.

Note that this function returns an anchor_client::RequestBuilder instance, so feel free to put more instructions into the request.

Trait Implementations

impl Debug for FulfillBuilder

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

Formats the value using the given formatter.

impl Default for FulfillBuilder

fn default() -> FulfillBuilder

Returns the “default value” for a type.