NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #3273 most downloaded on crates.io
An etcd v3 API client
Latest stable
0.21.1
Last release 1 months ago
19 Oct 2026
Ships fairly regularly
a new release about every 3 months
Nearly every release is documented
notes for 53 of 53 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
53 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Refresh an expired authentication token for the calls of AuthClient too when automatic token refresh is enabled, except authenticate, by @belltoy in #
AuthClient too when automatic token refresh is enabled, except authenticate, by @belltoy in #126Cluster.MemberList. etcd 3.6 and later require it when authentication is enabled and refuse the request with user name is empty otherwise (observed on 3.6.15 and 3.7.2, while 3.5.26 does not require it), by @belltoy in #127Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.21.0...v0.21.1
Add etcd 3.7 streaming range reads through KvClient::get_stream() and GetStreamResponse.
KvClient::get_stream() and GetStreamResponse.MaintenanceClient::downgrade() to validate, enable, or cancel cluster downgrades.Lock and Election requests when etcd returns Unknown with an invalid authentication token error by @askalt in #124.Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.20.0...v0.21.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add system and Mozilla’s trust roots, by @messense in #116
aws-lc-rs feature support, by @mrthinger in #120Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.19.0...v0.20.0
Expose watch_request::RequestUnion as PbWatchRequestUnion by @srporwal12 in #117
watch_request::RequestUnion as PbWatchRequestUnion by @srporwal12 in #117Fixed the WatchStream::split method introduced in v0.18.0, by @belltoy in #119:
- WatchStream::split(self) -> (Sender<WatchRequest>, Streaming<PbWatchResponse>)
+ WatchStream::split(self) -> (WatchRequestSender, WatchResponseStream)
Read discussion details in #118.
Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.18.0...v0.19.0
Simplify authentication (with interceptor) by @belltoy in https://github.com/etcdv3/etcd-client/pull/106
Since 0.18, the WatchClient API has changed to support watch stream error handling precisely.
The WatchClient is not a high level watcher, it is just a watch API stub. So it should be only
responsible for sending requests and receiving responses. Let the high level watcher decide what
to do if received an unexpected response.
- WatchClient::watch(key: impl Into<Vec<u8>>, options: Option<WatchOptions>) -> Result<(WatchResponse, Watcher, WatchStream)>
+ WatchClient::watch(key: impl Into<Vec<u8>>, options: Option<WatchOptions>) -> Result<WatchStream>
The new WatchStream is different from the old version. It represents underlying bidirectional
watch stream (HTTP 2 stream). So it can be used to send requests and receive responses and events.
It's the user's responsibility to check the received response is a response or an event, if it is created successfully or not, or if it is a cancel response.
See watch.rs for example.
Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.17.0...v0.18.0
## What's Changed * tonic: upgrade to tonic 0.14 (#112) Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.16.1...v0.17.0
Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.16.1...v0.17.0
## What's Changed * Fix Client (Channel) Sync (#110) Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.16.0...v0.16.1
Client (Channel) Sync (#110)Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.16.0...v0.16.1
Update tonic to 0.13.1 and tower to 0.5
Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.15.0...v0.16.0
Use {RwLock/Mutex}::clear_poison() to remove {RwLock/Mutex}::unwrap() by @davidli2010 in https://github.com/etcdv3/etcd-client/pull/94
{RwLock/Mutex}::clear_poison() to remove {RwLock/Mutex}::unwrap() by @davidli2010 in https://github.com/etcdv3/etcd-client/pull/94Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.14.1...v0.15.0
{RwLock/Mutex}::clear_poison() to remove {RwLock/Mutex}::unwrap() by @davidli2010 in #94Full Changelog: https://github.com/etcdv3/etcd-client/compare/v0.14.1...v0.15.0
Enhance the example which showcases the snapshot maintenance operation. by @renormalize in https://github.com/etcdv3/etcd-client/pull/83
Happy Chinese New Year! 🎉
Happy Chinese New Year! 🎉
- Upgrade tonic to 0.12 - Upgrade prost to 0.13 - Upgrade http to 1.1
Support manually in-place authentication token update
- Implement namespace APIs (#71) - Support tcp keepalive
Add GetResponse::take_kvs() & KeyValue::into_key_value()
Implement take_prev_kvs for DeleteResponse
- Export AuthenticateResponse
AuthenticateResponse (#64)Disable tower's default features
- Upgrade to Rust 2021 edition
- Upgrade tonic to 0.9.x - Upgrade other dependencies
- Fix doc.rs build
- Add openssl support
Add ConnectOptions::with_connect_timeout() to apply a timeout to connecting to the endpoint
ConnectOptions::with_connect_timeout() to apply a timeout to connecting to the endpointExpose the keep_alive_while_idle config
keep_alive_while_idle config- Upgrade tokio to 1.20.1 - Upgrade tonic to 0.8.0 - Upgrade prost to 0.11.0
- Upgrade tokio to 1.18
- Watcher can watch more keys
Upgrade tonic to 0.7.1 and prost to 0.10.0
- Add timeout to ConnectOptions - Upgrade tokio to 1.17.0
Connect lazy for single endpoint
Fix: allow KeyValue be exported by feature pub-response-field
pub-response-field- Update README and documents
Upgrade tonic to 0.6 and prost to 0.9
- Support http2 keep alive - Upgrade tokio to 1.11.0
Add pub-response-field feature to turn *Response related struct fields public and expose internal protobuf response representations.
pub-response-field feature to turn *Response related struct fields public and expose internal protobuf response representations.- Upgrade to tonic 0.5
- Enhance DeleteOptions - Upgrade tokio to 1.8.1
Upgrade tokio to 1.6.1
Upgrade tokio to 1.6.1
- Upgrade dependencies - Update docs
Get separate operation clients from Client.
Get separate operation clients from Client.
1. Upgrade tokio to 1.2.0 2. Fix typo
Upgrade to Tokoio 1.0.
Upgrade to Tokoio 1.0.
Support TLS connection.
Support TLS connection.
Upgrade tonic to 0.3
Upgrade tonic to 0.3
Support Clone operation on the client.
Support Clone operation on the client.
Disable the use of rustfmt to format the output code.
Disable the use of rustfmt to format the output code.
Move auto-generated files to OUT_DIR.
Move auto-generated files to OUT_DIR.
Add election APIs.
Add election APIs.
Add cluster APIs.
Add cluster APIs.
Add maintanence and user APIs.
Add maintanence and user APIs.
Support role operations.
Support role operations.
- Support Lock APIs. - Support user authentication.
Supports Lease APIs.
Supports Lease APIs.
Basic KV and watch operations.
Basic KV and watch operations.
One column per quarter.