Crate actordb_protocol 

Committed Prost bindings and stable limits for peer and application protocols.

Regenerate with cargo run -p actordb-protocol --features codegen --bin generate. Append -- --check to verify schema/binding agreement without writing files.

Modules

client

meta

rpc

Framework-neutral client/service traits, ownership, and request envelopes. Framework-neutral unary RPC boundary. Adapters own authentication and I/O. No adapter may transparently replay a mutation. Decoding must be bounded before allocating message collections, including opaque receipt payloads.

write_concern

Per-write acknowledgement policy and progress receipts. Acknowledgement thresholds do not establish a global mutation order.

Structs

RecordVersion

A totally ordered hybrid-clock timestamp.

RpcDecodeReport

Work admitted before Prost or SDK receipt/result conversion allocates. Header charges include Vec geometric growth/minimum capacity and conservative map/portable-conversion storage. Payloads are charged twice for decoded and temporary validation copies. Caller-retained returned results, allocator slack, transport buffers and outgoing request storage are outside this scope.

RpcResponseShape

Expectations derived from the actual pending application request, never from data echoed by the server. Use optional query shape from a trusted locally parsed plan; the protocol preflight does not parse SQL.

Constants

DEFAULT_MAX_DECODED_RESPONSE_BYTES

Default accounted response allowance, including raw framing, decoded collections/payloads and portable conversion work. Not an allocator/RSS cap.

MAX_BATCH_ITEMS

MAX_FRAME_BYTES

Peer framing limit; independent of the application RPC adapter.

MAX_RPC_MESSAGE_BYTES

PORTABLE_CELL_HEADER_CHARGE

Conservative portable QueryValue header allowance. SDK tests check that their actual layout fits this charge without coupling the wire crate to SQL.

RPC_CALL_PATH

RPC_SERVICE_NAME

Functions

preflight_rpc_request

Allocation-free request preflight before an RPC adapter materializes Prost.

preflight_rpc_response

Allocation-free response admission, pinned to the actual pending request.

preflight_rpc_response_unchecked_shape

Structural response admission for adapters which validate the pending shape separately.