Per-microVM facade over the generated Firecracker API (Hyper.Firecracker.Api.Operations). One GenServer per VM, registered cluster-wide via Hyper.Cluster.Routing.via({vm_id, :client}). It serializes every request through handle_call (Firecracker's API server is single-threaded).

The VM's API socket is derived from vm_id alone via Hyper.Node.FireVMM.Jailer.host_socket/1 (the same function the controller uses), so the client needs no socket threaded in and the two cannot disagree. A :socket_path override is accepted for tests/stand-ins.

Call any generated operation through run/2, passing a 1-arity closure that receives the per-call opts (carrying :socket_path) to forward as the operation's trailing opts argument:

alias Hyper.Firecracker.Api.Operations

Client.run(Client.via(vm_id), &Operations.describe_instance/1)

Client.run(Client.via(vm_id), fn opts ->
  Operations.put_guest_boot_source(%Hyper.Firecracker.Api.BootSource{
    kernel_image_path: "/vmlinux"
  }, opts)
end)

The closure's return value (:ok / {:ok, struct} / {:error, _} from Hyper.Firecracker.Api.Transport) is returned to the caller unchanged.