Hedera测试环境搭建报错：无效私钥长度问题排查

可能原因及解决方法 #

1. 检查私钥格式与长度 #

Hedera测试网采用ED25519密钥体系，合法私钥需满足以下任一格式：

• 原始32字节私钥：对应64位十六进制字符串
• ASN.1 DER编码格式：对应96位十六进制字符串（以302e020100300506032b657004220420开头）

操作步骤：

• 打开.env文件，删除MY_PRIVATE_KEY值前后的空格、换行符或多余引号
• 统计字符数，确认长度符合上述要求

2. 确认私钥来源正确 #

• 从Hedera测试网门户复制私钥时，仅复制中间的十六进制字符串部分，不要包含PrivateKey(和)包裹的冗余字符
• 确保使用的是账户私钥，而非公钥（公钥虽长度与原始私钥一致，但传入私钥参数会触发格式错误）

3. 验证环境变量读取有效性 #

在代码中添加日志，确认读取到的私钥内容与长度：

console.log('读取到的私钥:', myPrivateKey);
console.log('私钥字符长度:', myPrivateKey.length);

运行代码后核对输出，排查是否存在环境变量转义、截断问题。

4. 手动解析私钥定位问题 #

修改代码，手动解析私钥并捕获详细错误：

const { Client, PrivateKey } = require("@hashgraph/sdk");
require("dotenv").config();

async function main() {
    const myAccountId = process.env.MY_ACCOUNT_ID;
    const myPrivateKeyStr = process.env.MY_PRIVATE_KEY;

    if (!myAccountId || !myPrivateKeyStr) {
        throw new Error("环境变量myAccountId和myPrivateKey必须存在");
    }

    let myPrivateKey;
    try {
        myPrivateKey = PrivateKey.fromString(myPrivateKeyStr);
        console.log('私钥解析成功');
    } catch (err) {
        console.error('私钥解析失败:', err.message);
        return;
    }

    const client = Client.forTestnet();
    client.setOperator(myAccountId, myPrivateKey);
    console.log('success');
    client.close();
}
main();

通过报错信息可直接定位是格式错误还是长度不符。

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