Utils
This package provides utility functions for Ethereum dapps and other web3.js packages.
For using Utils functions, first install Web3 package using npm i web3 or yarn add web3.
After that, Web3 Utils functions will be available as mentioned below.
import { Web3 } from 'web3';
const web3 = new Web3();
const value = web3.utils.fromWei("1", "ether")
For using individual package install web3-utils package using npm i web3-utils or yarn add web3-utils and only import required functions.
This is more efficient approach for building lightweight applications.
import { fromWei, soliditySha3Raw } from 'web3-utils';
console.log(fromWei("1", "ether"));
console.log(soliditySha3Raw({ type: "string", value: "helloworld" }))
Functions
asciiToHex
▸ asciiToHex(str): string
Should be called to get hex representation (prefixed by 0x) of ascii string
Parameters
| Name | Type | Description |
|---|---|---|
str | string | String to be converted to hex |
Returns
string
- Hex string
Example
console.log(web3.utils.asciiToHex('Hello World'));
> 0x48656c6c6f20576f726c64
Defined in
packages/web3-utils/src/converters.ts:291
bytesToHex
▸ bytesToHex(bytes): string
Convert a byte array to a hex string
Parameters
| Name | Type | Description |
|---|---|---|
bytes | Bytes | Byte array to be converted |
Returns
string
- The hex string representation of the input byte array
Example
console.log(web3.utils.bytesToHex(new Uint8Array([72, 12])));
> "0x480c"
#### Defined in
[packages/web3-utils/src/converters.ts:125](https://github.com/web3/web3.js/blob/5949ee3/packages/web3-utils/src/converters.ts#L125)
___
### bytesToUint8Array
▸ **bytesToUint8Array**(`data`): `Uint8Array`
Convert a value from bytes to Uint8Array
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `data` | `Bytes` | Data to be converted |
#### Returns
`Uint8Array`
- The Uint8Array representation of the input data
**`Example`**
```ts
console.log(web3.utils.bytesToUint8Array("0xab")));
> Uint8Array(1) [ 171 ]
Defined in
packages/web3-utils/src/converters.ts:91
encodePacked
▸ encodePacked(...values): string
Encode packed arguments to a hexstring
Parameters
| Name | Type |
|---|---|
...values | Sha3Input[] |
Returns
string
Defined in
packages/web3-utils/src/hash.ts:353
fromAscii
▸ fromAscii(str): string
Parameters
| Name | Type |
|---|---|
str | string |
Returns
string
Alias
asciiToHex
Defined in
packages/web3-utils/src/converters.ts:291
fromDecimal
▸ fromDecimal(value, hexstrict?): string
Converts value to it's hex representation
Parameters
| Name | Type |
|---|---|
value | Numbers |
hexstrict? | boolean |
Returns
string
Alias
numberToHex
Defined in
packages/web3-utils/src/converters.ts:182
fromUtf8
▸ fromUtf8(str): string
Parameters
| Name | Type |
|---|---|
str | string |
Returns
string
Alias
utf8ToHex
Defined in
packages/web3-utils/src/converters.ts:227
fromWei
▸ fromWei(number, unit): string
Takes a number of wei and converts it to any other ether unit.
Parameters
| Name | Type | Description |
|---|---|---|
number | Numbers | The value in wei |
unit | "noether" | "wei" | "kwei" | "Kwei" | "babbage" | "femtoether" | "mwei" | "Mwei" | "lovelace" | "picoether" | "gwei" | "Gwei" | "shannon" | "nanoether" | "nano" | "szabo" | "microether" | "micro" | "finney" | "milliether" | "milli" | "ether" | "kether" | "grand" | "mether" | "gether" | "tether" | The unit to convert to |
Returns
string
- Returns the converted value in the given unit
Example
console.log(web3.utils.fromWei("1", "ether"));
> 0.000000000000000001
console.log(web3.utils.fromWei("1", "shannon"));
> 0.000000001
Defined in
packages/web3-utils/src/converters.ts:480
getStorageSlotNumForLongString
▸ getStorageSlotNumForLongString(mainSlotNumber): undefined | string
Get slot number for storage long string in contract. Basically for getStorage method returns slotNumber where will data placed
Parameters
| Name | Type | Description |
|---|---|---|
mainSlotNumber | string | number | the slot number where will be stored hash of long string |
Returns
undefined | string
- the slot number where will be stored long string
Defined in
packages/web3-utils/src/hash.ts:394
hexToAscii
▸ hexToAscii(str): string
Should be called to get ascii from it's hex representation
Parameters
| Name | Type | Description |
|---|---|---|
str | string | Hex string to be converted to ascii |
Returns
string
- Ascii string
Example
console.log(web3.utils.hexToAscii('0x48656c6c6f20576f726c64'));
> Hello World
Defined in
packages/web3-utils/src/converters.ts:318
hexToBytes
▸ hexToBytes(bytes): Uint8Array
Convert a hex string to a byte array
Parameters
| Name | Type |
|---|---|
bytes | string |
Returns
Uint8Array
- The byte array representation of the input hex string
Example
console.log(web3.utils.hexToBytes('0x74657374'));
> Uint8Array(4) [ 116, 101, 115, 116 ]
Defined in
packages/web3-utils/src/converters.ts:139
hexToNumber
▸ hexToNumber(value): number | bigint
Converts value to it's number representation
Parameters
| Name | Type | Description |
|---|---|---|
value | string | Hex string to be converted |
Returns
number | bigint
- The number representation of the input value
Example
conoslle.log(web3.utils.hexToNumber('0xa'));
> 10
Defined in
packages/web3-utils/src/converters.ts:157
hexToNumberString
▸ hexToNumberString(data): string
Converts value to it's decimal representation in string
Parameters
| Name | Type |
|---|---|
data | string |
Returns
string
- The decimal representation of the input value
Example
console.log(web3.utils.hexToNumberString('0xa'));
> "10"
Defined in
packages/web3-utils/src/converters.ts:213
hexToString
▸ hexToString(str): string
Parameters
| Name | Type |
|---|---|
str | string |
Returns
string
Alias
hexToUtf8
Defined in
packages/web3-utils/src/converters.ts:260
hexToUtf8
▸ hexToUtf8(str): string
Should be called to get utf8 from it's hex representation
Parameters
| Name | Type | Description |
|---|---|---|
str | string | Hex string to be converted |
Returns
string
- Utf8 string
Example
console.log(web3.utils.hexToUtf8('0x48656c6c6f20576f726c64'));
> Hello World
Defined in
packages/web3-utils/src/converters.ts:260
keccak256Wrapper
▸ keccak256Wrapper(data): string
A wrapper for ethereum-cryptography/keccak256 to allow hashing a string and a bigint in addition to UInt8Array
Parameters
| Name | Type | Description |
|---|---|---|
data | string | number | bigint | Uint8Array | readonly number[] | the input to hash |
Returns
string
- the Keccak-256 hash of the input
Example
console.log(web3.utils.keccak256Wrapper('web3.js'));
> 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
console.log(web3.utils.keccak256Wrapper(1));
> 0xc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc6
console.log(web3.utils.keccak256Wrapper(0xaf12fd));
> 0x358640fd4719fa923525d74ab5ae80a594301aba5543e3492b052bf4598b794c
Defined in
packages/web3-utils/src/hash.ts:149
numberToHex
▸ numberToHex(value, hexstrict?): string
Converts value to it's hex representation
Parameters
| Name | Type | Description |
|---|---|---|
value | Numbers | Value to be converted |
hexstrict? | boolean | Add padding to converted value if odd, to make it hexstrict |
Returns
string
- The hex representation of the input value
Example
console.log(web3.utils.numberToHex(10));
> "0xa"
Defined in
packages/web3-utils/src/converters.ts:182
processSolidityEncodePackedArgs
▸ processSolidityEncodePackedArgs(arg): string
returns a string of the tightly packed value given based on the type
Parameters
| Name | Type | Description |
|---|---|---|
arg | Sha3Input | the input to return the tightly packed value |
Returns
string
- the tightly packed value
Defined in
packages/web3-utils/src/hash.ts:336
sha3
▸ sha3(data): undefined | string
computes the Keccak-256 hash of the input and returns a hexstring
Parameters
| Name | Type | Description |
|---|---|---|
data | Bytes | the input to hash |
Returns
undefined | string
- the Keccak-256 hash of the input
Example
console.log(web3.utils.sha3('web3.js'));
> 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
console.log(web3.utils.sha3(''));
> undefined
Defined in
packages/web3-utils/src/hash.ts:91
sha3Raw
▸ sha3Raw(data): string
Will calculate the sha3 of the input but does return the hash value instead of null if for example a empty string is passed.
Parameters
| Name | Type | Description |
|---|---|---|
data | Bytes | the input to hash |
Returns
string
- the Keccak-256 hash of the input
Example
conosle.log(web3.utils.sha3Raw('web3.js'));
> 0x63667efb1961039c9bb0d6ea7a5abdd223a3aca7daa5044ad894226e1f83919a
console.log(web3.utils.sha3Raw(''));
> 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470
Defined in
packages/web3-utils/src/hash.ts:123
soliditySha3
▸ soliditySha3(...values): undefined | string
Will tightly pack values given in the same way solidity would then hash. returns a hash string, or null if input is empty
Parameters
| Name | Type | Description |
|---|---|---|
...values | Sha3Input[] | the input to return the tightly packed values |
Returns
undefined | string
- the keccack246 of the tightly packed values
Example
console.log(web3.utils.soliditySha3({ type: "string", value: "31323334" }));
> 0xf15f8da2ad27e486d632dc37d24912f634398918d6f9913a0a0ff84e388be62b
Defined in
packages/web3-utils/src/hash.ts:370
soliditySha3Raw
▸ soliditySha3Raw(...values): string
Will tightly pack values given in the same way solidity would then hash.
returns a hash string, if input is empty will return 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470
Parameters
| Name | Type | Description |
|---|---|---|
...values | TypedObject[] | TypedObjectAbbreviated[] | the input to return the tightly packed values |
Returns
string
- the keccack246 of the tightly packed values
Example
console.log(web3.utils.soliditySha3Raw({ type: "string", value: "helloworld" }))
> 0xfa26db7ca85ead399216e7c6316bc50ed24393c3122b582735e7f3b0f91b93f0
Defined in
packages/web3-utils/src/hash.ts:385
stringToHex
▸ stringToHex(str): string
Parameters
| Name | Type |
|---|---|
str | string |
Returns
string
Alias
utf8ToHex
Defined in
packages/web3-utils/src/converters.ts:227
toAscii
▸ toAscii(str): string
Parameters
| Name | Type |
|---|---|
str | string |
Returns
string
Alias
hexToAscii
Defined in
packages/web3-utils/src/converters.ts:318
toBigInt
▸ toBigInt(value): bigint
Auto converts any given value into it's bigint representation
Parameters
| Name | Type | Description |
|---|---|---|
value | unknown | The value to convert |
Returns
bigint
- Returns the value in bigint representation
Example
console.log(web3.utils.toBigInt(1));
> 1n
Defined in
packages/web3-utils/src/converters.ts:445
toChecksumAddress
▸ toChecksumAddress(address): string
Will convert an upper or lowercase Ethereum address to a checksum address.
Parameters
| Name | Type | Description |
|---|---|---|
address | string | An address string |
Returns
string
The checksum address
Example
web3.utils.toChecksumAddress('0xc1912fee45d61c87cc5ea59dae31190fffff232d');
> "0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d"
Defined in
packages/web3-utils/src/converters.ts:588
toDecimal
▸ toDecimal(value): number | bigint
Converts value to it's number representation
Parameters
| Name | Type |
|---|---|
value | string |
Returns
number | bigint
Alias
hexToNumber
Defined in
packages/web3-utils/src/converters.ts:157
toHex
▸ toHex(value, returnType?): string
Auto converts any given value into it's hex representation.
Parameters
| Name | Type | Description |
|---|---|---|
value | string | number | bigint | boolean | object | Uint8Array | Value to be converted to hex |
returnType? | boolean | If true, it will return the type of the value |
Returns
string
Example
console.log(web3.utils.toHex(10));
> 0xa
console.log(web3.utils.toHex('0x123', true));
> bytes
Defined in
packages/web3-utils/src/converters.ts:342
toNumber
▸ toNumber(value): number | bigint
Converts any given value into it's number representation, if possible, else into it's bigint representation.
Parameters
| Name | Type | Description |
|---|---|---|
value | Numbers | The value to convert |
Returns
number | bigint
- Returns the value in number or bigint representation
Example
console.log(web3.utils.toNumber(1));
> 1
console.log(web3.utils.toNumber(Number.MAX_SAFE_INTEGER));
> 9007199254740991
console.log(web3.utils.toNumber(BigInt(Number.MAX_SAFE_INTEGER)));
> 9007199254740991
console.log(web3.utils.toNumber(BigInt(Number.MAX_SAFE_INTEGER) + BigInt(1)));
> 9007199254740992n
Defined in
packages/web3-utils/src/converters.ts:411
toUtf8
▸ toUtf8(input): string
Parameters
| Name | Type |
|---|---|
input | string | Uint8Array |
Returns
string
Alias
hexToUtf8
Defined in
packages/web3-utils/src/converters.ts:265
toWei
▸ toWei(number, unit): string
Takes a number of a unit and converts it to wei.
Parameters
| Name | Type | Description |
|---|---|---|
number | Numbers | The number to convert. |
unit | "noether" | "wei" | "kwei" | "Kwei" | "babbage" | "femtoether" | "mwei" | "Mwei" | "lovelace" | "picoether" | "gwei" | "Gwei" | "shannon" | "nanoether" | "nano" | "szabo" | "microether" | "micro" | "finney" | "milliether" | "milli" | "ether" | "kether" | "grand" | "mether" | "gether" | "tether" | EtherUnits The unit of the number passed. |
Returns
string
The number converted to wei.
Example
console.log(web3.utils.toWei("0.001", "ether"));
> 1000000000000000 //(wei)
Defined in
packages/web3-utils/src/converters.ts:538
utf8ToHex
▸ utf8ToHex(str): string
Should be called to get hex representation (prefixed by 0x) of utf8 string
Parameters
| Name | Type | Description |
|---|---|---|
str | string | Utf8 string to be converted |
Returns
string
- The hex representation of the input string
Example
console.log(utf8ToHex('web3.js'));
> "0x776562332e6a73"