renew_ens_name
Renew an ENS name or batch of names. Returns the transaction data needed to extend registration.
Unlike registration, renewal is simple — just one transaction with payment. No commit/reveal needed.
Accepts any duration from 1 day up — days, weeks, months, years. ENS protocol has no minimum renewal period; this tool floors at 1 day for safety. Examples: 1 day, 7 days (1 week), 28 days (1 month), 365 days (1 year).
Anyone can renew any name (you don't need to be the owner). This is useful for:
Extending your own names before expiry
Gifting renewal to a friend's name
Protecting valuable names from expiring
Returns exact on-chain pricing from the ETHRegistrarController with a 5% buffer (excess is refunded) — do NOT estimate renewal prices yourself.
For batch renewals (multiple names), all names are bundled into a SINGLE Multicall3 transaction.
Calling this tool never spends money — it only builds an unsigned transaction rendered as a sign-card; nothing happens until the user clicks Sign. So the sign-card IS the confirmation step.
Conversational flow:
User names the specific name(s) ("renew coffee.eth", "renew coffee.eth for 3 months"): call this tool IMMEDIATELY. If no duration was given, use the 1-year default and say so ("built it for 1 year — tell me if you want longer/shorter") — do NOT stop to ask the duration first; they can just say a different one and you rebuild.
Open-ended "renew my names" / "bulk renew" with no list: first call get_wallet_portfolio to find the names, IGNORE every EXPIRED and PREMIUM_AUCTION name (renewing those reverts the whole batch), present a numbered list grouped by urgency, and ask which names + what duration. Only THEN call this tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| names | Yes | ENS name or array of names to renew (e.g. "coffee.eth" or ["coffee.eth", "wallet.eth"]) | |
| years | No | DEPRECATED — use duration instead. Number of years (converted to days internally). | |
| duration | No | Duration in days to extend registration (e.g. 7 for 1 week, 28 for a month, 365 for a year). Default: 365. Minimum: 1 day. Maximum: 36500 (100 years). |