Module system_actors

Expand description

System actors for remote operations (spawn, watch, cancel, directory). System actors for remote operations.

When a node needs to perform a remote operation (spawn an actor, watch a remote actor, cancel a remote operation), it sends a message to a system actor on the target node. System actors are automatically started by the runtime and handle these requests.

§System Actor Types

SpawnManager — handles remote actor spawn requests
WatchManager — handles remote watch/unwatch subscriptions
CancelManager — handles remote cancellation requests
NodeDirectory — maps NodeId → connection metadata

§System Message Type Constants

Well-known WireEnvelope::message_type values used by the transport router to dispatch incoming envelopes to the correct system actor mailbox. See system_router.

Structs§

CancelManager: Manages remote cancellation requests.
CancelRequest: Request to cancel a remote operation.
HandshakeRequest: Information sent by a node when initiating a version handshake.
NodeDirectory: Maps NodeIds to peer connection information.
PeerInfo: Metadata about a peer node.
SpawnManager: Manages remote actor spawn requests on a node.
SpawnRequest: Message requesting a remote actor spawn.
SystemActorConfig: Configuration for system actors spawned by the runtime.
UnwatchRequest: Request to stop watching a remote actor.
WatchManager: Manages remote watch/unwatch subscriptions.
WatchNotification: Notification that a watched actor has terminated.
WatchRequest: Request to watch a remote actor for termination.

Enums§

CancelResponse: Acknowledgement of a cancel request.
HandshakeResponse: The result of a version handshake.
PeerStatus: Connection status of a peer node.
RejectionReason: Reason a version handshake was rejected.
SpawnResponse: Response to a spawn request.

Constants§

SYSTEM_MSG_TYPE_CANCEL: Wire protocol identifier for CancelRequest messages.
SYSTEM_MSG_TYPE_CONNECT_PEER: Wire protocol identifier for peer connect messages routed to NodeDirectory.
SYSTEM_MSG_TYPE_DISCONNECT_PEER: Wire protocol identifier for peer disconnect messages routed to NodeDirectory.
SYSTEM_MSG_TYPE_SPAWN: Wire protocol identifier for SpawnRequest messages.
SYSTEM_MSG_TYPE_UNWATCH: Wire protocol identifier for UnwatchRequest messages.
SYSTEM_MSG_TYPE_WATCH: Wire protocol identifier for WatchRequest messages.

Functions§

is_system_message_type: Returns true if message_type is a well-known system message type.
validate_handshake: Validate a remote node’s HandshakeRequest against local configuration.
verify_peer_identity: Verify that an accepted handshake response came from the expected peer.