> ## Documentation Index
> Fetch the complete documentation index at: https://docs.restate.dev/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.restate.dev/feedback

```json
{
  "path": "/changelog/rust-sdk",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Rust SDK changelog

> Releases of the Rust SDK.

<Update label="2026-04-28" description="Rust SDK v0.10.0">
  ### New Features

  ### `DurableFuturesUnordered`

  Push a dynamic number of durable futures and consume them in completion order. Each result comes back with the index of the future that completed, so you can correlate it with your input.

  ```rust theme={null}
  let mut futures = DurableFuturesUnordered::new();
  futures.push(ctx.sleep(Duration::from_secs(1)));
  futures.push(ctx.sleep(Duration::from_secs(2)));
  futures.push(ctx.sleep(Duration::from_secs(3)));

  while let Some((index, result)) = futures.next().await? {
      result?;
      // ...
  }
  ```

  PR [#106](https://github.com/restatedev/sdk-rust/pull/106)

  ### Selectable `jsonwebtoken` crypto backend

  You can now pick `jsonwebtoken`'s backend explicitly, either `rust_crypto` or `aws_lc_rs`:

  ```toml theme={null}
  restate-sdk = { version = "0.10", default-features = false, features = ["http_server", "aws_lc_rs"] }
  ```

  `rust_crypto` remains the default. Disabling both lets you call `jsonwebtoken::crypto::CryptoProvider::install_default()` yourself.

  PR [#108](https://github.com/restatedev/sdk-rust/pull/108)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.10.0)
</Update>

<Update label="2026-02-20" description="Rust SDK v0.9.0">
  ### ✨ Highlights

  * 🔧 **MSRV raised to 1.90.0** — a downstream dependency silently raised its MSRV, which would cause build failures for users relying on our previously announced MSRV
  * 🏷️ **`#[lazy_state]` handler attribute** — opt into lazy state loading on a per-handler basis

  ### ⚠️ Breaking Changes

  ### Dependency bumps with user-facing API changes

  Several dependencies have been bumped. Most are transparent, but the following affect user code:

  #### `rand` 0.9 → 0.10

  The `rand()` method on context types returns `&mut rand::prelude::StdRng`. In rand 0.10, the trait that provides convenience methods like `.random()` and `.random_range()` was renamed from `Rng` to `RngExt`. If you import this trait, update your code:

  ```diff theme={null}
  - use rand::Rng;
  + use rand::RngExt;
  ```

  Additionally, the low-level trait `RngCore` (providing `next_u32()`, `next_u64()`, `fill_bytes()`) was renamed to `Rng`:

  ```diff theme={null}
  - use rand::RngCore;
  + use rand::Rng;
  ```

  `StdRng` no longer implements `Clone`. If you were cloning the RNG returned by `ctx.rand()`, this is no longer possible.

  #### Other dependency bumps (no user-facing changes)

  The following dependencies were also bumped but require no changes to user code:

  | Dependency                | Old      | New     |
  | ------------------------- | -------- | ------- |
  | `restate-sdk-shared-core` | `0.6.0`  | `0.9.0` |
  | `aws_lambda_events`       | `0.16.1` | `1.0`   |
  | `lambda_runtime`          | `0.14.2` | `1.0`   |
  | `typify`                  | `0.1.0`  | `0.6`   |
  | `jsonptr`                 | `0.5.1`  | `0.7`   |
  | `regress`                 | `0.10.3` | `0.10`  |
  | `bytes`                   | `1.10`   | `1.11`  |
  | `http`                    | `1.3`    | `1.4`   |
  | `hyper`                   | `1.6`    | `1.8`   |
  | `tokio`                   | `1.44`   | `1.49`  |
  | `uuid`                    | `1.16.0` | `1.20`  |
  | `schemars`                | `1.0.0`  | `1.2`   |
  | `reqwest` (dev)           | `0.12`   | `0.13`  |
  | `testcontainers`          | `0.23.3` | `0.27`  |

  ### MSRV raised to 1.90.0

  The minimum supported Rust version (MSRV) has been raised from **1.85.0** to **1.90.0**.

  This bump was necessary because a downstream dependency raised its own MSRV without announcing it. Without this change, users relying on our previously announced MSRV of 1.85.0 would encounter build failures. Any user building with a toolchain between 1.85.0 and 1.87.x is affected. Rather than pinning to an older version of the dependency, we chose to follow the ecosystem forward.

  **Impact on Users:**

  * Projects using a Rust toolchain older than 1.90.0 will fail to compile against this version of the SDK
  * Your own crate's `edition` field does not need to change, but your installed Rust toolchain must be >= 1.90.0

  **Migration Guidance:**

  Update your Rust toolchain:

  ```bash theme={null}
  rustup update stable
  ```

  Verify your version:

  ```bash theme={null}
  rustc --version  # Must be >= 1.90.0
  ```

  ### 🆕 New Features

  ### `#[lazy_state]` handler attribute

  You can now annotate individual handlers with `#[lazy_state]` to enable lazy state loading for that handler. When enabled, state is fetched on demand rather than eagerly loaded when the handler is invoked.

  **Example:**

  ```rust theme={null}
  #[restate_sdk::object]
  pub trait MyObject {
      #[lazy_state]
      async fn my_handler(name: String) -> Result<String, HandlerError>;
  }
  ```

  **Related Issues:**

  * PR [#90](https://github.com/restatedev/sdk-rust/pull/90)

  ***

  📄 [Full release notes](https://github.com/restatedev/sdk-rust/blob/v0.9.0/release-notes/v0.9.0.md)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.9.0)
</Update>

<Update label="2026-02-12" description="Rust SDK v0.8.0">
  ### ✨ Highlights

  * 🔧 **MSRV raised to 1.85.0** with Rust edition 2024 — ensure your toolchain is up to date
  * 🆔 **Invocation ID now accessible** from all handler context types via `invocation_id()`
  * 🔓 **`ProtocolMode` and `HandleOptions` are now public** — enabling custom server integrations beyond the built-in HTTP server and Lambda endpoint

  ### ⚠️ Breaking Changes

  ### Rust edition 2024 and MSRV 1.85.0

  The SDK now uses Rust edition 2024 and requires a minimum supported Rust version (MSRV) of **1.85.0** (previously 1.76.0).

  **Impact on Users:**

  * Projects using an older Rust toolchain will fail to compile against this version of the SDK
  * Your own crate's `edition` field does not need to change, but your installed Rust toolchain must be >= 1.85.0

  **Migration Guidance:**

  Update your Rust toolchain:

  ```bash theme={null}
  rustup update stable
  ```

  Verify your version:

  ```bash theme={null}
  rustc --version  # Must be >= 1.85.0
  ```

  **Related Issues:**

  * PR [#82](https://github.com/restatedev/sdk-rust/pull/82)

  ### 🚀 New Features

  ### 🆔 Invocation ID available in handler context

  All handler context types now expose an `invocation_id()` method that returns the current Restate invocation ID as a `&str`.

  This is useful for logging, debugging, and correlating requests across services.

  **Example:**

  ```rust theme={null}
  impl Greeter for GreeterImpl {
      async fn greet(&self, ctx: Context<'_>, name: String) -> HandlerResult<String> {
          let id = ctx.invocation_id();
          tracing::info!("Handling invocation {id} for {name}");
          Ok(format!("Greetings {name}"))
      }
  }
  ```

  Available on all context types: `Context`, `ObjectContext`, `SharedObjectContext`, `WorkflowContext`, and `SharedWorkflowContext`.

  **Related Issues:**

  * PR [#83](https://github.com/restatedev/sdk-rust/pull/83)

  ### 🔓 Public `ProtocolMode`, `HandleOptions`, and `handle_with_options`

  `ProtocolMode`, `HandleOptions`, and the `Endpoint::handle_with_options()` method are now part of the public API (exported via the prelude).

  This enables building custom server integrations beyond the built-in `HttpServer` and `LambdaEndpoint`. For example, you can now implement your own HTTP framework adapter or request-response transport by calling `handle_with_options` directly with the desired `ProtocolMode`.

  **Related Issues:**

  * PR [#86](https://github.com/restatedev/sdk-rust/pull/86)

  ***

  📄 [Full release notes](https://github.com/restatedev/sdk-rust/blob/main/release-notes/v0.8.0.md)

  ### 👋 New Contributors

  * @sagikazarmark made their first contribution in [https://github.com/restatedev/sdk-rust/pull/80](https://github.com/restatedev/sdk-rust/pull/80)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.8.0)
</Update>

<Update label="2025-09-16" description="Rust SDK v0.7.0">
  ### AWS Lambda support

  You can now use the Rust SDK with AWS Lambda, check out [https://github.com/restatedev/sdk-rust?tab=readme-ov-file#running-on-lambda](https://github.com/restatedev/sdk-rust?tab=readme-ov-file#running-on-lambda) for more details on how to set it up.

  ### Invocation retry policy

  When used with Restate 1.5, you can now configure the invocation retry policy from the SDK directly. See [https://github.com/restatedev/restate/releases/tag/v1.5.0](https://github.com/restatedev/restate/releases/tag/v1.5.0) for more details on the new invocation retry policy configuration.

  ### What's Changed

  * Refactor Endpoint internals. by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/71](https://github.com/restatedev/sdk-rust/pull/71)
  * Add lambda runtime support by @muhamadazmy in [https://github.com/restatedev/sdk-rust/pull/70](https://github.com/restatedev/sdk-rust/pull/70)
  * Add new retry policy options by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/73](https://github.com/restatedev/sdk-rust/pull/73)
  * Clarify max attempts meaning by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/74](https://github.com/restatedev/sdk-rust/pull/74)

  ### New Contributors

  * @muhamadazmy made their first contribution in [https://github.com/restatedev/sdk-rust/pull/70](https://github.com/restatedev/sdk-rust/pull/70)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.7.0)
</Update>

<Update label="2025-07-02" description="Rust SDK v0.6.0">
  Introduce new feature `bind_with_options`, allowing to customize service and handler configuration options. Please note, this feature works only with Restate 1.4 onward.

  ### What's Changed

  * Discovery protocol v3 by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/62](https://github.com/restatedev/sdk-rust/pull/62)
  * Update shared core by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/63](https://github.com/restatedev/sdk-rust/pull/63)
  * Update shared core by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/66](https://github.com/restatedev/sdk-rust/pull/66)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.6.0)
</Update>

<Update label="2025-04-29" description="Rust SDK v0.5.0">
  ### What's Changed

  ### Schema generation

  By enabling the optional dependency `schemars`, the SDK will generate and propagate JSON schemas of your handlers input/output, which will be available in the generated [OpenAPI](https://docs.restate.dev/invoke/http/#openapi-support) and in the Restate Playground. For more details on the schema generation, and info on how to tune it, check the [https://docs.rs/restate-sdk/latest/restate\_sdk/serde/trait.PayloadMetadata.html](https://docs.rs/restate-sdk/latest/restate_sdk/serde/trait.PayloadMetadata.html) documentation.

  Thanks to @hxphsts for the contribution!

  ### New `restate-sdk-testcontainers` module

  We've released a first version of the testcontainers integration, that simplifies testing locally your restate service. Check [https://github.com/restatedev/sdk-rust/blob/main/testcontainers/tests/test\_container.rs](https://github.com/restatedev/sdk-rust/blob/main/testcontainers/tests/test_container.rs) for a full example.

  Thanks to @kpwebb for the contribution.

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.5.0)
</Update>

<Update label="2025-04-09" description="Rust SDK v0.4.0">
  We're pleased to announce the release of Rust SDK 0.4.0, in combination with Restate 1.3.
  Check out the announcement blog post for more details about Restate 1.3 and the new SDK features: [https://restate.dev/blog/announcing-restate-1.3/](https://restate.dev/blog/announcing-restate-1.3/)

  This SDK introduces the following new APIs:

  * Support the new features of Restate 1.3, check [`InvocationHandle`](https://docs.rs/restate-sdk/latest/restate_sdk/context/trait.InvocationHandle.html) for more details
  * You can now use the new macro [`select!`](https://docs.rs/restate-sdk/latest/restate_sdk/macro.select.html) (alike `tokio::select`) to await concurrently for multiple operations to complete.
  * `Request::send_with_delay` was renamed to `Request::send_after`
  * The SDK now provides a utility to use in combination with `tracing` that hides logs on replay. Check [https://docs.rs/restate-sdk/latest/restate\_sdk/filter/struct.ReplayAwareFilter.html](https://docs.rs/restate-sdk/latest/restate_sdk/filter/struct.ReplayAwareFilter.html) for more details.

  Rust SDK 0.4.0 can be used in combination with Restate 1.3 onward.

  ### Full changelog

  * Add note on retry policies for ctx.run by @gvdongen in [https://github.com/restatedev/sdk-rust/pull/39](https://github.com/restatedev/sdk-rust/pull/39)
  * Improve workflow docs by @gvdongen in [https://github.com/restatedev/sdk-rust/pull/40](https://github.com/restatedev/sdk-rust/pull/40)
  * Use test suite 2.4 by @jackkleeman in [https://github.com/restatedev/sdk-rust/pull/37](https://github.com/restatedev/sdk-rust/pull/37)
  * rust testcontainer framework by @kpwebb in [https://github.com/restatedev/sdk-rust/pull/41](https://github.com/restatedev/sdk-rust/pull/41)
  * Pin sha2 version by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/45](https://github.com/restatedev/sdk-rust/pull/45)
  * Service Protocol V4 by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/46](https://github.com/restatedev/sdk-rust/pull/46)
  * Fix cancel test by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/47](https://github.com/restatedev/sdk-rust/pull/47)
  * Replay aware logger by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/48](https://github.com/restatedev/sdk-rust/pull/48)
  * Update test suite by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/49](https://github.com/restatedev/sdk-rust/pull/49)
  * Protocol V5 by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/50](https://github.com/restatedev/sdk-rust/pull/50)
  * First pass at a select statement by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/51](https://github.com/restatedev/sdk-rust/pull/51)
  * Add CLA automation by @tillrohrmann in [https://github.com/restatedev/sdk-rust/pull/52](https://github.com/restatedev/sdk-rust/pull/52)
  * Fix little bug with run cancellation by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/54](https://github.com/restatedev/sdk-rust/pull/54)
  * Dependency bumping by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/55](https://github.com/restatedev/sdk-rust/pull/55)
  * Bump SDK versions by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/57](https://github.com/restatedev/sdk-rust/pull/57)

  ### New Contributors

  * @jackkleeman made their first contribution in [https://github.com/restatedev/sdk-rust/pull/37](https://github.com/restatedev/sdk-rust/pull/37)
  * @kpwebb made their first contribution in [https://github.com/restatedev/sdk-rust/pull/41](https://github.com/restatedev/sdk-rust/pull/41)
  * @tillrohrmann made their first contribution in [https://github.com/restatedev/sdk-rust/pull/52](https://github.com/restatedev/sdk-rust/pull/52)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.4.0)
</Update>

<Update label="2024-12-05" description="Rust SDK v0.3.2">
  ### What's Changed

  * Add MSRV computed with `cargo msrv` by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/26](https://github.com/restatedev/sdk-rust/pull/26)
  * Example with periodic task by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/28](https://github.com/restatedev/sdk-rust/pull/28)
  * Make endpoint handle function independent of other handlers by @h7kanna in [https://github.com/restatedev/sdk-rust/pull/29](https://github.com/restatedev/sdk-rust/pull/29)
  * No need for the run future to be `Sync` by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/32](https://github.com/restatedev/sdk-rust/pull/32)
  * Documentation for Rust SDK by @gvdongen in [https://github.com/restatedev/sdk-rust/pull/34](https://github.com/restatedev/sdk-rust/pull/34)
  * Fix docs landing page by @gvdongen in [https://github.com/restatedev/sdk-rust/pull/36](https://github.com/restatedev/sdk-rust/pull/36)

  ### New Contributors

  * @h7kanna made their first contribution in [https://github.com/restatedev/sdk-rust/pull/29](https://github.com/restatedev/sdk-rust/pull/29)
  * @gvdongen made their first contribution in [https://github.com/restatedev/sdk-rust/pull/34](https://github.com/restatedev/sdk-rust/pull/34)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.3.2)
</Update>

<Update label="2024-09-10" description="Rust SDK v0.3.0">
  ### Breaking changes

  * The `ctx.run` API now does not require `name` as first parameter anymore
  * Renamed `Endpoint.with_service` to `Endpoint.bind`
  * This SDK is compatible only with Restate >= 1.1

  ### New features

  * It is now possible to configure a retry policy for `ctx.run`
  * Now std `Result` can be returned from handlers, and similarly any error type can be used. Behind the hood, the error type will always be converted to `HandlerError`, following the rules described here: [https://docs.rs/restate-sdk/latest/restate\_sdk/errors/struct.HandlerError.html](https://docs.rs/restate-sdk/latest/restate_sdk/errors/struct.HandlerError.html)

  ### What's Changed

  * Rust docs by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/17](https://github.com/restatedev/sdk-rust/pull/17)
  * Fix bad indendation in docs by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/18](https://github.com/restatedev/sdk-rust/pull/18)
  * Add x\_restate\_server header by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/21](https://github.com/restatedev/sdk-rust/pull/21)
  * Side effect retry by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/20](https://github.com/restatedev/sdk-rust/pull/20)
  * Now a standalone Result can be returned from handlers by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/22](https://github.com/restatedev/sdk-rust/pull/22)
  * Naming improvements by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/23](https://github.com/restatedev/sdk-rust/pull/23)
  * Docs improvements by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/24](https://github.com/restatedev/sdk-rust/pull/24)
  * Add rust toolchain file by @slinkydeveloper in [https://github.com/restatedev/sdk-rust/pull/25](https://github.com/restatedev/sdk-rust/pull/25)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.3.0)
</Update>

<Update label="2024-08-22" description="Rust SDK v0.2.0">
  ### New features

  * Generated clients from the respective service/object/workflow macros. To use them, just use `context.service_client::&lt;MyTraitClient&gt;()` et al.
  * You can now use the hyper integration alone, without using our `HttpServer` that depends on `tokio`, by enabling the feature `hyper` and disabling the feature `http_server`
  * Now the context methods are defined in traits
  * Add `ctx.rand()` and `ctx.rand_uuid()` for deterministic random number/uuid generation
  * Add `ctx.headers()` and `ctx.headers_mut()` to access the ingress headers
  * Add identity verification

  ### Breaking changes

  * Renamed `HyperServer` to `HttpServer`
  * Removed context `send`, `send_delay` and `call`, replaced with `ctx.request(..).send()` and `ctx.request(..).call()` (in future this `Request` struct will allow to configure some parameters of the request, such as headers)

  [View on GitHub](https://github.com/restatedev/sdk-rust/releases/tag/v0.2.0)
</Update>