Event sourcing · CQRS · Orleans
Build actors.
Keep the story.
Troolio gives .NET teams event-sourced actor primitives, durable projection handoffs, and provider adapters built around Microsoft Orleans.
10.0.8 available on NuGet · .NET 10 / Orleans 10
terminal / your-host
# Begin with the framework
$ dotnet add package Troolio.Core \
--version 10.0.8
# Add only the provider your host uses
$ dotnet add package Troolio.SqlServer \
--version 10.0.8
# Select and configure your serving route
$ dotnet build
The framework
One model for the full command journey.
Shape domain behavior around actors, events, and read models. Choose the store and integrations that fit your host.
01 / ACTORS
Actor state
Use Orleans actors as the boundary for event-sourced command handling.
Explore actors →02 / COMMITAtomic work
Commit selected participant events and required durable handoffs together through a compatible store.
Understand commits →03 / READ SIDEProjections
Process durable handoffs asynchronously to keep read models current.
See the boundary →How it fits
Follow a command.
Start with one actor and its event history. Add read models and advanced routes when the application needs them.
01 · CommandAsk an actor to make a change.
02 · DecideThe handler checks the request and emits events.
03 · StoreAppend accepted events to the stream.
04 · ReadRebuild state and update read models.
Choose your pieces
A small package family.
Start with Core. Add agent or storage integration only when your application needs it.
Designed for explicit host control. Installing a package does not select a production route. Your application supplies authentication, authorization, provider credentials, retention rules, and recovery operations. Read the host contract →