​

ENS (Ethereum Name Service)

​

Overview

• Normalization - ENSIP-15 compliant name normalization and beautification
• Validation - Character set, script mixing, and confusable detection
• Security - Homograph attack prevention and security best practices
• Performance - 5-6x faster normalization via WebAssembly
• Standards - Full ENSIP-1, 10, and 15 compliance

​

Quick Start

import {
  normalize,
  beautify,
  is,
  from,
  toString
} from 'tevm/Ens';

// Normalize ENS name
const normalized = normalize("Nick.ETH");
// Returns: "nick.eth"

// Beautify (preserve emoji)
const beautified = beautify("💩.eth");

// Type guard
if (is(value)) {
  // value is BrandedEns
}

// Convert to/from string
const branded = from("vitalik.eth");
const plain = toString(branded);

​

Effect Schema

import { EnsSchema } from '@tevm/voltaire/Ens/effect'

const ens = EnsSchema.from('vitalik.eth')
ens.namehash() // Uint8Array(32)
ens.normalize().toString() // 'vitalik.eth'

​

Core Functions

​

normalize(name)

normalize(name: string): string

​

beautify(name)

beautify(name: string): string

​

from(name)

from(name: string): BrandedEns

​

toString(ens)

toString(ens: BrandedEns): string

​

is(value)

is(value: unknown): value is BrandedEns

​

Types

import type { brand } from 'tevm/brand';

type BrandedEns = string & { readonly [brand]: "Ens" }

​

Security

​

Related Projects

​

See Also

• Ens (Effect) - Effect.ts integration with Schema validation
• Normalization - ENSIP-15 details
• Validation - Name validation rules
• Security - Homograph attack prevention
• ENSIP Standards - ENS improvement proposals
• z-ens-normalize - Zig ENSIP-15 implementation