Run Method

After initializing the VM and configuring your desired capabilities, you can load your bytecode and start the execution process.

Using TypeScript

For TypeScript, you can pass raw bytecode arrays directly to the loader. It is recommended to use optimizeBytecode beforehand to ensure the VM runs the most efficient version of your instructions.

With Array

const raw = [
  ['push', 5],
  ['val', 'x'],
  ['set', 'x'],
];
vm.load(tools.optimizeBytecode(raw)).run();

Using Rust

In Rust, you typically work with serialized bytecode strings (or serde_json). Similar to the TypeScript implementation, always optimize your bytecode before loading it into the VM to maintain optimal performance.

With Raw String

let raw = r#"[
  ["push", 5],
  ["val", "x"],
  ["set", "x"]
]"#;
vm.load(tools.optimize_bytecode(raw).clone())
  .run(None);

With Serde

let raw = serde_json::json!([
  ["push", 5],
  ["val", "x"],
  ["set", "x"]
]);
vm.load(tools.optimize_bytecode(raw).clone())
  .run(None);

INFO

Capability Required: Control

TIP

The .run() method is the final step in the execution pipeline. Ensure all necessary capabilities have been granted during initialization to avoid runtime security exceptions.