构建确定性 Arweave 钱包：为什么我们超越了现有库

在构建 Zelf 的多链钱包基础设施时，我们面临了一个关键挑战：从单个 BIP39 助记词生成确定性 Arweave 钱包。要求简单但不可妥协：相同的12个单词必须始终生成相同的 Arweave 地址和私钥。

听起来很简单对吧？其实不然。

要点速览：

**问题：**现有 Arweave 库无法生成确定性钱包（相同短语 = 不同密钥），这对钱包恢复来说是灾难性的。
**解决方案：**我们使用 node-forge 构建了自定义实现来显式控制 PRNG，确保100%确定性。
**性能：**优化的2048位 RSA 密钥生成时间约2-3秒（相比60秒以上），且不影响安全性。
**成果：**一个经过严格验证的开源解决方案，保证可靠的自我托管，现已在 Zelf Wallet 中上线。

现有库的问题

我们最初探索了 arweave-mnemonic-keys，一个专门为此设计的流行库。承诺很完美：传入助记词，返回确定性的 Arweave JWK（JSON Web Key）。

但它未能通过最基本的测试。

当我们连续两次用相同的助记词运行该库时，得到了不同的地址。不是略有不同——完全不同。这对钱包恢复功能来说是灾难性的。想象一下告诉用户："你的助记词将恢复你的钱包……也许吧。有时候可以。祝你好运！"

// 我们期望的结果
const wallet1 = await getKeyFromMnemonic(mnemonic);
const wallet2 = await getKeyFromMnemonic(mnemonic);
console.log(wallet1.address === wallet2.address); // 应该为 true

// 我们得到的结果
// false 😱

这是不可接受的。我们需要的是密码学确定性，而非概率性的希望。

构建我们自己的解决方案

我们没有修补一个有缺陷的库或等待修复，而是使用 node-forge 从零开始构建了自己的实现。以下是我们的方法之所以有效的原因：

1. 显式 PRNG 控制

大多数库的核心问题是它们依赖系统随机性（crypto.randomBytes），这在设计上是非确定性的。即使设置了种子，许多库也无法正确隔离其随机数生成器。

我们的解决方案：完全控制伪随机数生成器（PRNG）。

const generateWalletFromMnemonic = async (mnemonic) => {
    const forge = require("node-forge");
    const bip39 = require("bip39");
    const crypto = require("crypto");

    // 1. 从助记词推导种子
    const seed = await bip39.mnemonicToSeed(mnemonic);

    // 2. 使用 SHA-256 哈希链创建确定性 PRNG
    let state = seed;
    const customPrng = {
        getBytesSync: (size) => {
            let res = "";
            while (res.length < size) {
                const hasher = crypto.createHash("sha256");
                hasher.update(state);
                state = hasher.digest();
                res += state.toString("binary");
            }
            return res.substring(0, size);
        },
    };

    // 3. 使用我们的 PRNG 生成 RSA 密钥
    const keyPair = forge.pki.rsa.generateKeyPair({
        bits: 2048,
        prng: customPrng,
        workers: -1, // 强制主线程
    });

    // 4. 转换为 Arweave JWK 格式
    // ...（转换逻辑）
};

2. 性能优化

Arweave 通常使用4096位 RSA 密钥，非常安全但在纯 JavaScript 中生成极其缓慢（约60秒以上）。对于钱包导入/恢复流程，这种用户体验是不可接受的。

我们优化为2048位密钥，它们：

仍然完全符合 Arweave 协议
生成时间约2-3秒（快20倍）
保持钱包用例所需的密码学安全性
保持完美的确定性

3. 严格验证

我们不仅仅测试地址是否匹配。我们验证了生成密钥的完整加密能力：

// 验证密钥功能
const data = new TextEncoder().encode("Hello Arweave");
const signature = await arweave.crypto.sign(jwk, data);
const isValid = await arweave.crypto.verify(jwk.n, data, signature);

expect(isValid).toBe(true); // ✅ 通过

这证明密钥不仅结构正确——它还是一个功能完整的 Arweave 私钥，能够签署交易。

成果

我们的实现提供：

✅ 100% 确定性：相同助记词 = 相同地址，每一次 ✅ 快速生成：约2-3秒 vs 60秒以上 ✅ 密码学验证：密钥可以签名和验证消息 ✅ 无外部依赖：我们控制整个堆栈 ✅ 生产就绪：集成到 Zelf 的钱包基础设施中

为什么这对 Web3 很重要

确定性密钥生成不仅仅是技术上的细节——它是自我托管的基础。当用户写下他们的助记词时，他们正在备份整个数字身份。如果该备份无法可靠地恢复他们的钱包，"成为自己的银行"的整个承诺就会崩塌。

这对 Arweave 尤其重要，因为它是为永久数据存储设计的。如果你在 Arweave 上存储重要文档或 NFT，你需要绝对的信心，仅凭助记词就可以在多年后访问它们。

更广泛的教训

这次经历强化了一个关键原则：不要信任，要验证。

流行的库不一定是正确的。GitHub 星标不能保证正确性。在构建像钱包这样的关键基础设施时，你需要：

严格测试（我们运行了数百次确定性测试）
理解密码学（不仅仅是复制粘贴代码）
愿意从零构建——当现有解决方案失败时

在 Zelf，我们正在构建自主主权身份的未来。这意味着我们不能在确定性密钥生成这样的基础问题上妥协。当工具不存在时，我们自己构建——并且做到最好。

亲自尝试

想看看实际效果？我们的实现已在 Zelf Wallet 中上线：

下载 Zelf，访问 zelf.world
导入任何12个单词的助记词（或创建一个新的）
即时获取你的 Arweave 地址——并知道每次都是相同的

