// Copyright (C) 2024 Vaughn Nugent // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU Affero General Public License as // published by the Free Software Foundation, either version 3 of the // License, or (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Affero General Public License for more details. // // You should have received a copy of the GNU Affero General Public License // along with this program. If not, see . using System; using System.Reflection; using System.Runtime.CompilerServices; using System.Runtime.InteropServices; using static VNLib.Utils.Cryptography.Noscrypt.NoscryptLibrary; using NCResult = System.Int64; namespace VNLib.Utils.Cryptography.Noscrypt { public static class NCUtil { /// /// Gets a span of bytes from the current secret key /// structure /// /// /// The secret key data span public unsafe static Span AsSpan(this ref NCSecretKey key) { //Safe to cast secret key to bytes, then we can make a span to its memory ref byte asBytes = ref Unsafe.As(ref key); return MemoryMarshal.CreateSpan(ref asBytes, sizeof(NCSecretKey)); } /// /// Gets a span of bytes from the current public key /// structure /// /// /// The public key data as a data span public unsafe static Span AsSpan(this ref NCPublicKey key) { //Safe to cast secret key to bytes, then we can make a span to its memory ref byte asBytes = ref Unsafe.As(ref key); return MemoryMarshal.CreateSpan(ref asBytes, sizeof(NCPublicKey)); } /// /// Casts a span of bytes to a secret key reference. Note that /// the new structure reference will point to the same memory /// as the span. /// /// The secret key data /// A mutable secret key reference /// public unsafe static ref NCSecretKey AsSecretKey(Span span) { ArgumentOutOfRangeException.ThrowIfLessThan(span.Length, sizeof(NCSecretKey), nameof(span)); ref byte asBytes = ref MemoryMarshal.GetReference(span); return ref Unsafe.As(ref asBytes); } /// /// Casts a span of bytes to a public key reference. Note that /// the new structure reference will point to the same memory /// as the span. /// /// The public key data span /// A mutable reference to the public key structure /// public unsafe static ref NCPublicKey AsPublicKey(Span span) { ArgumentOutOfRangeException.ThrowIfLessThan(span.Length, sizeof(NCPublicKey), nameof(span)); ref byte asBytes = ref MemoryMarshal.GetReference(span); return ref Unsafe.As(ref asBytes); } /// /// Casts a read-only span of bytes to a secret key reference. Note that /// the new structure reference will point to the same memory as the span. /// /// The secret key data span /// A readonly refernce to the secret key structure /// public unsafe static ref readonly NCSecretKey AsSecretKey(ReadOnlySpan span) { ArgumentOutOfRangeException.ThrowIfLessThan(span.Length, sizeof(NCSecretKey), nameof(span)); ref byte asBytes = ref MemoryMarshal.GetReference(span); return ref Unsafe.As(ref asBytes); } /// /// Casts a read-only span of bytes to a public key reference. Note that /// the new structure reference will point to the same memory as the span. /// /// The public key data span /// A readonly reference to the public key structure /// public unsafe static ref readonly NCPublicKey AsPublicKey(ReadOnlySpan span) { ArgumentOutOfRangeException.ThrowIfLessThan(span.Length, sizeof(NCPublicKey), nameof(span)); ref byte asBytes = ref MemoryMarshal.GetReference(span); return ref Unsafe.As(ref asBytes); } internal static void CheckResult(NCResult result, bool raiseOnFailure) where T : Delegate { //Only negative values are errors if (result >= NC_SUCCESS) { return; } NCResult asPositive = -result; // Error code are only 8 bits, if an argument error occured, the // argument number will be in the next upper 8 bits byte errorCode = (byte)(asPositive & 0xFF); byte argNumber = (byte)((asPositive >> 8) & 0xFF); switch (errorCode) { case E_NULL_PTR: RaiseNullArgExceptionForArgumentNumber(argNumber); break; case E_INVALID_ARG: RaiseArgExceptionForArgumentNumber(argNumber); break; case E_ARGUMENT_OUT_OF_RANGE: RaiseOORExceptionForArgumentNumber(argNumber); break; case E_INVALID_CTX: throw new InvalidOperationException("The library context object is null or invalid"); case E_OPERATION_FAILED: RaiseOperationFailedException(raiseOnFailure); break; case E_VERSION_NOT_SUPPORTED: throw new NotSupportedException("The requested version is not supported"); default: if(raiseOnFailure) { throw new InvalidOperationException($"The operation failed for an unknown reason, code: {errorCode:x}"); } break; } } private static void RaiseOperationFailedException(bool raise) { if (raise) { throw new InvalidOperationException("The operation failed for an unknown reason"); } } private static void RaiseNullArgExceptionForArgumentNumber(int argNumber) where T : Delegate { //Get delegate parameters Type type = typeof(T); ParameterInfo arg = type.GetMethod("Invoke")!.GetParameters()[argNumber]; throw new ArgumentNullException(arg.Name, "Argument is null or invalid cannot continue"); } private static void RaiseArgExceptionForArgumentNumber(int argNumber) where T : Delegate { //Get delegate parameters Type type = typeof(T); ParameterInfo arg = type.GetMethod("Invoke")!.GetParameters()[argNumber]; throw new ArgumentException("Argument is null or invalid cannot continue", arg.Name); } private static void RaiseOORExceptionForArgumentNumber(int argNumber) where T : Delegate { //Get delegate parameters Type type = typeof(T); ParameterInfo arg = type.GetMethod("Invoke")!.GetParameters()[argNumber]; throw new ArgumentOutOfRangeException(arg.Name, "Argument is out of range of acceptable values"); } } }