ENS DNS Import Tool

WHAT IT DOES

The ENS DNS Import Tool enables importing of DNS domains into the Ethereum Name Service (ENS). It reads comprehensive state from ENS registry and DNS oracle contracts including DNS domain name, DNS record type, DNS proof data, ENS node, import eligibility, import status (pending, imported, failed), import windows, domain expiry, resolver address, owner address, and import history. Users can import domains using multiple methods: importDNS with proof data, claimDNSDomain for claiming, importDNSSEC with force option, or registerDNSName for registration. The tool displays domain eligibility, import status, expiry, resolver, and import history, providing full visibility before importing DNS domains into ENS.

HOW TO USE

Connect your Web3 wallet and paste the ENS registry contract address and DNS oracle contract address. The tool never hardcodes addresses—you specify the contracts you're vouching for. Enter the DNS domain name to import, select the import method, choose the DNS record type (TXT, A, AAAA, CNAME, MX), and provide the DNS proof data as a hex string. Optionally provide custom import data. Check "Approve token spending" to handle approvals automatically or "Force import" to bypass eligibility checks. Click "Fetch import state" to view domain, ENS node, import eligibility, import status, import window, domain expiry, resolver address, platform fee, and import history. Review the displayed eligibility and proof requirements carefully—importing a DNS domain requires valid DNSSEC proofs. Click "Import domain" to submit the import transaction. Transaction status, gas costs, and confirmation are displayed upon completion.

MECHANICAL ADVANTAGE: DUAL-CONTRACT STATE AGGREGATION WITH IMPORT HISTORY DISCOVERY

Unlike hardcoded ENS tools that only read from the registry, this tool simultaneously aggregates state from both ENS registry and DNS oracle contracts, fetching seven different data points in parallel using Promise.all with individual error boundaries. This ensures that a revert in one view function doesn't prevent retrieval of other critical metrics. The tool automatically discovers import history by iterating through import event indices until it hits empty entries (capped at 10 for performance), displaying domain names and status for full transparency. The tool dynamically selects the appropriate import method based on user input—importDNS with proof, claimDNSDomain for claiming, importDNSSEC with force, and registerDNSName for registration. Gas estimation factors in import method complexity and proof data size, and the tool uses receipt.effectiveGasPrice post-transaction for accurate cost reporting rather than relying on the pre-EIP-1559 gasPrice cap. Import eligibility, windows, and expiry are displayed prominently, enabling informed import decisions.

WHAT IT CANNOT SEE

This tool cannot verify that the ENS registry contract or DNS oracle contract is legitimate or has not been compromised. It cannot detect if the DNS proof data has been manipulated or if the contracts have been upgraded or modified. Import may not execute at optimal gas price due to network conditions or succeed if the contract is paused or frozen. The tool cannot recover funds if execution fails due to contract bugs or insufficient approval. It cannot verify that DNS proof data is valid, predict gas prices during congestion, or detect if the import has been front-run. The tool cannot ensure that the DNS domain will be imported correctly, verify off-chain DNS data, provide legal or domain advice, guarantee that the import will be recognized, verify the correctness of DNSSEC proofs, ensure that all conditions for import are met, or track import status outside of the tool. DNS imports require valid DNSSEC proofs—incorrect proof data will cause import failure.

PLEASE NOTE

This tool operates on EVM-compatible chains only. It reads from and writes to ENS and DNS oracle contracts but provides no legal or domain advice. All import decisions remain your responsibility. Always verify contract addresses, domain names, and proof data before submitting transactions. The tool displays current state but does not automatically import—you must review and confirm each transaction through your wallet. Gas costs vary by network conditions and proof data size; the tool estimates but cannot guarantee optimal pricing. DNS imports require DNSSEC-enabled domains—ensure your domain has DNSSEC configured before attempting import. Import windows may be time-limited—ensure you import within the allowed window. Domain expiry dates affect ENS registration—verify domain ownership before importing.