ENS 显示名称不一致:核对同链正反向解析与 L2 延迟
链小知 · 进阶 · 核验 · 依官方文档整理
从已有公开地址排查 Primary Name,避免把单独的反向记录当身份确认,也不把传播延迟直接判为配置丢失。
开始前准备
- 准备完整公开地址、所处网络和已有名称显示记录,不提供私钥。
- 只核对现有资料;不设置 Primary Name、修改 Resolver 或触发钱包签名。
1. 固定地址与目标网络
记录是 Ethereum、Base、OP Mainnet、Arbitrum One、Scroll 还是 Linea 的显示问题。官方已列 L2 Primary Name,但该链有功能不证明每个钱包、库版本都支持;解析仍从 Ethereum Mainnet 开始,目标链由对应 coinType 区分。不要把另一条链的截图当该链结果。
检查结果:完整地址、目标链、客户端及读取时刻均可追溯。
2. 把反向名称当待验证结果
从已有查询记录取地址对应的反向名称,再对该名称做同链正向核对。Primary Name 要求两个方向相互一致;反向字符串即便返回成功,也可能配置错误或被冒用。正向地址不等于原地址时,保留原始地址显示,不用该名称替代身份。
检查结果:反向名称已与同链正向地址配对;未通过配对的记录没有标为有效 Primary Name。
3. 分清链专属与默认的两类记录
Base 反向记录指向某名称,但该名称只填 ETH Address 时,不能据此推定 Base 验证通过。支持新功能的解析器可使用 Default 地址和 Default reverse 记录;它们是不同方向的两条记录,任意一条单独存在都不替代双向核对。专属链记录优先级与客户端实际支持仍需逐项保留。
检查结果:正向地址、反向名称、Default 回退及支持条件各有记录。
4. 区分传播、缓存与真正不匹配
官方 L2 Primary Name 实现说明传播可达 6 小时。已有设置交易、设置时间与当前查询时间分开保存,不把暂时未显示立即写成记录被删。文档中“截至 2025 年 9 月”的库支持名单是当时范围,不是 2026 年所有客户端的排他名单;不使用官方明确不建议生产使用的 hackathon 替代实现绕过等待。
检查结果:传播等待、客户端支持和配对失败各自注明,未为排错再次写入链上记录。
5. 给出能复查的显示结论
输出原地址、目标链、反向名称、同链正向地址、是否相等和读取时间。缺少一个方向或服务失败时只写未完成核对。两个方向一致证明名称显示关系,不证明地址属于某个人、品牌或商户,也不证明目标地址可接收所有资产。
检查结果:结论限制在同链名称显示关系,缺失和失败没有变成身份认证。
怎样确认完成
- 保存两个方向、同一网络和读取时刻,明确一致、不一致或资料不足。
- 本教程为官方文档整理,未执行正反向 RPC、设置交易或客户端兼容测试。
常见错误与边界
- 单次反向返回名称不构成 Primary Name 验证。
- L1 与 L2 地址记录以及 Default reverse 不可混用。
- 传播和缓存没有排除前,不应凭显示异常直接修改记录。