Dolittle.SDK.Microservices 18.0.0

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher. .NET Core 3.1 This package targets .NET Core 3.1. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Dolittle.SDK.Microservices --version 18.0.0                

                    
                

            
NuGet\Install-Package Dolittle.SDK.Microservices -Version 18.0.0
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="Dolittle.SDK.Microservices" Version="18.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Dolittle.SDK.Microservices --version 18.0.0                

                    
                

            
#r "nuget: Dolittle.SDK.Microservices, 18.0.0"
#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. 
// Install Dolittle.SDK.Microservices as a Cake Addin
#addin nuget:?package=Dolittle.SDK.Microservices&version=18.0.0

// Install Dolittle.SDK.Microservices as a Cake Tool
#tool nuget:?package=Dolittle.SDK.Microservices&version=18.0.0

Dolittle

Dolittle is a decentralized, distributed, event-driven microservice platform built to harness the power of events.

This is our C# SDK, install it with:

dotnet add package Dolittle.SDK

Get Started

Want to try another language?

Issues and Contributing

Issues and contributions are always welcome!

To learn how to contribute, please read our contributing guide.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Dolittle.SDK.Microservices:

Package Downloads
Dolittle.SDK.Execution

Dolittle is a decentralized, distributed, event-driven microservice platform built to harness the power of events.
Dolittle.SDK

