C#连接Bitcoin Core遇障：问题排查、库选型与实现指导

1. C#连接Bitcoin Core的完整步骤 #

• 配置Bitcoin Core节点
  1. 编辑bitcoin.conf，添加核心配置项：

     server=1
     rpcport=8332  # 主网端口，测试网请用18332
     rpcuser=myuser
     rpcpass=mypass
     rpcallowip=127.0.0.1  # 本地开发填此值，远程访问填对应客户端IP
     # 测试网需额外添加：testnet=1
     

  2. 重启Bitcoin Core，等待节点完成区块同步（至少达到可响应RPC请求的状态）
• 准备C#开发环境
  1. 新建C#控制台/类库项目
  2. 通过NuGet安装适配的Bitcoin开发库（推荐NBitcoin）
• 编写验证代码
  实例化RPC客户端，调用基础方法（如获取区块高度）确认连接正常

2. 推荐合适的开发库 #

首推NBitcoin：

• 功能覆盖全面，支持主网/测试网切换、签名验证、钱包操作、全RPC方法封装等
• 社区活跃度高，维护更新及时，完美适配最新版本Bitcoin Core
• 文档示例丰富，适合从入门到进阶的全场景开发需求

次选BitcoinLib：

• 轻量简洁，专注于RPC调用封装，但维护频率较低，对新版本Bitcoin Core的兼容性可能滞后

3. 修复连接错误 #

针对401未授权错误 #

• 检查bitcoin.conf中rpcuser和rpcpass的拼写，确保无多余空格或拼写错误
• 确认rpcallowip配置包含C#程序所在IP（本地开发必须包含127.0.0.1）
• 若Bitcoin Core版本≥0.18，避免同时使用rpcuser/rpcpass和rpcauth，二者只能二选一
• 手动RPC请求时，需正确添加HTTP Basic Auth头：将myuser:mypass做Base64编码后，添加Authorization: Basic <编码结果>请求头

针对RPC请求不被理解的错误 #

• 核对RPC方法名是否符合Bitcoin Core v22.0.0的规范（避免调用已废弃方法）
• 确认请求参数为JSON格式，且参数数量、类型与方法要求匹配
• 若使用BitcoinLib，检查库版本是否适配v22.0.0，建议更换为NBitcoin测试

4. NBitcoin简单使用示例 #

先通过NuGet安装包：Install-Package NBitcoin

基础连接与调用示例：

using NBitcoin;
using NBitcoin.RPC;
using System;

class BitcoinCoreConnector
{
    static void Main()
    {
        // 选择网络：主网用Network.Main，测试网用Network.TestNet
        var targetNetwork = Network.Main;
        // 初始化RPC凭据与客户端
        var rpcCredentials = new RPCCredentials("myuser", "mypass", targetNetwork);
        var rpcClient = new RPCClient(rpcCredentials, "http://127.0.0.1:8332");

        try
        {
            // 获取当前区块高度
            long blockCount = rpcClient.GetBlockCount();
            Console.WriteLine($"当前区块高度: {blockCount}");

            // 获取钱包总余额（需确保节点加载钱包，可在bitcoin.conf添加wallet=default）
            Money walletBalance = rpcClient.GetBalance();
            Console.WriteLine($"钱包余额: {walletBalance.ToDecimal(MoneyUnit.BTC)} BTC");

            // 获取最新区块信息
            uint256 bestBlockHash = rpcClient.GetBestBlockHash();
            Block latestBlock = rpcClient.GetBlock(bestBlockHash);
            Console.WriteLine($"最新区块哈希: {bestBlockHash}");
            Console.WriteLine($"最新区块生成时间: {latestBlock.Header.Time}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"错误信息: {ex.Message}");
        }
    }
}

注意：使用测试网时，需将targetNetwork改为Network.TestNet，rpcport改为18332，同时bitcoin.conf添加testnet=1

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