Address.fromBytes

Create address from raw byte array

Try it Live

Run Address examples in the interactive playground

This page is a placeholder. All examples on this page are currently AI-generated and are not correct. This documentation will be completed in the future with accurate, tested examples.

View the complete executable example at playground/src/examples/primitives/address/from-bytes.ts.

Length Validation

The input must be exactly 20 bytes. Any other length throws an error:

import { Address } from '@tevm/voltaire'

// Valid: 20 bytes
const addr = Address(new Uint8Array(20)) // ✓

// Invalid: too short
try {
  Address(new Uint8Array(19))
} catch (e) {
  console.error(e) // InvalidAddressLengthError
}

// Invalid: too long
try {
  Address(new Uint8Array(21))
} catch (e) {
  console.error(e) // InvalidAddressLengthError
}

Memory Behavior

TypeScript/JavaScript:

• Creates a new Uint8Array (copies input)
• Safe to modify original bytes after creation
• No aliasing between input and result

const original = new Uint8Array(20)
const addr = Address(original)

// Modifying original doesn't affect address
original[0] = 0xFF
console.log(addr[0]) // Still 0x00

Zig:

• Copies to fixed-size array
• Stack-allocated by default
• No heap allocation required

Common Use Cases

Extracting from ABI Encoded Data

// ABI-encoded addresses are left-padded to 32 bytes
const abiEncoded = new Uint8Array(32)
// Last 20 bytes are the address
const addr = Address(abiEncoded.slice(12, 32))

Reading from Buffer

// Parse address from binary data stream
const buffer = new Uint8Array(100)
const offset = 40

const addr = Address(buffer.slice(offset, offset + 20))

Converting from Hash

import { keccak256 } from '@tevm/voltaire/crypto'

// Take last 20 bytes of keccak256 hash
const hash = keccak256(data) // 32 bytes
const addr = Address(hash.slice(12, 32))

Performance

Zero allocation overhead - directly wraps the bytes into branded type.

For repeated conversions, fromBytes() is the fastest constructor:

• No hex parsing required
• No numeric conversion
• Direct memory operation

See Also

• from - Universal constructor
• fromHex - Parse from hex string
• toBytes - Convert to Uint8Array
• fromAbiEncoded - Extract from 32-byte ABI encoding