Struct SingBoxBackendOptions 

pub struct SingBoxBackendOptions { /* private fields */ }

Already-resolved host inputs for one sing-box backend.

The driver never resolves product paths: the host supplies the installed binary, the active profile document, the stable Core instance identity and the loopback Clash API coordinates that the profile declares.

Implementations

impl SingBoxBackendOptions

pub fn new( binary_path: impl Into<PathBuf>, config_path: impl Into<PathBuf>, instance_id: CoreInstanceId, controller_endpoint: impl Into<String>, secret: Option<String>, ) -> Result<Self, PortError>

Validates the host inputs with the default readiness bound.

pub fn with_readiness_timeout( binary_path: impl Into<PathBuf>, config_path: impl Into<PathBuf>, instance_id: CoreInstanceId, controller_endpoint: impl Into<String>, secret: Option<String>, readiness_timeout: Duration, ) -> Result<Self, PortError>

Validates the host inputs together with an explicit readiness bound.

pub fn binary_path(&self) -> &PathBuf

Returns the path of the sing-box binary the host may launch.

pub fn config_path(&self) -> &PathBuf

Returns the path of the configuration file the core reads.

pub fn instance_id(&self) -> &CoreInstanceId

Returns the configured instance identity of the core.

pub fn controller_address(&self) -> SocketAddr

Returns the socket address the controller binds to.

pub fn controller_endpoint(&self) -> String

Returns the explicit HTTP loopback endpoint of the controller.

pub const fn readiness_timeout(&self) -> Duration

Bound the host applies while waiting for Clash API readiness after it explicitly starts the Core. Bundle creation never waits.