SpacetimeDB.Runtime 1.3.0

Prefix Reserved
dotnet add package SpacetimeDB.Runtime --version 1.3.0
                    
NuGet\Install-Package SpacetimeDB.Runtime -Version 1.3.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="SpacetimeDB.Runtime" Version="1.3.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SpacetimeDB.Runtime" Version="1.3.0" />
                    
Directory.Packages.props
<PackageReference Include="SpacetimeDB.Runtime" />
                    
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 SpacetimeDB.Runtime --version 1.3.0
                    
#r "nuget: SpacetimeDB.Runtime, 1.3.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.
#:package SpacetimeDB.Runtime@1.3.0
                    
#: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=SpacetimeDB.Runtime&version=1.3.0
                    
Install as a Cake Addin
#tool nuget:?package=SpacetimeDB.Runtime&version=1.3.0
                    
Install as a Cake Tool

SpacetimeDB.Runtime

This project contains the core SpacetimeDB SATS typesystem, attributes for the codegen as well as runtime bindings for SpacetimeDB WebAssembly modules.

The runtime bindings are currently implementing via Wasi.Sdk package, which is a .NET implementation of the WASI standard. This is likely to change in the future.

While not really documented, it allows to build raw WebAssembly modules with custom bindings as well, which is what we're using here. The process is somewhat complicated, but here are the steps:

  • bindings.c declares raw C bindings to the SpacetimeDB FFI imports and marks them with attributes like __attribute__((import_module("spacetime"), import_name("_insert"))) that make them WebAssembly imports. (unfortunately, function name duplication is currently unavoidable)
  • bindings.c implements a bunch of Mono-compatible wrappers that convert between Mono types and raw types expected by the SpacetimeDB FFI and invoke corresponding raw bindings.
  • Runtime.cs declares corresponding functions with compatible signatures for Mono-compatible wrappers to attach to. It marks them all with [MethodImpl(MethodImplOptions.InternalCall)].
  • bindings.c attaches all those Mono-compatible wrappers to their C# declarations in a mono_stdb_attach_bindings function.
  • bindings.c adds FFI-compatible exports that search for a method by assembly name, namespace, class name and a method name in the Mono runtime and invoke it. Those exports are marked with attributes like __attribute__((export_name("__call_reducer__"))) so that they're exported from Wasm by the linker.
  • Finally, bindings.c implements no-op shims for all the WASI APIs so that they're linked internally and not attempted to be imported from the runtime itself.

The result is a WebAssembly module FFI-compatible with SpacetimeDB and with no WASI imports, which is what we need.

Regenerating RawModuleDef

To regenenerate the Autogen folder, run:

cargo run -p spacetimedb-codegen --example regen-csharp-moduledef
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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.  net10.0 was computed.  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
1.3.0 84 8/1/2025
1.2.1 746 6/23/2025
1.2.0 236 6/17/2025
1.1.2 1,468 5/22/2025
1.1.1 1,749 4/22/2025
1.1.0 1,181 4/16/2025
1.0.1 802 3/15/2025
1.0.0 2,018 2/28/2025
1.0.0-rc3-hotfix3 94 1/24/2025
1.0.0-rc3-hotfix2 92 1/24/2025
1.0.0-rc3 109 1/14/2025
1.0.0-rc2 979 12/14/2024
1.0.0-rc1-hotfix1 104 11/12/2024
1.0.0-rc1 127 11/6/2024
0.12.0 980 10/4/2024
0.11.1 1,123 9/2/2024
0.11.0 959 8/6/2024
0.10.1 294 6/28/2024
0.10.0 168 6/13/2024
0.9.2 153 5/28/2024
0.9.0 154 5/22/2024
0.8.2 407 12/11/2023
0.8.2-naot-experimental 119 1/10/2024
0.8.1 177 12/7/2023
0.8.0 155 11/30/2023
0.7.2 212 10/11/2023
0.7.1 174 10/3/2023
0.7.0 307 9/12/2023
0.6.4 262 8/14/2023
0.6.3 220 8/8/2023
0.6.2 211 8/7/2023
0.6.1 253 8/2/2023
0.6.0 221 8/2/2023