Alert Source Discuss
🚧 Stagnant Standards Track: Interface

EIP-3014: eth_symbol JSON-RPC 方法

Authors Peter Grassberger (@PeterTheOne)
Created 2020-09-30
Discussion Link https://github.com/ethereum/EIPs/issues/3012

简单概要

向 JSON-RPC 添加 eth_symbol 方法,该方法返回网络原生币的符号。

摘要

新的 eth_symbol 方法(eth_-命名空间)没有参数,并返回网络原生币的字符串。对于以太坊主网,这将是 ETH,其他网络将有其他符号。

动机

处理多个网络的钱包需要它们连接的每个区块链的一些基本信息。其中之一是网络原生币的符号。与其要求用户研究并手动添加符号,不如通过此建议的 JSON-RPC 端点将其提供给钱包并自动使用。存在带有符号的网络列表,例如 https://github.com/ethereum-lists/chains,用户可以在其中手动查找正确的值。但是,此信息可以很容易地来自网络本身。

规范

方法:eth_symbol

参数:无。

返回:result - 原生币符号,字符串

示例:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_symbol","params":[],"id":1}'

// Result
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "ETH"
}

基本原理

此端点类似于 EIP-695,但它提供的是符号而不是 chainId。它提供了已经为 ERC-20 代币提供的功能,但尚未为网络的原生币提供。曾考虑过 eth_nativeCurrencySymbol 的替代命名,但上下文以及它仅返回一个值的事实清楚地表明它返回的是网络原生币的符号。

安全考虑

这是一个只读端点。该信息仅像 JSON-RPC 节点本身一样可信,它可能会提供错误的信息,从而欺骗用户,使其相信他/她正在处理另一种原生币。

版权

CC0 下放弃版权及相关权利。

Citation

Please cite this document as:

Peter Grassberger (@PeterTheOne), "EIP-3014: eth_symbol JSON-RPC 方法 [DRAFT]," Ethereum Improvement Proposals, no. 3014, September 2020. [Online serial]. Available: https://eips.ethereum.org/EIPS/eip-3014.