Back to Details

ens-primary-name

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ENS Primary Name

ENS主名称

Set your primary ENS name on Base and other L2 chains via the ENS Reverse Registrar.
A primary name creates a bi-directional link:
  • Forward: 
    name.eth
    → 
    0x1234...
    (set in ENS resolver)
  • Reverse: 
    0x1234...
    → 
    name.eth
    (set via this skill)
在Base及其他L2链上通过ENS反向注册器设置您的主ENS名称。
主名称会创建双向链接：
  • 正向解析：
    name.eth
    → 
    0x1234...
    （在ENS解析器中设置）
  • 反向解析：
    0x1234...
    → 
    name.eth
    （通过本工具设置）

Requirements

要求

Required: Bankr CLI

必备工具：Bankr CLI

This skill requires the Bankr CLI for transaction signing:
bash
bun install -g @bankr/cli
bankr login
The scripts use 
bankr prompt
to submit transactions like:
Submit this transaction: {"to": "0x...", "data": "0x...", "value": "0", "chainId": 8453}
本工具需要Bankr CLI来进行交易签名：
bash
bun install -g @bankr/cli
bankr login
脚本使用
bankr prompt
来提交交易，示例如下：
Submit this transaction: {"to": "0x...", "data": "0x...", "value": "0", "chainId": 8453}

Required: Node.js

必备工具：Node.js

Scripts use Node.js with 
viem
for ENS namehash calculation and ABI encoding.
bash
npm install -g viem
脚本使用Node.js搭配
viem
来计算ENS名称哈希并进行ABI编码。
bash
npm install -g viem

Quick Start

快速开始

bash
undefined
bash
undefined

Set primary name on Base

在Base上设置主名称

./scripts/set-primary.sh myname.eth
./scripts/set-primary.sh myname.eth

Set on specific chain

在指定链上设置

./scripts/set-primary.sh myname.eth arbitrum
./scripts/set-primary.sh myname.eth arbitrum

Verify primary name is set

验证主名称是否设置成功

./scripts/verify-primary.sh 0x1234... base
./scripts/verify-primary.sh 0x1234... base

Set avatar (L1 only)

设置头像（仅支持L1）

./scripts/set-avatar.sh myname.eth https://example.com/avatar.png
undefined
./scripts/set-avatar.sh myname.eth https://example.com/avatar.png
undefined

Supported Chains

支持的链

ChainReverse Registrar
Base
0x0000000000D8e504002cC26E3Ec46D81971C1664
Arbitrum
0x0000000000D8e504002cC26E3Ec46D81971C1664
Optimism
0x0000000000D8e504002cC26E3Ec46D81971C1664
Ethereum
0x283F227c4Bd38ecE252C4Ae7ECE650B0e913f1f9
链名称反向注册器地址
Base
0x0000000000D8e504002cC26E3Ec46D81971C1664
Arbitrum
0x0000000000D8e504002cC26E3Ec46D81971C1664
Optimism
0x0000000000D8e504002cC26E3Ec46D81971C1664
Ethereum
0x283F227c4Bd38ecE252C4Ae7ECE650B0e913f1f9

Prerequisites

前提条件

  1. Own or control an ENS name - The name must be registered
  2. Forward resolution configured - The name must resolve to your address
  3. Native tokens for gas - ETH on the target chain
  1. 拥有或控制一个ENS名称 - 该名称必须已注册
  2. 已配置正向解析 - 该名称必须能解析到您的地址
  3. 拥有用于支付Gas费的原生代币 - 目标链上的ETH

How It Works

工作原理

  1. Checks forward resolution exists (name → address)
  2. Warns if chain-specific address is not set
  3. Encodes 
    setName(string)
    calldata
  4. Submits transaction to the Reverse Registrar
  5. Verifies the primary name is correctly set
  1. 检查正向解析是否存在（名称→地址）
  2. 若未设置对应链的地址则发出警告
  3. 编码
    setName(string)
    调用数据
  4. 向反向注册器提交交易
  5. 验证主名称是否已正确设置

Verification

验证

The skill automatically verifies after setting. You can also verify manually:
bash
./scripts/verify-primary.sh 0xYourAddress base
Output:
✅ Reverse record: 0x1234... → myname.eth
✅ Forward resolution: myname.eth → 0x1234...
🎉 PRIMARY NAME VERIFIED: myname.eth
设置完成后工具会自动验证。您也可以手动验证：
bash
./scripts/verify-primary.sh 0xYourAddress base
输出示例：
✅ 反向记录：0x1234... → myname.eth
✅ 正向解析：myname.eth → 0x1234...
🎉 主名称验证通过：myname.eth

Setting Avatars

设置头像

bash
undefined
bash
undefined

Set avatar (requires L1 transaction + ETH for gas)

设置头像（需要L1交易及ETH支付Gas费）

./scripts/set-avatar.sh myname.eth https://example.com/avatar.png

**Supported avatar formats:**
- HTTPS: `https://example.com/image.png`
- IPFS: `ipfs://QmHash`
- NFT: `eip155:1/erc721:0xbc4ca.../1234`

**Note:** Avatars are text records stored on Ethereum mainnet. The script automatically looks up the resolver for your ENS name (works with both public and custom resolvers).
./scripts/set-avatar.sh myname.eth https://example.com/avatar.png

**支持的头像格式：**
- HTTPS：`https://example.com/image.png`
- IPFS：`ipfs://QmHash`
- NFT：`eip155:1/erc721:0xbc4ca.../1234`

**注意：** 头像存储在以太坊主网的文本记录中。脚本会自动查找您ENS名称对应的解析器（支持公共解析器和自定义解析器）。

Troubleshooting

故障排除

IssueSolution
"Transaction reverted"Ensure the ENS name resolves to your address
"Name not showing"Forward resolution may not be set for that chain's cointype
"Not authorized"You must call from the address the name resolves to
"Bankr CLI not found"Install with 
bun install -g @bankr/cli && bankr login
"Chain-specific address not set"Set the address for the target chain via app.ens.domains
"Could not find resolver"Ensure the ENS name exists and has a resolver set
问题解决方案
"交易被回滚"确保ENS名称能解析到您的地址
"名称未显示"可能未为该链的币种类型设置正向解析
"未授权"您必须从该名称解析到的地址发起调用
"未找到Bankr CLI"使用
bun install -g @bankr/cli && bankr login
安装
"未设置链特定地址"通过app.ens.domains设置目标链的地址
"未找到解析器"确保ENS名称已存在且已设置解析器

Links

相关链接