比特幣開發環境完整搭建指南

本指南協助開發者從零開始搭建比特幣開發環境，涵蓋不同技術棧的開發需求。

開發環境選擇

常見技術棧

Python 開發環境

安裝依賴

使用 pip

# 建立虛擬環境
python3 -m venv bitcoin-dev
source bitcoin-dev/bin/activate

# 安裝比特幣相關庫
pip install python-bitcoinlib
pip install btctxstore
pip install mnemonic
pip install base58
pip install ecdsa

使用 poetry

# 建立專案
poetry new bitcoin-project
cd bitcoin-project

# 添加依賴
poetry add python-bitcoinlib
poetry add mnemonic
poetry add requests

基本範例：建立比特幣錢包

from bitcoin import SelectParams
from bitcoin.wallet import CBitcoinSecret
from bitcoin.core import x
from bitcoin.core.key import CECKey
import hashlib
import os

# 選擇網路（mainnet, testnet, regtest）
SelectParams('testnet')

# 建立隨機私鑰
private_key = CBitcoinSecret.from_secret_bytes(os.urandom(32))

# 取得公鑰
public_key = private_key.pub

# 取得地址
address = private_key.pub.address()

print(f"私鑰: {private_key}")
print(f"公鑰: {public_key.hex()}")
print(f"地址: {address}")

進階：交易建立與簽名

from bitcoin.wallet import CBitcoinAddress
from bitcoin.transaction import sign_transaction, deserialize

# 建立交易
tx = create_transaction(
    prev_txid="...",
    prev_vout=0,
    to_address="...",
    amount=100000,  # satoshi
    fee=1000
)

# 簽名交易
signed_tx = sign_transaction(tx, [private_key])

# 廣播（需要節點連接）
print(signed_tx.hex())

JavaScript/Node.js 開發環境

安裝 bitcoinjs-lib

使用 npm

# 建立專案
mkdir bitcoin-js-app
cd bitcoin-js-app
npm init -y

# 安裝 bitcoinjs-lib
npm install bitcoinjs-lib tiny-secp256k1 ecpair

# 安裝開發依賴
npm install --save-dev typescript @types/node

基本範例：金鑰生成

const bitcoin = require('bitcoinjs-lib');
const { ECPairFactory } = require('ecpair');
const tinysecp = require('tiny-secp256k1');
const crypto = require('crypto');

const ECPair = ECPairFactory(tinysecp);

// 生成隨機私鑰
function generateKeyPair() {
    const privateKey = crypto.randomBytes(32);
    const keyPair = ECPair.fromPrivateKey(privateKey);

    return {
        privateKey: keyPair.toWIF(),
        publicKey: keyPair.publicKey.toString('hex'),
        address: bitcoin.payments.p2pkh({ pubkey: keyPair.publicKey }).address
    };
}

const wallet = generateKeyPair();
console.log(wallet);

P2PKH 交易範例

const bitcoin = require('bitcoinjs-lib');
const { ECPairFactory } = require('ecpair');
const tinysecp = require('tiny-secp256k1');

const ECPair = ECPairFactory(tinysecp);

// 網路配置
const network = bitcoin.networks.testnet;

function createTransaction() {
    const keyPair = ECPair.fromWIF('...', network);

    const txb = new bitcoin.TransactionBuilder(network);

    // 添加輸入（UTXO）
    txb.addInput(
        'previous-transaction-id',
        0,  // vout
        0xffffffff,  // sequence
        Buffer.from('...', 'hex')  // 見證腳本
    );

    // 添加輸出
    txb.addOutput(
       -address',
         'target50000  // satoshi
    );

    // 找零地址
    txb.addOutput(
        keyPair.getAddress(),
        49000
    );

    // 簽名
    txb.sign(0, keyPair);

    return txb.build().toHex();
}

Rust 開發環境

安裝 Rust 和依賴

# 安裝 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 建立專案
cargo new bitcoin-rust-app
cd bitcoin-rust-app

# 添加依賴
cargo add rust-bitcoin
cargo add hex
cargo add serde --features derive

