主页EIPs
EIPsEIP-3014
EIP-3014

eth_symbol JSON-RPC method

StagnantStandards Track: Interface
创建时间: 2020-09-30
Peter Grassberger (@PeterTheOne)
社区讨论原文链接编辑
1 分钟了解

相关视频
欢迎补充好内容
去提交
正文

Simple Summary

Add eth_symbol method to the JSON-RPC that returns the symbol of the native coin of the network.

Abstract

The new method eth_symbol (eth_-namespaced) has no parameters and returns a string of the native coin of the network. For the Ethereum mainnet this will be ETH, other networks will have other symbols.

Motivation

Wallets that deal with multiple networks need some basic information for every blockchain that they connect to. One of those things is the symbol of the native coin of the network. Instead of requiring the user to research and manually add the symbol it could be provided to the wallet via this proposed JSON-RPC endpoint and used automatically. There are lists of networks with symbols like https://github.com/ethereum-lists/chains where a user can manually look up the correct values. But this information could easily come from the network itself.

Specification

Method: eth_symbol.

Params: none.

Returns: result - the native coin symbol, string

Example:

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

Rationale

This endpoint is similar to EIP-695 but it provides the symbol instead of chainId. It provides functionality that is already there for ERC-20 tokens, but not yet for the native coin of the network. Alternative naming of eth_nativeCurrencySymbol was considered, but the context and the fact that it just returns one value makes it clear that that it returns the symbol for the native coin of the network.

Security Considerations

It is a read only endpoint. The information is only as trusted as the JSON-RPC node itself, it could supply wrong information and thereby trick the user in believing he/she is dealing with another native coin.

Copyright and related rights waived via CC0.

扩展阅读
欢迎补充好内容
去提交
相关项目
欢迎补充好内容
去提交

不想错过最新的 EIP 动态?

订阅 EIPs Fun 周刊以跟进相关更新,建⽴你与 EIP 之间的连接 ,更好地建设以太坊。

详情
聚集 EIP 贡献者, 扩展以太坊
资源
GitHub
支持社区