fhelium.distributed._transfer
Metadata descriptors and receiver allocation for distributed transfers.
The distributed wire protocol carries a serialized value description plus transport-specific tensor allocation metadata. The protocol version is independent of the durable value schema version: changing one does not imply a change to the other. Raw torch.Tensor remains a transport-only special case and is not part of the FHElium value schema.
TRANSFER_PROTOCOL_VERSION
constant View source
TRANSFER_PROTOCOL_VERSION = 5TransferDescriptor
data View source
TransferDescriptor = dict[str, Any]describe_value
function View source
def describe_value(value: object) -> TransferDescriptor: ...Describe a workload value without serializing its tensor payload.
allocate_value
function View source
def allocate_value(descriptor: TransferDescriptor, *, local_device: torch.device) -> torch.Tensor | TensorResident: ...Allocate the receiver-side value described by describe_value.
describe_key
function View source
def describe_key(key: object) -> TransferDescriptor: ...Describe selected key material for transfer.
allocate_key
function View source
def allocate_key(descriptor: TransferDescriptor, *, local_device: torch.device) -> TensorResident: ...Allocate receiver-side key material from a transmitted descriptor.