Struct SessionToken 

pub struct SessionToken(/* private fields */);

A 256-bit random session token for socket authentication.

Implementations

impl SessionToken

pub fn generate() -> Self

Generate a new random session token from the OS CSPRNG.

pub fn to_hex(&self) -> String

Hex-encode the token for file storage and wire transmission.

pub fn from_hex(hex: &str) -> Result<Self, Error>

Decode a hex-encoded token string.

Errors

Returns an error if the hex string is not exactly 64 characters or contains invalid hex digits.

pub fn write_to_file(&self, path: &Path) -> Result<()>

Write the token to a file with owner-only permissions (0o600).

On Unix, this uses write-then-rename atomicity: writes to a temporary file at 0o600 (via OpenOptions::mode to avoid a TOCTOU permissions window), then atomically renames it to the target path. This prevents a racing read_from_file from seeing a truncated/empty file during daemon restarts.

Errors

Returns an error if the file cannot be written or permissions cannot be set.

pub fn read_from_file(path: &Path) -> Result<Self>

Read and decode a token from a file.

Errors

Returns an error if the file cannot be read or contains invalid hex.

pub fn ct_eq(&self, other: &Self) -> bool

Constant-time comparison. Returns true if the tokens are equal.

Trait Implementations

impl Debug for SessionToken

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

Formats the value using the given formatter.