Prepare a registration
register_namePrepare registering .eth names for the user to sign in their own wallet, e.g. 'Register alice.eth for 2 years'. Nothing is sent. Registration takes two signatures at least a minute apart (commit, then register) and is paid in USDC by default, or DAI. Can also set records and make the name the account's primary name. Returns the steps, cost, what the account needs, whether it would succeed, plain signing instructions and the unsigned calls. Check availability and price first with check_availability.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"names": "<names>",
"duration": "<duration>",
"account": "<account>"
},
"name": "register_name"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| names | Yes | 1 to 20 .eth names to register together | |
| owner | No | Who will own the names. Default: the account | |
| account | Yes | Account that will sign the transactions: an address (0x…) or an ENS name | |
| records | No | Records to set on every name | |
| duration | Yes | ||
| resolver | No | own (default): a new resolver for each name; shared: the account's shared resolver, as the ENS app uses; none; or a resolver address | |
| paymentToken | No | Token to pay with: usdc (default) or dai | |
| setPrimaryName | No | Make the (single) name the account's primary name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | Yes | ||
| plan | Yes | Handle of this plan for get_plan; pass it back unchanged | |
| calls | Yes | Unsigned calls, in order, for the account's wallet | |
| chain | Yes | ||
| steps | Yes | ||
| issues | Yes | Why a checked step would fail | |
| account | Yes | ||
| deploys | No | Contracts the plan deploys, at addresses known in advance | |
| signing | Yes | How to sign the steps, in plain words | |
| summary | Yes | ||
| warnings | Yes | ||
| willSucceed | Yes | Whether the steps that can be checked now would succeed if signed now | |
| requirements | Yes | What the account needs before signing, e.g. a token balance |