> ## Documentation Index
> Fetch the complete documentation index at: https://voltaire.tevm.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# WASM Implementation

> WebAssembly-accelerated Address methods compiled from Zig

<Card title="Try it Live" icon="play" href="https://playground.tevm.sh?example=primitives/address.ts">
  Run Address examples in the interactive playground
</Card>

# WASM Implementation

WebAssembly-accelerated implementations of Address methods, compiled from Zig using ReleaseSmall mode.

## Overview

WASM implementations provide performance-critical operations using compiled Zig code targeting WebAssembly. These are **purely opt-in** replacements for the JavaScript implementations with identical APIs.

All WASM methods are compiled from [address.zig](https://github.com/evmts/voltaire/blob/main/src/primitives/Address/address.zig) with `ReleaseSmall` optimization targeting minimal bundle size.

## Quick Start

<Tabs>
  <Tab title="Direct Import">
    ```typescript theme={null}
    // Import WASM implementation instead of JS version
    import { Address } from 'tevm/Address.wasm'

    // API is identical to JS version
    const addr = Address("0x742d35Cc6634C0532925a3b844Bc9e7595f51e3e")
    addr.toChecksummed() // Uses WASM acceleration
    addr.equals(other)    // Uses WASM acceleration
    ```
  </Tab>

  <Tab title="Override Static Methods">
    ```typescript theme={null}
    import { Address } from 'tevm'
    import * as WasmAddress from 'tevm/Address.wasm'

    // Override specific methods with WASM versions
    Address.fromHex = WasmAddress.fromHex
    Address.toChecksummed = WasmAddress.toChecksummed
    Address.equals = WasmAddress.equals

    // Now uses WASM implementations
    const addr = Address("0x742d35Cc...")
    ```
  </Tab>
</Tabs>

## Performance

WASM implementations provide significant speedup for computationally intensive operations:

* **Hex parsing** - Native byte manipulation vs JavaScript string operations
* **Checksumming** - keccak256 hashing in compiled code
* **Comparisons** - Memory-efficient byte-by-byte comparison
* **Contract address calculation** - RLP encoding and hashing in Zig

<Tip title="When to use WASM">
  Use WASM when processing large numbers of addresses (bulk validation, sorting, checksum verification). For single operations, JS overhead may outweigh WASM benefits.
</Tip>

## API Reference

WASM implementations match the standard Address API. See main documentation:

* [Constructors](/primitives/address/constructors) - `fromHex`, `fromBytes`, `fromNumber`, `fromPublicKey`, `fromAbiEncoded`
* [Conversions](/primitives/address/conversions) - `toHex`, `toChecksummed`, `toLowercase`, `toUppercase`, `toU256`, `toAbiEncoded`, `toShortHex`
* [Validation](/primitives/address/validation) - `isValid`, `isValidChecksum`, `is`
* [Comparisons](/primitives/address/comparisons) - `equals`, `compare`, `lessThan`, `greaterThan`, `isZero`
* [Contract Addresses](/primitives/address/contract-addresses) - `calculateCreateAddress`, `calculateCreate2Address`