Struct StoffelRuntime 

pub struct StoffelRuntime { /* private fields */ }

Implementations

impl StoffelRuntime

pub fn program(&self) -> &Program

pub fn to_bytecode(&self) -> Result<Vec<u8>>

Serialize the compiled program as CLI-compatible Stoffel bytecode.

pub fn save_bytecode(&self, path: impl AsRef<Path>) -> Result<()>

Save the compiled program as CLI-compatible Stoffel bytecode.

pub fn bytecode_summary(&self) -> Result<BytecodeSummary>

Summarize the CLI-compatible bytecode artifact without changing it.

pub fn client(&self) -> ClientBuilder

pub fn client_for_deployment( &self, deployment: &NetworkDeployment, ) -> ClientBuilder

Create a client builder with this runtime’s program and all deployment servers.

pub fn offchain_client_config( &self, client_slot: u64, ) -> Result<OffChainClientConfigBuilder>

Create an off-chain client IO config builder from this runtime’s typed program metadata.

The runtime supplies the MPC backend, topology, and output count for client_slot. Callers still provide coordinator/node endpoints, timestamp, and client identity explicitly.

pub fn server(&self, party_id: usize) -> ServerBuilder

pub fn server_for_config(&self, config: &NetworkConfig) -> ServerBuilder

Create a server builder for one party config while carrying this program.

pub fn servers_for_deployment( &self, deployment: &NetworkDeployment, ) -> Vec<ServerBuilder>

Create one server builder per party in a validated deployment plan.

Each builder carries this runtime’s compiled program metadata and uses the corresponding party’s network config.

pub fn mpc_config(&self) -> Option<&MpcConfig>

pub fn network_config(&self) -> Option<&NetworkConfig>

pub fn mpc_summary(&self) -> Result<Option<MpcConfigSummary>>

pub fn network_summary(&self) -> Result<Option<NetworkConfigSummary>>

pub fn summary(&self) -> Result<RuntimeSummary>

pub fn local_runner_binary_path(&self) -> Option<&Path>

pub fn inputs(&self) -> &[(String, Value)]

pub fn client_inputs(&self) -> &[(u64, Vec<Value>)]

pub fn configured_expected_clients(&self) -> Option<usize>

pub fn validate_client_inputs(&self) -> Result<()>

pub fn with_inputs<V>(self, inputs: &[(&str, V)]) -> Self

where V: Clone + Into<Value>,

Replace named function inputs for clear execution.

pub fn with_input<V>(self, name: impl Into<String>, value: V) -> Self

where V: Into<Value>,

Add one named function input for clear execution.

pub fn with_input_file(self, path: impl AsRef<Path>) -> Result<Self>

Replace named function inputs with values loaded from a .json, .csv, or .txt file.

pub fn with_client_input<V>(self, client_slot: u64, values: &[V]) -> Self

where V: Clone + Into<Value>,

Add one coordinator client input set for local networked execution.

pub fn with_client_input_file(self, path: impl AsRef<Path>) -> Result<Self>

Replace local ClientStore inputs with values loaded from a .json, .csv, or .txt file.

pub fn with_client_inputs<V>(self, inputs: &[(u64, &[V])]) -> Self

where V: Clone + Into<Value>,

Replace all coordinator client input sets for local networked execution.

pub fn expected_output_clients(self, n: usize) -> Self

Declare output-capable client slots 0..n-1 for local execution.

pub fn local_runner_path(self, path: impl AsRef<Path>) -> Self

Set the stoffel-run binary path used by local coordinator execution.

pub fn local_network(&self) -> LocalNetworkBuilder<'_>

Configure a real localhost coordinator-backed MPC run.

This builder exposes local development controls without replacing the networking, coordinator, or protocol implementations owned by the lower crates.

pub fn execute_clear(&self) -> Result<Vec<Value>>

pub fn execute_clear_function(&self, name: &str) -> Result<Vec<Value>>

pub fn execute<A>(&self, name: &str, args: A) -> Result<Vec<Value>>

where A: ProgramArgs,

Execute a named function with positional SDK values.

This is the direct, local cleartext execution path for a loaded or compiled program. Arguments are validated against the function metadata stored in the binary before the VM is invoked.

pub fn execute_main<A>(&self, args: A) -> Result<Vec<Value>>

where A: ProgramArgs,

Execute main with positional SDK values.

pub async fn execute_local(&self) -> Result<Vec<Value>>

Execute the runtime’s main entrypoint using the local coordinator runner.

This uses the same real localhost party mesh as crate::Stoffel::execute_local. It is intended for runtimes that were built from no-argument ClientStore entrypoints with client input supplied through the builder.

pub async fn execute_local_function(&self, name: &str) -> Result<Vec<Value>>

Execute a named runtime entrypoint using the local coordinator runner.

Trait Implementations

impl Clone for StoffelRuntime

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoffelRuntime

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

Formats the value using the given formatter.