SnowflakeGenerator

SnowflakeGenerator is a unique ID generator based on Twitter's Snowflake. It generates 64-bit, time-ordered, unique IDs based on the Snowflake algorithm. It is written in C# and is compatible with .NET Standard 2.0.

The default bit assignment for this Snowflake implementation is:

42 bits for the TimeStamp value 10 bits for the MachineID value 12 bits for Sequence value

This provides by default:

• A time range of approximately 139 years (2^42 milliseconds).
• Use of 1024 (2^10) unique MachineIDs across a distributed deployment.
• Generation for a maximum of 4096 (2^12) IDs per ms from a single Snowflake instance.

If you require a higher generation rate or large range of MachineID's these values can be customised by the Settings used to initialize a Snowflake instance.

NOTE: 42 bits is always reserved for the TimeStamp value. Therefore, the sum of the MachineIDBitLength and SequenceBitLength cannot exceed 22. With the SequenceBitLength being at least equal to 1.

Features

• Generates 64-bit unique IDs, which are time-ordered.
• Customizable machine ID and custom epoch settings.
• Thread-safe ID generation.
• High-performance and low-latency.

Installation

To install the SnowflakeGenerator library, you can use the following command in the Package Manager Console:

Install-Package SnowflakeGenerator

Alternatively, you can use the .NET CLI:

dotnet add package SnowflakeGenerator

Usage

First, import the SnowflakeGenerator namespace:

using SnowflakeGenerator;

Create a new instance of the Snowflake class with optional settings:

Settings settings = new Settings { MachineID = 1, CustomEpoch = new DateTimeOffset(2020, 1, 1, 0, 0, 0, TimeSpan.Zero) }; Snowflake snowflake = new Snowflake(settings);

Generate a new unique ID:

ulong id = snowflake.NextID();

Decode ID content:

var (timeStamp, machineId, sequence) = sonyflake.DecodeID(uniqueId);

NextID() will throw a TimestampOverflowException once it reaches the limit of the TimeStamp.

Settings

The Settings class allows you to customize the Snowflake instance: