Struct CallOptions 

pub struct CallOptions {
    pub satoshis: Option<i64>,
    pub change_address: Option<String>,
    pub new_state: Option<HashMap<String, SdkValue>>,
    pub outputs: Option<Vec<OutputSpec>>,
    pub additional_contract_inputs: Option<Vec<Utxo>>,
    pub additional_contract_input_args: Option<Vec<Vec<SdkValue>>>,
    pub change_pub_key: Option<String>,
    pub terminal_outputs: Option<Vec<TerminalOutput>>,
}

Options for calling a contract method.

Fields

satoshis: Option<i64>

Satoshis for the next output (stateful contracts).

change_address: Option<String>

new_state: Option<HashMap<String, SdkValue>>

New state values for the continuation output (stateful contracts).

outputs: Option<Vec<OutputSpec>>

Multiple continuation outputs for multi-output methods (e.g., transfer). When provided, replaces the single continuation output from new_state.

additional_contract_inputs: Option<Vec<Utxo>>

Additional contract UTXOs as inputs (e.g., merge, swap). Each input is signed with the same method and args as the primary call, with OP_PUSH_TX and Sig auto-computed per input.

additional_contract_input_args: Option<Vec<Vec<SdkValue>>>

Per-input args for additional contract inputs. When provided, additional_contract_input_args[i] overrides args for additional_contract_inputs[i]. Sig params (Auto) are still auto-computed.

change_pub_key: Option<String>

Override the public key used for the change output (hex-encoded). Defaults to the signer’s public key.

terminal_outputs: Option<Vec<TerminalOutput>>

Terminal outputs for methods that verify exact output structure via extractOutputHash(). When set, the transaction is built with ONLY the contract UTXO as input (no funding inputs, no change output). The fee comes from the contract balance. The contract is considered fully spent after this call (currentUtxo becomes None).

Trait Implementations

impl Clone for CallOptions

fn clone(&self) -> CallOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallOptions

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

Formats the value using the given formatter.

impl Default for CallOptions

fn default() -> CallOptions

Returns the “default value” for a type.