gRPC API reference.
Orbita serves KV, Admin, and readiness APIs on client port 7100. The current server does not provide gRPC reflection, so generate clients from the checked-in protobuf definitions.
KV service
| RPC | Contract |
|---|---|
Get | Read a value, opaque version, and optional absolute expiry |
Set | Write bytes with an optional relative TTL and condition |
Delete | Delete unconditionally or by version |
List | Read an ordered prefix page with an opaque cursor |
GetLimits | Discover key, value, page, and gRPC message limits |
Set.ttl_millis is relative to commit time. The owner converts it immediately to an absolute deadline so replication lag cannot extend expiration.
Admin service
The Admin service creates and manages keyspaces and credentials, describes the cluster, controls partition split/merge/transfer, and finalizes upgrades.
Readiness service
CheckReadiness reports Orbita-specific node readiness. It is not the standard grpc.health.v1.Health protocol.
Not present today
- Watch or subscribe streams
- Multi-key transactions
- Backup and restore RPCs
- Standard gRPC health
- Server reflection
See proto/orbita/v1 for the complete schema.