Quick Start Guide
Get your free ENS name in under a minute. No gas, no fees—just connect your wallet and sign.
Prerequisites
- Web3 wallet — MetaMask , Rainbow , WalletConnect , or any compatible wallet
- Ethereum address — Your wallet provides this automatically
Lime ENS works on Ethereum Mainnet and Sepolia testnet. Make sure your wallet is connected to a supported network.
Claim Your Name
1. Go to lime.dev
Open the homepage. You’ll see the claim card with an input field.
2. Connect your wallet
Click Connect Wallet and approve the connection in your wallet. Supported wallets include MetaMask, Rainbow, WalletConnect, and others.
3. Choose your name
Type your desired name in the input (e.g. alice). Your full ENS name will be alice.lime.dev.
- Use only lowercase letters, numbers, hyphens, and dots
- The system checks availability in real time
- Green checkmark = available, red X = taken
4. Claim for free
Click Claim for Free. Your wallet will prompt you to sign a message—this is not a transaction. No gas is required.
5. Done
Your name is live. You can now manage it, add records, or claim another name.
Signing is gasless. You never pay for claiming or updating offchain records. Gas applies only when you explicitly write records onchain.
Claim a Subname
Once you have a primary name (for example log01.eth), you can create free subnames like team.log01.eth or alice.log01.eth.
There are two ways to do this:
Option A — From your Account
- Go to lime.dev/account and connect your wallet if needed.
- In the Owned section, find the name you want to use as a parent (e.g.
log01.eth). - Click Create subname on that card.
- On the subname page, enter the label (e.g.
team).
Your full subname will beteam.log01.eth. - Click Claim for Free and sign the message in your wallet.
The new subname will appear under Owned once the claim succeeds, and you can manage it like any other name.
Option B — Direct URL
If you know the parent name, you can go directly to:
https://lime.dev/{parentName}/new
Examples:
https://lime.dev/log01.eth/new→ claim subnames underlog01.ethhttps://lime.dev/team.lime.dev/new→ claim subnames underteam.lime.dev
The form works the same way as on the homepage—gasless, with real-time availability checks.
Set Up Text Records
Text records let you attach metadata to your name—avatar, website, social links, and more. Go to your name page (click Manage Name after claiming, or open lime.dev/account ) and switch to the Text tab.
Standard Records
Fill in any of these fields:
| Field | Description |
|---|---|
| Name | Display name |
| Description | Short bio or tagline |
| Website | Your website URL |
| Avatar URL | Profile image (URL to an image) |
| Location | Geographic location |
Twitter/X handle (e.g. @username) | |
| GitHub | GitHub username |
| Discord | Discord username |
| Telegram | Telegram username |
Custom Fields
Add arbitrary key-value pairs for apps that support custom ENS records. Click Add Field, enter a key (e.g. com.lens) and value, then save.
Saving
Click Save Offchain and sign the message in your wallet. No gas required—changes take effect immediately.
Set Up Wallet Addresses
Link multiple blockchain addresses to your name so others can send you assets across chains. Open the Addresses tab on your name page.
Supported Chains
- Ethereum (default) — Primary EVM address
- Bitcoin, Solana — Non-EVM chains
- Optimism, Arbitrum, Base, Polygon, Linea, Celo, Scroll — L2s and sidechains
Offchain vs Onchain
- Offchain — Enter an address and click Save Offchain. Free, instant, no gas. Works with Lime resolver.
- Onchain — Click Write onchain next to an address. Requires a one-time gas fee. The record is permanent on Ethereum and supported by all ENS-compatible wallets.
Start with offchain. Use Write onchain only for addresses you want permanently on the blockchain (e.g. your main Ethereum address for receiving payments).
What’s Next?
- Manage your name — lime.dev/account
- Learn more — What is the Lime?, What is ENS?, Hybrid vs Onchain, Custom Records
Troubleshooting
| Issue | Solution |
|---|---|
| ”This name is already taken” | Choose a different name or add numbers/hyphens |
| ”Connect wallet to check” | Connect your wallet to verify availability |
| ”User rejected the request” | Approve the signature in your wallet |
| Wrong network | Switch to Ethereum Mainnet or Sepolia in your wallet |
If you reject the signature in your wallet, the claim will fail. You can try again—no data is lost.