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.

​
Comparison

How Voltaire’s request builders compare to other Ethereum libraries.

​
vs Raw EIP-1193

FeatureRaw EIP-1193Voltaire Request Builders
Method callsrequest({ method, params })Request builder + request()
ParametersPlain strings/objectsBranded primitive types
Type safetyNone (manual typing)Full compile-time checking
ErrorsThrows exceptionsThrows exceptions
AutocompletionNoYes

​
Example Comparison

// Raw EIP-1193 - no type safety
const balance = await provider.request({
  method: 'eth_getBalance',
  params: ['0x...', 'latest']  // Typos not caught!
});

// Voltaire - fully typed
import * as Rpc from '@tevm/voltaire/jsonrpc';
import * as Address from '@tevm/voltaire/Address';

const balance = await provider.request(
  Rpc.Eth.GetBalanceRequest(Address('0x...'), 'latest')
);

​
vs ethers.js

Featureethers.jsVoltaire
Method styleAbstracted (getBalance)Direct JSON-RPC (eth_getBalance)
TypesRuntime classesBranded primitives (zero overhead)
Type safetyGoodExcellent (branded types)
Tree-shakingLimitedFull
Voltaire provides lower-level JSON-RPC access with maximum type safety and tree-shaking.

​
vs viem

FeatureviemVoltaire
API styleActionsRequest builders
Type systemNarrow typesBranded primitives
Tree-shaking✅ Yes✅ Yes
WASM❌ No✅ Yes (optional)
Multi-language❌ No✅ Yes (TS/Zig/Rust/C)
Both provide excellent type safety. Voltaire adds multi-language support and optional WASM acceleration.

​
When to Use Voltaire

  • Type safety - Branded primitives catch errors at compile time
  • Tree-shaking - Import only what you need
  • Multi-language - Building for TypeScript + Zig/Rust/C
  • WASM acceleration - Performance-critical crypto operations
  • Direct JSON-RPC - Work directly with JSON-RPC spec