toBytes

Encodes a string, hex value, number or boolean to a byte array.

Shortcut Functions:

Import

import { toBytes } from 'viem'

Usage

import { toBytes } from 'viem'
 
toBytes('Hello world')
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])
 
toBytes('0x48656c6c6f20576f726c6421')
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])
 
toBytes(420)
// Uint8Array([1, 164])
 
toBytes(true)
// Uint8Array([1])

Returns

ByteArray

The byte array represented as a Uint8Array.

Parameters

value

Type: string | Hex

The value to encode as bytes.

toBytes(
  'Hello world'
)
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])

options

toBytes(
  'Hello world', 
  { size: 32 } 
)
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0])

Shortcut Functions

hexToBytes

Type: Hex

Encodes a hex value to a byte array.

import { hexToBytes } from 'viem'
 
hexToBytes('0x48656c6c6f20576f726c6421') 
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])
 
hexToBytes('0x48656c6c6f20576f726c6421', { size: 32 }) 
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0])

stringToBytes

Type: Hex

Encodes a string to a byte array.

import { stringToBytes } from 'viem'
 
stringToBytes('Hello world') 
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33])
 
stringToBytes('Hello world', { size: 32 }) 
// Uint8Array([72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100, 33, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0])

numberToBytes

Type: number | bigint

Encodes a number to a byte array.

import { numberToBytes } from 'viem'
 
numberToBytes(420) 
// Uint8Array([1, 164])
 
numberToBytes(420, { size: 32 }) 
// Uint8Array([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 164])

boolToBytes

Type: boolean

Encodes a boolean to a byte array.

import { boolToBytes } from 'viem'
 
boolToBytes(true) 
// Uint8Array([1])
 
boolToBytes(true, { size: 32 }) 
// Uint8Array([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1])