基本範例：金鑰生成

use rust_bitcoin::secp256k1::{Secp256k1, SecretKey};
use rust_bitcoin::util::address::Address;
use rust_bitcoin::util::key::PrivateKey;
use rust_bitcoin::network::constants::Network;

fn main() {
    let secp = Secp256k1::new();
    let secret = SecretKey::new(&mut rand::thread_rng(), &secp);
    let private_key = PrivateKey::new(secret, Network::Bitcoin);

    let address = Address::p2pkh(&private_key.public_key(&secp), Network::Bitcoin);

    println!("Private Key: {}", private_key);
    println!("Address: {}", address);
}

Go 開發環境

安裝 btcd

# 安裝 Go
# https://go.dev/dl/

# 建立專案
mkdir bitcoin-go-app
cd bitcoin-go-app
go mod init bitcoin-go-app

# 安裝 btcd
go get github.com/btcsuite/btcd/btcjson/v4
go get github.com/btcsuite/btcd/chaincfg/chainhash

基本範例：連接節點

package main

import (
    "fmt"
    "github.com/btcsuite/btcd/rpcclient"
)

func main() {
    // 連接比特幣節點
    connCfg := &rpcclient.ConnConfig{
        Host:         "localhost:8332",
        User:         "your-username",
        Pass:         "your-password",
        HTTPPostMode: true,
        DisableTLS:   true,
    }

    client, err := rpcclient.New(connCfg, nil)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer client.Shutdown()

    // 獲取區塊高度
    blockCount, err := client.GetBlockCount()
    if err != nil {
        fmt.Println(err)
        return
    }

    fmt.Printf("Current block height: %d\n", blockCount)
}

Docker 開發環境

比特幣核心容器

# docker-compose.yml
version: '3.8'

services:
  bitcoin-core:
    image: ruimarinho/bitcoin-core:latest
    container_name: bitcoin-dev-node
    environment:
      - BITCOIN_USER=developer
      - BITCOIN_PASS=devpassword
    ports:
      - "8332:8332"  # RPC
      - "8333:8333"  # P2P
      - "28332:28332" # ZMQ
    volumes:
      - bitcoin-data:/home/bitcoin/.bitcoin
    command: -regtest -server -rpcuser=developer -rpcpass=devpassword -prune=550

# 啟動容器
docker-compose up -d

# 查看日誌
docker-compose logs -f bitcoin-core

# 進入容器
docker exec -it bitcoin-dev-node bitcoin-cli -regtest -rpcuser=developer -rpcpass=devpassword

測試網路配置

Bitcoin RegTest

# 啟動 RegTest 模式
bitcoind -regtest -daemon

# 挖礦到指定地址
bitcoin-cli -regtest generate 101

# 檢查餘額
bitcoin-cli -regtest getbalance

測試網路

# 使用比特幣測試網路
bitcoind -testnet -daemon

# 獲取測試網比特幣
# https://testnet-faucet.mempool.co/

開發工具推薦

區塊鏈瀏覽器 API

比特幣 Fee API

// 使用 Mempool API 獲取建議費用
const response = await fetch('https://mempool.space/api/v1/fees/recommended');
const fees = await response.json();

console.log(fees);
// {
//   "fastestFee": 20,
//   "halfHourFee": 15,
//   "hourFee": 10,
//   "economyFee": 5,
//   "minimumFee": 1
// }

常見開發問題

Q：如何選擇比特幣網路？

A：開發時使用 regtest 或 testnet，生產環境使用 mainnet。

Q：私鑰如何安全儲存？

A：使用環境變數、加密錢包或硬體安全模組（HSM）。

Q：如何處理比特幣延遲確認？

A：實現監視機制，根據交易狀態更新 UI。

Q：比特幣節點需要多少資源？

A：完整節點需要 500GB+ 儲存空間，4GB+ RAM。

Q：如何測試比特幣應用？

A：使用 regtest 本地網路，結合自動化測試框架。

相關連結

• 比特幣節點快速部署
• 比特幣節點維護指南
• 比特幣測試網指南