Struct ClientRootRef 

pub struct ClientRootRef { /* private fields */ }

An opaque bearer capability to the program’s one client root.

The inner behavior reference is never exposed. Possession of an inherited ClientRootRef is the authority under Hyperactor’s trusted-actor model (CROOT-2); it is API attenuation, not actor authentication.

Implementations

impl ClientRootRef

pub fn bind(root: &ActorHandle<ProcAgent>) -> Self

Bind [ClientRootApi] on the program’s root ProcAgent handle and wrap the resulting reference (CROOT-1). Only the active root bootstrap calls this; worker ProcAgents never bind the API.

pub fn from_env(environment: &ActorEnvironment) -> Result<ClientRootRef>

Read the client-root capability from the supplied actor environment, failing closed when it is absent (CROOT-6). Every consumer (starting with RDMA) obtains the root here rather than re-deriving it, so the missing-capability path is enforced in one place.

Trait Implementations

impl AttrValue for ClientRootRef

fn display(&self) -> String

Display the value, typically using std::fmt::Display. This is called to show the output in human-readable form.

fn parse(_value: &str) -> Result<Self, Error>

Parse a value from a string, typically using std::str::FromStr.

impl Clone for ClientRootRef

fn clone(&self) -> ClientRootRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientRootRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientRootRef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ClientRootRef

impl Hash for ClientRootRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Named for ClientRootRef

fn typename() -> &'static str

The globally unique type name for the type. This should typically be the fully qualified Rust name of the type.

fn typehash() -> u64

A globally unique hash for this type. TODO: actually enforce perfect hashing

fn typeid() -> TypeId

The TypeId for this type. TypeIds are unique only within a binary, and should not be used for global identification.

fn port() -> u64

A globally unique numeric identifier for this type.

fn arm(&self) -> Option<&'static str>

If the named type is an enum, this returns the name of the arm of the value self.

unsafe fn arm_unchecked(self_: *const ()) -> Option<&'static str>

An unsafe version of ‘arm’, accepting a pointer to the value, for use in type-erased settings.

impl PartialEq for ClientRootRef

fn eq(&self, other: &ClientRootRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ClientRootRef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ClientRootRef