Release v1.1.0: Complete the WebSocket subscription surface with SubscribeSlotsUpdatesAsync (slot lifecycle with per-stage transaction stats) and SubscribeVotesAsync (gossip votes; requires --rpc-pubsub-enable-vote-subscription on the node), both unstable per Solana, with notification models, tests, and documentation across USAGE, README, changelog, and package metadata.

Author: jecacs

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to SolSharp are documented here. The format is loosely based
 [semantic versioning](https://semver.org) — from 1.0.0 breaking changes only come with a major
 version (on the earlier 0.x releases, minor versions could carry them).
 
+## [1.1.0]
+
+### Added
+
+- Two new WebSocket streams completing the subscription surface: `SubscribeSlotsUpdatesAsync`
+  (`slotsUpdatesSubscribe` — every stage of the slot lifecycle: shreds received, bank created, frozen
+  with per-slot transaction stats, optimistic confirmation, root, dead) and `SubscribeVotesAsync`
+  (`voteSubscribe` — gossip votes before they land in a block; requires a node started with
+  `--rpc-pubsub-enable-vote-subscription`). Both are parameterless `IAsyncEnumerable` streams like
+  `SubscribeSlotsAsync`, and both are marked unstable by Solana — the wire shape can change between
+  node versions.
+- New notification models: `SlotsUpdate` (+ `SlotsUpdateStats`) and `VoteNotification`.
+
 ## [1.0.1]
 
 Documentation-only release; no code changes.

CLAUDE.md

@@ -4,7 +4,7 @@ A lean, modern .NET SDK for Solana: RPC + WebSocket streaming, wire-level transa
 signing/building. Optimised for low latency and a small dependency footprint — it is a
 deliberate, focused alternative to the heavier general-purpose SDKs, not a clone of them.
 
-Status: 1.0.1, first stable release line (semver compatibility promise now applies to the public API). All four projects are in place: Core primitives (incl. a Borsh reader/writer), the Rpc client (reads + typed account state via `Mint`/`TokenAccount`/`NonceAccount` + Token-2022 extension decoding (`TokenExtensionSet`), `jsonParsed` transaction/block/account reads, the full current JSON-RPC HTTP read surface (deprecated getStakeActivation excluded), send/simulate, JSON-RPC batching via `RpcBatch`, typed transaction errors, multiplexed WebSocket streaming with auto-reconnect, DI + resilience), the Wallet (Ed25519 keys, signing, verification, key parsing, BIP-39/SLIP-0010 mnemonic derivation), and Programs (System/Token/ATA/Compute Budget/Memo + the Address Lookup Table program, PDA/ATA, legacy + v0 transaction building/signing/parsing, durable-nonce builder support, and instruction decompilation). As of 0.7.0 all JSON is source-generated (no reflection) and every assembly is Native AOT compatible (`IsAotCompatible`), with an AOT smoke sample published and run in CI. A separate live integration suite exercises the read and streaming paths against a real cluster.
+Status: 1.1.0, stable release line (semver compatibility promise now applies to the public API). All four projects are in place: Core primitives (incl. a Borsh reader/writer), the Rpc client (reads + typed account state via `Mint`/`TokenAccount`/`NonceAccount` + Token-2022 extension decoding (`TokenExtensionSet`), `jsonParsed` transaction/block/account reads, the full current JSON-RPC HTTP read surface (deprecated getStakeActivation excluded), send/simulate, JSON-RPC batching via `RpcBatch`, typed transaction errors, full WebSocket subscription surface (incl. unstable voteSubscribe/slotsUpdatesSubscribe) with auto-reconnect, DI + resilience), the Wallet (Ed25519 keys, signing, verification, key parsing, BIP-39/SLIP-0010 mnemonic derivation), and Programs (System/Token/ATA/Compute Budget/Memo + the Address Lookup Table program, PDA/ATA, legacy + v0 transaction building/signing/parsing, durable-nonce builder support, and instruction decompilation). As of 0.7.0 all JSON is source-generated (no reflection) and every assembly is Native AOT compatible (`IsAotCompatible`), with an AOT smoke sample published and run in CI. A separate live integration suite exercises the read and streaming paths against a real cluster.
 
 ## Commands
 

Directory.Build.props

@@ -18,7 +18,7 @@
   </PropertyGroup>
 
   <PropertyGroup Label="Package metadata">
-    <Version>1.0.1</Version>
+    <Version>1.1.0</Version>
     <Authors>Yevhen Koval</Authors>
     <Product>SolSharp</Product>
     <Title>SolSharp — Solana SDK for .NET</Title>

README.md

@@ -145,10 +145,11 @@ bool ok = PublicKey.TryParse(input, out var key);
 - `GetParsedTransactionAsync` / `GetParsedBlockAsync` / `GetParsedAccountInfoAsync` return the node's
   `jsonParsed` decoding — typed instructions, token balances, account state, and logs without local Borsh
   work — each instruction keeping both its parsed form and its raw program id / accounts / data.
-- WebSocket streaming multiplexed over one connection: `SubscribeSlotsAsync` and `SubscribeRootsAsync`
-  (`IAsyncEnumerable`), `SubscribeLogsAsync`, `SubscribeAccountAsync`, `SubscribeParsedAccountAsync`, `SubscribeProgramAsync`,
-  `SubscribeSignatureAsync`, `SubscribeBlocksAsync`, and `SubscribeParsedBlocksAsync` (`ChannelReader`), with
-  automatic reconnect and resubscribe across dropped connections.
+- WebSocket streaming multiplexed over one connection: `SubscribeSlotsAsync`, `SubscribeRootsAsync`,
+  `SubscribeSlotsUpdatesAsync` (slot lifecycle with per-stage stats), and `SubscribeVotesAsync` (gossip
+  votes) as `IAsyncEnumerable`; `SubscribeLogsAsync`, `SubscribeAccountAsync`, `SubscribeParsedAccountAsync`,
+  `SubscribeProgramAsync`, `SubscribeSignatureAsync`, `SubscribeBlocksAsync`, and `SubscribeParsedBlocksAsync`
+  (`ChannelReader`) — with automatic reconnect and resubscribe across dropped connections.
 - DI registration with a built-in resilience pipeline (retry on transient errors and HTTP 429), plus
   `AddSolanaWs` for a container-managed streaming client.
 - JSON-RPC batching — `CreateBatch()` queues reads (and sends) and submits them in one HTTP round-trip.

docs/USAGE.md

@@ -697,6 +697,21 @@ Also available: `SubscribeRootsAsync` (rooted slots, like `SubscribeSlotsAsync`)
 streams `SubscribeParsedBlocksAsync` / `SubscribeParsedAccountAsync`. Cancel any channel subscription by
 cancelling the `CancellationToken` you pass in.
 
+Two more streams cover the slot lifecycle in depth — both are marked *unstable* by Solana, so their
+wire shape can change between node versions:
+
+```csharp
+// Every stage a slot moves through: firstShredReceived, createdBank, frozen (with
+// transaction stats), optimisticConfirmation, root, dead. Richer than SubscribeSlotsAsync:
+await foreach (var update in ws.SubscribeSlotsUpdatesAsync())
+    Console.WriteLine($"{update.Slot} {update.Type} fails={update.Stats?.NumFailedTransactions}");
+
+// Votes as they arrive in gossip, before they land in a block. The node must run with
+// --rpc-pubsub-enable-vote-subscription, otherwise the subscribe is rejected:
+await foreach (var vote in ws.SubscribeVotesAsync())
+    Console.WriteLine($"{vote.VotePubkey} voted on {vote.Slots[^1]}");
+```
+
 The reconnect policy is tunable through `SolanaWsClientOptions`: `AutoReconnect` (on by default), the
 `ReconnectInitialDelay` → `ReconnectMaxDelay` exponential backoff, and `MaxReconnectAttempts` (`0` retries
 forever). When the attempts are exhausted — or auto-reconnect is off — every subscription completes with the

src/SolSharp.Rpc/Protocol/SolanaJsonContext.cs

@@ -90,6 +90,8 @@ namespace SolSharp.Rpc.Protocol;
 [JsonSerializable(typeof(RpcResponse<PublicKey>))]
 // WebSocket notification payloads (SubscriptionSink roots).
 [JsonSerializable(typeof(SlotInfo))]
+[JsonSerializable(typeof(VoteNotification))]
+[JsonSerializable(typeof(SlotsUpdate))]
 [JsonSerializable(typeof(RpcContextValue<LogInfo>))]
 [JsonSerializable(typeof(RpcContextValue<AccountInfo>))]
 [JsonSerializable(typeof(RpcContextValue<ParsedAccountInfo>))]

src/SolSharp.Rpc/Streaming/SlotsUpdate.cs

@@ -0,0 +1,59 @@
+using System.Text.Json.Serialization;
+
+namespace SolSharp.Rpc.Streaming;
+
+/// <summary>
+/// A slot-lifecycle notification payload from <c>slotsUpdatesSubscribe</c> - one update per stage a
+/// slot moves through (see <see cref="Type"/>).
+/// </summary>
+/// <seealso href="https://solana.com/docs/rpc/websocket/slotsupdatessubscribe">slotsUpdatesSubscribe</seealso>
+public sealed record SlotsUpdate
+{
+    /// <summary>The slot the update is about.</summary>
+    [JsonPropertyName("slot")]
+    public ulong Slot { get; init; }
+
+    /// <summary>
+    /// The update type: <c>firstShredReceived</c>, <c>completed</c>, <c>createdBank</c>, <c>frozen</c>,
+    /// <c>dead</c>, <c>optimisticConfirmation</c>, or <c>root</c>. Kept as a string so new node-side
+    /// stages do not break deserialization.
+    /// </summary>
+    [JsonPropertyName("type")]
+    public string Type { get; init; } = string.Empty;
+
+    /// <summary>The update's Unix timestamp in milliseconds.</summary>
+    [JsonPropertyName("timestamp")]
+    public long Timestamp { get; init; }
+
+    /// <summary>The parent slot; only present on <c>createdBank</c> updates.</summary>
+    [JsonPropertyName("parent")]
+    public ulong? Parent { get; init; }
+
+    /// <summary>Why the slot died; only present on <c>dead</c> updates.</summary>
+    [JsonPropertyName("err")]
+    public string? Error { get; init; }
+
+    /// <summary>Transaction counts for the slot; only present on <c>frozen</c> updates.</summary>
+    [JsonPropertyName("stats")]
+    public SlotsUpdateStats? Stats { get; init; }
+}
+
+/// <summary>The per-slot transaction counts attached to a <c>frozen</c> <see cref="SlotsUpdate"/>.</summary>
+public sealed record SlotsUpdateStats
+{
+    /// <summary>The number of transaction entries in the slot.</summary>
+    [JsonPropertyName("numTransactionEntries")]
+    public ulong NumTransactionEntries { get; init; }
+
+    /// <summary>The number of successful transactions in the slot.</summary>
+    [JsonPropertyName("numSuccessfulTransactions")]
+    public ulong NumSuccessfulTransactions { get; init; }
+
+    /// <summary>The number of failed transactions in the slot.</summary>
+    [JsonPropertyName("numFailedTransactions")]
+    public ulong NumFailedTransactions { get; init; }
+
+    /// <summary>The largest number of transactions in a single entry.</summary>
+    [JsonPropertyName("maxTransactionsPerEntry")]
+    public ulong MaxTransactionsPerEntry { get; init; }
+}

src/SolSharp.Rpc/Streaming/SolanaWsClient.cs

@@ -112,6 +112,32 @@ public IAsyncEnumerable<SlotInfo> SubscribeSlotsAsync(CancellationToken cancella
     public IAsyncEnumerable<ulong> SubscribeRootsAsync(CancellationToken cancellationToken = default)
         => SubscribeAsync<ulong>("rootSubscribe", [], "rootUnsubscribe", cancellationToken);
 
+    /// <summary>
+    /// Subscribes to new votes observed in gossip, before they land in a block. Ending the enumeration
+    /// sends the matching unsubscribe. This subscription is marked unstable by Solana and is only
+    /// available on nodes started with <c>--rpc-pubsub-enable-vote-subscription</c>; on other nodes the
+    /// subscribe call is rejected.
+    /// See <see href="https://solana.com/docs/rpc/websocket/votesubscribe">voteSubscribe</see>.
+    /// </summary>
+    /// <param name="cancellationToken">Stops the subscription when cancelled.</param>
+    /// <returns>An async stream of vote notifications.</returns>
+    /// <exception cref="InvalidOperationException">Surfaced during enumeration if the connection closes or the node rejects the subscription (for example, when vote subscriptions are not enabled).</exception>
+    public IAsyncEnumerable<VoteNotification> SubscribeVotesAsync(CancellationToken cancellationToken = default)
+        => SubscribeAsync<VoteNotification>("voteSubscribe", [], "voteUnsubscribe", cancellationToken);
+
+    /// <summary>
+    /// Subscribes to slot-lifecycle updates - one notification per stage a slot moves through
+    /// (shreds received, bank created, frozen, optimistically confirmed, rooted, or dead), richer and
+    /// more frequent than <see cref="SubscribeSlotsAsync"/>. Ending the enumeration sends the matching
+    /// unsubscribe. This subscription is marked unstable by Solana.
+    /// See <see href="https://solana.com/docs/rpc/websocket/slotsupdatessubscribe">slotsUpdatesSubscribe</see>.
+    /// </summary>
+    /// <param name="cancellationToken">Stops the subscription when cancelled.</param>
+    /// <returns>An async stream of slot-lifecycle updates.</returns>
+    /// <exception cref="InvalidOperationException">Surfaced during enumeration if the connection closes or the node rejects the subscription.</exception>
+    public IAsyncEnumerable<SlotsUpdate> SubscribeSlotsUpdatesAsync(CancellationToken cancellationToken = default)
+        => SubscribeAsync<SlotsUpdate>("slotsUpdatesSubscribe", [], "slotsUpdatesUnsubscribe", cancellationToken);
+
     /// <summary>
     /// Subscribes to transaction logs mentioning <paramref name="program"/>, delivered through a channel.
     /// Cancelling <paramref name="cancellationToken"/> unsubscribes and completes the channel.

src/SolSharp.Rpc/Streaming/VoteNotification.cs

@@ -0,0 +1,32 @@
+using System.Text.Json.Serialization;
+using SolSharp.Core.Primitives;
+
+namespace SolSharp.Rpc.Streaming;
+
+/// <summary>
+/// A new-vote notification payload from <c>voteSubscribe</c> - a vote observed in gossip before it
+/// lands in a block.
+/// </summary>
+/// <seealso href="https://solana.com/docs/rpc/websocket/votesubscribe">voteSubscribe</seealso>
+public sealed record VoteNotification
+{
+    /// <summary>The identity of the voting validator.</summary>
+    [JsonPropertyName("votePubkey")]
+    public PublicKey VotePubkey { get; init; }
+
+    /// <summary>The slots the vote covers.</summary>
+    [JsonPropertyName("slots")]
+    public IReadOnlyList<ulong> Slots { get; init; } = [];
+
+    /// <summary>The hash the vote is for (base58).</summary>
+    [JsonPropertyName("hash")]
+    public string Hash { get; init; } = string.Empty;
+
+    /// <summary>The vote's Unix timestamp in seconds, when the validator attached one.</summary>
+    [JsonPropertyName("timestamp")]
+    public long? Timestamp { get; init; }
+
+    /// <summary>The signature of the transaction carrying the vote (base58).</summary>
+    [JsonPropertyName("signature")]
+    public string Signature { get; init; } = string.Empty;
+}

src/SolSharp/SolSharp.csproj

@@ -5,7 +5,7 @@
     <PackageId>SolSharp</PackageId>
     <IsPackable>true</IsPackable>
     <Description>A lean, Native AOT-ready .NET 8 SDK for Solana — source-generated JSON, no reflection, trimmable, compiles to a native binary. The full JSON-RPC HTTP read surface, send/simulate, and multiplexed WebSocket streaming; Ed25519 keys and signing; SPL Token, PDA, and ATA helpers; and spec-accurate legacy and v0 (versioned) transaction building, signing, and decoding — every wire format checked byte-for-byte against the Rust solana-sdk. Ships as one package bundling the Core, Wallet, Rpc, and Programs assemblies.</Description>
-    <PackageReleaseNotes>1.0.1 — documentation release, no code changes. Fixes the package README rendering on nuget.org (the page showed raw HTML from the GitHub README; the package now ships a dedicated markdown-only README) and expands the usage guide with a Native AOT publishing section plus examples for signature-history paging, block walking, data-driven priority fees, and the node/cluster basics. 1.0.0 recap — the first stable release: the full current Solana JSON-RPC HTTP read surface (19 methods added), all JSON source-generated (no reflection), every assembly Native AOT compatible, and the public API under the semver compatibility promise. Changelog: https://github.com/jecacs/SolSharp/blob/main/CHANGELOG.md</PackageReleaseNotes>
+    <PackageReleaseNotes>1.1.0 — completes the WebSocket subscription surface with two new IAsyncEnumerable streams: SubscribeSlotsUpdatesAsync (slotsUpdatesSubscribe — the full slot lifecycle: shreds received, bank created, frozen with per-slot transaction stats, optimistic confirmation, root, dead) and SubscribeVotesAsync (voteSubscribe — gossip votes before they land in a block; the node must run with --rpc-pubsub-enable-vote-subscription). Both are marked unstable by Solana. New models: SlotsUpdate, SlotsUpdateStats, VoteNotification. No breaking changes. Changelog: https://github.com/jecacs/SolSharp/blob/main/CHANGELOG.md</PackageReleaseNotes>
     <TargetsForTfmSpecificBuildOutput>$(TargetsForTfmSpecificBuildOutput);BundleProjectReferences</TargetsForTfmSpecificBuildOutput>
   </PropertyGroup>