Dolittle is a decentralized, distributed, event-driven microservice platform built to harness the power of events.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
24.1.2 261 2/5/2025
24.1.1 228 2/3/2025
24.1.0 216 1/7/2025
24.0.0 205 11/13/2024
23.5.2 391 11/13/2024
23.5.1 431 11/7/2024
23.5.0 1,161 10/23/2024
23.4.0 562 10/2/2024
23.3.0 834 7/31/2024
23.2.5 817 6/20/2024
23.2.4 447 6/13/2024
23.2.3 401 6/10/2024
23.2.2 380 6/2/2024
23.2.1 398 5/16/2024
23.2.0 1,958 3/14/2024
23.1.0 536 3/12/2024
23.0.0 502 3/8/2024
22.1.3 677 2/26/2024
22.1.2 1,799 10/24/2023
22.1.1 1,021 10/4/2023
22.1.0 957 9/18/2023
22.0.5 1,048 9/7/2023
22.0.4 1,065 8/28/2023
22.0.3 1,147 8/15/2023
22.0.2 1,123 8/8/2023
22.0.1 1,045 8/8/2023
22.0.0 1,385 6/22/2023
22.0.0-arkenstone.1 85 6/21/2023
22.0.0-arkenstone.0 87 6/12/2023
21.0.2 1,207 9/7/2023
21.0.1 3,641 6/8/2023
21.0.0 1,456 6/2/2023
21.0.0-feanor.2 90 5/31/2023
21.0.0-feanor.1 1,156 5/30/2023
21.0.0-feanor.0 81 5/30/2023
20.2.0 4,931 1/23/2023
20.2.0-shire.17 118 1/19/2023
20.2.0-shire.16 124 1/16/2023
20.2.0-shire.15 123 1/12/2023
20.2.0-shire.14 112 1/12/2023
20.2.0-shire.13 114 1/12/2023
20.2.0-shire.12 145 1/11/2023
20.2.0-shire.11 107 1/10/2023
20.2.0-shire.10 114 1/6/2023
20.2.0-shire.9 197 1/6/2023
20.2.0-shire.8 107 1/6/2023
20.2.0-shire.7 113 1/6/2023
20.2.0-shire.6 118 1/5/2023
20.2.0-shire.5 124 1/5/2023
20.2.0-shire.4 117 1/5/2023
20.2.0-shire.3 118 1/5/2023
20.2.0-shire.2 129 12/26/2022
20.2.0-shire.1 118 12/26/2022
20.2.0-shire.0 116 12/26/2022
20.1.0 2,283 12/25/2022
20.1.0-faramir.1 113 12/12/2022
20.1.0-faramir.0 103 12/9/2022
20.0.2 2,973 12/13/2022
20.0.1 2,325 12/12/2022
20.0.0 2,347 12/8/2022
19.1.0-elrond.7 103 12/7/2022
19.1.0-elrond.6 103 12/5/2022
19.1.0-elrond.5 100 12/5/2022
19.1.0-elrond.4 102 12/2/2022
19.1.0-elrond.3 119 12/2/2022
19.1.0-elrond.2 106 11/29/2022
19.1.0-elrond.1 108 11/28/2022
19.1.0-elrond.0 104 11/28/2022
19.0.0 4,154 11/25/2022
19.0.0-proto.5 102 11/25/2022
19.0.0-proto.4 135 11/22/2022
19.0.0-proto.3 111 11/21/2022
19.0.0-proto.2 105 11/21/2022
19.0.0-proto.1 106 11/21/2022
19.0.0-proto.0 111 11/18/2022
18.2.0-bolt.1 104 11/16/2022
18.2.0-bolt.0 120 11/16/2022
18.1.1 5,124 10/31/2022
18.1.0 5,172 10/26/2022
18.0.1 5,333 10/20/2022
18.0.0 5,536 9/15/2022
17.2.3 5,552 9/9/2022
17.2.2 6,145 8/26/2022
17.2.1 6,358 8/10/2022
17.2.0 5,691 7/8/2022
17.1.2 5,536 7/7/2022
17.1.1 5,621 7/7/2022
17.1.0 5,489 7/5/2022
17.1.0-boromir.4 139 7/8/2022
17.1.0-boromir.3 125 7/5/2022
17.1.0-boromir.2 125 7/1/2022
17.1.0-boromir.1 126 7/1/2022
17.0.2 6,056 6/21/2022
17.0.0 8,873 3/25/2022
17.0.0-meriadoc.0 138 3/24/2022
16.0.1 5,768 3/22/2022
16.0.0 5,721 3/14/2022
15.1.3 5,717 3/8/2022
15.1.2 5,682 3/1/2022
15.1.1 5,691 2/11/2022
15.1.0 5,637 2/11/2022
15.0.1 5,786 2/10/2022
15.0.0 5,627 2/10/2022
14.2.0 5,649 2/9/2022
14.2.0-sam.2 132 2/9/2022
14.2.0-sam.1 120 2/7/2022
14.2.0-sam.0 131 2/7/2022
14.1.0 5,650 1/28/2022
14.0.0 5,757 1/25/2022
14.0.0-gollum.1 144 1/25/2022
14.0.0-gollum.0 139 1/24/2022
13.1.0-bilbo.4 143 1/24/2022
13.1.0-bilbo.3 136 1/24/2022
13.1.0-bilbo.2 131 1/21/2022
13.1.0-bilbo.1 137 1/21/2022
13.1.0-bilbo.0 140 1/21/2022
13.0.1 5,658 1/24/2022
13.0.0 5,711 1/20/2022
13.0.0-gimli.10 134 1/20/2022
13.0.0-gimli.9 177 1/19/2022
13.0.0-gimli.8 132 1/19/2022
13.0.0-gimli.7 135 1/18/2022
13.0.0-gimli.6 141 1/17/2022
13.0.0-gimli.5 138 1/17/2022
13.0.0-gimli.4 132 1/17/2022
13.0.0-gimli.3 158 12/7/2021
13.0.0-gimli.2 185 12/7/2021
13.0.0-gimli.1 185 12/7/2021
13.0.0-gimli.0 849 12/1/2021
12.1.0-gandalf.0 1,446 11/26/2021
12.0.0 4,239 11/18/2021
12.0.0-legolas.7 140 11/18/2021
12.0.0-legolas.6 162 11/16/2021
12.0.0-legolas.5 147 11/15/2021
12.0.0-legolas.4 151 11/15/2021
12.0.0-legolas.3 181 11/11/2021
12.0.0-legolas.2 165 11/10/2021
12.0.0-legolas.1 169 11/9/2021
12.0.0-legolas.0 154 11/9/2021
11.0.0 9,703 11/5/2021
11.0.0-aragorn.8 180 11/5/2021
11.0.0-aragorn.7 184 11/4/2021
11.0.0-aragorn.6 154 11/4/2021
11.0.0-aragorn.5 179 11/4/2021
11.0.0-aragorn.4 173 11/2/2021
11.0.0-aragorn.3 177 11/2/2021
11.0.0-aragorn.2 172 10/29/2021
11.0.0-aragorn.1 145 10/26/2021
11.0.0-aragorn.0 200 10/25/2021
10.1.0 3,621 10/21/2021
10.0.0 3,444 10/13/2021
10.0.0-eventsource.1 160 10/13/2021
10.0.0-eventsource.0 141 10/5/2021
9.2.0 8,960 9/29/2021
9.2.0-register-all.1 161 9/15/2021
9.2.0-register-all.0 154 9/7/2021
9.1.1 4,256 12/21/2021
9.1.0 7,543 7/14/2021
9.1.0-embeddings.0 154 7/5/2021
9.0.0 3,507 6/16/2021
8.5.0-timeout.4 1,377 6/4/2021
8.5.0-timeout.3 165 6/4/2021
8.5.0-timeout.2 215 5/31/2021
8.5.0-timeout.1 321 5/30/2021
8.5.0-timeout.0 248 5/29/2021
8.4.0 10,355 4/9/2021
8.4.0-projections.2 175 4/9/2021
8.4.0-projections.1 184 4/7/2021
8.4.0-projections.0 176 4/7/2021
8.3.2 4,715 3/24/2021
8.3.1 3,355 2/22/2021
8.3.0 3,246 2/17/2021
8.2.0 3,243 2/17/2021
8.1.1 3,260 2/14/2021
8.1.0 3,247 2/14/2021
8.1.0-updatedeps.0 203 1/20/2021
8.0.0 5,225 11/2/2020
7.0.0 3,073 10/28/2020
7.0.0-redpill.1 291 10/14/2020
7.0.0-redpill.0 350 10/13/2020
6.0.0 2,989 10/2/2020
6.0.0-rc.21 231 10/2/2020
6.0.0-rc.20 231 10/1/2020
6.0.0-rc.19 227 9/30/2020
6.0.0-rc.18 253 9/30/2020
6.0.0-rc.17 231 9/30/2020
6.0.0-rc.16 235 9/30/2020
6.0.0-rc.15 253 9/28/2020
6.0.0-rc.14 232 9/25/2020
6.0.0-rc.13 239 9/25/2020
6.0.0-rc.12 230 9/25/2020
6.0.0-rc.11 241 9/22/2020
6.0.0-rc.10 230 9/21/2020
6.0.0-rc.9 244 9/18/2020
6.0.0-rc.8 224 9/18/2020
6.0.0-rc.7 274 9/16/2020
6.0.0-rc.6 292 9/16/2020
6.0.0-rc.5 229 9/15/2020
6.0.0-rc.4 240 9/11/2020
6.0.0-rc.3 252 9/11/2020
6.0.0-rc.2 262 9/8/2020

Version 18.0.0:
Adds a new method to the EventStore for fetching committed aggregate events filtered by event types. This allows us to change the rehydration of aggregates to be much more effective by just fetching the committed aggregate events for an aggregate that are relevant to the rehydration (meaning that there are an On method for that event type). This can have a significant impact on the performance of aggregates that have many events, but few state changes or are completely stateless.

Added:
- FetchForAggregate that takes in a list event types used for filtering
- FetchStreamForAggregate fetches a stream of committed aggregate event batches

Changed:
- Rehydration logic of aggregate roots. It now only fetches the committed aggregate events that are relevant
- AggregateRootVersion on the CommittedAggregateEvents now represents the current aggregate root version of the aggregate root, not the version of the last committed aggregate event
- Minor version of Contracts meaning that this version of the SDK is only compatible with version >= 8.5.0 of the Runtime

Fixed:
- Some users could experience exceptions when performing actions on aggregate roots that had lots of events or big events due to the protobuf messages being too big. This should be fixed now since the internals of fetching aggregate roots are now implemented using streaming and batching.

Changelog:
For all release notes, see changelog (https://github.com/dolittle/DotNET.SDK/blob/master/CHANGELOG.md)