以太坊 RPC 教程,如何连接与交互以太坊节点

常见的以太坊 RPC 端点

要使用以太坊 RPC，首先需要一个 RPC 端点（Endpoint），即节点的网络地址，常见的来源有：

1. 自己搭建节点：

   • Geth：以太坊官方的 Go 语言客户端。
   • Parity/OpenEthereum：另一款流行的以太坊客户端。
   • Nethermind：高性能的 .NET 以太坊客户端。
   • Infura (也提供节点服务，但这里主要指自己搭建)：搭建后，默认 RPC 端口通常是 8545（本地测试网）或根据配置的公网端口。
   • 优点：数据完全自己掌控，隐私性好，适合需要高安全性和定制化需求的场景。
   • 缺点：需要维护节点，同步区块数据需要大量时间和存储空间，对硬件有要求。

2. 使用第三方 RPC 服务提供商（推荐初学者和大多数开发者）：

   • Infura：最知名的提供商之一，提供 Mainnet（主网）、Ropsten/Kovan/Goerli/Sepolia（测试网）的 RPC 端点，需要注册账号获取 API Key。
   • Alchemy：另一家强大的 RPC 服务商，以其稳定性和丰富的开发者工具著称。
   • QuickNode：提供高性能的 RPC 节点，支持多种网络和自定义选项。
   • 优点：无需自己维护节点，开箱即用，高可用性，通常提供更好的速度和稳定性。
   • 缺点：免费额度有限，大量调用可能需要付费，数据经过第三方。

3. 本地测试节点：

   • 在开发阶段,通常会运行一个本地私有测试链或使用测试网（如 Goerli, Sepolia）的本地节点，RPC 端点一般为 http://localhost:8545。

如何使用以太坊 RPC？（以 HTTP JSON-RPC 为例）

以太坊 RPC 最常用的通信方式是 HTTP JSON-RPC，客户端向节点的 RPC 端点发送 HTTP POST 请求，请求体是 JSON 格式的数据。

准备工作

• 一个 RPC 端点（URL），https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID 或 http://localhost:8545。
• （可选）如果节点启用了认证，可能需要用户名和密码。
• 一个能够发送 HTTP 请求的工具，如 curl（命令行）、Postman（图形界面），或编程语言中的 HTTP 客户端库（如 JavaScript 的 axios/fetch， Python 的 requests）。

RPC 请求的基本结构

一个 JSON-RPC 请求包含以下字段：

• jsonrpc: 版本号，通常为 "2.0"。
• method: 要调用的 RPC 方法名称（字符串），eth_blockNumber, eth_getBalance。
• params: 方法所需的参数数组（Array），顺序和类型需与方法定义一致，如果没有参数，可以为空数组 []。
• id: 请求 ID，可以是任意数字或字符串，用于匹配请求和响应。

常用 RPC 方法示例

示例 1：获取最新区块号

• 方法: eth_blockNumber
• 参数: 无
• 请求 (使用 curl):

  curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' http://localhost:8545

• 响应:

  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1a2b3c" // 十六进制表示的区块号
  }

示例 2：获取指定地址的 ETH 余额

• 方法: eth_getBalance
• 参数: ["0xAddress", "latest"] （地址和区块标识符，"latest" 表示最新区块）
• 请求 (使用 curl):

  curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x742d35Cc6634C0532925a3b844Bc9e7595f8AbE1", "latest"],"id":1}' http://localhost:8545

• 响应:

  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1a05dc300000000000000000000000000000000000000000000000000000000" // 十六进制表示的余额（以 wei 为单位）
  }

示例 3：发送交易（需要签名）

• 方法: eth_sendRawTransaction
• 参数: ["0xRawSignedTransaction"] （已签名的原始交易数据）
• 说明: 这个过程通常比较复杂，需要先对交易进行签名（可以使用 web3.js, ethers.js 等库的 signer 完成），然后将签名后的交易数据（十六进制字符串）作为参数发送。
• 请求 (使用 curl, 假设已有签名交易数据):

  curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xRAW_SIGNED_TX_DATA"],"id":1}' http://localhost:8545

• 响应:

  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef" // 交易哈希
  }

在代码中使用（以 JavaScript + ethers.js 为例）

ethers.js 是一个流行的以太坊 JavaScript 库，它简化了与以太坊节点的交互，底层就是使用 RPC。

const { ethers } = require("ethers");
// 1. 创建 Provider（连接到以太坊节点）
// 使用 Infura 的示例（需要替换为你的 Infura Project ID）
const provider = new ethers.providers.JsonRpcProvider("https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID");
// 或者连接到本地节点
// const provider = new ethers.providers.JsonRpcProvider("http://localhost:8545");
async function main() {
  try {
    // 2. 获取最新区块号
    const blockNumber = await provider.getBlockNumber();
    console.log("Latest Block Number:", blockNumber);
    // 3. 获取指定地址的余额
    const address = "0x742d35Cc6634C0532925a3b844Bc9e7595f8AbE1";
    const balance = await provider.getBalance(address);
    console.log(`Balance of ${address}:`, ethers.utils