>

初始化Web3实例

你需要创建一个Web3实例,并连接到以太坊节点。

const Web3 = require('web3');
// 使用Infura提供的测试网节点URL (例如Ropsten测试网)
// const provider = new Web3.providers.HttpProvider('https://ropsten.infura.io/v3/YOUR_INFURA_PROJECT_ID');
// 或者连接到本地运行的Geth节点 (默认端口8545)
const provider = new Web3.providers.HttpProvider('http://localhost:8545');
const web3 = new Web3(provider);
// 验证连接
web3.eth.getBlockNumber().then(console.log).catch(console.error);

将 YOUR_INFURA_PROJECT_ID 替换为你自己在Infura上创建的项目ID。

账户管理

与区块链交互（尤其是发送交易）需要账户，Web3.js可以管理账户：

// 获取节点上的账户列表
web3.eth.getAccounts().then(console.log); //  ['0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B', ...]
// 使用特定账户
const account = '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B';
// 获取账户余额
web3.eth.getBalance(account).then(balance => {
    console.log(`Balance of ${account}: ${web3.utils.fromWei(balance, 'ether')} ETH`);
});

与智能合约交互

这是Web3.js的核心功能，你需要知道合约的ABI（Application Binary Interface，应用程序二进制接口）和地址。

假设你已经有一个编译好的智能合约（例如SimpleStorage.sol），其ABI和地址如下：

const contractABI = [
    {
        "constant": false,
        "inputs": [{"name": "x", "type": "uint256"}],
        "name": "set",
        "outputs": [],
        "payable": false,
        "stateMutability": "nonpayable",
        "type": "function"
    },
    {
        "constant": true,
        "inputs": [],
        "name": "get",
        "outputs": [{"name": "", "type": "uint256"}],
        "payable": false,
        "stateMutability": "view",
        "type": "function"
    }
];
const contractAddress = '0x1234567890123456789012345678901234567890'; // 替换为你的合约地址
// 创建合约实例
const contract = new web3.eth.Contract(contractABI, contractAddress);
// 调用合约的常量函数 (view/pure函数，不需要gas)
contract.methods.get().call().then(result => {
    console.log('Current stored value:', result);
});
// 调用合约的修改函数 (需要发送交易)
const setValue = 42;
const privateKey = 'YOUR_ACCOUNT_PRIVATE_KEY'; // 注意：实际项目中应使用安全方式存储和管理私钥
web3.eth.accounts.signTransaction({
    from: account,
    to: contractAddress,
    data: contract.methods.set(setValue).encodeABI(),
    gas: 2000000 // 根据合约需求调整gas limit
}, privateKey).then(signedTx => {
    return web3.eth.sendSignedTransaction(signedTx.rawTransaction);
}).then(receipt => {
    console.log('Transaction receipt:', receipt);
    // 交易成功后，可以再次调用get方法获取最新值
    return contract.methods.get().call();
}).then(updatedValue => {
    console.log('Updated stored value:', updatedValue);
}).catch(console.error);

重要提示：

• ABI：是编译智能合约时生成的，描述了合约的接口（函数、事件、结构体等）。
• 合约地址：是部署合约后得到的地址。
• Gas：发送交易需要支付Gas费用，需要设置足够的Gas limit和合理的Gas price。
• 私钥管理：绝对不要将私钥硬编码在代码中！应使用环境变量、加密钱包或专业的密钥管理服务。

监听链上事件

智能合约可以发出事件，Node.js可以监听这些事件：

// 假设我们的合约有一个名为ValueChanged的事件
// event ValueChanged(uint256 oldValue, uint256 newValue);
contract.events.ValueChanged({
    fromBlock: 0 // 从创世块开始监听，或指定特定区块号
}, (error, event) => {
    if (error) {
        console.error('Error listening to event:', error);
    } else {
        console.log('ValueChanged event:', event.returnValues);
    }
});
// 也可以监听特定地址的所有事件
// contract.events.allEvents({...});

实际应用场景与注意事项

1. 构建DApp后端：Node.js可以作为DApp的后端，处理复杂业务逻辑，通过Web3.js与区块链交互,为前端提供API。
2. 自动化脚本：编写脚本定时执行某些链上操作，如数据统计、定期调用合约函数等。
3. 数据分析：连接到区块链节点,获取链上数据进行分析和可视化。
4. 测试与部署：使用Node.js脚本自动化测试智能合约和部署流程。

注意事项：

• 安全性：私钥安全至关重要，避免私钥泄露，考虑使用硬件钱包（如Ledger, Trezor）或托管服务。
• Gas费用：在主网上发送交易需要支付真实的ETH作为Gas费用,测试网则可以使用测试网ETH。
• 网络延迟与重试：区块链交易确认需要时间，网络也可能不稳定,代码中应考虑适当的重试机制和错误处理。
• 节点稳定性：依赖远程节点服务时，要注意其稳定性和速率限制,本地节点需要自行维护。
• 异步编程：Node.js和Web3.js大量使用Promise/async-await,良好的异步编程能力是必须的。

Node.js结合Web3.js（或Ethers.js等库）为开发者提供了强大的工具，使得构建与区块链交互的应用变得前所未有的便捷，从连接节点、管理账户，到调用智能合约、监听事件，Node.js都能胜任，虽然Web