1.替换为你的RPC URL

admin 发布于 2026-02-16 4:12 频道：默认分类阅读：1

从零开始构建你的Web3交互桥梁

以太坊作为全球最大的智能合约平台,不仅是加密经济的核心基础设施，更是Web3生态的“操作系统”，无论是开发去中心化应用（DApp）、执行智能合约交互，还是进行链上数据分析，通过代码连接以太坊网络都是开发者的必备技能，本文将详细介绍如何使用主流编程语言和工具，从环境搭建到实际调用，带你打通与以太坊网络的“代码连接”之路。

理解连接以太坊网络的核心：节点与RPC

在开始编码前,我们需要明确一个核心概念：代码如何与以太坊网络通信？ 以太坊作为一个分布式网络，由全球成千上万的节点组成，每个节点都完整存储了区块链数据，开发者无法直接“访问”整个网络，而是需要通过节点提供的RPC（Remote Procedure Call）接口，向节点发送请求（如查询账户余额、发送交易等），并接收节点的响应。

关键选择：节点类型

连接以太坊网络时,开发者可以选择以下三类节点：

全节点：完整存储以太坊所有数据（如Geth、OpenEthereum），同步成本高，但数据最完整，隐私性最好。
归档节点：在全节点基础上存储了所有历史状态数据，可查询任意时间的链上数据，但存储需求极大（数TB）。
轻节点/第三方RPC服务：通过Infura、Alchemy等服务商提供的RPC节点，无需自行维护，适合开发测试，但存在中心化风险和调用频率限制。

对于个人开发者或中小项目,第三方RPC服务是最便捷的选择；若追求去中心化或需要高定制化，可自行搭建全节点。

环境准备：开发工具与依赖库

以最主流的JavaScript/TypeScript（Node.js）和Python为例，我们先完成开发环境的搭建。

JavaScript/TypeScript（Node.js）生态

安装Node.js：从官网下载LTS版本，安装后通过node -v和npm -v验证。

i>安装以太坊交互库：

ethers.js：轻量级、易用，是目前DApp开发的主流选择，支持合约交互、钱包管理、签名等。
web3.js：老牌库，功能全面，但API相对复杂。
```
npm install ethers  
```

Python生态

安装Python：建议3.8+版本，通过python --version验证。
安装以太坊交互库：
- web3.py：Python生态中最成熟的以太坊交互库，支持RPC调用、合约部署与交互。
```
pip install web3  
```

代码实战：连接以太坊网络的核心操作

场景1：通过RPC连接以太坊主网/测试网

无论是哪种语言,连接网络的核心都是初始化provider（提供网络连接的对象），传入RPC URL即可。

JavaScript（ethers.js示例）

const { ethers } = require("ethers");  
// 1. 替换为你的RPC URL（如Infura、Alchemy或本地节点）  
const RPC_URL = "https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID";  
// 2. 创建Provider  
const provider = new ethers.JsonRpcProvider(RPC_URL);  
// 3. 调用网络数据（示例：获取最新区块号）  
provider.getBlockNumber().then((blockNumber) => {  
  console.log("当前最新区块号:", blockNumber);  
}).catch((error) => {  
  console.error("连接失败:", error);  
});

Python（web3.py示例）

from web3 import Web3  
RPC_URL = "https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID"  
# 2. 创建Web3实例  
w3 = Web3(Web3.HTTPProvider(RPC_URL))  
# 3. 检查连接状态并获取最新区块号  
if w3.is_connected():  
    print("连接成功！当前最新区块号:", w3.eth.block_number)  
else:  
    print("连接失败！")

关键说明：

RPC URL获取：Infura（https://infura.io/）或Alchemy（https://www.alchemy.com/）注册后可免费获取，支持主网（如mainnet）、测试网（如sepolia、goerli）。
本地节点：若运行Geth全节点，RPC URL默认为http://localhost:8545。

场景2：查询账户余额与交易数据

连接网络后,最常用的操作是查询链上数据。

JavaScript（查询ETH余额）

const { ethers } = require("ethers");  
const RPC_URL = "https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID";  
const provider = new ethers.JsonRpcProvider(RPC_URL);  
// 替换为要查询的地址（如以太坊创始人Vitalik地址）  
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";  
// 获取ETH余额（单位：wei，转换为ether）  
provider.getBalance(address).then((balance) => {  
  const etherBalance = ethers.formatEther(balance);  
  console.log(`地址 ${address} 的ETH余额: ${etherBalance} ETH`);  
});

Python（查询交易详情）

from web3 import Web3  
RPC_URL = "https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID"  
w3 = Web3(Web3.HTTPProvider(RPC_URL))  
# 替换为要查询的交易哈希  
tx_hash = "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060"  
# 获取交易详情  
tx = w3.eth.get_transaction(tx_hash)  
print("交易发送方:", tx["from"])  
print("交易接收方:", tx["to"])  
print("交易金额:", w3.from_wei(tx["value"], "ether"), "ETH")

场景3：发送交易（示例：转账ETH）

发送交易比查询数据复杂,需要私钥签名（需注意：私钥绝对不要泄露！），实践中推荐使用“钱包抽象”（如MetaMask注入）或硬件钱包，但本文以私钥签名为例演示。

JavaScript（ethers.js发送ETH转账）

const { ethers } = require("ethers");  
const RPC_URL = "https://sepolia.infura.io/v3/YOUR_INFURA_PROJECT_ID";  
const provider = new ethers.JsonRpcProvider(RPC_URL);  
// 1. 创建钱包（需发送方的私钥和地址）  
const privateKey = "YOUR_PRIVATE_KEY"; // 替换为实际私钥  
const wallet = new ethers.Wallet(privateKey, provider);  
// 2. 定义转账参数  
const recipient = "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"; // 接收方地址  
const amount = ethers.parseEther("0.01"); // 转账0.01 ETH（单位：wei）  
// 3. 发送交易并等待确认  
wallet.sendTransaction({  
  to: recipient,  
  value: amount,  
}).then((tx) => {  
  console.log("交易已发送，哈希:", tx.hash);  
  return tx.wait(); // 等待区块确认  
}).then((receipt) => {  
  console.log("交易已确认，区块号:", receipt.blockNumber);  
}).catch((error) => {  
  console.error("交易失败:", error);  
});

Python（web3.py发送ETH转账）

from web3 import Web3  
from web3.eth import Account  
RPC_URL = "https://sepolia.infura.io/v3/YOUR_INFURA_PROJECT_ID"  
w3 = Web3(Web3.HTTPProvider(RPC_URL))  
# 1. 创建账户（需私钥）  
private_key = "YOUR_PRIVATE_KEY".encode()  
account = Account.from_key(private_key)  
sender_address = account.address  
# 2. 获取nonce（防止交易重放）  
nonce = w3.eth.get_transaction_count(sender_address)  
# 3. 构建交易  
tx = {  
    "to": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",  
    "value": w3.to_wei(