Prepare creating a subname
create_subnamePrepare creating a subname for the user to sign in their own wallet, e.g. 'Create pay.alice.eth for 0xabc… with its ETH address set'. Nothing is sent. The account must control the parent name. Can set the owner, records, resolver and expiry; fuses apply to wrapped ENSv1 parents and roles to ENSv2 parents. Returns the steps, whether the account may make the change, plain signing instructions and the unsigned calls.
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": {
"name": "<name>",
"account": "<account>"
},
"name": "create_subname"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Full subname to create, e.g. pay.alice.eth | |
| fuses | No | NameWrapper fuses to burn on the subname (wrapped parents); permanent | |
| owner | No | Who will own the subname. Default: the account | |
| roles | No | ENSv2 roles the owner gets on the subname | |
| expiry | No | ||
| account | Yes | Account that will sign the transactions: an address (0x…) or an ENS name | |
| records | No | ||
| resolver | No | own (default): a new resolver for the subname; parent: the parent's resolver; none; or a resolver address |
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 |