Reference

etcd KV, Watch, and Lease API

etcd KV, Watch, and Lease API

Astra implements the following etcd-compatible services:

  • KV
  • Watch
  • Lease

For canonical RPC request/response fields, use the generated proto contract in crates/astra-proto/proto/rpc.proto.

RPC Surface

KV Service

RPCPurpose
RangePoint read and prefix LIST reads.
PutKey write with optional lease association.
DeleteRangePoint delete or range delete.
TxnCompare-and-swap and conditional operations.
CompactLogical compaction signal.

Watch Service

RPCPurpose
Watch(stream WatchRequest)Bidirectional stream for create/cancel/progress watch control and event delivery.

Lease Service

RPCPurpose
LeaseGrantCreate lease ID/TTL binding.
LeaseRevokeRevoke lease and detach keys.
LeaseKeepAlive(stream LeaseKeepAliveRequest)Lease heartbeat stream.
LeaseTimeToLiveInspect TTL state and keys.
LeaseLeasesList current leases.

Compatibility Notes

  • Focus is control-plane compatibility for validated scenarios.
  • Unsupported historical edge semantics should be validated case-by-case before migration.