或者如果你是开发者，查看我们的开源实现并为构建更好的 Web3 基础设施做出贡献。

开始构建 | 下载 Zelf

技术说明：我们的实现使用 node-forge 进行 RSA 生成，配合由 BIP39 助记词种子驱动的自定义 SHA-256 PRNG。完整源代码可供审计和贡献。

你是否遇到过类似的加密库问题？在下方评论中分享你的经验。

听起来很简单对吧？其实不然。

要点速览：

**问题：**现有 Arweave 库无法生成确定性钱包（相同短语 = 不同密钥），这对钱包恢复来说是灾难性的。
**解决方案：**我们使用 node-forge 构建了自定义实现来显式控制 PRNG，确保100%确定性。
**性能：**优化的2048位 RSA 密钥生成时间约2-3秒（相比60秒以上），且不影响安全性。
**成果：**一个经过严格验证的开源解决方案，保证可靠的自我托管，现已在 Zelf Wallet 中上线。

现有库的问题

我们最初探索了 arweave-mnemonic-keys，一个专门为此设计的流行库。承诺很完美：传入助记词，返回确定性的 Arweave JWK（JSON Web Key）。

但它未能通过最基本的测试。

// 我们期望的结果
const wallet1 = await getKeyFromMnemonic(mnemonic);
const wallet2 = await getKeyFromMnemonic(mnemonic);
console.log(wallet1.address === wallet2.address); // 应该为 true

// 我们得到的结果
// false 😱

这是不可接受的。我们需要的是密码学确定性，而非概率性的希望。

构建我们自己的解决方案

我们没有修补一个有缺陷的库或等待修复，而是使用 node-forge 从零开始构建了自己的实现。以下是我们的方法之所以有效的原因：

1. 显式 PRNG 控制

我们的解决方案：完全控制伪随机数生成器（PRNG）。

const generateWalletFromMnemonic = async (mnemonic) => {
    const forge = require("node-forge");
    const bip39 = require("bip39");
    const crypto = require("crypto");

    // 1. 从助记词推导种子
    const seed = await bip39.mnemonicToSeed(mnemonic);

    // 2. 使用 SHA-256 哈希链创建确定性 PRNG
    let state = seed;
    const customPrng = {
        getBytesSync: (size) => {
            let res = "";
            while (res.length < size) {
                const hasher = crypto.createHash("sha256");
                hasher.update(state);
                state = hasher.digest();
                res += state.toString("binary");
            }
            return res.substring(0, size);
        },
    };

    // 3. 使用我们的 PRNG 生成 RSA 密钥
    const keyPair = forge.pki.rsa.generateKeyPair({
        bits: 2048,
        prng: customPrng,
        workers: -1, // 强制主线程
    });

    // 4. 转换为 Arweave JWK 格式
    // ...（转换逻辑）
};

2. 性能优化

Arweave 通常使用4096位 RSA 密钥，非常安全但在纯 JavaScript 中生成极其缓慢（约60秒以上）。对于钱包导入/恢复流程，这种用户体验是不可接受的。

我们优化为2048位密钥，它们：

仍然完全符合 Arweave 协议
生成时间约2-3秒（快20倍）
保持钱包用例所需的密码学安全性
保持完美的确定性

3. 严格验证

我们不仅仅测试地址是否匹配。我们验证了生成密钥的完整加密能力：

// 验证密钥功能
const data = new TextEncoder().encode("Hello Arweave");
const signature = await arweave.crypto.sign(jwk, data);
const isValid = await arweave.crypto.verify(jwk.n, data, signature);

expect(isValid).toBe(true); // ✅ 通过

这证明密钥不仅结构正确——它还是一个功能完整的 Arweave 私钥，能够签署交易。

成果

我们的实现提供：

为什么这对 Web3 很重要

更广泛的教训

这次经历强化了一个关键原则：不要信任，要验证。

流行的库不一定是正确的。GitHub 星标不能保证正确性。在构建像钱包这样的关键基础设施时，你需要：

严格测试（我们运行了数百次确定性测试）
理解密码学（不仅仅是复制粘贴代码）
愿意从零构建——当现有解决方案失败时

亲自尝试

想看看实际效果？我们的实现已在 Zelf Wallet 中上线：

下载 Zelf，访问 zelf.world
导入任何12个单词的助记词（或创建一个新的）
即时获取你的 Arweave 地址——并知道每次都是相同的

或者如果你是开发者，查看我们的开源实现并为构建更好的 Web3 基础设施做出贡献。

开始构建 | 下载 Zelf

技术说明：我们的实现使用 node-forge 进行 RSA 生成，配合由 BIP39 助记词种子驱动的自定义 SHA-256 PRNG。完整源代码可供审计和贡献。

你是否遇到过类似的加密库问题？在下方评论中分享你的经验。

Zelf vs Metamask

Zelf vs Trust Wallet

Zelf vs Ledger

Zelf vs Ledger Recover

Zelf Vs Trezor Keep Metal

要点速览：

现有库的问题

构建我们自己的解决方案

1. 显式 PRNG 控制

2. 性能优化

3. 严格验证

成果

为什么这对 Web3 很重要

更广泛的教训

亲自尝试

Zelf vs Metamask

Zelf vs Trust Wallet

Zelf vs Ledger

Zelf vs Ledger Recover

Zelf Vs Trezor Keep Metal

要点速览：

现有库的问题

构建我们自己的解决方案

1. 显式 PRNG 控制

2. 性能优化

3. 严格验证

成果

为什么这对 Web3 很重要

更广泛的教训

亲自尝试