以太坊API使用入门,连接区块链世界的桥梁

时间： 2026-06-07 14:48 阅读数： 1人阅读

以太坊作为全球领先的智能合约平台和去中心化应用（DApps）的底层基础设施，其强大的功能离不开与外部世界的交互，而以太坊API（应用程序编程接口）正是实现这种交互的关键桥梁，它允许开发者通过编程方式访问以太坊网络的数据（如账户余额、交易历史、智能合约状态）和发送交易（如转账、调用合约函数），本文将为你提供一个清晰、实用的以太坊API使用教程，帮助你快速上手。

了解以太坊API的类型

在开始之前,我们需要了解以太坊API的几种主要类型，它们各有优劣，适用于不同的场景：

JSON-RPC API：
- 简介：这是以太坊节点（如Geth、Parity）最核心、最基础的API接口，它定义了一系列标准的JSON格式请求和响应，允许客户端与节点进行通信。
- 特点：功能全面，几乎所有节点操作都能通过它完成；但需要自己处理节点连接、请求构建、错误处理等。
- 适用场景：需要直接与节点交互，对控制力要求高，或构建自定义工具的开发者。
WebSocket API：
- 简介：基于JSON-RPC，但提供了全双工通信能力，允许服务器主动向客户端推送实时数据（如新区块、 pending交易、事件日志）。
- 特点：实时性高，能显著减少轮询带来的开销和延迟。
- 适用场景：需要实时监控区块链数据的应用，如行情分析、实时通知系统、高频交易机器人。
第三方API服务 (如Infura, Alchemy, QuickNode)：
- 简介：这些服务商提供了托管的以太坊节点接入服务，你无需自己搭建和维护节点，通过简单的HTTP/HTTPS请求即可访问经过优化的API。
- 特点：使用简单，无需关心节点运维，通常提供更高的稳定性和可用性，以及额外的开发者工具和监控；部分服务可能有免费额度限制。
- 适用场景：大多数DApp开发者，尤其是初创团队和个人开发者，可以快速部署应用，降低运维成本。

准备工作：环境与工具

在开始调用API之前,你需要准备以下几样东西：

以太坊节点访问：
- 选择1：使用第三方服务（推荐新手）
  - 访问 Infura、Alchemy 或 QuickNode 等网站。
  - 注册账号并创建一个新的项目,你会得到一个HTTP/HTTPS或WebSocket的API端点（URL）。
- 选择2：运行本地节点
  - 下载并安装以太坊客户端,如 Geth 或 Nethermind。
  - 启动节点并开启RPC服务（Geth命令行中加上 --http 和 --http.addr "0.0.0.0" --http.port "8545" 参数）。
  - 本地节点的默认RPC地址通常是

>http://localhost:8545。

API调用工具：

Postman：一款流行的API测试工具，可以方便地发送HTTP/HTTPS请求并查看响应。
cURL：命令行工具，适合快速测试API。
编程语言库：如JavaScript的 web3.js 或 ethers.js，Python的 web3.py，这些库封装了底层API调用，使开发更便捷。

以太坊钱包（可选，用于发送交易）：

如果你需要发送交易（如转账），你需要一个包含ETH的钱包（如MetaMask），并导出私钥或助记词（注意：私钥极度敏感，切勿泄露！）。

实战：通过HTTP调用JSON-RPC API

我们以第三方服务（如Infura）为例，使用cURL命令来演示几个常用的JSON-RPC API调用。

假设你的Infura HTTP API端点是 https://mainnet.infura.io/v3/YOUR_PROJECT_ID。

获取最新区块号：

请求方法：POST

请求体 (JSON)：

{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
}

cURL命令：

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' https://mainnet.infura.io/v3/YOUR_PROJECT_ID

响应示例：

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1a3f2e" // 十六进制区块号
}

获取指定地址的ETH余额：

请求方法：POST
请求体 (JSON)：
```
{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e", "latest"],
    "id": 1
}
```
- params[0]：要查询的以太坊地址。
- params[1]：区块号或 "latest"（最新区块）、"pending"（待处理区块）。

cURL命令（替换地址和YOUR_PROJECT_ID）：

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x742d35Cc6634C0532925a3b844Bc454e4438f44e","latest"],"id":1}' https://mainnet.infura.io/v3/YOUR_PROJECT_ID

响应示例：

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x1a05f200" // 十六进制余额，单位为Wei
}

发送交易（转账）：
- 这比查询操作复杂,需要构造一个包含from, to, value, gas, gasPrice, nonce等参数的交易对象，并用发送者的私钥进行签名。
- 步骤：
  1. 获取nonce：eth_getTransactionCount
  2. 估算gas：eth_estimateGas
  3. 构造交易对象。
  4. 使用私钥对交易对象进行签名（通常在客户端完成，如MetaMask或代码库）。
  5. 发送已签名的交易：eth_sendRawTransaction
- 示例cURL（需替换为实际签名后的交易数据）：
```
curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":["0xSignedTransactionData..."],"id":1}' https://mainnet.infura.io/v3/YOUR_PROJECT_ID
```

使用Web3.js库简化API调用（JavaScript示例）

手动构造JSON-RPC请求比较繁琐，使用Web3.js这样的库可以大大简化开发。

安装Web3.js：
```
npm install web3
```

示例代码：

const Web3 = require('web3');
// 连接到以太坊节点（使用Infura）
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_PROJECT_ID');
// 获取最新区块号
async function getLatestBlockNumber() {
    try {
        const blockNumber = await web3.eth.getBlockNumber();
        console.log('Latest block number:', blockNumber);
    } catch (error) {
        console.error('Error fetching block number:', error);
    }
}
// 获取地址余额
async function getBalance(address) {
    try {
        const balance = await web3.eth.getBalance(address);
        console.log(`Balance of ${address}:`, web3.utils.fromWei(balance, 'ether'), 'ETH');
    } catch (error) {
        console.error('Error fetching balance:', error);
    }
}
// 调用函数
getLatestBlockNumber();
getBalance('0x742d35Cc6634C0532925a3b844Bc454e