以太坊图标 ENS 前端设计指南

何时显示 ENS 域

在用户可能会看到以太坊地址或内容哈希的每个实际场景中，都可以用 ENS 域名代替显示。 关于在 DApp 中向用户显示 ENS 域名，这里有两个典型的用例：

将以太坊地址替换为ENS域名：在用户浏览使用的DApp前端界面中，只要要显示以太坊地址所在的位置，即可将其替换为ENS域名即可展示。 解析输入：无需输入一长串十六进制地址，您可以让用户在需要输入以太坊地址的文本框中直接输入更具可读性的 ENS 域名。

除了这些用例之外以太坊图标，请记住 ENS 公共解析器支持将 ENS 域名指向不同类型的资源（例如：存储在 IPFS 或 Swarm 上的内容，或文本内容等任意数据）。 因此，还会有一些其他的应用场景，让你想要在 DApp 中使用 ENS。 例如，当面对 IPFS 或 Swarm 内容的复杂哈希时，可以使用 ENS 将哈希转换为可读的域名。 文章在 DApps 中启用 ENS 可以帮助您了解更多关于不同用例的信息。

1.将以太坊地址替换为ENS域名

警告：只有当用户为自己的地址设置了反向记录，并且反向记录（地址>域名）能够与正向解析（域名>地址）完全匹配时，这个ENS域名（作为对应以太坊的替代品）地址）显示。

因此，作为DApp开发者，首先要确认用户是否为其地址设置了反向记录。 而且，由于用户可以自由设置反向记录，即使是不属于自己的域名或者其他随机字符也可以设置成功，所以你也要确认反向解析的域名也可以通过正向解析得到原始地址. 在这里和下面的“其他指南”部分阅读更多内容。

1.1 - 更改以太坊地址为ENS域名显示

在用 ENS 名称替换以太坊地址时，您应该考虑以下情况和实践经验：

**添加可视化校验：** 在使用ENS域名时需要向用户指出，这里的域名是指可以与以太坊地址或其他哈希相关联的ENS域名，而不是http链接。 为此，建议将 ENS 域名与某种形式的视觉校验和（例如地址标识、Blockies 或其他自定义算法表示）相关联。

警告：视觉校验和可以像身份一样被欺骗或冒充，因此它们不是一种安全机制。 它们只是一个标识符，让用户知道这个域名只是以太坊地址的另一种表示。

1.2 - 提供随时查看与ENS域名关联的以太坊地址的方式

如果你想显示完整的域名或 ENS 的缩写版本，你应该：

1.3 - 同时显示ENS域名和以太坊地址

有时您可能希望同时显示 ENS 名称和它解析到的以太坊地址。 此显示在以下情况下派上用场：

2.输入文本解析

用户可以输入以太坊地址的文本框也应该支持ENS域名的输入和解析。 这些输入表明用户想要与另一个用户的以太坊地址或合约进行交互。

遵循以下准则可打造最佳用户体验：

其他指南和提示 如果反向记录和正向分辨率不正确对应怎么办？

如前所述，用户可以将反向解析记录设置为任何内容，甚至是另一个用户拥有的域名或完全随机的字符串。 这就是为什么DApp开发者在查询到反向记录中写入的域名后，还要检查是否匹配正向解析，因为正向解析就是ENS域名指向的地址。 **如果两者不匹配，则无法显示可读域名，只能直接显示以太坊地址。 **否则，用户可能会在您的 DApp 中冒充其他用户。 有关反向解析的章节包含此类验证的代码。

用户名显示

最直接的方式是将用户的ENS域名显示为用户名。 为此，您可以要求用户在您的子域下注册一个域名，或者使用反向解析来查找用​​户的 ENS 域名。

缓存和更新 ENS 域名

如果你的 DApp 需要在 UI 界面显示很多以太坊地址或 ENS 域名，你也可以考虑在解析（并验证）域名后，或者用户在输入框添加域名后缓存 ENS 域名。

您开放的 UI 可以安全地显示缓存中的域名，没有风险以太坊图标，例如，用户只是浏览，不需要根据显示的信息采取行动或做出决定，尤其是有风险的决定。 但是，在所有有风险的情况下（例如转移 ETH、代币或其他价值），或者当用户与另一个 ENS 域或以太坊地址交互时，您应该直接执行实时解析并从 ENS 注册表中检索值。 获取最新信息。

此外，您应该定期验证当前缓存的信息，考虑到用户可以随时更改 ENS 注册表中的信息。 您可以通过订阅相关合约中发生的一些特定事件来做到这一点，尤其是 和 。

显示以太坊地址的说明（带或不带 ENS 域）

研究表明，即使在 ENS 域未启用的情况下，在 DApp 中显示以太坊地址时也有一些很好的经验教训。

前面提到的一些教训也适用于缩写的以太坊地址：

前端工具