Skip to content

btcdage2000/BrainWalletSigner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

BTC Offline Signer(比特币离线签名工具)

@btcdage

A minimal, air-gapped Bitcoin transaction signer for manual UTXO workflows. 一个极简的、用于手动UTXO流程的比特币离线签名工具。


⚠️ SECURITY MODEL(安全模型)

EN

This tool is designed ONLY for:

  • Fully offline (air-gapped) environments
  • Manual UTXO input from trusted sources

The author is NOT responsible for:

  • Incorrect UTXO amounts
  • Wrong recipient or change addresses
  • Compromised or non-secure environments
  • Any loss of funds due to misuse

中文

本工具仅适用于

  • 完全离线(Air-gapped)环境
  • 从可信来源手动输入 UTXO 数据

作者不对以下情况负责

  • UTXO 金额填写错误
  • 接收地址或找零地址错误
  • 运行环境被入侵或不安全
  • 因误用导致的任何资产损失

📌 DESIGN PRINCIPLE(设计原则)

EN

This is NOT a wallet.

This tool intentionally:

  • Does NOT connect to the internet
  • Does NOT fetch blockchain data
  • Does NOT verify UTXOs
  • Does NOT use PSBT

It is a manual, deterministic signing tool.


中文

这不是一个钱包。

本工具刻意:

  • 不联网
  • 不获取链上数据
  • 不验证 UTXO
  • 不使用 PSBT

它是一个完全手动、确定性的签名工具


✅ SUPPORTED FEATURES(支持功能)

  • Single-signature transactions(单签交易)
  • P2PKH(1开头地址)
  • P2WPKH(bc1q 开头地址)
  • Manual UTXO input(手动输入UTXO)
  • Fee calculation (rate or fixed)(手续费计算:费率/固定)
  • Change output handling(找零处理)
  • Dust protection(粉尘保护)
  • QR code export(二维码导出)
  • Bilingual UI(中英双语界面)

❌ NOT SUPPORTED(不支持)

  • Multi-signature(多签)
  • Taproot spending(Taproot 花费)
  • PSBT workflow
  • Hardware wallet integration
  • Automatic UTXO discovery
  • Network broadcasting

⚠️ Note: Sending to Taproot (bc1p) addresses is allowed, but spending from them is NOT supported.


⚠️ IMPORTANT WARNINGS(重要警告)

1. UTXO AMOUNT MUST BE 100% ACCURATE

UTXO 金额必须 100% 准确

If the input amount is incorrect:

  • The transaction will be invalid
  • Or the fee will be unintentionally increased

2. THIS TOOL DOES NOT VERIFY ANYTHING

本工具不会验证任何链上数据

You are responsible for:

  • TXID correctness
  • VOUT correctness
  • Amount correctness

3. FEE IS ESTIMATED ONLY

手续费仅为估算

  • Fee rate mode is approximate
  • Final fee depends on actual transaction size

4. HIGH FEE PROTECTION EXISTS

存在高手续费保护机制

  • Warning for unusually high fee
  • Hard rejection for extreme fee

5. DUST HANDLING

粉尘处理

  • Change < 546 sats will be merged into fee automatically

🧠 RECOMMENDED WORKFLOW: COLD-HOT SEPARATION

推荐工作流:冷热分离架构

EN

For maximum security, use this tool in conjunction with the Brain Wallet Generator by @btcdage.

  1. Generation (Offline): Use the Brain Wallet Generator on an air-gapped PC to create high-entropy keys (WIF). Save your addresses and keep the WIF secret.
  2. Deposit (Online): Send funds to your generated address from an exchange or hot wallet.
  3. Inquiry (Online): Use a block explorer (e.g., mempool.space) to find your TXID, VOUT, and Amount.
  4. Signing (Offline): Use this BTC Offline Signer to sign the transaction. Input the WIF and UTXO data manually.
  5. Broadcasting (Online): Scan the generated QR code or copy the Raw Hex to an online device and broadcast it via a full node or web service.

中文

为了实现最高级别的安全性,建议配合 @btcdage 开发的 高级脑钱包生成器 使用,构建完整的“冷热分离”方案:

  1. 生成(离线): 在断网电脑上使用“脑钱包工具”生成高熵私钥(WIF)。记录地址,严密保管私钥。
  2. 注入(在线): 从交易所或热钱包向你的离线地址转入 BTC。
  3. 查询(在线): 通过区块浏览器(如 mempool.space)查询该地址的 TXIDVOUT索引准确金额
  4. 签名(离线): 在断网电脑上打开本“离线签名工具”,手动录入上述数据和私钥进行签名。
  5. 广播(在线): 扫描生成的二维码或复制十六进制(Raw Hex),在联网设备上通过全节点或区块浏览器发布交易。

💡 Tip: This combination eliminates the need for expensive hardware wallets while maintaining physical isolation. 提示: 这种“双剑合璧”的方案在保持物理隔离的同时,完全省去了购买昂贵硬件钱包的必要。

🧪 HOW TO USE(使用方法)

EN

  1. Run on an offline computer
  2. Input UTXO (TXID / VOUT / Amount / WIF)
  3. Enter recipient address and amount
  4. Set fee
  5. Click "Verify & Sign"
  6. Confirm details
  7. Export raw transaction or QR

中文

  1. 在离线电脑运行
  2. 输入 UTXO(TXID / VOUT / 金额 / 私钥)
  3. 输入接收地址和金额
  4. 设置手续费
  5. 点击“验证并签署交易”
  6. 确认信息
  7. 导出交易或二维码

⚠️ KNOWN LIMITATIONS(已知限制)

  • No UTXO validation
  • No protection against clipboard/address replacement attacks
  • No recovery mechanism for mistakes
  • No transaction preview beyond summary
  • Fee estimation is not exact

🧠 INTENDED USERS(目标用户)

This tool is intended for:

  • Advanced users
  • Developers
  • Air-gapped workflows
  • Educational purposes

Not recommended for beginners.


本工具适用于:

  • 有经验的用户
  • 开发者
  • 离线签名场景
  • 教学用途

不建议新手使用。


📜 DISCLAIMER(免责声明)

USE AT YOUR OWN RISK.

This software is provided "as is", without warranty of any kind.


使用本工具即表示你已理解并接受所有风险。

本软件不提供任何形式的担保。


👤 Author

BTC DAGE (@BTCDAGE)


⭐ FINAL NOTE(最后说明)

This tool prioritizes:

Simplicity > Automation Determinism > Convenience Offline Safety > Feature Completeness


本工具优先考虑:

简单性 > 自动化 确定性 > 便利性 离线安全 > 功能完整性


About

Securely sign BTC transactions on offline devices. No internet, no PSBT, no auto-discovery—just pure deterministic signing for advanced users and cold storage. 比特币确定性离线签名方案。无联网、无 PSBT、无自动获取,专为资深玩家和冷存储场景设计的纯手动、物理隔离签名工具。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages