web3.js 1.0中文手册

web3
web3.version - 版本信息 web3.modules - 子模块集合对象 web3.setProvider - 设置服务提供器 web3.providers - 服务提供器集合对象 web3.givenProvider - 原生服务提供器 web3.currentProvider - 当前服务提供器 web3.BatchRequest - 批量请求 web3.extend - 模块继承
web3.eth
web3.eth.defaultAccount - 默认账户 web3.eth.defaultBlock - 默认块 web3.eth.getProtocolVersion - 返回协议版本信息 web3.eth.isSyncing - 检查节点是否同步 web3.eth.getCoinbase - 返回挖矿收益账户 web3.eth.isMining - 检查节点是否在挖矿 web3.eth.getHashrate - 返回节点旳哈希计算速度 web3.eth.getGasPrice - 返回当前gas价格 web3.eth.getAccounts - 返回账户列表 web3.eth.getBlockNumber - 返回当前块编号 web3.eth.getBalance - 返回指定账户余额 web3.eth.getStorageAt - 返回指定地址存储内容 web3.eth.getCode - 返回指定地址的代码 web3.eth.getBlock - 返回指定块 web3.eth.getBlockTransactionCount - 返回指定块中的交易数量 web3.eth.getUncle - 返回指定叔伯块 web3.eth.getTransaction - 返回指定交易对象 web3.eth.getTransactionFromBlock - 返回块中指定交易对象 web3.eth.getTransactionReceipt - 返回指定交易的收据 web3.eth.getTransactionCount - 返回指定地址发生的交易数量 web3.eth.sendTransaction - 发送交易 web3.eth.sendSignedTransaction - 发送已签名交易 web3.eth.sign - 为数据生成签名 web3.eth.signTransaction - 为交易生成签名 web3.eth.call - 执行消息调用 web3.eth.estimateGas - 估算gas用量 web3.eth.getPastLogs - 返回历史日志 web3.eth.getCompilers - 返回可用编译器清单 web3.eth.compile.solidity - 编译solidity代码 web3.eth.compile.lll - 编译lll代码 web3.eth.compile.serpent - 编译serpent代码 web3.eth.getWork - 返回当前挖矿工作情况 web3.eth.submitWork - 提交POW解决方案
web3.eth.subscribe
web3.eth.subscribe - 订阅链上事件 web3.eth.clearSubscriptions - 复位订阅状态 web3.eth.subscribe('pendingTransactions') - 订阅挂起交易事件 web3.eth.subscribe('newBlockHeaders') - 订阅区块头生成事件 web3.eth.subscribe('syncing') - 订阅同步事件 web3.eth.subscribe('logs') - 订阅日志
智能合约
web3.eth.Contract - 合约构造函数 options - 合约配置对象 options.address - 合约地址 options.jsonInterface - 合约JSON接口 clone - 克隆合约 deploy - 部署合约 methods - 为合约方法创建交易 call - 调用合约方法 send - 发送合约方法交易 estimateGas - 估算合约方法gas用量 encodeABI - ABI编码合约方法 once - 单次订阅合约事件 events - 订阅合约事件 events.allEvents - 订阅全部事件 getPastEvents - 读取历史事件
账户管理
web3.eth.accounts - 账户管理与交易签名 web3.eth.accounts.create - 创建账户 web3.eth.accounts.privateKeyToAccount - 使用指定私钥创建账户 web3.eth.accounts.recoverTransaction - 提取交易的签名账户 web3.eth.accounts.hashMessage - 计算消息的哈希 web3.eth.accounts.sign - 为数据生成签名 web3.eth.accounts.recover - 提取数据的签名账户 web3.eth.accounts.encrypt - 加密指定私钥 web3.eth.accounts.decrypt - 解密keystore对象 web3.eth.accounts.wallet - 钱包对象 web3.eth.accounts.wallet.create - 在钱包中创建账户 web3.eth.accounts.wallet.add - 向钱包添加已有账户 web3.eth.accounts.wallet.remove - 从钱包中移除指定账户 web3.eth.accounts.wallet.clear - 清空钱包 web3.eth.accounts.wallet.encrypt - 加密钱包 web3.eth.accounts.wallet.decrypt - 解密钱包 web3.eth.accounts.wallet.save - 保存钱包 web3.eth.accounts.wallet.load - 载入钱包
账户交互
web3.eth.personal - 账户交互 web3.eth.personal.newAccount - 创建新账户 web3.eth.personal.sign - 为数据生成签名 web3.eth.personal.ecRecover - 提取数据的签名账户 web3.eth.personal.signTransaction - 为交易生成签名
应用二进制接口ABI
web3.eth.abi - ABI管理 web3.eth.abi.encodeFunctionSignature - 函数编码 web3.eth.abi.encodeEventSignature - 事件编码 web3.eth.abi.encodeParameter - 参数编码 web3.eth.abi.encodeParameters - 参数组编码 web3.eth.abi.encodeFunctionCall - 函数调用编码 web3.eth.abi.decodeParameter - 参数解码 web3.eth.abi.decodeParameters - 参数组解码 web3.eth.abi.decodeLog - 日志解码
辅助工具
web3.utils - 辅助工具函数集 web3.utils.randomHex - 生成伪随机16进制字符串 web3.utils._ - underscore接口 web3.utils.BN - BN.js接口 web3.utils.isBN - 检查给定参数是否BN对象 web3.utils.isBigNumber - 检查给定参数是否为BigNumber对象 web3.utils.sha3 - 计算sha3哈希值 web3.utils.soliditySha3 - solidity方式计算sha3哈希 web3.utils.isHex - 检查给定参数是否为16进制 web3.utils.isHexStrict - 严格模式16进制检查 web3.utils.isAddress - 检查给定参数是否为有效地址 web3.utils.toChecksumAddress - 转换为校验和地址 web3.utils.checkAddressChecksum - 校验地址 web3.utils.toHex - 转换为16进制字符串 web3.utils.toBN - 转换为BN对象 web3.utils.hexToNumberString - 转换为10进制数值字符串 web3.utils.hexToNumber - 转换为数值 web3.utils.numberToHex - 数值转换为16进制表示 web3.utils.hexToUtf8 - 16进制字符串转换为utf-8 web3.utils.hexToAscii - 16进制字符串转换为ascii web3.utils.utf8ToHex - utf-8字符串转换为16进制 web3.utils.asciiToHex - ascii字符串转换为16进制 web3.utils.hexToBytes - 16进制字符串转换为字节数组 web3.utils.toWei - 转换到wei web3.utils.fromWei - 从wei转换到其他以太单位 web3.utils.unitMap - 以太单位换算表 web3.utils.padLeft - 左侧零补齐 web3.utils.padRight - 右侧零补齐
网络交互
web3.*.net - 网络交互 web3.*.net.getId - 返回网络id web3.*.net.isListening - 检查节点监听状态 web3.*.net.getPeerCount - 返回已连接对端节点数
地址转换
web3.eth.Iban - 创建Iban对象 web3.eth.Iban.toAddress - 将iban对象转换为以太坊地址 web3.eth.Iban.toIban - 将以太坊地址转换为Iban对象 web3.eth.Iban.toAddress - 将iban对象转换为以太坊地址 web3.eth.Iban.fromEthereumAddress - 将以太坊地址转换为Iban对象 web3.eth.Iban.fromBban - 使用Bban地址创建Iban对象 web3.eth.Iban.createIndirect - 创建间接Iban对象 web3.eth.Iban.isValid - 检查给定Iban地址是否有效 web3.eth.Iban.isDirect - 检查是否采用直接编码方案 web3.eth.Iban.isIndirect - 检查是否采用间接编码方案 web3.eth.Iban.institution - 返回Iban的机构名称 web3.eth.Iban.client - 返回Iban的客户账号 web3.eth.Iban.toAddress - 实例方法 web3.eth.Iban.toString - 返回Iban地址字符串
whisper协议交互
web3.shh - whisper协议交互 web3.shh.getVersion - 返回whisper协议版本 web3.shh.getInfo - 返回whisper节点信息 web3.shh.setMaxMessageSize - 设置whisper消息大小上限 web3.shh.setMinPoW - 设置节点最小PoW web3.shh.markTrustedPeer - 标记可信节点 web3.shh.newKeyPair - 创建密钥对 web3.shh.addPrivateKey - 使用私钥创建密钥对 web3.shh.deleteKeyPair - 删除指定密钥对 web3.shh.hasKeyPair - 检查节点是否有指定密钥对 web3.shh.getPublicKey - 返回公钥 web3.shh.getPrivateKey - 返回私钥 web3.shh.newSymKey - 创建对称密钥 web3.shh.addSymKey - 添加对称密钥 web3.shh.generateSymKeyFromPassword - 使用指定密码生成对称密钥 web3.shh.hasSymKey - 检查是否有指定对称密钥 web3.shh.getSymKey - 返回对称密钥 web3.shh.post - 发送whisper消息 web3.shh.subscribe - 订阅whisper消息 web3.shh.clearSubscriptions - 清理订阅 web3.shh.newMessageFilter - 创建消息过滤器 web3.shh.deleteMessageFilter - 删除消息过滤器 web3.shh.getFilterMessages - 读取新消息
Swarm交互
web3.bzz - Swarm交互 web3.bzz.upload - 上传到Swarm web3.bzz.download - 从Swarm下载 web3.bzz.pick - 打开文件选择器

