以太坊：Web3.js 0.20 使用说明

web3简介

注意 web3.js 有两个不兼容的版本：0.20.x及1.0beta，1.0对0.20版本做了重构。

本文档是web3.js 0.20.x版本翻译，其对应的官方文档地址在 JavaScript-API 。 如果你使用的是 web3.js 1.0版本，其对应的官方文档地址在 Web3js Readthedocs 。

Web3是一套和以太坊节点进行通信的API，如果我们需要基于以太坊来开发去中心化应用，则web3是必须要了解的内容，例如需要通过Web3来获取节点状态，获取账号信息，调用合约、监听合约事件等等。

译者注: 智能合约是运行在节点提供的虚拟机上，因此调用智能合约也需要像节点发送请求。

基于以太坊开发DApp（去中心化应用程序），可以使用 web3.js库 提供的 web3 对象， 在底层实现上， web3 通 过 RPC调用 与本地节点通信， web3.js 可以与任何暴露了RPC接口的以太坊节点连接。

web3 包含下面几个对象：

• web3.eth 用来与以太坊区块链及合约的交互

• web3.shh 用来与Whisper协议相关交互

• web3.net 用来获取网络相关信息

• web3 主对象 包含一些工具

web3.js使用示例：

• 使用web3.js API在页面中转账

• 使用web3.js 与合约交互及监听合约事件

• 多个API 使用Demo

• 官方示例

• Dapp 模式

想要学习去中心化应用(DAPP)开发，这门课程不容错过 区块链全栈-以太坊DAPP开发实战

引入web3

首先你需要将web3引入到应用工程中，可以通过如下几个方法：

• npm: npm install web3

• bower: bower install web3

• meteor: meteor add ethereum:web3

• vanilla: 链接 dist/web3.min.js

然后你需要创建一个 web3 的实例，设置一个provider。为了保证你不会覆盖一个已有的provider（Mist浏览器或安装了MetaMak的浏览器会提供Provider），需要先检查是否 web3 实例已存在，示例代码如下：

if (typeof web3 !== 'undefined') {
  web3 = new Web3(web3.currentProvider);
} else {
  // set the provider you want from Web3.providers
  web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"));
}

译者注: 官方文档中对于web3的没有更新，现在新的检查方式为：

// 检查是否是新的MetaMask 或 DApp浏览器
var web3Provider;
if (window.ethereum) {
   web3Provider = window.ethereum;
  try {
    // 请求用户授权
    await window.ethereum.enable();
  } catch (error) {
    // 用户不授权时
    console.error("User denied account access")
  }
} else if (window.web3) {   // 老版 MetaMask Legacy dapp browsers...
  web3Provider = window.web3.currentProvider;
} else {
  web3Provider = new Web3.providers.HttpProvider('http://localhost:8545');
}
web3 = new Web3(web3Provider);

成功引入后，你现在可以使用 web3 对象的API 了。

使用回调

由于这套API被设计来与本地的RPC结点交互，所有函数默认使用同步的HTTP的请求。

如果你想发起一个异步的请求。大多数函数允许传一个跟在参数列表后的可选的回调函数来支持异步，回调函数支持 Error-first回调 的风格。

web3.eth.getBlock(48, function(error, result){
    if(!error)
        console.log(JSON.stringify(result));
    else
        console.error(error);
})

批量请求

可以允许将多个请求放入队列，并一次执行。

注意：批量请求并不会更快，在某些情况下，同时发起多个异步请求，也许更快。这里的批量请求主要目的是用来保证请求的串行执行。

var batch = web3.createBatch();
batch.add(web3.eth.getBalance.request('0x0000000000000000000000000000000000000000', 'latest', callback));
batch.add(web3.eth.contract(abi).at(address).balance.request(address, callback2));
batch.execute();

web3.js中的大数处理

如果是一个数据类型的返回结果，通常会得到一个BigNumber对象，因为Javascript不能正确的处理BigNumber，看看下面的例子：

"101010100324325345346456456456456456456"
// "101010100324325345346456456456456456456"
101010100324325345346456456456456456456
// 1.0101010032432535e+38

所以web3.js依赖 BigNumber Library _ 。

var balance = new BigNumber('131242344353464564564574574567456');
// or var balance = web3.eth.getBalance(someAddress);

balance.plus(21).toString(10); // 转化为字符串
// "131242344353464564564574574567477"

下一个例子中，我们会看到，如果有20位以上的浮点值，仍会导致出错。所以推荐尽量让帐户余额以wei为单位，仅仅在需要向用户展示时，才转换为其它单位。

var balance = new BigNumber('13124.234435346456466666457455567456');

balance.plus(21).toString(10); // toString(10) converts it to a number string, but can only show upto 20 digits
// "13145.23443534645646666646" // your number will be truncated after the 20th digit

Web3.js 0.2x.x API 手册

• 主对象 web3
  • web3
  • web3.version
  • web3.isConnected
  • web3.setProvider
  • web3.currentProvider
  • web3.reset
  • web3.sha3
  • web3.toHex
  • web3.toAscii
  • web3.fromAscii
  • web3.toDecimal
  • web3.fromDecimal
  • web3.fromWei
  • web3.toWei
  • web3.toBigNumber
  • web3.isAddress
• 网络对象 net
  • web3.net.listening
  • web3.net.peerCount
• 以太坊交互对象 eth
  • web3.eth.defaultAccount
  • web3.eth.defaultBlock
  • web3.eth.syncing
  • web3.eth.isSyncing
  • web3.eth.coinbase
  • web3.eth.mining
  • web3.eth.hashrate
  • web3.eth.gasPrice
  • 帐户列表 accounts
  • 区块号 blockNumber
  • web3.eth.register
  • web3.eth.unRegister
  • 余额 getBalance
  • web3.eth.getStorageAt
  • web3.eth.getCode
  • 区块 getBlock
  • web3.eth.getBlockTransactionCount
  • web3.eth.getUncle
  • 获取交易 getTransaction
  • 通过区块获取交易 getTransactionFromBlock
  • 获取交易收据 getTransactionReceipt
  • 交易数量 getTransactionCount
  • 发送交易 sendTransaction
  • 发送离线签名交易 sendRawTransaction
  • 签名 sign
  • 消息调用 call
  • 估算 gasLimit estimateGas
  • web3.eth.filter
  • 合约对象 contract
  • 调用合约方法 Contract Methods
  • 监听合约事件 Contract Events
  • 合约所有事件 Contract allEvents
  • web3.eth.getCompilers
  • web3.eth.compile.solidity
  • web3.eth.compile.lll
  • web3.eth.compile.serpent
  • web3.eth.namereg
  • web3.eth.sendIBANTransaction
  • web3.eth.iban
• 数据对象 db
  • web3.db.putString
  • web3.db.getString
  • web3.db.putHex
  • web3.db.getHex
• 通信协议对象 shh
  • 示例
  • web3.shh.post
  • web3.shh.newIdentity
  • web3.shh.hasIdentity
  • web3.shh.newGroup
  • web3.shh.addToGroup
  • web3.shh.filter

Indices and tables

• 索引

• 搜索页面