ethereumjs-util

What is ethereumjs-util?

The ethereumjs-util package provides a set of utility functions for Ethereum. These utilities include functions for handling addresses, big numbers, hashing, and encoding/decoding data according to the Ethereum protocol standards. It is a foundational package that can be used to develop Ethereum-based applications, facilitating tasks such as transaction formatting, signature verification, and data conversion.

What are ethereumjs-util's main functionalities?

Address Formatting

Converts an Ethereum address to its checksummed version to prevent case sensitivity errors.

const { toChecksumAddress } = require('ethereumjs-util');
const checksumAddress = toChecksumAddress('0xfb6916095ca1df60bb79ce92ce3ea74c37c5d359');
console.log(checksumAddress);

Hashing

Generates a keccak256 hash of the input data, a common hashing function used in Ethereum.

const { keccak256 } = require('ethereumjs-util');
const hash = keccak256(Buffer.from('hello'));
console.log('Hash:', hash.toString('hex'));

Signature Verification

Signs a message hash with a private key and serializes the signature in a format compatible with RPC calls.

const { ecsign, toRpcSig } = require('ethereumjs-util');
const privateKey = Buffer.from('c87509a1c067bbde7aebb4d3c0a0b8ab8bd02b676c91662b5f41c4ec9863d8ee', 'hex');
const msgHash = keccak256(Buffer.from('hello'));
const sig = ecsign(msgHash, privateKey);
const serializedSig = toRpcSig(sig.v, sig.r, sig.s);
console.log('Signature:', serializedSig);

Other packages similar to ethereumjs-util

web3

Web3 is a comprehensive Ethereum library that includes utilities similar to ethereumjs-util but also provides a wide range of functionalities to interact with Ethereum nodes directly. It covers the entire Ethereum API and is more extensive for building DApps.

ethers

Ethers is a lightweight library that aims to be a complete and compact library for interacting with the Ethereum Blockchain and its ecosystem. It includes utilities for addresses, big numbers, and hashing, similar to ethereumjs-util, but also features a complete set of functions to interact with smart contracts and blockchain data.

README

SYNOPSIS

A collection of utility functions for ethereum. It can be used in node.js or can be in the browser with browserify.

CONTACT

Scrollback or #ethereumjs on freenode

API

properties

• MAX_INTEGER - The max interger that the VM can handle
• TWO_POW256 - 2^256
• SHA3_NULL - SHA3-256 hash of null
• SHA3_RLP_ARRAY - SHA3-256 of an rlp of an empty array
• SHA3_RLP - SHA3-256 hash of the rlp of null
• ETH_UNITS - an array of ethereum units

methods

zeros(number)

Returns buffer filled with 0's

• number - the number bytes to to return

pad(val, length)

pads an array or buffer with leading zeros till it has length bytes

• val - the value to pad
• length - the of the resulting value

unpad(val)

Trims leading zeros from a buffer or an array

• val - a buffer to unpad

intToHex(int)

Converts an Integer into a hex String

• int

intToBuffer(int)

Converts an Integer to a Buffer

• int

bufferToInt(buf)

converts a Buffer to an Interger

• buf

fromSigned(buf)

interpets a Buffer as a signed Integer and returns a Bignum

• buf

toUnsigned(num)

Converts a bignum to an unsigned interger and returns it as a buffer

• num - a bignum

publicToAddress(pubKey)

Returns the ethereum address of a given public key

• pubKey - the public key as a buffer

privateToAddress(privateKey)

Returns the ethereum address of a given private key

• privateKey - the private key as a buffer

privateToPublic(privateKey)

Returns the ethereum public key of a given private key

• privateKey - the private key as a buffer

generateAddress(from, nonce)

Generates an address of a newly created contract

• from - the address creating contract
• nonce - the creating accounts nonce

sha3(a, bytes)

Returns a sha3 of a of the length of bytes

• a the value to hash
• bytes how many bytes the hash should be

defineProperties(self, fields)

defines properties on a Object

• self - the Object to define properties on
• fields - an array fields to define

validate(fields, data)

Validate defined fields

• fields
• data

printBA(ba)

Print a Buffer Array

• ba - an Array of Buffers

baToJSON(ba)

converts a buffer array to JSON

• ba - an Array of Buffers

isHexPrefixed(String)

Returns a Boolean on whether or not the a sting starts with 0x

stripHexPrefix(String)

Removes 0x from a given String

addHexPrefix(String)

Adds 0x to a given string if it does not already start with 0x

TESTING

Node.js Tests use Mocha. Test in the browser use Testling.

LICENSE

GPL