web3.js

web3.js是一组用来和本地或远程以太坊节点进行交互的js库,它可以使用HTTP或IPC建立与以太坊节点旳连接。

本文档是web3.js 1.0的API参考手册,其中每个API都包含有示例代码。

web3

web3是顶层包,它包含了所有以太坊相关的模块。

var Web3 = require('web3');

> Web3.utils
> Web3.version
> Web3.modules

// 在支持以太坊的浏览器中,Web3.providers.givenProvider将被自动设置
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

> web3.eth
> web3.shh
> web3.bzz
> web3.utils
> web3.version

web3.eth

web3-eth这个包用来和以太坊区块链与智能合约交互。

var Eth = require('web3-eth');

// "Eth.providers.givenProvider" will be set if in an Ethereum supported browser.
var eth = new Eth(Eth.givenProvider || 'ws://some.local-or-remote.node:8546');


// or using the web3 umbrella package

var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

// -> web3.eth

web3.eth.subscribe

web3.eth.subscribe函数系列的作用是订阅区块链上的事件。

web3.eth.Contract

web3.eth.Contract对象简化了与以太坊区块链上合约的交互。 合约对象的json接口与 相应的智能合约相匹配,web3会自动帮你将所有的调用转化为底层的基于RPC的ABI调用。

这使得与智能合约的交互和操作JavaScript对象一样简单。

