Wiaoj.Idempotency.Redis 0.2.0-alpha.3

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Wiaoj.Idempotency.Redis. 
dotnet add package Wiaoj.Idempotency.Redis --version 0.2.0-alpha.3
                    


                    

                
NuGet\Install-Package Wiaoj.Idempotency.Redis -Version 0.2.0-alpha.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Wiaoj.Idempotency.Redis" Version="0.2.0-alpha.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Wiaoj.Idempotency.Redis" Version="0.2.0-alpha.3" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Wiaoj.Idempotency.Redis" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Wiaoj.Idempotency.Redis --version 0.2.0-alpha.3
                    


                    

                
#r "nuget: Wiaoj.Idempotency.Redis, 0.2.0-alpha.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Wiaoj.Idempotency.Redis@0.2.0-alpha.3
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Wiaoj.Idempotency.Redis&version=0.2.0-alpha.3&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Wiaoj.Idempotency.Redis&version=0.2.0-alpha.3&prerelease
                    


                            Install as a Cake Tool

Wiaoj.Idempotency.Redis

A distributed IIdempotencyStore, so a claim outlives the process that made it and is shared by every replica.

dotnet add package Wiaoj.Idempotency.Redis

Usage

// Uses the IConnectionMultiplexer already registered, sharing one connection.
builder.Services.AddRedisIdempotencyStore();

// Or connect from here:
builder.Services.AddRedisIdempotencyStore("localhost:6379,abortConnect=false");

// Or with full control, including the key prefix:
builder.Services.AddRedisIdempotencyStore(options => {
    options.KeyPrefix = "orders:idemp:";   // default: "wiaoj:idemp:"
    options.Database = 3;
});

// Several Redis connections in one application:
builder.Services.AddKeyedRedisIdempotencyStore("claims-cluster");

How a claim is stored

Contract Redis
TryMarkProcessedAsync(key, window) SET <prefix><key> 1 NX PX <window> → true when it was stored
ContainsAsync(key) EXISTS
MarkProcessedAsync(key, window) SET <prefix><key> 1 PX <window>
RemoveAsync(key) DEL
  • One round trip, atomic in Redis: SET NX stores the key only if it is absent, so exactly one caller wins. Nothing is buffered — a buffered claim is not a claim, since two replicas could both believe they won.
  • Membership, not a value: the stored value is one byte and is never read.
  • Namespaced keys: the prefix keeps a claim from colliding with a counter or a cache entry in a shared instance.

While Redis is unavailable

Every operation throws RedisConnectionException at once instead of queueing the command until StackExchange.Redis' backlog timeout expires (5 s by default). A claim that could not be recorded is a fact the caller has to decide about, and waiting five seconds per message only turns an outage into a stall. Operations resume as soon as the multiplexer reconnects.

The decision is yours: whether an unavailable store means "run the work anyway" (risking a duplicate) or "fail and let the message be redelivered" depends on what the work does. The store does not choose for you.

Use abortConnect=false so the application starts while Redis is down.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.2.0-alpha.3 42 9/24/2026
0.2.0-alpha.2 41 9/24/2026
0.2.0-alpha.1 46 9/24/2026
0.1.0-alpha.9 49 9/21/2026
0.1.0-alpha.8 41 9/21/2026