NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet · #3022 most downloaded on NuGet
UUID is a cutting-edge library meticulously crafted for modern distributed systems, offering unparalleled performance and reliability in unique identifier generation. At its core, the library ensures thread safety while maintaining exceptional performance characteristics, making it ideal for high-throughput applications. It generates time-ordered identifiers that enable natural sorting capabilities, while incorporating cryptographic randomness for enhanced security. The library seamlessly integrates with existing systems through its comprehensive Guid compatibility and intuitive conversion operators. It excels in string handling with efficient parsing and formatting capabilities, supporting versatile encoding formats including Base32 and Base64. The implementation features robust comparison and equality operations, complemented by thread-local secure random generation for optimal performance and security. Built with modern development practices in mind, UUID maintains a compact 16-byte binary format and ensures cross-platform compatibility across the .NET ecosystem. The library is backed by extensive test coverage and performance benchmarks, making it a reliable choice for enterprise-grade applications requiring robust unique identifier generation.
Last release 1 months ago
06 Sep 2026
Ships unpredictably
gaps range from 2 weeks to 125.0 years
Most releases are documented
notes for 8 of 12 stable releases
7 versions withdrawn
withdrawn after publishing
127 years old
19 releases · first in 1900
UUID v1.1.2 - .NET 11 Support, Modernized Infrastructure & Dependency Updates 🚀
Modern UUID Generator for .NET - Now featuring .NET 11 and .NET Framework 4.8.1 support, xUnit v3 & Microsoft Testing Platform integration, solution modernization to .slnx, and updated ecosystem dependencies
UUID v1.1.2 expands ecosystem compatibility with official support for .NET 11 (net11.0), .NET 10 (net10.0), and .NET Framework 4.8.1 (net481), while modernizing test and build infrastructure with xUnit v3, Microsoft.Testing.Platform runner, and the new .slnx solution format. All serialization packages, benchmark suites, and demo applications have also been updated with the latest dependencies to ensure seamless integration and top-tier reliability across modern .NET workloads.
🌐 .NET 11 & Extended Framework Support:
.NET 11 (net11.0) target framework support across the core library, serialization modules, demos, and benchmarks.NET Framework 4.8.1 (net481) and .NET 10 (net10.0) target frameworks🧪 Modernized Testing & Build Architecture:
Microsoft.Testing.Platform runnerxUnit v3.sln to modern .slnx format[] and [with])📦 Dependency Updates & Serialization Upgrades:
MessagePack to version 3.1.8Dapper to version 2.1.79Newtonsoft.Json to version 13.0.5-beta1System.Text.Json to 11.0.0 preview / 9.0.5Microsoft.EntityFrameworkCore & Microsoft.EntityFrameworkCore.SqliteBenchmarkDotNet to version 0.15.0Microsoft.SourceLink.GitHub to latest previewConsole.ReadKey()) across all demo console applications.pages) dependencies (Vue, Vue Router, ESLint, Vite)# Core UUID Library
Install-Package UUID
# Serialization Packages
Install-Package UUID.Serialization.Dapper
Install-Package UUID.Serialization.Entity
Install-Package UUID.Serialization.System
Install-Package UUID.Serialization.Newtonsoft
Install-Package UUID.Serialization.MessagePackSpecial thanks to our community for feedback and continuous support! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
One column per quarter.
.NET 11 ( net11.0 ) target framework support across core library, serialization, benchmark, demo, and test projects
.NET Framework 4.8.1 ( net481 ) target framework support across library projects
.NET 10 ( net10.0 ) target framework support
Microsoft.Testing.Platform runner integration for test projects
Interactive exit prompt ( Console.ReadKey() ) in demo applications
Added dotnet11 package source feed to NuGet configuration
Migrated Visual Studio solution from classic .sln to modern .slnx format
Upgraded test projects to xUnit v3 ( xunit.v3 and xunit.runner.visualstudio 3.1.4)
Modernized codebase collection initializations using C# collection expressions ( [] and [with] )
Updated MessagePack package dependency to version 3.1.8
Updated Dapper package dependency to version 2.1.79
Updated Newtonsoft.Json package dependency to version 13.0.5-beta1
Updated System.Text.Json package dependency to version 11.0.0 preview / 9.0.5
Updated Microsoft.EntityFrameworkCore and Microsoft.EntityFrameworkCore.Sqlite dependencies
Updated BenchmarkDotNet to version 0.15.0
Updated Microsoft.SourceLink.GitHub to version 11.0.100-rc.2.26455.110
Updated GitHub Actions CI workflows for .NET 11 preview and .slnx build
Updated documentation web app ( .pages ) dependencies (Vue, Vue Router, ESLint, Vite)
Updated README documentation with updated .NET compatibility matrix and direct MIT license links
UUID v1.1.1 - Dapper & EF Core Integration, Enhanced Serialization & Performance 🚀
Modern UUID Generator for .NET - Now with comprehensive Dapper and Entity Framework Core support, enhanced serialization capabilities and performance optimizations
UUID v1.1.1 introduces Dapper and Entity Framework Core integration, extending the library's versatility beyond MessagePack, System.Text.Json and Newtonsoft.Json. This release focuses on database integration, usability improvements, and security enhancements while maintaining our commitment to performance and efficiency.
📏 Dapper Integration:
🔐 Entity Framework Core Support:
🔚 Security Enhancements:
🧰 API Expansions:
⚡ Performance Optimizations:
# Dapper Integration
Install-Package UUID.Serialization.Dapper
# Entity Framework Core Integration
Install-Package UUID.Serialization.EntitySpecial thanks to our community for security feedback and performance optimization suggestions! 🙅
For bug reports and feature requests, please use our GitHub Issues page.
Full Dapper serialization support via UUID.Serialization.Dapper package
Entity Framework Core integration via UUID.Serialization.Entity package
ReadOnlySpan support for Parse and TryParse methods
ToFormattedString method for hyphenated UUID format
SecureEquals methods for timing attack prevention
Empty property for zero-value UUID representation
Three different handlers for Dapper with Base64, Binary and String formats
Custom UUID converter for EF Core
Dapper and EF Core demonstration projects
Optimized random generation with secure batched buffer
Constant-time comparison operations
Enhanced protection against side-channel attacks
Improved random generation with secure batched buffer
Reduced memory allocations
Enhanced buffer management
Optimized comparison operations
Optimized converters for database operations
Expanded formatting and parsing capabilities
Improved error handling
UUID v1.1.0 - MessagePack Integration & Multi-Format Serialization ⚡
Modern UUID Generator for .NET - Now with comprehensive MessagePack support and enhanced serialization capabilities
UUID v1.1.0 introduces full MessagePack serialization support, complementing existing System.Text.Json and Newtonsoft.Json integrations. This release focuses on high-performance binary serialization while maintaining our commitment to security and efficiency.
📦 MessagePack Integration:
🚀 Performance Features:
🔄 Serialization Architecture:
Install-Package UUID.Serialization.MessagePackSpecial thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
Full MessagePack serialization support via UUID.Serialization.MessagePack package
Custom UUIDFormatter for efficient binary serialization
Thread-safe MessagePack resolver implementation
Comprehensive error handling for MessagePack operations
Binary format validation with detailed error messages
Zero-allocation deserialization path optimization
Support for complex object serialization with MessagePack
Efficient handling of UUID collections and dictionaries
Updated MessagePack package dependency to version 3.1.1
Optimized binary format representation for UUIDs
Enhanced thread safety in serialization operations
Implemented efficient binary serialization
Minimized memory allocations in serialization paths
Optimized byte array handling for better performance
Reduced data size with compact binary representation
UUID v1.0.9 - Advanced Security Comparison & Parallel Generation 📐
Modern UUID Generator for .NET - Now featuring secure equality comparisons and efficient parallel UUID generation capabilities
UUID v1.0.9 introduces secure equality comparison methods and powerful parallel UUID generation features, enhancing both security and performance for bulk UUID operations.
📐 Secure Equality Comparisons:
SecureEquals methods for timing-attack resistant comparisonsUUID.Empty for null-object pattern support⚄ Parallel Generation Features:
GenerateOrdered methods for bulk UUID creation🖧 Array Operations:
Install-Package UUIDSpecial thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
Added UUID.Empty property for null-object pattern support
Added SecureEquals methods for timing-attack resistant comparisons
Added GenerateOrdered methods for bulk UUID creation
Added FillParallel methods for efficient array operations
Implemented constant-time comparison methods
Enhanced protection against timing attacks
Added secure ordered generation capabilities
Optimized parallel UUID array generation
Added configurable threshold for parallel operations
Improved bulk generation efficiency
Enhanced array operations with timestamp support
Improved thread safety in parallel operations
UUID v1.0.8 - Enhanced Cryptographic Security & Performance 🛡️
Modern UUID Generator for .NET - Now with improved cryptographic security and optimized performance through batched random generation
UUID v1.0.8 introduces significant security and performance improvements in random number generation, ensuring both cryptographic security and high performance through an innovative batched buffer approach.
🛡️ Enhanced Cryptographic Security:
🚀 Performance Optimizations:
🔒 Security Architecture:
Install-Package UUIDSpecial thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
Replaced PRNG with true cryptographic random generation
Implemented direct use of RandomNumberGenerator for all UUID components
Enhanced thread isolation with thread-local buffers
Maintained full cryptographic security throughout the generation process
Implemented efficient batched random generation system
Reduced cryptographic operation calls by 128x through buffer reuse
Optimized thread-local buffer management
Minimized memory allocations with 1024-byte buffer strategy
Improved random number generation architecture
Enhanced thread-safety implementation
Updated buffer management system
Optimized variant bit handling
Modern UUID Generator for .NET - Now with enhanced compact UUID generation and improved performance
Modern UUID Generator for .NET - Now with enhanced compact UUID generation and improved performance
UUID v1.0.7 introduces enhanced compact UUID generation capabilities, offering better uniqueness guarantees and improved performance. This release focuses on providing more efficient UUID representations while maintaining security and reliability.
NewCompact() method for 12-character UUIDsNewCompactWithTime()Install-Package UUID// Generate compact UUID (12 characters)
var compactId = UUID.NewCompact();
Console.WriteLine(compactId.ToString()); // Compact format
// Generate time-based compact UUID
var timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
var timeBasedId = UUID.NewCompactWithTime(timestamp);
Console.WriteLine(timeBasedId.ToString()); // Time-based compact formatThe documentation is available at https://uuid.soferity.com featuring:
Thank you to all contributors who helped make this release possible! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
Updated documentation for NewCompact() and NewCompactWithTime() methods
New methods for generating UUIDs with 12 characters
Added probabilistic uniqueness warnings
Detailed usage scenarios
Specified limitations and recommendations
Optimized bit manipulation operations
Improved memory usage efficiency
Enhanced thread synchronization mechanisms
Reduced memory allocations in critical paths
Enhanced random value generation security
Improved thread-safety implementations
Added additional input validation checks
Enhanced error handling for edge cases
Added detailed usage examples for Compact UUID methods
Added explanations about uniqueness guarantees and limitations
Updated performance recommendations
Improved code organization and readability
Enhanced XML documentation coverage
Made error messages more descriptive
Updated API reference documentation
Nothing published for this version
UUID v1.0.5 - Serialization Support 📄
Modern UUID Generator for .NET - Now with comprehensive serialization support for both System.Text.Json and Newtonsoft.Json
UUID v1.0.5 introduces robust serialization support through two dedicated packages, making it even easier to integrate UUID with your JSON serialization needs. This release maintains our commitment to high performance and security while adding seamless serialization capabilities.
UUID.Serialization.SystemUUID.Serialization.NewtonsoftInstall-Package UUID# For System.Text.Json support
Install-Package UUID.Serialization.System
# For Newtonsoft.Json support
Install-Package UUID.Serialization.Newtonsoft// System.Text.Json
var options = new JsonSerializerOptions();
options.Converters.Add(new UUIDConverter());
var uuid = UUID.New();
string json = JsonSerializer.Serialize(uuid, options);
// Newtonsoft.Json
var settings = new JsonSerializerSettings();
settings.Converters.Add(new UUIDConverter());
string json = JsonConvert.SerializeObject(uuid, settings);The documentation is available at https://uuid.soferity.com featuring:
Thank you to all contributors who helped make this release possible! 👌
For bug reports and feature requests, please use our GitHub Issues page.
Added serialization support through two new packages:
UUID.Serialization.System for System.Text.Json
UUID.Serialization.Newtonsoft for Newtonsoft.Json
Added comprehensive serialization documentation
Added benchmark projects for serialization performance testing
Added serialization examples in wiki and documentation
Updated project structure to include serialization packages
Enhanced documentation with serialization guidelines
Nothing published for this version
Nothing published for this version
UUID v1.0.2 - Initial Release 🎉
Modern UUID Generator for .NET - High-performance, secure, and thread-safe UUID implementation
UUID is a modern, high-performance UUID (Universally Unique Identifier) generator designed specifically for the .NET ecosystem. It provides a robust implementation focusing on security, performance, and thread safety, making it ideal for distributed systems and high-throughput applications.
The documentation is now available at https://uuid.soferity.com featuring:
Install-Package UUIDvar id = new UUID();
// Different string formats
Console.WriteLine(id.ToString()); // Standard format
Console.WriteLine(id.ToBase32()); // Base32 format
Console.WriteLine(id.ToBase64()); // Base64 format
// Get raw bytes
byte[] bytes = id.ToByteArray();Thank you to all contributors who helped make this initial release possible! 👉
For bug reports and feature requests, please use our GitHub Issues page.
Initial release of UUID library
Basic UUID generation functionality
Thread-safe operations
Guid compatibility
String format support (Hex, Base32, Base64)
Comprehensive unit tests
Performance benchmarks
Enhanced documentation with detailed examples
Improved thread safety documentation
Added performance benchmarking guidelines
Minimum .NET SDK requirement set to 9.0
Development environment requirements updated
Updated wiki documentation to English
Improved code examples in documentation
Enhanced API reference documentation
Documentation formatting and consistency
Code sample syntax highlighting
Wiki page cross-references
Cryptographically secure random number generation
Thread-safe implementation
Secure string parsing
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →