ENS Setup Guide

ENS Domain Setup Guide for 4EVERLAND IPFS Deployments

ENS Domain Setup Guide for 4EVERLAND IPFS Deployments

Introduction to ENS Integration

4EVERLAND supports Ethereum Name Service (ENS) domains for decentralized, censorship-resistant access to your IPFS projects. Unlike traditional DNS, ENS domains:

• Are owned via Ethereum private keys (no registrars)

• Use smart contracts for censorship-resistant resolution

• Auto-update content hashes via IPNS (InterPlanetary Name System)

• Work with Web3 browsers/wallets (MetaMask, Brave, Opera Crypto)

Current Support: IPFS projects only | Future Plans: IC/Arweave ENS support.

Prerequisites

1. Owned ENS Domain:

   • Purchase via ENS Registrar (e.g., yourproject.eth)
   • Ensure you control the Ethereum private key (MetaMask/ledger etc.)

2. Deployed IPFS Project:

   • Live on 4EVERLAND (Dashboard → Projects → [Project] → Details)

3. Web3 Wallet Setup:

   • Install MetaMask (Chrome/Firefox) with Ethereum Mainnet/Rinkeby configured

   • Sufficient ETH for transaction fees (≈ $0.5–$2 USD for mainnet)

Step 1: Add ENS Domain in 4EVERLAND

Add ENS Domain in 4EVERLAND

Path: Dashboard → Projects → [IPFS Project] → Domains → Decentralized Domains → ENS

1. Domain Input

   • Enter your ENS domain (e.g., yourproject.eth )

2. Ownership Verification

   • Click Add → 4EVERLAND will ask you to 'Verify Configuration'

Step 2: Configure Content Hash (IPNS Integration)

2.1 Automatic Setup (Recommended)

• 4EVERLAND auto-detects your project's IPNS hash (k51qzi5uqu5...)

• Click Set Content Hash → Sign transaction to:

  1. Update ENS contenthash record to your IPNS CID

  2. Click "Bind" to link IPNS to 4EVERLAND's auto-update service

  3. MetaMask popup appears:

     • Sign the message to prove domain control

     • Transaction cost: ~50k gas (≈ $0.3 on Ethereum mainnet)

  4. Success: Domain status changes to " ✅" (takes 1–3 minutes)

2.2 Manual Setup (Advanced)

• Copy your 4EVERLAND project's IPNS hash (k51qzi5uqu5...)

• Go to ENS App → Manage yourproject.eth

  • Add contenthash record:

    • Value: {IPNS_HASH} (IPNS prefix format)

    • Click Save → Sign transaction (cost: ~80k gas)

• Success: Domain status changes to " ✅" (takes 1–3 minutes)

Step 3: Confirm Transaction & Resolution

1. Track Transaction

   • Etherscan: Search your wallet address for ENS SetContentHash event

   • 4EVERLAND Status:

     • Invalid Configuration: Waiting for blockchain confirmation (10–30 minutes)

     • Active ✅: Domain resolves to your IPFS project

2. Test Resolution

   • Web3 Browser: Visit yourproject.eth (Brave/MetaMask Browser)

   • Non-Web3 Browser: Use eth.limo yourproject.eth.limo

Troubleshooting Common Issues

Issue	Technical Solution
"Invalid Configuration"	1. Check ENS contenthash format (must start with 0x01707102) 2. Resign ownership challenge
Transaction Stuck	Add gas to speed up or cancel the tx
Domain Not Resolving	Clear MetaMask cache → Settings → Advanced → Clear site data for app.ens.domains

📞 Support Resources

• Live Chat: Join Discord server → #Open a ticket
• Email: [e-mail] (include domain name & project ID in subject)