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

如何使用以太坊 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