web3.eth.accounts

web3.eth.accounts包含了与以太坊账户创建、交易和数据签名相关的函数。

可以单独使用这个包:

var Accounts = require('web3-eth-accounts');

// Passing in the eth or web3 package is necessary to allow retrieving chainId, gasPrice and nonce automatically
// for accounts.signTransaction().
var accounts = new Accounts('ws://localhost:8546');

web3.eth.personal

web3-eth-personal包的作用是与以太坊节点上的账户进行交互。

var Personal = require('web3-eth-personal');

// 在支持以太坊的浏览器中,`Personal.providers.givenProvider`将被自动设置
var personal = new Personal(Personal.givenProvider || 'ws://some.local-or-remote.node:8546');


// 也可以通过web3顶层包使用

var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

// -> web3.eth.personal

web3.eth.Iban

web3.eth.Iban函数系列用于在以太坊地址、IBAN/BBAN地址之间进行转换。

web3.eth.abi

web3.eth.abi函数系列用于将函数调用编码为ABI格式,或者反之。

web3.*.net

web3-net包用来访问以太坊节点旳网络属性。

var Net = require('web3-net');

// 在支持以太坊的浏览器中,Personal.providers.givenProvider被自动赋值
var net = new Net(Net.givenProvider || 'ws://some.local-or-remote.node:8546');


// 也可以使用web3顶层报

var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

// -> web3.eth.net
// -> web3.bzz.net
// -> web3.shh.net

web3.bzz

web3-bzz包用来与去中心化文件存储系统swarm进行交互。

var Bzz = require('web3-bzz');

// 可以自动检测ethereum对象是否存在,将连接到本地节点或swarm-gateways.net
// 可选地,可以指定一个服务提供器URL,当没有指定服务提供器URL时,将使用http://swarm-gateways.net
var bzz = new Bzz(Bzz.givenProvider || 'http://swarm-gateways.net');


// 也可以通过web3顶层包使用

var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

// -> web3.bzz.currentProvider 
// 如果Web3.givenProvider时一个以太坊服务提供器,该属性将被赋值为 http://localhost:8500 ,
//否则被赋值为 http://swarm-gateways.net

// 必要时可以手工设置服务提供器
web3.bzz.setProvider("http://localhost:8500");

web3.shh

web3-shh包用来与whisper协议进行交互,以便进行广播。

var Shh = require('web3-shh');

// `Shh.providers.givenProvider`在支持以太坊的浏览器中将被自动赋值
var shh = new Shh(Shh.givenProvider || 'ws://some.local-or-remote.node:8546');


// 也可以通过web3顶层包使用

var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');

// -> web3.shh

web3.utils

这个包提供以太坊Dapp开发相关的工具函数等。

如果你希望马上开始学习以太坊DApp开发,可以访问我们的在线互动教程:

推荐