Operations and Releases
Documents client releases, SDK updates, offchain gateway deployments, and resolver library changes that affect how ENS is operated and integrated. Wallet developers, exchange teams, and dapp operators rely on this group for compatibility guidance, migration instructions, and breaking-change notices in ENS tooling, the ENS app, and CCIP-Read gateway infrastructure.
ENSJS SDK Changelog
Tracks major, minor, and patch releases of the @ensdomains/ensjs library, the primary integration point for front-end developers. Highlights API surface changes, new helper functions for Name Wrapper interactions, and migration guides between major versions. Wallet and dapp teams need this to plan integration upgrades and avoid breaking changes in name resolution and management flows.
ENS App Release Notes
Chronological log of breaking changes, new features, and deprecations in the official ENS Manager App. Covers UI-driven registration flows, name management features, and resolver configuration options. Wallet teams and power users monitor this to understand when user-facing registration and management behaviors change, affecting support workflows and user education.
ENS Subgraph and Indexer Updates
Covers schema changes, new entity tracking, and deprecation notices for the official ENS subgraph. Data analysts, DeFi protocols, and portfolio trackers rely on this to ensure queries for name ownership, expiry, and resolver records remain accurate. Breaking schema changes can silently corrupt offchain data pipelines.
CCIP-Read Gateway Reference Implementations
Tracks versioned releases of the core offchain gateway codebase such as ens-offchain-registrar. Operators of L2 and offchain name services use this to ensure their gateways remain compatible with the latest EIP-3668 handling in clients like ethers.js and viem. Incompatible gateways cause silent resolution failures for end users.
CCIP-Read Client Integration Guide
Practical, versioned guide for wallet and library developers on correctly implementing CCIP-Read (EIP-3668) call handling. Addresses common pitfalls including request batching, gas limit estimation for callback transactions, and handling gateway timeouts or malformed responses. Incorrect implementation leads to broken resolution and potential fund loss.
Offchain Gateway Deployment and Operations Runbook
Guide for running production-grade CCIP-Read gateways covering configuration management, DNS record setup for endpoint discovery, TLS certificate rotation, caching strategies, and monitoring for availability and latency. Gateway operators and infrastructure teams need this to maintain reliable offchain resolution services.
Wildcard Resolution and Subname Gateway Compatibility
Documents operational requirements for gateways serving wildcard domains such as *.project.eth. Focuses on how gateway operators should structure responses to ensure seamless resolution for an infinite set of subnames without causing client-side errors. Critical for L2 and appchain teams deploying subname registrars.
Public Resolver Contract Deployments and Verification
Registry of canonical Public Resolver addresses across Ethereum mainnet, testnets, and major L2s. Integrators must verify they are interacting with legitimate resolver contracts to avoid malicious or deprecated deployments. Covers verification methods and address derivation patterns.
DNS-over-ENS Oracle Updates
Tracks changes to the DNSSEC oracle contracts and verification logic that enable .eth names to be proven against DNS records. Teams integrating traditional web domains into the ENS ecosystem need to understand proof format changes, oracle upgrades, and trust assumptions in the DNSSEC verification chain.
Resolver Library Migration Guides
Step-by-step instructions for migrating from older resolver interfaces such as PublicResolver v1 to newer versions supporting ABI-based record storage, multicall, or EIP-712 typed signatures. Dapps and wallets must update resolution logic safely to avoid data corruption or failed transactions during migration.
Text Record Key Standardization and Conventions
Documents the operational consensus on text record keys such as avatar, url, and com.twitter beyond formal EIPs. Tracks community-adopted conventions that wallets and dapps use to display rich profile information. Fragmentation in key usage causes inconsistent user experiences across platforms.
Name Wrapper Contract Release and Migration
Covers the initial launch and subsequent upgrades to the Name Wrapper contract. Details the migration path for unwrapped names, technical implications of fuse-burning, and how ERC-1155 ownership changes affect NFT marketplaces and custody solutions. Custodians and marketplaces need this to support wrapped names safely.
.eth Registrar Controller Upgrades
Tracks changes to the controller contracts governing registration and renewal for .eth second-level domains. Includes updates to pricing oracles, commitment schemes, and new registration features such as fuses set at registration time. Exchanges and registrars must update their automated renewal systems to match controller changes.
Fuse Management and Emancipation Guide
Operational guide for dapps and advanced users on managing Name Wrapper fuses. Explains the irreversible nature of burning the PARENT_CANNOT_CONTROL fuse and provides patterns for safely creating emancipated subnames for custody and lending protocols. Incorrect fuse management can permanently lock name control.
Ethereum Network Upgrade Compatibility Matrix
Post-upgrade analysis of how each major Ethereum hard fork such as Dencun and Pectra affects ENS contracts, gas costs for common operations like registration and renewal, and offchain gateway callback mechanics. Operators need this to anticipate cost changes and verify contract behavior after network upgrades.
Exchange and Custody Integration Checklist
Versioned checklist for centralized exchanges and custodians integrating ENS deposits and withdrawals. Covers address resolution safety, handling of multi-coin addresses, CCIP-Read gateway trust models, and detecting name expiry to prevent loss of funds. Each version reflects current best practices and known attack vectors.
L2 and Sidechain Resolution Compatibility
Tracks operational status and integration patterns for resolving ENS names on Layer 2 networks and sidechains. Documents specific gateway endpoints, contract addresses, and trust assumptions for each ecosystem. Wallet developers need this to implement cross-chain name resolution without introducing security gaps.
ENSIP-15 Normalization Implementation Guide
Documents the operational impact of the ENSIP-15 name normalization standard. Provides guidance for client and SDK developers on implementing the normalization algorithm correctly to prevent homoglyph attacks and ensure consistent name hashing across all platforms. Inconsistent normalization creates interoperability failures and phishing risks.
Thorin Design System Updates
Documents versioned releases of the Thorin React component library. Teams building custom ENS interfaces need to maintain visual and functional compatibility with the core ENS App design language. Breaking changes in component APIs or design tokens affect branded ENS manager deployments.
ENS Manager App Production Readiness
Covers deployment architecture, environment configuration, and operational requirements for self-hosting the ENS Manager App. Teams running private instances for internal name management need to understand build processes, IPFS deployment patterns, and environment variable configuration for different networks.
CCIP-Read Gateway Security Model and Trust Assumptions
Analyzes the security model of offchain gateways including data authenticity verification, response signing requirements, and the implications of gateway compromise. Integrators need to understand what guarantees CCIP-Read provides and what risks remain when relying on third-party gateway operators for name resolution.
ENS Metadata Service and Avatar Resolution
Documents the operational behavior of the ENS metadata service that resolves avatar images, NFT avatars, and profile metadata. Covers caching behavior, supported URI schemes, and fallback patterns. Wallets and dapps displaying ENS profiles need to handle metadata resolution failures gracefully.