specs/status-EIPs.md

233 lines
10 KiB
Markdown
Raw Normal View History

2019-11-26 13:47:24 +00:00
# Status EIPs standards
2020-03-24 06:25:08 +00:00
> Version: 0.2
>
> Status: Stable
2019-11-26 13:47:24 +00:00
>
> Authors: Ricardo Guilherme Schmidt <ricardo3@status.im>
## Abstract
In this specification, we describe how Status relates with EIPs.
## Table of Contents
- [Status EIPs standards ](#status-client-specification)
- [Abstract](#abstract)
- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Components](#components)
- [Security Considerations](#security-considerations)
- [Design Rationale](#design-rationale)
- [Footnotes](#footnotes)
- [Acknowledgements](#acknowledgements)
## Introduction
Status should follow all standards as possible. Whenever a feature is needed, it should be first checked if there is a standard for that, if not, Status should propose a standard.
### Support table
2019-11-28 04:03:26 +00:00
| | Status v0 | Status v1 | Other |
|----------|-----------|-----------|----------|
| BIP32 | N | Y | N |
| BIP39 | Y | Y | Y |
| BIP43 | N | Y | N |
| BIP44 | N | Y | N |
| EIP20 | Y | Y | Y |
| EIP55 | Y | Y | Y |
| EIP67 | P | P | N |
| EIP137 | P | P | N |
| EIP155 | Y | Y | Y |
| EIP165 | P | N | N |
| EIP181 | P | N | N |
| EIP191 | Y? | N | Y |
| EIP627 | Y | Y | N |
| EIP681 | Y | N | Y |
| EIP712 | P | P | Y |
| EIP721 | P | P | Y |
| EIP831 | N | Y | N |
| EIP945 | Y | Y | N |
| EIP1102 | Y | Y | Y |
| EIP1193 | Y | Y | Y |
| EIP1577 | Y | P | N |
| EIP1581 | N | Y | N |
2019-11-26 13:47:24 +00:00
## Components
### BIP32 - Hierarchical Deterministic Wallets
2019-11-28 03:58:37 +00:00
Support: Dependency.
Reference: https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki
Description: Enable wallets to derive multiple private keys from the same seed.
Used for: Dependency of BIP39 and BIP43.
2019-11-26 13:47:24 +00:00
### BIP39 - Mnemonic code for generating deterministic keys
2019-11-28 03:58:37 +00:00
Support: Dependency.
Reference: https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki
2019-11-26 13:47:24 +00:00
Description: Enable wallet to create private key based on a safe seed phrase.
2019-11-27 06:19:44 +00:00
Used for: Security and user experience.
2019-11-26 13:47:24 +00:00
### BIP43 - Purpose Field for Deterministic Wallets
2019-11-28 03:58:37 +00:00
Support: Dependency.
Reference: https://github.com/bitcoin/bips/blob/master/bip-0043.mediawiki
Description: Enable wallet to create private keys branched for a specific purpose.
Used for: Dependency of BIP44, uses "ethereum" coin.
2019-11-26 13:47:24 +00:00
### BIP44 - Multi-Account Hierarchy for Deterministic Wallets
2019-11-28 03:58:37 +00:00
Support: Dependency.
Reference: https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki
Description: Enable wallet to derive multiple accounts in top of BIP39.
Used for: Privacy.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/constants.cljs#L240
Observation: BIP44 don't solve privacy issues regarding the transparency of transactions, therefore directly connected addresses through a transactions can be identifiable by a "network reconnaissance attack" over transaction history, this attack together with leakage of information from centralized services, such as exchanges, would be fatal against the whole privacy of users, regardless of BIP44.
2019-11-26 13:47:24 +00:00
### EIP20 - Fungible Token
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-20
Description: Enable wallets to use tokens based on smart contracts compilant with this standard.
Used for: Wallet feature.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/tokens.cljs
2019-11-26 13:47:24 +00:00
### EIP55 - Mixed-case checksum address encoding
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-55
Description: Checksum standard that uses lowercase and uppercase inside address hex value.
Used for: Sanity check of forms using ethereum address.
Related: https://github.com/status-im/status-react/issues/4959 https://github.com/status-im/status-react/issues/8707
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/eip55.cljs
2019-11-26 13:47:24 +00:00
### EIP67 - Standard URI scheme with metadata, value and byte code
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://github.com/ethereum/EIPs/issues/67
Description: A standard way of creating Ethereum URIs for various use-cases.
Used for: Legacy support.
https://github.com/status-im/status-react/issues/875
2019-11-26 13:47:24 +00:00
### EIP137 - Ethereum Domain Name Service - Specification
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-137
Description: Enable wallets to lookup ENS names.
Used for: User experience, as a wallet and identity feature, usernames.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/ens.cljs#L86
2019-11-26 13:47:24 +00:00
### EIP155 - Simple replay attack protection
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-155
Description: Defined chainId parameter in the singed ethereum transaction payload.
Used for: Signing transactions, crucial to safety of users against replay attacks.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/core.cljs
2019-11-26 13:47:24 +00:00
### EIP165 - Standard Interface Detection
2019-11-28 03:58:37 +00:00
Support: Dependency/Partial.
Reference: https://eips.ethereum.org/EIPS/eip-165
Description: Standard interface for contract to answer if it supports other interfaces.
Used for: Dependency of ENS and EIP721.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/eip165.cljs
2019-11-26 13:47:24 +00:00
### EIP181 - ENS support for reverse resolution of Ethereum addresses
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-181
Description: Enable wallets to render reverse resolution of Ethereum addresses.
Used for: Wallet feature.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/ens.cljs#L86
2019-11-26 13:47:24 +00:00
### EIP191 - Signed Message
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-191
Description: Contract signature standard, adds an obrigatory padding to signed message to differentiate from Ethereum Transaction messages.
Used for: Dapp support, security, dependency of ERC712.
2019-11-26 13:47:24 +00:00
### EIP627 - Whisper Specification
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-627
Description: format of Whisper messages within the ÐΞVp2p Wire Protocol.
Used for: Chat protocol.
2019-11-26 13:47:24 +00:00
### EIP681 - URL Format for Transaction Requests
2019-11-28 03:58:37 +00:00
Support: Partial.
2019-11-26 13:47:24 +00:00
Reference: https://eips.ethereum.org/EIPS/eip-681
2019-11-28 03:58:37 +00:00
Description: A link that pop up a transaction in the wallet.
Used for: Useful as QRCode data for tranasction requests, chat transaction requests and for dapp links to transaction requests.
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/eip681.cljs
Related: [Issue #9183: URL Format for Transaction Requests (EIP681) is poorly supported](https://github.com/status-im/status-react/issues/9183) https://github.com/status-im/status-react/pull/9240 https://github.com/status-im/status-react/issues/9238 https://github.com/status-im/status-react/issues/7214 https://github.com/status-im/status-react/issues/7325 https://github.com/status-im/status-react/issues/8150
2019-11-26 13:47:24 +00:00
### EIP712 - Typed Signed Message
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-712
Description: Standarize types for contract siganture, allowing users to easily inspect whats being signed.
Used for: User experience, security.
Related: https://github.com/status-im/status-react/issues/5461 https://github.com/status-im/status-react/commit/ba37f7b8d029d3358c7b284f6a2383b9ef9526c9
2019-11-26 13:47:24 +00:00
### EIP721 - Non Fungible Token
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-721
Description: Enable wallets to use tokens based on smart contracts compilant with this standard.
Used for: Wallet feature.
Related: https://github.com/status-im/status-react/issues/8909
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/erc721.cljs https://github.com/status-im/status-react/blob/develop/src/status_im/ethereum/tokens.cljs
2019-11-26 13:47:24 +00:00
### EIP945 - Web 3 QR Code Scanning API
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://github.com/ethereum/EIPs/issues/945
Used for: Sharing contactcode, reading transaction requests.
Related: https://github.com/status-im/status-react/issues/5870
2019-11-26 13:47:24 +00:00
### EIP1102 - Opt-in account exposure
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-1102
Description: Allow users to opt-in the exposure of their ethereum address to dapps they browse.
Used for: Privacy, DApp support.
Related: https://github.com/status-im/status-react/issues/7985
2019-11-26 13:47:24 +00:00
### EIP1193 - Ethereum Provider JavaScript API
2019-11-28 03:58:37 +00:00
Support: Full.
Reference: https://eips.ethereum.org/EIPS/eip-1193
Description: Allows dapps to recognize event changes on wallet.
Used for: DApp support.
Related: https://github.com/status-im/status-react/pull/7246
2019-11-26 13:47:24 +00:00
### EIP1577 - contenthash field for ENS
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-1577
Description: Allows users browse ENS domains using contenthash standard.
Used for: Browser, DApp support.
Related: https://github.com/status-im/status-react/issues/6688
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/utils/contenthash.cljs https://github.com/status-im/status-react/blob/develop/test/cljs/status_im/test/utils/contenthash.cljs#L5
2019-11-26 13:47:24 +00:00
### EIP1581 - Non-wallet usage of keys derived from BIP-32 trees
2019-11-28 03:58:37 +00:00
Support: Partial.
Reference: https://eips.ethereum.org/EIPS/eip-1581
Description: Allow wallet to derive keys that are less sensible (non wallet).
Used for: Security (dont reuse wallet key) and user experience (dont request keycard every login).
Related: https://github.com/status-im/status-react/issues/9088 https://github.com/status-im/status-react/pull/9096
Sourcecode: https://github.com/status-im/status-react/blob/develop/src/status_im/constants.cljs#L242
2019-11-26 13:47:24 +00:00
## Security Considerations
## Design Rationale
## Footnotes
## Acknowledgements