1
月
在社区成长 1 月
LEVEL 1
1 XP
## 背景：先弄清“钱包在做什么”
刚接触 Web3，常见的困惑是：钱包是不是账户、转账为什么要付 Gas、测试网币有没有价值、网站为什么会请求签名？理解这些问题，最好亲手完成一次**测试网读取和写入**。本文以以太坊 Sepolia 测试网为例，使用浏览器钱包和一个公开的测试合约完成交互。全程不接触真实资产，也不需要把助记词交给任何网站。
钱包通常负责管理私钥、展示地址，并在用户确认后对交易或消息签名。地址可以公开分享；私钥和助记词则相当于控制资产的凭据，不能发给客服、贴到代码仓库或输入陌生网页。区块链节点保存链上状态，钱包和 DApp 通过 RPC 节点查询状态、提交签名后的交易。签名并不等于“登录”：签名内容可能是普通消息，也可能是转账或授权，必须先看清请求的用途。
## 原理：读操作与写操作有什么区别
链上交互大致分为两类：
- **读取（read）**：查询余额、合约状态等，不改变链上状态，通常不需要钱包签名，也不消耗用户支付的 Gas。
- **写入（write）**：发起转账、调用会改变状态的合约方法，需要钱包签名并广播交易。交易被打包后会消耗 Gas；测试网上的 Gas 由测试币支付。
智能合约的 ABI 可以理解为调用接口的描述，合约地址则是链上程序的位置。地址和 ABI 要来自可信文档或官方发布页面，不能因为搜索结果或社群消息看起来熟悉就直接照用。本文只做只读查询，避免把不必要的写入操作误当成入门步骤。
## 前置条件
1. 安装一个从官方渠道获取的浏览器钱包，例如 MetaMask。创建钱包后，把助记词离线妥善保存；不要截图上传，也不要发给任何人。
2. 在钱包网络列表中选择 **Sepolia**。确认页面顶部显示的是测试网，而不是 Ethereum 主网。若钱包默认隐藏测试网，可在钱包设置中启用测试网络。
3. 如需测试币，从钱包官方帮助页提供的水龙头入口申请少量 Sepolia ETH。水龙头可能要求登录、持有一定条件或限制领取频率；具体规则会变化。不要为领测试币向陌生人付费，也不要在水龙头页面输入助记词或私钥。
4. 准备一个现代浏览器。本文采用 Etherscan 的 Sepolia 浏览器查阅公开合约信息；浏览器只是查询工具，不需要连接钱包即可浏览公开数据。
## 分步骤实践：核对网络并查看一笔交易
### 第一步：检查钱包网络和地址
打开钱包，确认网络名称是 Sepolia，并复制公开地址。地址可以用于接收测试币或查询链上记录，但它不是秘密。若页面显示主网，先切换网络；在不确定当前网络时，不要确认任何交易。
### 第二步：打开 Sepolia 区块浏览器
手动输入或从可信来源进入 Sepolia Etherscan。在搜索框粘贴自己的公开地址，可以查看该地址在 Sepolia 上的交易记录和测试币余额。检查页面的网络标识，避免把主网浏览器与测试网浏览器混淆。浏览器显示的余额是特定网络上的状态，Sepolia ETH 不是可直接当作主网 ETH 使用的资产。
### 第三步：识别交易详情
如果地址有历史交易，打开一笔记录，重点查看：
- **Status**：成功、失败或待处理；失败交易也可能已经消耗部分 Gas。
- **From / To**：发送方与接收方；若 To 是合约地址，交易可能调用了合约。
- **Value**：原生币转账数量；为零不代表没有合约操作。
- **Transaction Fee**：该笔交易实际消耗的费用。
- **Input Data**：调用合约时附带的数据。不要仅凭这一栏的十六进制内容猜测操作含义，应结合合约 ABI 和可靠的合约说明核对。
这一步是只读的，不会改变链上状态，也不需要连接钱包。若自己的地址没有交易记录，说明当前测试网地址尚无可展示活动，不必为了“做出记录”而随意给陌生地址转账。
### 第四步：理解一次只读合约查询的代码形式
下面是一个本地查询示例，使用 Ethers.js 读取 ERC-20 合约的名称、符号和余额。示例只查询公开状态，不签名、不广播交易。请将合约地址替换成**已通过项目官方文档确认的 Sepolia 测试合约地址**；不同代币的地址不能互换。若没有可靠地址，跳过运行，不要从评论区随便复制。
```bash
mkdir web3-read-demo
cd web3-read-demo
npm init -y
npm install ethers
```
创建 `read.mjs`：
```js
import { JsonRpcProvider, Contract, formatUnits } from "ethers";
const rpcUrl = process.env.SEPOLIA_RPC_URL;
const tokenAddress = process.env.TOKEN_ADDRESS;
const ownerAddress = process.env.OWNER_ADDRESS;
if (!rpcUrl || !tokenAddress || !ownerAddress) {
throw new Error("请设置 SEPOLIA_RPC_URL、TOKEN_ADDRESS、OWNER_ADDRESS");
}
const provider = new JsonRpcProvider(rpcUrl);
const network = await provider.getNetwork();
if (network.chainId !== 11155111n) {
throw new Error(`网络不匹配，当前 chainId=${network.chainId}`);
}
const abi = [
"function name() view returns (string)",
"function symbol() view returns (string)",
"function decimals() view returns (uint8)",
"function balanceOf(address) view returns (uint256)"
];
const token = new Contract(tokenAddress, abi, provider);
const [name, symbol, decimals, rawBalance] = await Promise.all([
token.name(),
token.symbol(),
token.decimals(),
token.balanceOf(ownerAddress)
]);
console.log({ name, symbol, balance: formatUnits(rawBalance, decimals) });
```
在终端中设置环境变量后运行：
```bash
export SEPOLIA_RPC_URL="你的Sepolia RPC地址"
export TOKEN_ADDRESS="已核实的测试代币合约地址"
export OWNER_ADDRESS="你的公开钱包地址"
node read.mjs
```
Windows PowerShell 可使用 `$env:SEPOLIA_RPC_URL="..."` 这样的语法设置变量。RPC 服务商可能要求注册或限制请求频率；不要把带有私密访问令牌的 RPC 地址提交到公开仓库。运行前要核对脚本中的 `chainId` 校验，Sepolia 的链 ID 是 `11155111`。这个校验能减少连错网络的风险，但不能证明合约地址可信。
## 风险与注意事项
- **助记词和私钥永不输入网页或代码。** 正常的余额查询不需要它们。任何以“验证钱包”“领取奖励”为由索要助记词的页面，都应立即关闭。
- **确认签名内容。** 消息签名可能被用于登录，也可能被用于其他授权流程；交易签名则可能转移资产或修改合约状态。不要盲目点击确认。
- **测试网不等于无风险。** 测试币没有主网价值，但假网站、恶意扩展和钓鱼链接仍可能窃取真实钱包凭据。测试网也不能替代正式环境的安全审计。
- **核对链、地址和单位。** 同一项目可能在多个网络部署不同合约；小数位也由代币合约决定。展示的余额应按合约的 `decimals` 处理，不要直接把最小单位当成完整代币数量。
- **不要把示例配置中的占位符原样运行。** 地址必须来自项目可信渠道，并在对应网络的区块浏览器核对。合约名称相同不代表地址相同。
- **谨慎处理授权。** 代币授权（approve）可能允许某个合约在额度范围内转走代币。初学阶段先学会识别授权对象和额度；不理解交易内容时取消，不要为了体验而授权真实资产。
## 常见问题
**Sepolia ETH 能兑换成主网 ETH 吗？** 不能把它当作有主网价值的资产。它用于测试网交易和支付测试网 Gas，获取方式以官方水龙头规则为准。
**查询余额为什么不需要连接钱包？** 区块链公开数据可以由 RPC 节点读取。连接钱包主要是为了让 DApp 获得地址上下文，或在用户确认后请求签名，并不是读取公开数据的必要条件。
**交易失败是不是一定没花费？** 不一定。失败交易可能仍消耗已使用的 Gas。应查看区块浏览器中的状态和费用，不要只看钱包弹出的提示。
**脚本报网络不匹配怎么办？** 检查 RPC 地址是否确实指向 Sepolia，再核对服务商配置与链 ID。不要为了让脚本通过而删掉网络检查。
**没有代币合约地址怎么办？** 先从项目官方文档、代码仓库发布说明等可信来源查证；无法核实就只做钱包和区块浏览器练习，不需要为了完成教程冒险使用陌生地址。
## 总结
入门链上交互时，先学会区分网络、地址、合约和签名，再从区块浏览器的只读查询开始。本文通过 Sepolia 认识交易详情，并用带链 ID 检查的脚本读取 ERC-20 公开状态；整个过程不需要私钥，也不广播交易。等能解释清楚交易要调用什么、在哪条链上执行、由谁支付 Gas，再考虑在测试网上练习写入操作。安全习惯不是最后补上的步骤，而是每一次连接钱包和确认操作之前都要做的检查。
刚接触 Web3，常见的困惑是：钱包是不是账户、转账为什么要付 Gas、测试网币有没有价值、网站为什么会请求签名？理解这些问题，最好亲手完成一次**测试网读取和写入**。本文以以太坊 Sepolia 测试网为例，使用浏览器钱包和一个公开的测试合约完成交互。全程不接触真实资产，也不需要把助记词交给任何网站。
钱包通常负责管理私钥、展示地址，并在用户确认后对交易或消息签名。地址可以公开分享；私钥和助记词则相当于控制资产的凭据，不能发给客服、贴到代码仓库或输入陌生网页。区块链节点保存链上状态，钱包和 DApp 通过 RPC 节点查询状态、提交签名后的交易。签名并不等于“登录”：签名内容可能是普通消息，也可能是转账或授权，必须先看清请求的用途。
## 原理：读操作与写操作有什么区别
链上交互大致分为两类：
- **读取（read）**：查询余额、合约状态等，不改变链上状态，通常不需要钱包签名，也不消耗用户支付的 Gas。
- **写入（write）**：发起转账、调用会改变状态的合约方法，需要钱包签名并广播交易。交易被打包后会消耗 Gas；测试网上的 Gas 由测试币支付。
智能合约的 ABI 可以理解为调用接口的描述，合约地址则是链上程序的位置。地址和 ABI 要来自可信文档或官方发布页面，不能因为搜索结果或社群消息看起来熟悉就直接照用。本文只做只读查询，避免把不必要的写入操作误当成入门步骤。
## 前置条件
1. 安装一个从官方渠道获取的浏览器钱包，例如 MetaMask。创建钱包后，把助记词离线妥善保存；不要截图上传，也不要发给任何人。
2. 在钱包网络列表中选择 **Sepolia**。确认页面顶部显示的是测试网，而不是 Ethereum 主网。若钱包默认隐藏测试网，可在钱包设置中启用测试网络。
3. 如需测试币，从钱包官方帮助页提供的水龙头入口申请少量 Sepolia ETH。水龙头可能要求登录、持有一定条件或限制领取频率；具体规则会变化。不要为领测试币向陌生人付费，也不要在水龙头页面输入助记词或私钥。
4. 准备一个现代浏览器。本文采用 Etherscan 的 Sepolia 浏览器查阅公开合约信息；浏览器只是查询工具，不需要连接钱包即可浏览公开数据。
## 分步骤实践：核对网络并查看一笔交易
### 第一步：检查钱包网络和地址
打开钱包，确认网络名称是 Sepolia，并复制公开地址。地址可以用于接收测试币或查询链上记录，但它不是秘密。若页面显示主网，先切换网络；在不确定当前网络时，不要确认任何交易。
### 第二步：打开 Sepolia 区块浏览器
手动输入或从可信来源进入 Sepolia Etherscan。在搜索框粘贴自己的公开地址，可以查看该地址在 Sepolia 上的交易记录和测试币余额。检查页面的网络标识，避免把主网浏览器与测试网浏览器混淆。浏览器显示的余额是特定网络上的状态，Sepolia ETH 不是可直接当作主网 ETH 使用的资产。
### 第三步：识别交易详情
如果地址有历史交易，打开一笔记录，重点查看：
- **Status**：成功、失败或待处理；失败交易也可能已经消耗部分 Gas。
- **From / To**：发送方与接收方；若 To 是合约地址，交易可能调用了合约。
- **Value**：原生币转账数量；为零不代表没有合约操作。
- **Transaction Fee**：该笔交易实际消耗的费用。
- **Input Data**：调用合约时附带的数据。不要仅凭这一栏的十六进制内容猜测操作含义，应结合合约 ABI 和可靠的合约说明核对。
这一步是只读的，不会改变链上状态，也不需要连接钱包。若自己的地址没有交易记录，说明当前测试网地址尚无可展示活动，不必为了“做出记录”而随意给陌生地址转账。
### 第四步：理解一次只读合约查询的代码形式
下面是一个本地查询示例，使用 Ethers.js 读取 ERC-20 合约的名称、符号和余额。示例只查询公开状态，不签名、不广播交易。请将合约地址替换成**已通过项目官方文档确认的 Sepolia 测试合约地址**；不同代币的地址不能互换。若没有可靠地址，跳过运行，不要从评论区随便复制。
```bash
mkdir web3-read-demo
cd web3-read-demo
npm init -y
npm install ethers
```
创建 `read.mjs`：
```js
import { JsonRpcProvider, Contract, formatUnits } from "ethers";
const rpcUrl = process.env.SEPOLIA_RPC_URL;
const tokenAddress = process.env.TOKEN_ADDRESS;
const ownerAddress = process.env.OWNER_ADDRESS;
if (!rpcUrl || !tokenAddress || !ownerAddress) {
throw new Error("请设置 SEPOLIA_RPC_URL、TOKEN_ADDRESS、OWNER_ADDRESS");
}
const provider = new JsonRpcProvider(rpcUrl);
const network = await provider.getNetwork();
if (network.chainId !== 11155111n) {
throw new Error(`网络不匹配，当前 chainId=${network.chainId}`);
}
const abi = [
"function name() view returns (string)",
"function symbol() view returns (string)",
"function decimals() view returns (uint8)",
"function balanceOf(address) view returns (uint256)"
];
const token = new Contract(tokenAddress, abi, provider);
const [name, symbol, decimals, rawBalance] = await Promise.all([
token.name(),
token.symbol(),
token.decimals(),
token.balanceOf(ownerAddress)
]);
console.log({ name, symbol, balance: formatUnits(rawBalance, decimals) });
```
在终端中设置环境变量后运行：
```bash
export SEPOLIA_RPC_URL="你的Sepolia RPC地址"
export TOKEN_ADDRESS="已核实的测试代币合约地址"
export OWNER_ADDRESS="你的公开钱包地址"
node read.mjs
```
Windows PowerShell 可使用 `$env:SEPOLIA_RPC_URL="..."` 这样的语法设置变量。RPC 服务商可能要求注册或限制请求频率；不要把带有私密访问令牌的 RPC 地址提交到公开仓库。运行前要核对脚本中的 `chainId` 校验，Sepolia 的链 ID 是 `11155111`。这个校验能减少连错网络的风险，但不能证明合约地址可信。
## 风险与注意事项
- **助记词和私钥永不输入网页或代码。** 正常的余额查询不需要它们。任何以“验证钱包”“领取奖励”为由索要助记词的页面，都应立即关闭。
- **确认签名内容。** 消息签名可能被用于登录，也可能被用于其他授权流程；交易签名则可能转移资产或修改合约状态。不要盲目点击确认。
- **测试网不等于无风险。** 测试币没有主网价值，但假网站、恶意扩展和钓鱼链接仍可能窃取真实钱包凭据。测试网也不能替代正式环境的安全审计。
- **核对链、地址和单位。** 同一项目可能在多个网络部署不同合约；小数位也由代币合约决定。展示的余额应按合约的 `decimals` 处理，不要直接把最小单位当成完整代币数量。
- **不要把示例配置中的占位符原样运行。** 地址必须来自项目可信渠道，并在对应网络的区块浏览器核对。合约名称相同不代表地址相同。
- **谨慎处理授权。** 代币授权（approve）可能允许某个合约在额度范围内转走代币。初学阶段先学会识别授权对象和额度；不理解交易内容时取消，不要为了体验而授权真实资产。
## 常见问题
**Sepolia ETH 能兑换成主网 ETH 吗？** 不能把它当作有主网价值的资产。它用于测试网交易和支付测试网 Gas，获取方式以官方水龙头规则为准。
**查询余额为什么不需要连接钱包？** 区块链公开数据可以由 RPC 节点读取。连接钱包主要是为了让 DApp 获得地址上下文，或在用户确认后请求签名，并不是读取公开数据的必要条件。
**交易失败是不是一定没花费？** 不一定。失败交易可能仍消耗已使用的 Gas。应查看区块浏览器中的状态和费用，不要只看钱包弹出的提示。
**脚本报网络不匹配怎么办？** 检查 RPC 地址是否确实指向 Sepolia，再核对服务商配置与链 ID。不要为了让脚本通过而删掉网络检查。
**没有代币合约地址怎么办？** 先从项目官方文档、代码仓库发布说明等可信来源查证；无法核实就只做钱包和区块浏览器练习，不需要为了完成教程冒险使用陌生地址。
## 总结
入门链上交互时，先学会区分网络、地址、合约和签名，再从区块浏览器的只读查询开始。本文通过 Sepolia 认识交易详情，并用带链 ID 检查的脚本读取 ERC-20 公开状态；整个过程不需要私钥，也不广播交易。等能解释清楚交易要调用什么、在哪条链上执行、由谁支付 Gas，再考虑在测试网上练习写入操作。安全习惯不是最后补上的步骤，而是每一次连接钱包和确认操作之前都要做的检查。
