3
年
来到社区 3 年
LEVEL 100
XP
一、背景：为什么新手应该先从测试网开始
Web3 的核心变化，是用户通过钱包持有密钥，并用签名直接授权链上操作。传统 App 中，账号密码丢失后通常可以找客服重置；非托管钱包一旦丢失助记词或泄露私钥，往往没有中心机构能够恢复。因此，新手学习的第一目标不应是追逐代币，而应是弄清账户、网络、交易、Gas、合约授权分别意味着什么，并在测试网中走完一次可验证、低风险的完整流程。
本文使用本地开发链演示，不接触真实资产，也不针对任何真实网站或 App 做安全测试。你将创建临时钱包、启动本地节点、查询余额、发送交易，并理解移动钱包或 DApp 连接过程中最重要的安全边界。
二、基本原理
1. 地址与私钥：私钥用于生成签名，地址可理解为公开的收款标识。知道地址不能反推出私钥，但拿到私钥的人通常就能控制对应账户。助记词可以派生多个私钥，其敏感级别高于普通密码。
2. 链与 RPC：区块链节点通过 JSON-RPC 提供查询余额、读取合约、广播已签名交易等接口。RPC 不是钱包，也不应替你保管私钥。远程 RPC 提供方能够观察来源 IP、查询内容和地址关联，因此也涉及隐私问题。
3. 签名与交易：钱包先把接收地址、金额、链 ID、Nonce、Gas 等字段组织成交易，再使用私钥签名并广播。链 ID 用于区分网络，Nonce 用于确定账户交易顺序。
4. Gas：链上计算和存储需要成本。即使合约调用最终失败，也可能因节点已经执行计算而消耗 Gas。本地链使用无实际价值的测试余额，适合练习。
5. 授权不等于转账：ERC-20 的 approve 通常是在允许某个合约未来从你的账户划走代币。无限额度授权会扩大风险面，签名前必须确认授权对象、代币和额度。
三、前置条件
准备一台个人电脑，安装 Node.js 18 或更高版本、npm 与终端工具。示例使用 Hardhat 和 ethers，仅在本机 127.0.0.1 上运行。不要导入真实助记词，不要把示例账户用于主网，也不要将本地节点暴露到公网。可用以下命令检查环境：
node -v
npm -v
四、分步骤实践
步骤 1：建立隔离目录并安装工具
mkdir web3-local-lab
cd web3-local-lab
npm init -y
npm install --save-dev hardhat
npm install ethers
执行 npx hardhat --init，根据提示创建一个基础 JavaScript 项目。如果不同版本的初始化界面略有差异，以终端提示为准。实验目录不要同步到公开仓库，尤其不要提交 .env、助记词、私钥或节点返回的测试账户密钥。
步骤 2：启动本地链
在第一个终端运行：
npx hardhat node
本地节点通常会监听 http://127.0.0.1:8545，并输出若干预置测试账户及私钥。这些密钥是公开开发用途，只能在本地实验链使用。看到测试账户拥有大量余额是正常现象，这些余额没有现实价值。
步骤 3：验证 RPC 与链 ID
打开第二个终端，执行：
curl -s -X POST http://127.0.0.1:8545 -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
返回结果通常是十六进制链 ID。本地 Hardhat 网络常见链 ID 为 31337，即十六进制 0x7a69，但应以实际响应为准。核对链 ID 是防止“界面看似相同、实际网络不同”的基本动作。
步骤 4：用脚本查询余额并转账
新建 transfer.js。将 PRIVATE_KEY 的值替换为本地节点输出的第一个测试私钥，将 TO_ADDRESS 替换为第二个测试地址：
const { ethers } = require('ethers');
async function main() {
const provider = new ethers.JsonRpcProvider('http://127.0.0.1:8545');
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
const network = await provider.getNetwork();
const before = await provider.getBalance(process.env.TO_ADDRESS);
console.log('chainId:', network.chainId.toString());
console.log('before:', ethers.formatEther(before));
const tx = await wallet.sendTransaction({
to: process.env.TO_ADDRESS,
value: ethers.parseEther('0.01')
});
console.log('txHash:', tx.hash);
const receipt = await tx.wait();
console.log('status:', receipt.status, 'block:', receipt.blockNumber);
const after = await provider.getBalance(process.env.TO_ADDRESS);
console.log('after:', ethers.formatEther(after));
}
main().catch((err) => { console.error(err); process.exit(1); });
macOS 或 Linux 可运行：
PRIVATE_KEY='本地测试私钥' TO_ADDRESS='本地测试收款地址' node transfer.js
Windows PowerShell 可先执行：
$env
RIVATE_KEY='本地测试私钥'
$env:TO_ADDRESS='本地测试收款地址'
node transfer.js
这里要重点观察交易哈希、回执状态和区块高度，而不是只相信前端弹出的“成功”提示。交易哈希是查询依据，receipt.status 为 1 通常表示执行成功，为 0 表示执行失败。
步骤 5：理解钱包连接而不盲签
将浏览器钱包连接到本地 RPC 时，可手工添加网络：RPC URL 填 http://127.0.0.1:8545，链 ID 填节点实际返回值。仅导入本地节点提供的测试私钥。连接站点通常只是向页面公开地址；真正产生资产影响的是后续签名。
签名前依次核对：当前网络、发起站点域名、交互合约地址、函数名称、收款地址、数额、授权额度和预计 Gas。对于 eth_sign、personal_sign 或 EIP-712 typed data，也不能因为“没有 Gas”就认为无风险：离线签名可能被用作登录凭证、订单或授权证明。看不懂的签名应拒绝。
五、从移动应用安全角度看攻击面与修复方案
1. 私钥落盘：若钱包 App 把助记词明文存入 SharedPreferences、NSUserDefaults、日志、剪贴板或普通数据库，设备备份、调试日志和恶意应用都可能成为泄露渠道。防护上应使用 Android Keystore 或 iOS Keychain 保存受硬件或系统保护的密钥材料，敏感内容不写日志，并限制云备份。
2. 深链与 WalletConnect：恶意页面可能构造深链诱导打开钱包，或用相似域名发起连接。App 应校验 URI 参数、明确展示来源域名和链 ID，对高风险方法给出结构化预览，不能只显示一串十六进制。
3. RPC 篡改与隐私：不可信 RPC 可能返回错误余额、隐藏交易或记录用户地址。钱包应使用 TLS、允许用户核验网络配置，对关键结果可采用多个可信数据源交叉检查。证书固定可以降低部分中间人风险，但必须设计轮换和失效策略，避免更新证书后全量断网。
4. 剪贴板替换：移动端恶意软件可能把复制的收款地址替换成攻击者地址。产品应完整或分段展示首尾之外的可核验信息，支持地址簿和二维码校验；用户发送大额前应先做小额测试。
5. 合约授权：前端被劫持时可能把 approve 的 spender 换成恶意地址。钱包应解码 calldata，显示授权对象与额度；用户应优先使用精确额度，定期在可信区块浏览器或授权管理工具中检查并撤销不再需要的授权。撤销本身也是链上交易，仍需 Gas。
六、风险与注意事项
不要截图、聊天发送或网盘保存助记词；任何索要助记词的客服、空投页面或机器人都应视为高风险。测试钱包与资产钱包彻底分离，主网、测试网和本地链使用不同账户。下载钱包只通过官方渠道，并核对开发者、包名、签名与更新来源。
不要把 RPC 的 8545 端口映射到公网。本地开发节点通常没有认证，预置账户密钥还是公开的；一旦公网可访问，可能遭遇未授权调用、资源消耗和信息暴露。安全测试只在自己的本地环境、授权测试网项目或明确许可的靶场开展。
交易广播前至少检查两次地址。区块链地址区分字符且通常不可撤销，转错链或转错地址未必能找回。测试币只用于练习，不应购买来源不明的所谓“测试币”。
七、常见问题
Q1：钱包显示已连接，为什么不能转账？
A：连接只代表 DApp 获得了公开地址。还要确认钱包所在网络与 DApp 一致、账户有该网络的 Gas 代币、Nonce 正常，并查看节点返回的具体错误。
Q2：交易一直 pending 怎么办？
A：先确认 RPC 正常、链是否出块、Gas 设置是否合理，以及同一账户是否存在更低 Nonce 的待处理交易。本地链重启后状态可能被清空，旧交易哈希也可能无法查询。
Q3：测试网操作绝对安全吗？
A：不是。测试币没有实际价值，不代表助记词、签名和隐私没有价值。若测试网与主网复用同一助记词，钓鱼签名、恶意授权和身份关联仍可能带来主网风险。
Q4：只读调用会消耗 Gas 吗？
A：通过 RPC 执行 eth_call 通常不产生链上交易，也不消耗真实 Gas；但写入状态的方法需要签名并广播。前端按钮名称不能作为判断标准，应查看实际请求方法和钱包弹窗。
Q5：合约显示已验证就一定安全吗？
A：不一定。源码验证只提高透明度，不等于完成安全审计，也不排除代理升级、权限过大、业务逻辑缺陷或前端替换参数。新手应优先使用成熟项目，并限制投入和授权额度。
八、总结
一次合格的 Web3 入门实践，不只是把交易发出去，而是能够回答：私钥在哪里、连接的是哪条链、RPC 信任谁、签名授权了什么、交易是否真正上链、失败时如何从回执定位原因。建议先在本地链反复练习查询、签名、广播和核验，再进入公开测试网；始终让测试账户与真实资产账户隔离。技术上理解交易结构，操作上坚持最小授权、来源核验和拒绝盲签，才能从一开始建立正确的链上安全习惯。
Web3 的核心变化，是用户通过钱包持有密钥，并用签名直接授权链上操作。传统 App 中，账号密码丢失后通常可以找客服重置；非托管钱包一旦丢失助记词或泄露私钥，往往没有中心机构能够恢复。因此，新手学习的第一目标不应是追逐代币，而应是弄清账户、网络、交易、Gas、合约授权分别意味着什么，并在测试网中走完一次可验证、低风险的完整流程。
本文使用本地开发链演示，不接触真实资产，也不针对任何真实网站或 App 做安全测试。你将创建临时钱包、启动本地节点、查询余额、发送交易，并理解移动钱包或 DApp 连接过程中最重要的安全边界。
二、基本原理
1. 地址与私钥：私钥用于生成签名，地址可理解为公开的收款标识。知道地址不能反推出私钥，但拿到私钥的人通常就能控制对应账户。助记词可以派生多个私钥，其敏感级别高于普通密码。
2. 链与 RPC：区块链节点通过 JSON-RPC 提供查询余额、读取合约、广播已签名交易等接口。RPC 不是钱包，也不应替你保管私钥。远程 RPC 提供方能够观察来源 IP、查询内容和地址关联，因此也涉及隐私问题。
3. 签名与交易：钱包先把接收地址、金额、链 ID、Nonce、Gas 等字段组织成交易，再使用私钥签名并广播。链 ID 用于区分网络，Nonce 用于确定账户交易顺序。
4. Gas：链上计算和存储需要成本。即使合约调用最终失败，也可能因节点已经执行计算而消耗 Gas。本地链使用无实际价值的测试余额，适合练习。
5. 授权不等于转账：ERC-20 的 approve 通常是在允许某个合约未来从你的账户划走代币。无限额度授权会扩大风险面，签名前必须确认授权对象、代币和额度。
三、前置条件
准备一台个人电脑，安装 Node.js 18 或更高版本、npm 与终端工具。示例使用 Hardhat 和 ethers，仅在本机 127.0.0.1 上运行。不要导入真实助记词，不要把示例账户用于主网，也不要将本地节点暴露到公网。可用以下命令检查环境：
node -v
npm -v
四、分步骤实践
步骤 1：建立隔离目录并安装工具
mkdir web3-local-lab
cd web3-local-lab
npm init -y
npm install --save-dev hardhat
npm install ethers
执行 npx hardhat --init，根据提示创建一个基础 JavaScript 项目。如果不同版本的初始化界面略有差异，以终端提示为准。实验目录不要同步到公开仓库，尤其不要提交 .env、助记词、私钥或节点返回的测试账户密钥。
步骤 2：启动本地链
在第一个终端运行：
npx hardhat node
本地节点通常会监听 http://127.0.0.1:8545，并输出若干预置测试账户及私钥。这些密钥是公开开发用途，只能在本地实验链使用。看到测试账户拥有大量余额是正常现象，这些余额没有现实价值。
步骤 3：验证 RPC 与链 ID
打开第二个终端，执行：
curl -s -X POST http://127.0.0.1:8545 -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
返回结果通常是十六进制链 ID。本地 Hardhat 网络常见链 ID 为 31337，即十六进制 0x7a69，但应以实际响应为准。核对链 ID 是防止“界面看似相同、实际网络不同”的基本动作。
步骤 4：用脚本查询余额并转账
新建 transfer.js。将 PRIVATE_KEY 的值替换为本地节点输出的第一个测试私钥，将 TO_ADDRESS 替换为第二个测试地址：
const { ethers } = require('ethers');
async function main() {
const provider = new ethers.JsonRpcProvider('http://127.0.0.1:8545');
const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
const network = await provider.getNetwork();
const before = await provider.getBalance(process.env.TO_ADDRESS);
console.log('chainId:', network.chainId.toString());
console.log('before:', ethers.formatEther(before));
const tx = await wallet.sendTransaction({
to: process.env.TO_ADDRESS,
value: ethers.parseEther('0.01')
});
console.log('txHash:', tx.hash);
const receipt = await tx.wait();
console.log('status:', receipt.status, 'block:', receipt.blockNumber);
const after = await provider.getBalance(process.env.TO_ADDRESS);
console.log('after:', ethers.formatEther(after));
}
main().catch((err) => { console.error(err); process.exit(1); });
macOS 或 Linux 可运行：
PRIVATE_KEY='本地测试私钥' TO_ADDRESS='本地测试收款地址' node transfer.js
Windows PowerShell 可先执行：
$env
RIVATE_KEY='本地测试私钥'$env:TO_ADDRESS='本地测试收款地址'
node transfer.js
这里要重点观察交易哈希、回执状态和区块高度，而不是只相信前端弹出的“成功”提示。交易哈希是查询依据，receipt.status 为 1 通常表示执行成功，为 0 表示执行失败。
步骤 5：理解钱包连接而不盲签
将浏览器钱包连接到本地 RPC 时，可手工添加网络：RPC URL 填 http://127.0.0.1:8545，链 ID 填节点实际返回值。仅导入本地节点提供的测试私钥。连接站点通常只是向页面公开地址；真正产生资产影响的是后续签名。
签名前依次核对：当前网络、发起站点域名、交互合约地址、函数名称、收款地址、数额、授权额度和预计 Gas。对于 eth_sign、personal_sign 或 EIP-712 typed data，也不能因为“没有 Gas”就认为无风险：离线签名可能被用作登录凭证、订单或授权证明。看不懂的签名应拒绝。
五、从移动应用安全角度看攻击面与修复方案
1. 私钥落盘：若钱包 App 把助记词明文存入 SharedPreferences、NSUserDefaults、日志、剪贴板或普通数据库，设备备份、调试日志和恶意应用都可能成为泄露渠道。防护上应使用 Android Keystore 或 iOS Keychain 保存受硬件或系统保护的密钥材料，敏感内容不写日志，并限制云备份。
2. 深链与 WalletConnect：恶意页面可能构造深链诱导打开钱包，或用相似域名发起连接。App 应校验 URI 参数、明确展示来源域名和链 ID，对高风险方法给出结构化预览，不能只显示一串十六进制。
3. RPC 篡改与隐私：不可信 RPC 可能返回错误余额、隐藏交易或记录用户地址。钱包应使用 TLS、允许用户核验网络配置，对关键结果可采用多个可信数据源交叉检查。证书固定可以降低部分中间人风险，但必须设计轮换和失效策略，避免更新证书后全量断网。
4. 剪贴板替换：移动端恶意软件可能把复制的收款地址替换成攻击者地址。产品应完整或分段展示首尾之外的可核验信息，支持地址簿和二维码校验；用户发送大额前应先做小额测试。
5. 合约授权：前端被劫持时可能把 approve 的 spender 换成恶意地址。钱包应解码 calldata，显示授权对象与额度；用户应优先使用精确额度，定期在可信区块浏览器或授权管理工具中检查并撤销不再需要的授权。撤销本身也是链上交易，仍需 Gas。
六、风险与注意事项
不要截图、聊天发送或网盘保存助记词；任何索要助记词的客服、空投页面或机器人都应视为高风险。测试钱包与资产钱包彻底分离，主网、测试网和本地链使用不同账户。下载钱包只通过官方渠道，并核对开发者、包名、签名与更新来源。
不要把 RPC 的 8545 端口映射到公网。本地开发节点通常没有认证，预置账户密钥还是公开的；一旦公网可访问，可能遭遇未授权调用、资源消耗和信息暴露。安全测试只在自己的本地环境、授权测试网项目或明确许可的靶场开展。
交易广播前至少检查两次地址。区块链地址区分字符且通常不可撤销，转错链或转错地址未必能找回。测试币只用于练习，不应购买来源不明的所谓“测试币”。
七、常见问题
Q1：钱包显示已连接，为什么不能转账？
A：连接只代表 DApp 获得了公开地址。还要确认钱包所在网络与 DApp 一致、账户有该网络的 Gas 代币、Nonce 正常，并查看节点返回的具体错误。
Q2：交易一直 pending 怎么办？
A：先确认 RPC 正常、链是否出块、Gas 设置是否合理，以及同一账户是否存在更低 Nonce 的待处理交易。本地链重启后状态可能被清空，旧交易哈希也可能无法查询。
Q3：测试网操作绝对安全吗？
A：不是。测试币没有实际价值，不代表助记词、签名和隐私没有价值。若测试网与主网复用同一助记词，钓鱼签名、恶意授权和身份关联仍可能带来主网风险。
Q4：只读调用会消耗 Gas 吗？
A：通过 RPC 执行 eth_call 通常不产生链上交易，也不消耗真实 Gas；但写入状态的方法需要签名并广播。前端按钮名称不能作为判断标准，应查看实际请求方法和钱包弹窗。
Q5：合约显示已验证就一定安全吗？
A：不一定。源码验证只提高透明度，不等于完成安全审计，也不排除代理升级、权限过大、业务逻辑缺陷或前端替换参数。新手应优先使用成熟项目，并限制投入和授权额度。
八、总结
一次合格的 Web3 入门实践，不只是把交易发出去，而是能够回答：私钥在哪里、连接的是哪条链、RPC 信任谁、签名授权了什么、交易是否真正上链、失败时如何从回执定位原因。建议先在本地链反复练习查询、签名、广播和核验，再进入公开测试网；始终让测试账户与真实资产账户隔离。技术上理解交易结构，操作上坚持最小授权、来源核验和拒绝盲签，才能从一开始建立正确的链上安全习惯。