@3test/ethereum-utils 中文文档教程

Question

具有以太坊区块链辅助功能的通用以太坊实用程序模块。

0xcert Framework 是一个免费的开源 JavaScript 库，它提供用于构建强大的去中心化应用程序的工具。 请参阅官方文档了解更多详情。

该模块是 0xcert Framework 的组成部分之一。 它是用 TypeScript 编写的，并且得到积极维护。 源代码可在 GitHub 上找到，您还可以在其中找到我们的 问题跟踪器。

Ethereum Utilities

该模块包装了几个有用的以太坊函数，这些函数将通过 0xcert 框架发挥作用。 目前支持的是来自 ethers.js 的这些函数和类：

ABI coder

这将值与打包的 以太坊 ABI 编码。

• encodeParameters(types: any, values: Array<any>): string
• decodeParameters(types: any, data: any): any

编码示例：

import { decodeParameters, encodeParameters } from '0xcert/ethereum-utils/abi';

const types = ['tuple(uint256, uint256[])'];
const values = [[ 42, [ 45 ] ]];
const encodedValues = encodeParameters(types, values);

解码示例：

import { decodeParameters, encodeParameters } from '0xcert/ethereum-utils/abi';

const types = ['tuple(uint256, uint256[])'];
const encoded = '0x' +
  '0000000000000000000000000000000000000000000000000000000000000020' +
  '000000000000000000000000000000000000000000000000000000000000002a' +
  '0000000000000000000000000000000000000000000000000000000000000040' +
  '0000000000000000000000000000000000000000000000000000000000000001' +
  '000000000000000000000000000000000000000000000000000000000000002d';
const values = decodeParameters(types, values);

BigNumber and bigNumberify

这是一个改编自 ethers.js 文档。

import { BigNumber, bigNumberify } from '0xcert/ethereum-utils/big-number';

let gasPriceWei = bigNumberify("20902747399");
let gasLimit = bigNumberify(3000000);

let maxCostWei = gasPriceWei.mul(gasLimit)
console.log("Max Cost: " + maxCostWei.toString());
// "Max Cost: 62708242197000000"

console.log("Number: " + maxCostWei.toNumber());
// throws an Error, the value is too large for JavaScript to handle safely

Address normalization

ethers.js 地址规范化函数实现EIP-55 混合大小写校验和地址编码。

import { getAddress } from '0xcert/ethereum-utils/normalize-address';

let zxcTokenAddress = '0x83e2be8d114f9661221384b3a50d24b96a5653f5';
let zxcTokenAddressNormalized = normalizeAddress(zxcToenAddress);
// 0x83e2BE8d114F9661221384B3a50d24B96a5653F5