使用PrivateKey.fromStringECDSA时TransactionReceipt子数组为空的问题

问题原因 #

1. 账户状态差异：
   • 使用PrivateKey.generateECDSA()时，示例代码会自动创建新的Hedera账户，这个过程会生成子交易收据（对应账户创建操作），因此receipt.children数组存在内容，代码可正常读取receipt.children[0].accountId。
   • 使用自定义私钥时，该私钥对应已存在的Hedera账户，无需执行账户创建操作，交易收据的children数组为空，代码直接访问索引0就会触发TypeError。
2. MetaMask转账失败的关联原因：
   已存在的账户可能未完成EVM地址的关联初始化，或者示例代码依赖新账户创建逻辑同步EVM关联信息，现有账户缺少该步骤，导致MetaMask无法正常发起HBAR转账。

解决方案 #

步骤1：修改收据处理逻辑，兼容已有账户 #

添加判断逻辑，避免直接访问空数组索引：

// 替换原报错的代码段
let targetAccountId;
if (receipt.children.length > 0) {
  // 新账户场景：从子收据获取账户ID
  targetAccountId = receipt.children[0].accountId;
} else {
  // 已有账户场景：从私钥推导账户ID（需匹配你的网络shard/ realm ID）
  const publicKey = privateKey.publicKey;
  targetAccountId = publicKey.toAccountId(0, 0);
}

步骤2：提前验证账户存在性（可选） #

执行转账前先查询账户状态，明确逻辑分支：

// 提前查询账户是否存在
const balanceQuery = new AccountBalanceQuery()
  .setAccountId(targetAccountId);

try {
  const balance = await balanceQuery.execute(client);
  console.log("账户已存在，余额:", balance.hbars.toString());
} catch (err) {
  // 账户不存在时，执行原示例中的账户创建逻辑
  console.log("账户不存在，将创建新账户");
  // 此处保留原示例的账户创建代码
}

步骤3：确保已有账户关联EVM地址 #

若MetaMask仍无法转账，需确认账户已关联正确的EVM地址：

1. 查询当前账户的EVM地址：

const accountInfo = await new AccountInfoQuery()
  .setAccountId(targetAccountId)
  .execute(client);
console.log("当前账户关联的EVM地址:", accountInfo.evmAddress);

2. 若未关联EVM地址，执行更新操作：

// 从私钥推导EVM地址（或直接使用MetaMask中的地址）
const evmAddress = privateKey.publicKey.toEvmAddress();

const updateTx = new AccountUpdateTransaction()
  .setAccountId(targetAccountId)
  .setEvmAddress(evmAddress)
  .freezeWith(client);

const signedTx = await updateTx.sign(privateKey);
const updateReceipt = await signedTx.execute(client);
await updateReceipt.getReceipt(client);
console.log("已成功关联EVM地址");

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