Struct Options 

pub struct Options {
    pub app_id: Option<u32>,
    pub mortality: Option<MortalityOption>,
    pub nonce: Option<u32>,
    pub tip: Option<u128>,
}

Lightweight builder for composing extrinsic signing options.

All fields default to None, deferring to runtime-derived values during Options::build.

Fields

app_id: Option<u32>

Application identifier recorded in the signature payload.

mortality: Option<MortalityOption>

Mortality configuration prior to refinement.

nonce: Option<u32>

Nonce override to use during signing.

tip: Option<u128>

Tip (in smallest units) to attach to the extrinsic.

Implementations

impl Options

pub fn new(app_id: u32) -> Self

Starts a builder with the provided application id.

Arguments

• app_id - Application identifier recorded in the signature payload.

Returns

Returns an Options builder seeded with the supplied application id.

pub fn app_id(self, value: u32) -> Self

Sets the application id recorded in the extrinsic.

Arguments

• value - Application identifier to embed in the extrinsic.

Returns

Returns the builder with the application id updated.

pub fn mortality(self, value: MortalityOption) -> Self

Sets the mortality configuration for the extrinsic.

Arguments

• value - Mortality option describing how long the extrinsic remains valid.

Returns

Returns the builder with the mortality updated.

pub fn nonce(self, value: u32) -> Self

Overrides the nonce to use when signing.

Arguments

• value - Nonce that should be used when constructing the payload.

Returns

Returns the builder with the nonce override applied.

pub fn tip(self, value: u128) -> Self

Overrides the tip to attach to the extrinsic.

Arguments

• value - Tip (in smallest units) applied to the extrinsic.

Returns

Returns the builder with the tip override applied.

pub async fn build( self, client: &Client, account_id: &AccountId, retry_on_error: Option<bool>, ) -> Result<RefinedOptions, Error>

Resolves all builder values into concrete options ready for signing.

Arguments

• client - Client used to fetch on-chain data when defaults are missing.
• account_id - Account whose nonce and mortality anchor are derived.
• retry_on_error - Optional override controlling retry behaviour for RPC calls.

Returns

• Ok(RefinedOptions) containing explicit nonce, tip, app id, and mortality details.
• Err(crate::Error) when fetching account information or finality data fails.

Errors

Returns Err(crate::Error) when RPC lookups required to refine options fail.

Behaviour

• Missing nonce triggers an RPC call to fetch the account’s next nonce.
• Missing mortality defaults to a 32-block period anchored at the latest finalized block.
• Missing app id and tip default to zero.

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Options

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

Formats the value using the given formatter.

impl Default for Options

fn default() -> Options

Returns the “default value” for a type.

impl Copy for Options