Skip to content

Update EIP-3014: Remove redundant word #10044

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
+1 −1
Open

Update EIP-3014: Remove redundant word #10044

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion EIPS/eip-3014.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
---

Check warning on line 1 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / EIP Walidator

preamble is missing header(s): `description` 

warning[preamble-req]: preamble is missing header(s): `description`
--> EIPS/eip-3014.md
 |
 |
 = help: see https://ethereum.github.io/eipw/preamble-req/
eip: 3014
title: eth_symbol JSON-RPC method
author: Peter Grassberger (@PeterTheOne)
discussions-to: https://github.com/ethereum/EIPs/issues/3012

Check warning on line 5 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / EIP Walidator

preamble header `discussions-to` should point to a thread on ethereum-magicians.org 

warning[preamble-re-discussions-to]: preamble header `discussions-to` should point to a thread on ethereum-magicians.org
 --> EIPS/eip-3014.md:5:16
  |
5 | discussions-to: https://github.com/ethereum/EIPs/issues/3012
  |                --------------------------------------------- required pattern was not matched
  |
  = info: the pattern in question: `^https://ethereum-magicians.org/t/[^/]+/[0-9]+$`
  = help: see https://ethereum.github.io/eipw/preamble-re-discussions-to/
status: Stagnant
type: Standards Track
category: Interface
created: 2020-09-30
---

## Simple Summary

Check warning on line 12 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / EIP Walidator

body has extra section(s) 

warning[markdown-order-section]: body has extra section(s)
  --> EIPS/eip-3014.md
   |
12 | ## Simple Summary
   |
   = help: see https://ethereum.github.io/eipw/markdown-order-section/

Check failure on line 12 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Simple Summary"] 

EIPS/eip-3014.md:12 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Simple Summary"]
Add `eth_symbol` method to the JSON-RPC that returns the symbol of the native coin of the network.

## Abstract

Check failure on line 15 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Abstract"] 

EIPS/eip-3014.md:15 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## 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

Check failure on line 18 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Motivation"] 

EIPS/eip-3014.md:18 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## 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.

Check warning on line 19 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / EIP Walidator

non-relative link or image 

warning[markdown-rel-links]: non-relative link or image
  --> EIPS/eip-3014.md
   |
19 | Wallets that deal with multiple networks need some basic information for every blockchain that they connect to. One of those things ...
   |
   = help: see https://ethereum.github.io/eipw/markdown-rel-links/

## Specification

Check failure on line 21 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Specification"] 

EIPS/eip-3014.md:21 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Specification"]
Method: `eth_symbol`.

Params: none.
Expand All @@ -38,11 +38,11 @@
}
```

## Rationale

Check failure on line 41 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Rationale"] 

EIPS/eip-3014.md:41 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Rationale"]
This endpoint is similar to [EIP-695](./eip-695.md) but it provides the symbol instead of `chainId`. It provides functionality that is already there for [ERC-20](./eip-20.md) 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.
This endpoint is similar to [EIP-695](./eip-695.md) but it provides the symbol instead of `chainId`. It provides functionality that is already there for [ERC-20](./eip-20.md) 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 it returns the symbol for the native coin of the network.

## Security Considerations

Check failure on line 44 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Security Considerations"] 

EIPS/eip-3014.md:44 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## 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

Check failure on line 47 in EIPS/eip-3014.md

View workflow job for this annotation

GitHub Actions / Markdown Linter

Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Copyright"] 

EIPS/eip-3014.md:47 MD022/blanks-around-headings/blanks-around-headers Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Copyright"]
Copyright and related rights waived via [CC0](../LICENSE.md).
Loading