Firma

警告 - 早期软件，请勿与真实比特币一起使用。

Firma是一个工具，用于创建在离线设备上存储私钥的比特币多签名钱包。

离线设备可以是CLI 终端或一部备用的Android 手机。

设备之间通过QR码传输信息。由于PSBT可能变得很大（一些KB），可能需要多个QR码，这些QR码通过QR 结构化附加 链接

钱包数据保存在本地文件系统中（见 datadir），并且可选地使用外部提供的密钥加密（在Android中，所有内容默认使用由本地keystore保护的密钥加密）。

它基于

• bitcoin core
• PSBT（部分签名比特币交易）
• rust-bitcoin
• 和其他 库

高级流程

                                      +---------------------+
+---------------------+               |+---------------------+
|                     |     xpubs     ||                     |
| online machine      | <------------ ||  offline machines   |
|                     |               ||                     |
| * firma-online      |     PSBT      ||  * firma-offline    |
| * bitcoin node      | ------------> ||  * xprv             |
| * xpubs             | <------------ ||                     |
|                     |               +|                     |
+---------------------+                +---------------------+

设置

• 在一个或多个离线设备上创建一个或多个扩展私钥 xprv。
• 将相应的扩展公钥 xpub 组合在一起，并将这些导入到在线Bitcoin core节点中，以仅监视模式。
• 将带有 xpub 的钱包描述符带回离线机器。虽然这不是签名的严格必要条件，但离线机器上的钱包充当备份和附加信息（例如，检查更改是否属于钱包）。

使用

接收

• firma-online 工具可以创建接收比特币的地址。

支出

• 从 firma-online 工具创建交易，并将其导出为PSBT格式。
• 将PSBT带到离线设备上，检查交易，如果一切看起来正确，则使用设备上现有的私钥签署PSBT。
• 将所有PSBT返回到可以组合和最终化这些交易的节点（此操作可以并行或顺序进行）。

需求

您需要

• Bitcoin core 0.20.1
• rust (MSRV >= 1.56.0)。

从crates安装

cargo install firma-cli

从源安装

git clone https://github.com/RCasatta/firma/
cd firma/cli
cargo build --release

可执行文件为 target/release/firma-online 和 target/release/firma-offline

测试

集成测试需要一个环境变量指向bitcoin core的可执行文件（bitcoind）。

例如

BITCOIND_EXE=./bitcoin-0.20.1/bin/bitcoind cargo test

示例

查看bin readme 中的CLI示例

常见问题解答

# encryption key creation and storage in encrypted gpg
dd if=/dev/urandom bs=1 count=32 | gpg --encrypt >encryption_key.gpg

# bitcoin private key creation
gpg --decrypt encryption_key.gpg | firma-offline --read-stdin random --key-name bitcoin-key

赞助商

由 Squarecrypto 赞助的项目

捐赠

我是OpenTimestamps日历的维护者之一，如果你觉得可以，你可以在那里捐赠