From 5008d065f7a61efc4d577bccf5dbb6c3b21010ec Mon Sep 17 00:00:00 2001 From: Pedro Gomes Date: Mon, 2 Nov 2020 20:34:02 +0100 Subject: [PATCH 1/4] Create eip-3091.md --- EIPS/eip-3091.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 EIPS/eip-3091.md diff --git a/EIPS/eip-3091.md b/EIPS/eip-3091.md new file mode 100644 index 00000000000000..96f521ba494444 --- /dev/null +++ b/EIPS/eip-3091.md @@ -0,0 +1,45 @@ +--- +eip: 3091 +title: Block Explorer API Routes +author: Pedro Gomes (@pedrouid) +discussions-to: https://github.com/ethereum/EIPs/pull/3091 +status: Draft +type: Standards Track +category: Interface +created: 2020-11-02 +--- + +## Simple Summary +This proposal brings standardization between block explorers API routes when linking transactions, blocks, accounts and tokens. + +## Abstract +Currently wallets will link transactions and accounts to block explorers web pages but as chain diversity and layer two solutions grow it becomes harder to maintain a consistent user experience. Standardizing the API routes to these links improves interoperability between wallets and block explorers. + +## Motivation +Adding new chains or layer two solutions becomes harder given these endpoints are inconsistent. This EIP makes RPC endpoints like EIP-2015 and EIP-2016 more feasible. + +## Specification +Block explorers will route their webpages accordingly for the following data: + +### Blocks +/block/ + + +### Transactions +/tx/ + +### Accounts +/address/ + + +### ERC-20 Tokens +/token/ + +## References + +- Related EIPs + - [EIP-2015: Wallet Update Ethereum Chain JSON-RPC Method (`wallet_updateChain`)](./eip-2015.md) + - [EIP-2016: Wallet Add Ethereum Chain RPC Method (`wallet_addEthereumChain`)](./eip-2016.md) + +## Copyright +Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). From cd9f2edbc064df25a6e84d029e2a6e12c1997138 Mon Sep 17 00:00:00 2001 From: Pedro Gomes Date: Tue, 3 Nov 2020 18:44:54 +0100 Subject: [PATCH 2/4] Update eip-3091.md --- EIPS/eip-3091.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/EIPS/eip-3091.md b/EIPS/eip-3091.md index 96f521ba494444..f5f6b766a76bd0 100644 --- a/EIPS/eip-3091.md +++ b/EIPS/eip-3091.md @@ -2,21 +2,22 @@ eip: 3091 title: Block Explorer API Routes author: Pedro Gomes (@pedrouid) -discussions-to: https://github.com/ethereum/EIPs/pull/3091 +discussions-to: https://ethereum-magicians.org/t/eip-3091-block-explorer-api-routes/4907 status: Draft type: Standards Track category: Interface created: 2020-11-02 +updated: 2020-11-03 --- ## Simple Summary -This proposal brings standardization between block explorers API routes when linking transactions, blocks, accounts and tokens. +Standard API Routes for Blockchain explorers ## Abstract -Currently wallets will link transactions and accounts to block explorers web pages but as chain diversity and layer two solutions grow it becomes harder to maintain a consistent user experience. Standardizing the API routes to these links improves interoperability between wallets and block explorers. +This proposal brings standardization between block explorers API routes when linking transactions, blocks, accounts and tokens. ## Motivation -Adding new chains or layer two solutions becomes harder given these endpoints are inconsistent. This EIP makes RPC endpoints like EIP-2015 and EIP-2016 more feasible. +Currently wallets will link transactions and accounts to block explorers web pages but as chain diversity and layer two solutions grow it becomes harder to maintain a consistent user experience. Adding new chains or layer two solutions becomes harder given these endpoints are inconsistent. Standardizing the API routes to these links improves interoperability between wallets and block explorers. This EIP makes RPC endpoints like [EIP-2015](./eip-2015.md) more feasible. ## Specification Block explorers will route their webpages accordingly for the following data: @@ -35,11 +36,11 @@ Block explorers will route their webpages accordingly for the following data: ### ERC-20 Tokens /token/ -## References +## Backward Compatability +This EIP was designed with existing API routes in mind to reduce disruption. Incompatible block explorers should include either 301 redirects to their existing API routes to match this EIP. -- Related EIPs - - [EIP-2015: Wallet Update Ethereum Chain JSON-RPC Method (`wallet_updateChain`)](./eip-2015.md) - - [EIP-2016: Wallet Add Ethereum Chain RPC Method (`wallet_addEthereumChain`)](./eip-2016.md) +## Security Considerations +TBD ## Copyright Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). From f775132d215ca290a5f2cb42f82a31cd82c5d55e Mon Sep 17 00:00:00 2001 From: Pedro Gomes Date: Thu, 5 Nov 2020 14:52:59 +0100 Subject: [PATCH 3/4] Update EIPS/eip-3091.md Co-authored-by: Micah Zoltu --- EIPS/eip-3091.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/EIPS/eip-3091.md b/EIPS/eip-3091.md index f5f6b766a76bd0..d00679c4381769 100644 --- a/EIPS/eip-3091.md +++ b/EIPS/eip-3091.md @@ -36,7 +36,7 @@ Block explorers will route their webpages accordingly for the following data: ### ERC-20 Tokens /token/ -## Backward Compatability +## Backward Compatibility This EIP was designed with existing API routes in mind to reduce disruption. Incompatible block explorers should include either 301 redirects to their existing API routes to match this EIP. ## Security Considerations From b7f1a1cbb2a8313ddcfe8c44c497de1d8076589b Mon Sep 17 00:00:00 2001 From: Pedro Gomes Date: Thu, 5 Nov 2020 14:53:05 +0100 Subject: [PATCH 4/4] Update EIPS/eip-3091.md Co-authored-by: Micah Zoltu --- EIPS/eip-3091.md | 1 - 1 file changed, 1 deletion(-) diff --git a/EIPS/eip-3091.md b/EIPS/eip-3091.md index d00679c4381769..24495eef755e30 100644 --- a/EIPS/eip-3091.md +++ b/EIPS/eip-3091.md @@ -7,7 +7,6 @@ status: Draft type: Standards Track category: Interface created: 2020-11-02 -updated: 2020-11-03 --- ## Simple Summary