Merge pull request #77 from onixbyte/feature/rename-modules

feat: rename modules
2025-06-17 17:57:19 +08:00
parent 6793e90331 c48577544a
commit 7ea6646e89
80 changed files with 564 additions and 408 deletions
@@ -64,14 +64,14 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("devkitUtils") {
+        create<MavenPublication>("commonToolbox") {
            groupId = group.toString()
-            artifactId = "devkit-utils"
+            artifactId = "common-toolbox"
            version = artefactVersion

            pom {
                name = "OnixByte Common Toolbox"
-                description = "The utils module of JDevKit."
+                description = "The utils module of OnixByte toolbox."
                url = projectUrl

                licenses {
@@ -82,8 +82,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -107,7 +107,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["devkitUtils"])
+                sign(publishing.publications["commonToolbox"])
            }
        }

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import javax.crypto.Cipher;
 import javax.crypto.spec.IvParameterSpec;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.Arrays;
 import java.util.Objects;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.Objects;
 import java.util.function.BooleanSupplier;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.ArrayList;
 import java.util.Collection;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.Map;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.Map;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import java.util.stream.IntStream;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.devkit.utils;
+package com.onixbyte.common.util;

 import org.junit.jupiter.api.Test;

@@ -68,9 +68,9 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("keyPairLoader") {
+        create<MavenPublication>("cryptoToolbox") {
            groupId = group.toString()
-            artifactId = "key-pair-loader"
+            artifactId = "crypto-toolbox"
            version = artefactVersion

            pom {
@@ -87,8 +87,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -112,7 +112,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["keyPairLoader"])
+                sign(publishing.publications["cryptoToolbox"])
            }
        }

@@ -0,0 +1,40 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto;
+
+import java.security.PrivateKey;
+
+/**
+ * The {@code PrivateKeyLoader} interface provides utility methods for loading keys pairs from
+ * PEM-formatted key text. This class supports loading both private and public keys.
+ *
+ * @author zihluwang
+ * @author siujamo
+ * @version 2.0.0
+ * @since 1.6.0
+ */
+public interface PrivateKeyLoader {
+
+    /**
+     * Load private key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PrivateKey loadPrivateKey(String pemKeyText);
+}
@@ -0,0 +1,75 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto;
+
+import com.onixbyte.crypto.exception.KeyLoadingException;
+
+import java.security.PublicKey;
+import java.security.interfaces.ECPublicKey;
+import java.security.interfaces.RSAPublicKey;
+
+/**
+ *
+ * @author siujamo
+ * @version 3.0.0
+ */
+public interface PublicKeyLoader {
+
+    /**
+     * Load public key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     */
+    PublicKey loadPublicKey(String pemKeyText);
+
+    /**
+     * Loads an EC public key using the provided x and y coordinates together with the curve name.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an EC public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param xHex      the hexadecimal string representing the x coordinate of the EC point
+     * @param yHex      the hexadecimal string representing the y coordinate of the EC point
+     * @param curveName the name of the elliptic curve
+     * @return the loaded {@link ECPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default ECPublicKey loadPublicKey(String xHex, String yHex, String curveName) {
+        throw new KeyLoadingException("This key loader does not support loading an EC public key.");
+    }
+
+    /**
+     * Loads an RSA public key using the provided modulus and exponent.
+     * <p>
+     * This default implementation throws a {@link KeyLoadingException} to signify that this key
+     * loader does not support loading an RSA public key. Implementing classes are expected to
+     * override this method to supply their own loading logic.
+     *
+     * @param modulus  the modulus value of the RSA public key, usually represented in hexadecimal
+     *                 or Base64 string format
+     * @param exponent the public exponent value of the RSA public key, usually represented in
+     *                 hexadecimal or Base64 string format
+     * @return the loaded {@link RSAPublicKey} instance
+     * @throws KeyLoadingException if loading is not supported or fails
+     */
+    default RSAPublicKey loadPublicKey(String modulus, String exponent) {
+        throw new KeyLoadingException("This key loader does not support loading an RSA public key.");
+    }
+}
@@ -0,0 +1,102 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.algorithm.ecdsa;
+
+import com.onixbyte.crypto.PrivateKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
+
+import java.math.BigInteger;
+import java.security.AlgorithmParameters;
+import java.security.KeyFactory;
+import java.security.NoSuchAlgorithmException;
+import java.security.interfaces.ECPrivateKey;
+import java.security.interfaces.ECPublicKey;
+import java.security.spec.*;
+import java.util.Base64;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Key pair loader for loading key pairs for ECDSA-based algorithms.
+ * <p>
+ *
+ * <b>Example usage for ECDSA:</b>
+ * <pre>{@code
+ * PrivateKeyLoader keyLoader = new EcKeyLoader();
+ * String pemPrivateKey = """
+ *                        -----BEGIN EC PRIVATE KEY-----
+ *                        ...
+ *                        -----END EC PRIVATE KEY-----""";
+ * ECPrivateKey privateKey = PrivateKeyLoader.loadEcdsaPrivateKey(pemPrivateKey);
+ *
+ * String pemPublicKey = """
+ *                       -----BEGIN EC PUBLIC KEY-----
+ *                       ...
+ *                       -----END EC PUBLIC KEY-----""";
+ * ECPublicKey publicKey = PrivateKeyLoader.loadPublicKey(pemPublicKey);
+ * }</pre>
+ *
+ * @author zihluwang
+ * @version 2.0.0
+ * @since 2.0.0
+ */
+public class ECPrivateKeyLoader implements PrivateKeyLoader {
+
+    private final KeyFactory keyFactory;
+
+    private final Base64.Decoder decoder;
+
+    /**
+     * Initialise a key loader for EC-based algorithms.
+     */
+    public ECPrivateKeyLoader() {
+        try {
+            this.keyFactory = KeyFactory.getInstance("EC");
+            this.decoder = Base64.getDecoder();
+        } catch (NoSuchAlgorithmException e) {
+            throw new KeyLoadingException(e);
+        }
+    }
+
+    /**
+     * Load ECDSA private key from pem-formatted key text.
+     *
+     * @param pemKeyText pem-formatted key text
+     * @return loaded private key
+     * @throws KeyLoadingException if the generated key is not a {@link ECPrivateKey} instance,
+     *                             or EC Key Factory is not loaded, or key spec is invalid
+     */
+    @Override
+    public ECPrivateKey loadPrivateKey(String pemKeyText) {
+        try {
+            pemKeyText = CryptoUtil.getRawContent(pemKeyText);
+            var decodedKeyString = decoder.decode(pemKeyText);
+            var keySpec = new PKCS8EncodedKeySpec(decodedKeyString);
+
+            var _key = keyFactory.generatePrivate(keySpec);
+            if (_key instanceof ECPrivateKey privateKey) {
+                return privateKey;
+            } else {
+                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
+            }
+        } catch (InvalidKeySpecException e) {
+            throw new KeyLoadingException("Key spec is invalid.", e);
+        }
+    }
+}
@@ -15,10 +15,11 @@
 * limitations under the License.
 */

-package com.onixbyte.security.impl;
+package com.onixbyte.crypto.algorithm.ecdsa;

-import com.onixbyte.security.KeyLoader;
-import com.onixbyte.security.exception.KeyLoadingException;
+import com.onixbyte.crypto.PublicKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;

 import java.math.BigInteger;
 import java.security.AlgorithmParameters;
@@ -31,47 +32,23 @@ import java.util.Base64;
 import java.util.HashSet;
 import java.util.Set;

-/**
- * Key pair loader for loading key pairs for ECDSA-based algorithms.
- * <p>
- *
- * <b>Example usage for ECDSA:</b>
- * <pre>{@code
- * KeyLoader keyLoader = new EcKeyLoader();
- * String pemPrivateKey = """
- *                        -----BEGIN EC PRIVATE KEY-----
- *                        ...
- *                        -----END EC PRIVATE KEY-----""";
- * ECPrivateKey privateKey = KeyLoader.loadEcdsaPrivateKey(pemPrivateKey);
- *
- * String pemPublicKey = """
- *                       -----BEGIN EC PUBLIC KEY-----
- *                       ...
- *                       -----END EC PUBLIC KEY-----""";
- * ECPublicKey publicKey = KeyLoader.loadPublicKey(pemPublicKey);
- * }</pre>
- *
- * @author zihluwang
- * @version 2.0.0
- * @since 2.0.0
- */
-public class ECKeyLoader implements KeyLoader {
+public class ECPublicKeyLoader implements PublicKeyLoader {
+
+    /**
+     * Supported curves.
+     */
+    public static final Set<String> SUPPORTED_CURVES = new HashSet<>(Set.of(
+        "secp256r1", "secp384r1", "secp521r1", "secp224r1"
+    ));

    private final KeyFactory keyFactory;

    private final Base64.Decoder decoder;

-    /**
-     * Supported curves.
-     */
-    public static final Set<String> SUPPORTED_CURVES = new HashSet<>(Set.of(
-            "secp256r1", "secp384r1", "secp521r1", "secp224r1"
-    ));
-
    /**
     * Initialise a key loader for EC-based algorithms.
     */
-    public ECKeyLoader() {
+    public ECPublicKeyLoader() {
        try {
            this.keyFactory = KeyFactory.getInstance("EC");
            this.decoder = Base64.getDecoder();
@@ -80,32 +57,6 @@ public class ECKeyLoader implements KeyLoader {
        }
    }

-    /**
-     * Load ECDSA private key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     * @throws KeyLoadingException if the generated key is not a {@link ECPrivateKey} instance,
-     *                             or EC Key Factory is not loaded, or key spec is invalid
-     */
-    @Override
-    public ECPrivateKey loadPrivateKey(String pemKeyText) {
-        try {
-            pemKeyText = getRawContent(pemKeyText);
-            var decodedKeyString = decoder.decode(pemKeyText);
-            var keySpec = new PKCS8EncodedKeySpec(decodedKeyString);
-
-            var _key = keyFactory.generatePrivate(keySpec);
-            if (_key instanceof ECPrivateKey privateKey) {
-                return privateKey;
-            } else {
-                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
-            }
-        } catch (InvalidKeySpecException e) {
-            throw new KeyLoadingException("Key spec is invalid.", e);
-        }
-    }
-
    /**
     * Load public key from pem-formatted key text.
     *
@@ -117,7 +68,7 @@ public class ECKeyLoader implements KeyLoader {
    @Override
    public ECPublicKey loadPublicKey(String pemKeyText) {
        try {
-            pemKeyText = getRawContent(pemKeyText);
+            pemKeyText = CryptoUtil.getRawContent(pemKeyText);
            var keyBytes = decoder.decode(pemKeyText);
            var spec = new X509EncodedKeySpec(keyBytes);
            var key = keyFactory.generatePublic(spec);
@@ -0,0 +1,102 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.algorithm.rsa;
+
+import com.onixbyte.crypto.PrivateKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;
+
+import java.math.BigInteger;
+import java.security.KeyFactory;
+import java.security.NoSuchAlgorithmException;
+import java.security.interfaces.RSAPrivateKey;
+import java.security.interfaces.RSAPublicKey;
+import java.security.spec.*;
+import java.util.Base64;
+
+/**
+ * A class responsible for loading RSA keys from PEM formatted text.
+ * <p>
+ * This class implements the {@link PrivateKeyLoader} interface and provides methods to load both private
+ * and public RSA keys. The keys are expected to be in the standard PEM format, which includes
+ * Base64-encoded key content surrounded by header and footer lines. The class handles the decoding
+ * of Base64 content and the generation of keys using the RSA key factory.
+ * <p>
+ * Any exceptions encountered during the loading process are encapsulated in a
+ * {@link KeyLoadingException}, allowing for flexible error handling.
+ *
+ * @author siujamo
+ * @see PrivateKeyLoader
+ * @see KeyLoadingException
+ */
+public class RSAPrivateKeyLoader implements PrivateKeyLoader {
+
+    private final Base64.Decoder decoder;
+
+    private final KeyFactory keyFactory;
+
+    /**
+     * Constructs an instance of {@code RsaKeyLoader}.
+     * <p>
+     * This constructor initialises the Base64 decoder and the RSA {@link KeyFactory}. It may throw
+     * a {@link KeyLoadingException} if the RSA algorithm is not available.
+     */
+    public RSAPrivateKeyLoader() {
+        try {
+            this.decoder = Base64.getDecoder();
+            this.keyFactory = KeyFactory.getInstance("RSA");
+        } catch (NoSuchAlgorithmException e) {
+            throw new KeyLoadingException(e);
+        }
+    }
+
+    /**
+     * Loads an RSA private key from a given PEM formatted key text.
+     * <p>
+     * This method extracts the raw key content from the provided PEM text, decodes the
+     * Base64-encoded content, and generates an instance of {@link RSAPrivateKey}. If the key cannot
+     * be loaded due to invalid specifications or types, a {@link KeyLoadingException} is thrown.
+     *
+     * @param pemKeyText the PEM formatted private key text
+     * @return an instance of {@link RSAPrivateKey}
+     * @throws KeyLoadingException if the key loading process encounters an error
+     */
+    @Override
+    public RSAPrivateKey loadPrivateKey(String pemKeyText) {
+        // Extract the raw key content
+        var rawKeyContent = CryptoUtil.getRawContent(pemKeyText);
+
+        // Decode the Base64-encoded content
+        var keyBytes = decoder.decode(rawKeyContent);
+
+        // Create a PKCS8EncodedKeySpec from the decoded bytes
+        var keySpec = new PKCS8EncodedKeySpec(keyBytes);
+
+        try {
+            // Get an RSA KeyFactory and generate the private key
+            var _key = keyFactory.generatePrivate(keySpec);
+            if (_key instanceof RSAPrivateKey key) {
+                return key;
+            } else {
+                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
+            }
+        } catch (InvalidKeySpecException e) {
+            throw new KeyLoadingException("Key spec is invalid.", e);
+        }
+    }
+}
@@ -15,35 +15,23 @@
 * limitations under the License.
 */

-package com.onixbyte.security.impl;
+package com.onixbyte.crypto.algorithm.rsa;

-import com.onixbyte.security.KeyLoader;
-import com.onixbyte.security.exception.KeyLoadingException;
+import com.onixbyte.crypto.PublicKeyLoader;
+import com.onixbyte.crypto.exception.KeyLoadingException;
+import com.onixbyte.crypto.util.CryptoUtil;

 import java.math.BigInteger;
 import java.security.KeyFactory;
 import java.security.NoSuchAlgorithmException;
-import java.security.interfaces.RSAPrivateKey;
 import java.security.interfaces.RSAPublicKey;
-import java.security.spec.*;
+import java.security.spec.InvalidKeySpecException;
+import java.security.spec.KeySpec;
+import java.security.spec.RSAPublicKeySpec;
+import java.security.spec.X509EncodedKeySpec;
 import java.util.Base64;

-/**
- * A class responsible for loading RSA keys from PEM formatted text.
- * <p>
- * This class implements the {@link KeyLoader} interface and provides methods to load both private
- * and public RSA keys. The keys are expected to be in the standard PEM format, which includes
- * Base64-encoded key content surrounded by header and footer lines. The class handles the decoding
- * of Base64 content and the generation of keys using the RSA key factory.
- * <p>
- * Any exceptions encountered during the loading process are encapsulated in a
- * {@link KeyLoadingException}, allowing for flexible error handling.
- *
- * @author siujamo
- * @see KeyLoader
- * @see KeyLoadingException
- */
-public class RSAKeyLoader implements KeyLoader {
+public class RSAPublicKeyLoader implements PublicKeyLoader {

    private final Base64.Decoder decoder;

@@ -57,7 +45,7 @@ public class RSAKeyLoader implements KeyLoader {
     * This constructor initialises the Base64 decoder and the RSA {@link KeyFactory}. It may throw
     * a {@link KeyLoadingException} if the RSA algorithm is not available.
     */
-    public RSAKeyLoader() {
+    public RSAPublicKeyLoader() {
        try {
            this.decoder = Base64.getDecoder();
            this.urlDecoder = Base64.getUrlDecoder();
@@ -67,41 +55,6 @@ public class RSAKeyLoader implements KeyLoader {
        }
    }

-    /**
-     * Loads an RSA private key from a given PEM formatted key text.
-     * <p>
-     * This method extracts the raw key content from the provided PEM text, decodes the
-     * Base64-encoded content, and generates an instance of {@link RSAPrivateKey}. If the key cannot
-     * be loaded due to invalid specifications or types, a {@link KeyLoadingException} is thrown.
-     *
-     * @param pemKeyText the PEM formatted private key text
-     * @return an instance of {@link RSAPrivateKey}
-     * @throws KeyLoadingException if the key loading process encounters an error
-     */
-    @Override
-    public RSAPrivateKey loadPrivateKey(String pemKeyText) {
-        // Extract the raw key content
-        var rawKeyContent = getRawContent(pemKeyText);
-
-        // Decode the Base64-encoded content
-        var keyBytes = decoder.decode(rawKeyContent);
-
-        // Create a PKCS8EncodedKeySpec from the decoded bytes
-        var keySpec = new PKCS8EncodedKeySpec(keyBytes);
-
-        try {
-            // Get an RSA KeyFactory and generate the private key
-            var _key = keyFactory.generatePrivate(keySpec);
-            if (_key instanceof RSAPrivateKey key) {
-                return key;
-            } else {
-                throw new KeyLoadingException("Unable to load private key from pem-formatted key text.");
-            }
-        } catch (InvalidKeySpecException e) {
-            throw new KeyLoadingException("Key spec is invalid.", e);
-        }
-    }
-
    /**
     * Loads an RSA public key from a given PEM formatted key text.
     * <p>
@@ -116,7 +69,7 @@ public class RSAKeyLoader implements KeyLoader {
    @Override
    public RSAPublicKey loadPublicKey(String pemKeyText) {
        // Extract the raw key content
-        var rawKeyContent = getRawContent(pemKeyText);
+        var rawKeyContent = CryptoUtil.getRawContent(pemKeyText);

        // Decode the Base64-encoded content
        var keyBytes = decoder.decode(rawKeyContent);
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.security.exception;
+package com.onixbyte.crypto.exception;

 /**
 * The {@code KeyLoadingException} class represents an exception that is thrown when there is an
@@ -29,7 +29,7 @@ package com.onixbyte.security.exception;
 * <p><b>Example usage:</b></p>
 * <pre>{@code
 * try {
- *     KeyLoader keyLoader = new EcKeyLoader();
+ *     PrivateKeyLoader keyLoader = new ECPrivateKeyLoader();
 *     ECPrivateKey privateKey = keyLoader.loadPrivateKey(pemPrivateKey);
 * } catch (KeyLoadingException e) {
 *     // Handle the exception
@@ -38,7 +38,7 @@ package com.onixbyte.security.exception;
 * }</pre>
 *
 * @author zihluwang
- * @version 2.0.0
+ * @version 3.0.0
 * @since 1.6.0
 */
 public class KeyLoadingException extends RuntimeException {
@@ -0,0 +1,49 @@
+/*
+ * Copyright (C) 2024-2025 OnixByte.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.onixbyte.crypto.util;
+
+public final class CryptoUtil {
+
+    private CryptoUtil() {
+    }
+
+    /**
+     * Retrieves the raw content of a PEM formatted key by removing unnecessary headers, footers,
+     * and new line characters.
+     *
+     * <p>
+     * This method processes the provided PEM key text to return a cleaned string that contains
+     * only the key content. The method strips away the
+     * {@code "-----BEGIN (EC )?(PRIVATE|PUBLIC) KEY-----"} and
+     * {@code "-----END (EC )?(PRIVATE|PUBLIC) KEY-----"} lines, as well as any new line characters,
+     * resulting in a continuous string representation of the key, which can be used for further
+     * cryptographic operations.
+     *
+     * @param pemKeyText the PEM formatted key as a string, which may include headers, footers and
+     *                   line breaks
+     * @return a string containing the raw key content devoid of  any unnecessary formatting
+     * or whitespace
+     */
+    public static String getRawContent(String pemKeyText) {
+        // remove all unnecessary parts of the pem key text
+        return pemKeyText
+            .replaceAll("-----BEGIN ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
+            .replaceAll("-----END ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
+            .replaceAll("\n", "");
+    }
+}
@@ -4,7 +4,7 @@

 Module `guid` serves as a guid creator for other `JDevKit` modules. You can also use this module as a guid creator standards.

-We have already implemented `SnowflakeGuidCreator`, you can also implement a custom guid creations by implementing `com.onixbyte.guid.GuidCreator`.
+We have already implemented `SnowflakeGuidCreator`, you can also implement a custom guid creations by implementing `com.onixbyte.identitygenerator.IdentityGenerator`.

 ## Example usage

@@ -64,9 +64,9 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("guid") {
+        create<MavenPublication>("identityGenerator") {
            groupId = group.toString()
-            artifactId = "guid"
+            artifactId = "identity-generator"
            version = artefactVersion

            pom {
@@ -82,8 +82,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -107,7 +107,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["guid"])
+                sign(publishing.publications["identityGenerator"])
            }
        }

@@ -15,10 +15,10 @@
 * limitations under the License.
 */

-package com.onixbyte.guid;
+package com.onixbyte.identitygenerator;

 /**
- * The {@code GuidCreator} is a generic interface for generating globally unique identifiers (GUIDs)
+ * The {@code IdentityGenerator} is a generic interface for generating globally unique identifiers (GUIDs)
 * of a specific type.
 * <p>
 * The type of ID is determined by the class implementing this interface.
@@ -26,7 +26,7 @@ package com.onixbyte.guid;
 *
 * <p><b>Example usage:</b></p>
 * <pre>{@code
- * public class StringGuidCreator implements GuidCreator<String> {
+ * public class StringGuidCreator implements IdentityGenerator<String> {
 *     private final AtomicLong counter = new AtomicLong();
 *
 *     @Override
@@ -37,7 +37,7 @@ package com.onixbyte.guid;
 *
 * public class Example {
 *     public static void main(String[] args) {
- *         GuidCreator<String> guidCreator = new StringGuidCreator();
+ *         IdentityGenerator<String> guidCreator = new StringGuidCreator();
 *         String guid = guidCreator.nextId();
 *         System.out.println("Generated GUID: " + guid);
 *     }
@@ -49,7 +49,7 @@ package com.onixbyte.guid;
 * @version 1.1.0
 * @since 1.0.0
 */
-public interface GuidCreator<IdType> {
+public interface IdentityGenerator<IdType> {

    /**
     * Generates and returns the next globally unique ID.
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.guid.exceptions;
+package com.onixbyte.identitygenerator.exceptions;

 /**
 * The {@code TimingException} class represents an exception that is thrown when there is an error
@@ -15,16 +15,16 @@
 * limitations under the License.
 */

-package com.onixbyte.guid.impl;
+package com.onixbyte.identitygenerator.impl;

-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;

 import java.nio.ByteBuffer;
 import java.security.SecureRandom;
 import java.util.UUID;

 /**
- * A {@code SequentialUuidCreator} is responsible for generating UUIDs following the UUID version 7 specification, which
+ * A {@code SequentialUuidGenerator} is responsible for generating UUIDs following the UUID version 7 specification, which
 * combines a timestamp with random bytes to create time-ordered unique identifiers.
 * <p>
 * This implementation utilises a cryptographically strong {@link SecureRandom} instance to produce the random
@@ -34,14 +34,14 @@ import java.util.UUID;
 * The generated UUID adheres strictly to the layout and variant bits of UUID version 7 as defined in the specification.
 * </p>
 */
-public class SequentialUuidCreator implements GuidCreator<UUID> {
+public class SequentialUuidGenerator implements IdentityGenerator<UUID> {

    private final SecureRandom random;

    /**
-     * Constructs a new {@code SequentialUuidCreator} with its own {@link SecureRandom} instance.
+     * Constructs a new {@code SequentialUuidGenerator} with its own {@link SecureRandom} instance.
     */
-    public SequentialUuidCreator() {
+    public SequentialUuidGenerator() {
        this.random = new SecureRandom();
    }

@@ -15,16 +15,16 @@
 * limitations under the License.
 */

-package com.onixbyte.guid.impl;
+package com.onixbyte.identitygenerator.impl;

-import com.onixbyte.guid.GuidCreator;
-import com.onixbyte.guid.exceptions.TimingException;
+import com.onixbyte.identitygenerator.IdentityGenerator;
+import com.onixbyte.identitygenerator.exceptions.TimingException;

 import java.time.LocalDateTime;
 import java.time.ZoneId;

 /**
- * The {@code SnowflakeGuidCreator} generates unique identifiers using the Snowflake algorithm,
+ * The {@code SnowflakeIdentityGenerator} generates unique identifiers using the Snowflake algorithm,
 * which combines a timestamp, worker ID, and data centre ID to create 64-bit long integers. The bit
 * distribution for the generated IDs is as follows:
 * <ul>
@@ -35,7 +35,7 @@ import java.time.ZoneId;
 *     <li>12 bits for sequence number (per millisecond)</li>
 * </ul>
 * <p>
- * When initializing a {@link SnowflakeGuidCreator}, you must provide the worker ID and data centre
+ * When initializing a {@link SnowflakeIdentityGenerator}, you must provide the worker ID and data centre
 * ID, ensuring they are within the valid range defined by the bit size. The generator maintains an
 * internal sequence number that increments for IDs generated within the same millisecond. If the
 * system clock moves backward, an exception is thrown to prevent generating IDs with
@@ -45,7 +45,7 @@ import java.time.ZoneId;
 * @version 1.1.0
 * @since 1.0.0
 */
-public final class SnowflakeGuidCreator implements GuidCreator<Long> {
+public final class SnowflakeIdentityGenerator implements IdentityGenerator<Long> {

    /**
     * Constructs a SnowflakeGuidGenerator with the default start epoch and custom worker ID, data
@@ -54,7 +54,7 @@ public final class SnowflakeGuidCreator implements GuidCreator<Long> {
     * @param dataCentreId the data centre ID (between 0 and 31)
     * @param workerId     the worker ID (between 0 and 31)
     */
-    public SnowflakeGuidCreator(long dataCentreId, long workerId) {
+    public SnowflakeIdentityGenerator(long dataCentreId, long workerId) {
        this(dataCentreId, workerId, DEFAULT_CUSTOM_EPOCH);
    }

@@ -67,7 +67,7 @@ public final class SnowflakeGuidCreator implements GuidCreator<Long> {
     * @throws IllegalArgumentException if the start epoch is greater than the current timestamp,
     *                                  or if the worker ID or data centre ID is out of range
     */
-    public SnowflakeGuidCreator(long dataCentreId, long workerId, long startEpoch) {
+    public SnowflakeIdentityGenerator(long dataCentreId, long workerId, long startEpoch) {
        if (startEpoch > currentTimestamp()) {
            throw new IllegalArgumentException("Start Epoch can not be greater than current timestamp!");
        }
@@ -50,7 +50,7 @@ implementation 'cn.org.codecrafters:simple-jwt-authzero:${simple-jwt-authzero.ve

 ## Use the `AuthzeroTokenResolver`

-We have implemented `TokenResolver` to make sure you can add JWT to your Java application as soon as possible. All you need to do is to create an instance of `com.onixbyte.simplejwt.authzero.AuthzeroTokenResolver` and other operations to JWT could follow our instruction in [`simple-jwt-facade`](../simple-jwt-facade/README.md).
+We have implemented `TokenResolver` to make sure you can add JWT to your Java application as soon as possible. All you need to do is to create an instance of `com.onixbyte.jwt.auth0.AuthzeroTokenResolver` and other operations to JWT could follow our instruction in [`simple-jwt-facade`](../simple-jwt-facade/README.md).

 ## Contact

@@ -55,10 +55,10 @@ dependencies {
    compileOnly(libs.slf4j)
    implementation(libs.logback)

-    api(project(":devkit-utils"))
-    api(project(":guid"))
-    api(project(":key-pair-loader"))
-    api(project(":simple-jwt-facade"))
+    api(project(":common-toolbox"))
+    api(project(":identity-generator"))
+    api(project(":crypto-toolbox"))
+    api(project(":jwt-toolbox-facade"))
    api(libs.jackson.databind)
    api(libs.jwt.core)

@@ -72,13 +72,13 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("simpleJwtAuthzero") {
+        create<MavenPublication>("jwtToolboxAuth0") {
            groupId = group.toString()
-            artifactId = "simple-jwt-authzero"
+            artifactId = "jwt-toolbox-auth0"
            version = artefactVersion

            pom {
-                name = "OnixByte JWT Toolbox :: Auth0 Implementation"
+                name = "OnixByte JWT Toolbox :: Auth0"
                description = "Simple JWT implemented with com.auth0:java-jwt."
                url = projectUrl

@@ -90,8 +90,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -115,7 +115,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["simpleJwtAuthzero"])
+                sign(publishing.publications["jwtToolboxAuth0"])
            }
        }

@@ -15,17 +15,17 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.authzero;
+package com.onixbyte.jwt.auth0;

-import com.onixbyte.devkit.utils.Base64Util;
-import com.onixbyte.guid.GuidCreator;
-import com.onixbyte.security.impl.ECKeyLoader;
-import com.onixbyte.simplejwt.TokenPayload;
-import com.onixbyte.simplejwt.TokenResolver;
-import com.onixbyte.simplejwt.annotations.ExcludeFromPayload;
-import com.onixbyte.simplejwt.annotations.TokenEnum;
-import com.onixbyte.simplejwt.constants.PredefinedKeys;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.common.util.Base64Util;
+import com.onixbyte.crypto.algorithm.ecdsa.ECPrivateKeyLoader;
+import com.onixbyte.identitygenerator.IdentityGenerator;
+import com.onixbyte.jwt.TokenPayload;
+import com.onixbyte.jwt.TokenResolver;
+import com.onixbyte.jwt.annotations.ExcludeFromPayload;
+import com.onixbyte.jwt.annotations.TokenEnum;
+import com.onixbyte.jwt.constants.PredefinedKeys;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import com.auth0.jwt.JWT;
 import com.auth0.jwt.JWTCreator;
 import com.auth0.jwt.algorithms.Algorithm;
@@ -35,9 +35,9 @@ import com.fasterxml.jackson.core.JsonProcessingException;
 import com.fasterxml.jackson.core.type.TypeReference;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.node.ObjectNode;
-import com.onixbyte.simplejwt.exceptions.IllegalKeyPairException;
-import com.onixbyte.simplejwt.exceptions.IllegalSecretException;
-import com.onixbyte.simplejwt.exceptions.UnsupportedAlgorithmException;
+import com.onixbyte.jwt.exceptions.IllegalKeyPairException;
+import com.onixbyte.jwt.exceptions.IllegalSecretException;
+import com.onixbyte.jwt.exceptions.UnsupportedAlgorithmException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

@@ -92,7 +92,7 @@ import java.util.function.Function;
 *
 * @author Zihlu Wang
 * @version 1.1.1
- * @see GuidCreator
+ * @see IdentityGenerator
 * @see Algorithm
 * @see JWTVerifier
 * @see JWTCreator
@@ -118,9 +118,9 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
    public static class Builder {

        /**
-         * GuidCreator used for generating unique identifiers for "jti" claim in JWT tokens.
+         * IdentityGenerator used for generating unique identifiers for "jti" claim in JWT tokens.
         */
-        private GuidCreator<?> jtiCreator;
+        private IdentityGenerator<?> jtiCreator;

        /**
         * The algorithm used for signing and verifying JWT tokens.
@@ -177,8 +177,8 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
         * @return the builder instance
         */
        public Builder keyPair(String publicKey, String privateKey) {
-            var keyLoader = new ECKeyLoader();
-            this.publicKey = keyLoader.loadPublicKey(publicKey);
+            var keyLoader = new ECPrivateKeyLoader();
+            // this.publicKey = keyLoader.loadPublicKey(publicKey);
            this.privateKey = keyLoader.loadPrivateKey(privateKey);
            return this;
        }
@@ -234,7 +234,7 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
         * @param jtiCreator a creator to create JWT id
         * @return the builder instance
         */
-        public Builder jtiCreator(GuidCreator<?> jtiCreator) {
+        public Builder jtiCreator(IdentityGenerator<?> jtiCreator) {
            this.jtiCreator = jtiCreator;
            return this;
        }
@@ -597,9 +597,9 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
    }

    /**
-     * GuidCreator used for generating unique identifiers for "jti" claim in JWT tokens.
+     * IdentityGenerator used for generating unique identifiers for "jti" claim in JWT tokens.
     */
-    private final GuidCreator<?> jtiCreator;
+    private final IdentityGenerator<?> jtiCreator;

    /**
     * The algorithm used for signing and verifying JWT tokens.
@@ -647,7 +647,7 @@ public class AuthzeroTokenResolver implements TokenResolver<DecodedJWT> {
     * @param issuer       the person or organisation who issued this JWT
     * @param objectMapper a mapper for handling JSON serialisation and deserialization
     */
-    private AuthzeroTokenResolver(GuidCreator<?> jtiCreator, Algorithm algorithm, String issuer, ObjectMapper objectMapper) {
+    private AuthzeroTokenResolver(IdentityGenerator<?> jtiCreator, Algorithm algorithm, String issuer, ObjectMapper objectMapper) {
        this.jtiCreator = jtiCreator;
        this.algorithm = algorithm;
        this.issuer = issuer;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.authzero.test;
+package com.onixbyte.jwt.auth0.test;

 /**
 * TestAuthzeroTokenResolver
@@ -55,8 +55,8 @@ dependencies {
    compileOnly(libs.slf4j)
    implementation(libs.logback)

-    api(project(":devkit-utils"))
-    api(project(":guid"))
+    api(project(":common-toolbox"))
+    api(project(":identity-generator"))

    testImplementation(platform(libs.junit.bom))
    testImplementation(libs.junit.jupiter)
@@ -68,9 +68,9 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("simpleJwtFacade") {
+        create<MavenPublication>("jwtToolboxFacade") {
            groupId = group.toString()
-            artifactId = "simple-jwt-facade"
+            artifactId = "jwt-toolbox-facade"
            version = artefactVersion

            pom {
@@ -86,8 +86,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -111,7 +111,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["simpleJwtFacade"])
+                sign(publishing.publications["jwtToolboxFacade"])
            }
        }

@@ -15,9 +15,9 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;

-import com.onixbyte.simplejwt.exceptions.WeakSecretException;
+import com.onixbyte.jwt.exceptions.WeakSecretException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;

 /**
 * {@code TokenPayload} interface is used to mark a data class as suitable
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt;
+package com.onixbyte.jwt;

 import java.time.Duration;
 import java.util.Map;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.annotations;
+package com.onixbyte.jwt.annotations;

 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
@@ -15,9 +15,9 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.annotations;
+package com.onixbyte.jwt.annotations;

-import com.onixbyte.simplejwt.constants.TokenDataType;
+import com.onixbyte.jwt.constants.TokenDataType;

 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;

 import java.util.List;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;

 import java.util.List;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.constants;
+package com.onixbyte.jwt.constants;

 /**
 * The base data types used to process enum data.
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;

 /**
 * {@link IllegalKeyPairException} indicates an exception that the key pair is invalid.
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;

 /**
 * {@link IllegalKeyPairException} indicates the secret to sign a JWT is illegal.
@@ -15,9 +15,9 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;

-import com.onixbyte.simplejwt.TokenResolver;
+import com.onixbyte.jwt.TokenResolver;

 /**
 * This {@code UnsupportedAlgorithmException} represents the given
@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.exceptions;
+package com.onixbyte.jwt.exceptions;

 /**
 * {@code WeakSecretException} represents that your secret is too weak to be
@@ -66,7 +66,7 @@ implementation 'com.onixbyte:simple-jwt-spring-boot-starter:${simple-jwt-spring-

 We need a `GuidCreator` instance to create JWT ID, though we did implemented a simple `GuidCreator`, but you can still customize it.

-First, please implement the `com.onixbyte.guid.GuidCreator` interface based on your own rules for generating JWT IDs.
+First, please implement the `com.onixbyte.identitygenerator.IdentityGenerator` interface based on your own rules for generating JWT IDs.

 Then, add the instance of your own guid creator to spring container, whose name is `jtiCreator`.

@@ -55,9 +55,9 @@ dependencies {
    compileOnly(libs.slf4j)
    implementation(libs.logback)

-    api(project(":guid"))
-    api(project(":simple-jwt-facade"))
-    api(project(":simple-jwt-authzero"))
+    api(project(":identity-generator"))
+    api(project(":jwt-toolbox-facade"))
+    api(project(":jwt-toolbox-auth0"))
    implementation(libs.springBoot.autoconfigure)
    implementation(libs.springBoot.starter.logging)
    implementation(libs.springBoot.configurationProcessor)
@@ -81,9 +81,9 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("simpleJwtSpringBootStarter") {
+        create<MavenPublication>("jwtSpringBootStarter") {
            groupId = group.toString()
-            artifactId = "simple-jwt-spring-boot-starter"
+            artifactId = "jwt-spring-boot-starter"
            version = artefactVersion

            pom {
@@ -99,8 +99,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -124,7 +124,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["simpleJwtSpringBootStarter"])
+                sign(publishing.publications["jwtSpringBootStarter"])
            }
        }

@@ -15,15 +15,15 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.autoconfiguration;
+package com.onixbyte.jwt.autoconfiguration;

-import com.onixbyte.guid.GuidCreator;
-import com.onixbyte.simplejwt.TokenResolver;
-import com.onixbyte.simplejwt.authzero.AuthzeroTokenResolver;
-import com.onixbyte.simplejwt.autoconfiguration.properties.SimpleJwtProperties;
+import com.onixbyte.identitygenerator.IdentityGenerator;
+import com.onixbyte.jwt.TokenResolver;
+import com.onixbyte.jwt.auth0.AuthzeroTokenResolver;
+import com.onixbyte.jwt.autoconfiguration.properties.SimpleJwtProperties;
 import com.auth0.jwt.interfaces.DecodedJWT;
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -60,7 +60,7 @@ import org.springframework.context.annotation.Bean;
@EnableConfigurationProperties(value = {SimpleJwtProperties.class})
@ConditionalOnClass({DecodedJWT.class, AuthzeroTokenResolver.class})
@ConditionalOnMissingBean({TokenResolver.class})
-@ConditionalOnBean(value = {GuidCreator.class}, name = "jtiCreator")
+@ConditionalOnBean(value = {IdentityGenerator.class}, name = "jtiCreator")
@AutoConfigureAfter(value = GuidAutoConfiguration.class)
 public class AuthzeroTokenResolverAutoConfiguration {

@@ -76,7 +76,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
     */
    @Autowired
    public AuthzeroTokenResolverAutoConfiguration(SimpleJwtProperties simpleJwtProperties,
-                                                  @Qualifier("jtiCreator") GuidCreator<?> jtiCreator,
+                                                  @Qualifier("jtiCreator") IdentityGenerator<?> jtiCreator,
                                                  ObjectMapper objectMapper) {
        this.jtiCreator = jtiCreator;
        this.simpleJwtProperties = simpleJwtProperties;
@@ -86,7 +86,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
    /**
     * Creates a new {@link TokenResolver} bean using {@link AuthzeroTokenResolver} if no existing
     * {@link TokenResolver} bean is found. The {@link AuthzeroTokenResolver} is configured with the
-     * provided {@link GuidCreator}, {@code algorithm}, {@code issuer}, and {@code secret}
+     * provided {@link IdentityGenerator}, {@code algorithm}, {@code issuer}, and {@code secret}
     * properties from {@link SimpleJwtProperties}.
     *
     * @return the {@link TokenResolver} instance
@@ -110,7 +110,7 @@ public class AuthzeroTokenResolverAutoConfiguration {
        return builder.build();
    }

-    private final GuidCreator<?> jtiCreator;
+    private final IdentityGenerator<?> jtiCreator;

    private final SimpleJwtProperties simpleJwtProperties;

@@ -15,10 +15,10 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.autoconfiguration;
+package com.onixbyte.jwt.autoconfiguration;

-import com.onixbyte.guid.GuidCreator;
-import com.onixbyte.simplejwt.autoconfiguration.conditions.GuidCreatorCondition;
+import com.onixbyte.identitygenerator.IdentityGenerator;
+import com.onixbyte.jwt.autoconfiguration.conditions.GuidCreatorCondition;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
@@ -28,7 +28,7 @@ import org.springframework.context.annotation.Conditional;
 import java.util.UUID;

 /**
- * Autoconfiguration for injecting a {@link GuidCreator} for generating jwt id.
+ * Autoconfiguration for injecting a {@link IdentityGenerator} for generating jwt id.
 *
 * @author Zihlu Wang
 * @version 1.1.0
@@ -52,7 +52,7 @@ public class GuidAutoConfiguration {
     */
    @Bean(name = "jtiCreator")
    @Conditional(GuidCreatorCondition.class)
-    public GuidCreator<?> jtiCreator() {
+    public IdentityGenerator<?> jtiCreator() {
        return UUID::randomUUID;
    }

@@ -15,9 +15,9 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.autoconfiguration.conditions;
+package com.onixbyte.jwt.autoconfiguration.conditions;

-import com.onixbyte.guid.GuidCreator;
+import com.onixbyte.identitygenerator.IdentityGenerator;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.context.annotation.Condition;
@@ -46,7 +46,7 @@ public class GuidCreatorCondition implements Condition {
    /**
     * The condition to create bean {@code jtiCreator}.
     * <p>
-     * If Spring does not have a bean of type {@link GuidCreator} named {@code jtiCreator} in the
+     * If Spring does not have a bean of type {@link IdentityGenerator} named {@code jtiCreator} in the
     * application context, then create {@code jtiCreator}.
     *
     * @param context  the spring application context
@@ -59,7 +59,7 @@ public class GuidCreatorCondition implements Condition {
        final var beanFactory = Objects.requireNonNull(context.getBeanFactory());
        var isContainJtiCreator = beanFactory.containsBean("jtiCreator");
        if (isContainJtiCreator) {
-            return !(beanFactory.getBean("jtiCreator") instanceof GuidCreator<?>);
+            return !(beanFactory.getBean("jtiCreator") instanceof IdentityGenerator<?>);
        }
        return true;
    }
@@ -15,11 +15,11 @@
 * limitations under the License.
 */

-package com.onixbyte.simplejwt.autoconfiguration.properties;
+package com.onixbyte.jwt.autoconfiguration.properties;

-import com.onixbyte.simplejwt.SecretCreator;
-import com.onixbyte.simplejwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration;
-import com.onixbyte.simplejwt.constants.TokenAlgorithm;
+import com.onixbyte.jwt.SecretCreator;
+import com.onixbyte.jwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration;
+import com.onixbyte.jwt.constants.TokenAlgorithm;
 import org.springframework.boot.context.properties.ConfigurationProperties;

 /**
@@ -0,0 +1,2 @@
+com.onixbyte.jwt.autoconfiguration.GuidAutoConfiguration
+com.onixbyte.jwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration
@@ -1,116 +0,0 @@
-/*
- * Copyright (C) 2024-2025 OnixByte.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package com.onixbyte.security;
-
-import com.onixbyte.security.exception.KeyLoadingException;
-
-import java.security.PrivateKey;
-import java.security.PublicKey;
-import java.security.interfaces.ECPublicKey;
-import java.security.interfaces.RSAPublicKey;
-
-/**
- * The {@code KeyLoader} class provides utility methods for loading keys pairs from PEM-formatted
- * key text. This class supports loading both private and public keys.
- * <p>
- * The utility methods in this class are useful for scenarios where ECDSA keys need to be loaded
- * from PEM-formatted strings for cryptographic operations.
- *
- * @author zihluwang
- * @version 2.0.0
- * @since 1.6.0
- */
-public interface KeyLoader {
-
-    /**
-     * Load private key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     */
-    PrivateKey loadPrivateKey(String pemKeyText);
-
-    /**
-     * Load public key from pem-formatted key text.
-     *
-     * @param pemKeyText pem-formatted key text
-     * @return loaded private key
-     */
-    PublicKey loadPublicKey(String pemKeyText);
-
-    /**
-     * Loads an RSA public key using the provided modulus and exponent.
-     * <p>
-     * This default implementation throws a {@link KeyLoadingException} to signify that this key loader does not support
-     * loading an RSA public key. Implementing classes are expected to override this method to supply their own
-     * loading logic.
-     *
-     * @param modulus  the modulus value of the RSA public key, usually represented in hexadecimal or Base64
-     *                 string format
-     * @param exponent the public exponent value of the RSA public key, usually represented in hexadecimal or Base64
-     *                 string format
-     * @return the loaded {@link RSAPublicKey} instance
-     * @throws KeyLoadingException if loading is not supported or fails
-     */
-    default RSAPublicKey loadPublicKey(String modulus, String exponent) {
-        throw new KeyLoadingException("This key loader does not support loading an RSA public key.");
-    }
-
-    /**
-     * Loads an EC public key using the provided x and y coordinates together with the curve name.
-     * <p>
-     * This default implementation throws a {@link KeyLoadingException} to signify that this key loader does not support
-     * loading an EC public key. Implementing classes are expected to override this method to supply their own
-     * loading logic.
-     *
-     * @param xHex      the hexadecimal string representing the x coordinate of the EC point
-     * @param yHex      the hexadecimal string representing the y coordinate of the EC point
-     * @param curveName the name of the elliptic curve
-     * @return the loaded {@link ECPublicKey} instance
-     * @throws KeyLoadingException if loading is not supported or fails
-     */
-    default ECPublicKey loadPublicKey(String xHex, String yHex, String curveName) {
-        throw new KeyLoadingException("This key loader does not support loading an EC public key.");
-    }
-
-    /**
-     * Retrieves the raw content of a PEM formatted key by removing unnecessary headers, footers,
-     * and new line characters.
-     *
-     * <p>
-     * This method processes the provided PEM key text to return a cleaned string that contains
-     * only the key content. The method strips away the
-     * {@code "-----BEGIN (EC )?(PRIVATE|PUBLIC) KEY-----"} and
-     * {@code "-----END (EC )?(PRIVATE|PUBLIC) KEY-----"} lines, as well as any new line characters,
-     * resulting in a continuous string representation of the key, which can be used for further
-     * cryptographic operations.
-     *
-     * @param pemKeyText the PEM formatted key as a string, which may include headers, footers and
-     *                   line breaks
-     * @return a string containing the raw key content devoid of  any unnecessary formatting
-     * or whitespace
-     */
-    default String getRawContent(String pemKeyText) {
-        // remove all unnecessary parts of the pem key text
-        return pemKeyText
-                .replaceAll("-----BEGIN ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
-                .replaceAll("-----END ((EC )|(RSA ))?(PRIVATE|PUBLIC) KEY-----", "")
-                .replaceAll("\n", "");
-    }
-
-}
@@ -64,9 +64,9 @@ tasks.test {

 publishing {
    publications {
-        create<MavenPublication>("num4j") {
+        create<MavenPublication>("mathToolbox") {
            groupId = group.toString()
-            artifactId = "num4j"
+            artifactId = "math-toolbox"
            version = artefactVersion

            pom {
@@ -83,8 +83,8 @@ publishing {
                }

                scm {
-                    connection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
-                    developerConnection = "scm:git:git://github.com:onixbyte/onixbyte-toolbox.git"
+                    connection = "scm:git:git://github.com:OnixByte/JDevKit.git"
+                    developerConnection = "scm:git:git://github.com:OnixByte/JDevKit.git"
                    url = projectGithubUrl
                }

@@ -108,7 +108,7 @@ publishing {
            from(components["java"])

            signing {
-                sign(publishing.publications["num4j"])
+                sign(publishing.publications["mathToolbox"])
            }
        }

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.nums;
+package com.onixbyte.math;

 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -15,9 +15,9 @@
 * limitations under the License.
 */

-package com.onixbyte.nums;
+package com.onixbyte.math;

-import com.onixbyte.nums.model.QuartileBounds;
+import com.onixbyte.math.model.QuartileBounds;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;

@@ -15,7 +15,7 @@
 * limitations under the License.
 */

-package com.onixbyte.nums.model;
+package com.onixbyte.math.model;

 /**
 * A record representing the quartile bounds of a dataset.
@@ -18,12 +18,12 @@
 rootProject.name = "onixbyte-toolbox"

 include(
-    "devkit-bom",
-    "devkit-utils",
-    "guid",
-    "key-pair-loader",
-    "num4j",
-    "simple-jwt-facade",
-    "simple-jwt-authzero",
-    "simple-jwt-spring-boot-starter",
+    "version-catalogue",
+    "common-toolbox",
+    "identity-generator",
+    "crypto-toolbox",
+    "math-toolbox",
+    "jwt-toolbox-facade",
+    "jwt-toolbox-auth0",
+    "jwt-toolbox-spring-boot-starter",
 )
@@ -1,2 +0,0 @@
-com.onixbyte.simplejwt.autoconfiguration.GuidAutoConfiguration
-com.onixbyte.simplejwt.autoconfiguration.AuthzeroTokenResolverAutoConfiguration
@@ -49,9 +49,9 @@ dependencies {

 publishing {
    publications {
-        create<MavenPublication>("devkitBom") {
+        create<MavenPublication>("versionCatalogue") {
            groupId = group.toString()
-            artifactId = "devkit-bom"
+            artifactId = "version-catalogue"
            version = artefactVersion

            pom {
@@ -92,7 +92,7 @@ publishing {
            from(components["javaPlatform"])

            signing {
-                sign(publishing.publications["devkitBom"])
+                sign(publishing.publications["versionCatalogue"])
            }
        }