Java环境下Lazysodium Ed25519密钥与JCA KeyPair互转及密钥库存储问题

1. Libsodium字节数组密钥转JCA KeyPair #

Libsodium的Ed25519密钥采用原始字节格式：公钥固定为32字节，私钥默认返回64字节（前32位为私钥种子，后32位为对应公钥）。Java 15及以上版本原生支持Ed25519算法的JCA实现，更低版本可以引入BouncyCastle加密库实现适配，转换代码如下：

import java.security.KeyFactory;
import java.security.KeyPair;
import java.security.spec.EdECPrivateKeySpec;
import java.security.spec.EdECPublicKeySpec;
import java.security.spec.NamedParameterSpec;

/**
 * @param sodiumPubKey libsodium生成的32字节Ed25519公钥
 * @param sodiumPrivKey libsodium生成的32字节私钥种子/64字节完整私钥
 * @return 标准JCA KeyPair实例
 */
public KeyPair sodiumBytesToJcaKeyPair(byte[] sodiumPubKey, byte[] sodiumPrivKey) throws Exception {
    // 提取32字节私钥种子：如果入参是64字节完整私钥，取前32位即可
    byte[] privSeed = sodiumPrivKey.length == 64 ? 
        java.util.Arrays.copyOfRange(sodiumPrivKey, 0, 32) : sodiumPrivKey;
    
    KeyFactory ed25519Factory = KeyFactory.getInstance("Ed25519");
    // 构造公钥、私钥规范
    EdECPublicKeySpec pubSpec = new EdECPublicKeySpec(
        NamedParameterSpec.ED25519, 
        EdECPoint.of(NamedParameterSpec.ED25519, sodiumPubKey)
    );
    EdECPrivateKeySpec privSpec = new EdECPrivateKeySpec(NamedParameterSpec.ED25519, privSeed);
    
    return new KeyPair(
        ed25519Factory.generatePublic(pubSpec),
        ed25519Factory.generatePrivate(privSpec)
    );
}

2. JCA KeyPair转回Libsodium兼容字节数组 #

转换得到的字节数组可以直接传入Lazysodium的相关接口使用，代码如下：

import java.security.interfaces.EdECPrivateKey;
import java.security.interfaces.EdECPublicKey;

/**
 * JCA Ed25519公钥转libsodium兼容32字节数组
 */
public byte[] jcaPubToSodiumBytes(java.security.PublicKey pubKey) throws IllegalArgumentException {
    if (!(pubKey instanceof EdECPublicKey edPubKey)) {
        throw new IllegalArgumentException("入参不是合法的Ed25519公钥");
    }
    return edPubKey.getPoint().getEncoded();
}

/**
 * JCA Ed25519私钥转libsodium兼容字节数组
 * @param returnFullPriv 若为true返回libsodium标准64字节私钥（种子+公钥），否则返回32字节私钥种子
 */
public byte[] jcaPrivToSodiumBytes(java.security.PrivateKey privKey, java.security.PublicKey pubKey, boolean returnFullPriv) throws IllegalArgumentException {
    if (!(privKey instanceof EdECPrivateKey edPrivKey) || !(pubKey instanceof EdECPublicKey edPubKey)) {
        throw new IllegalArgumentException("入参不是合法的Ed25519密钥");
    }
    byte[] privSeed = edPrivKey.getBytes()
        .orElseThrow(() -> new IllegalArgumentException("无法提取私钥原始字节"));
    
    if (!returnFullPriv) {
        return privSeed;
    }
    // 拼接为libsodium标准64字节私钥
    byte[] fullPriv = java.util.Arrays.copyOf(privSeed, 64);
    System.arraycopy(edPubKey.getPoint().getEncoded(), 0, fullPriv, 32, 32);
    return fullPriv;
}

注意事项 #

• Java 15以下版本无原生Ed25519 JCA实现，需要引入BouncyCastle加密库，调用KeyFactory.getInstance("Ed25519", "BC")即可，转换逻辑完全一致
• 转换全程直接操作原始密钥字节，无编码损耗，转换后的密钥在两端生态签名验签结果完全一致
• 转换得到的JCA KeyPair可以直接按照标准流程存入Java Keystore，无需额外处理

内容的提问来源于stack exchange，提问作者mikera