Skip to main content

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.

Creates a CallData instance from various input types. Primary constructor that accepts hex strings, Uint8Arrays, or existing CallData instances.

​
Signature

function from(value: string | Uint8Array | CallDataType): CallDataType

​
Parameters

  • value - Input to convert to CallData:
    • string - Hex string (with or without 0x prefix)
    • Uint8Array - Raw byte array
    • CallDataType - Existing CallData instance (returns as-is)

​
Returns

CallDataType - Branded Uint8Array representing transaction calldata

​
Examples

import { CallData } from '@tevm/voltaire';

// With 0x prefix
const calldata1 = CallData("0xa9059cbb000000000000000000000000...");

// Without 0x prefix
const calldata2 = CallData("a9059cbb000000000000000000000000...");

// Both produce identical CallData
console.log(CallData.equals(calldata1, calldata2)); // true

​
Validation

Validates input format and structure: 
import { CallData } from '@tevm/voltaire';

// Must be valid hex
try {
  CallData("0xGGGG"); // Invalid hex characters
} catch (error) {
  console.error("Invalid hex string");
}

// Must have at least selector (4 bytes)
try {
  CallData("0x1234"); // Only 2 bytes
} catch (error) {
  console.error("CallData must be at least 4 bytes");
}

// Valid
const calldata = CallData("0xa9059cbb");
console.log(calldata.length); // 4 (selector only)

​
Use Cases

​
Parsing Transaction Data

import { CallData } from '@tevm/voltaire';

interface Transaction {
  to: string;
  data: string;
}

function parseTransaction(tx: Transaction) {
  const calldata = CallData(tx.data);
  const selector = CallData.getSelector(calldata);

  console.log("Function selector:", selector);
  return calldata;
}

​
Normalized Input

import { CallData } from '@tevm/voltaire';

// Accept various formats, normalize to CallData
function processCallData(
  input: string | Uint8Array | CallDataType
): CallDataType {
  return CallData(input); // Handles all types
}

// Usage
processCallData("0xa9059cbb...");
processCallData(new Uint8Array([0xa9, 0x05, 0x9c, 0xbb]));
processCallData(existingCallData);

​
Type Safety

TypeScript enforces CallData brand: 
import { CallData, type CallDataType } from '@tevm/voltaire';

// Type error: Uint8Array not assignable to CallDataType
const bytes = new Uint8Array([0xa9, 0x05, 0x9c, 0xbb]);
const calldata: CallDataType = bytes; // ❌ Type error

// Correct: Use constructor
const calldata: CallDataType = CallData(bytes); // ✅
  • fromHex - Parse hex string specifically
  • fromBytes - Create from Uint8Array
  • encode - Encode function call
  • isValid - Validate before constructing