Skip to content

Commit

Permalink
Merge pull request #6622 from ethereum/wallet-listing-policy
Browse files Browse the repository at this point in the history
Wallet listing policy
  • Loading branch information
wackerow authored Jun 17, 2022
2 parents e5a33cc + 7121994 commit db51793
Show file tree
Hide file tree
Showing 2 changed files with 77 additions and 0 deletions.
76 changes: 76 additions & 0 deletions src/content/contributing/adding-wallet/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: Adding wallets
description: The policy we use when adding a wallet to ethereum.org
lang: en
sidebar: true
---

# Adding wallets {#adding-wallets}

We want to make sure we show a variety of wallets covering the feature-rich landscape of wallets so that users can navigate Ethereum in a confident manner.

Anyone is free to suggest adding a wallet on ethereum.org. If there's a wallet that we have missed, please suggest it!

Anyone is free to suggest a new wallet. Wallets are currently listed on:

- [ethereum.org/wallets/find-wallet/](/wallets/find-wallet/)
- [ethereum.org/wallets/](/wallets/)
- [ethereum.org/get-eth/](/get-eth/)

Wallets are rapidly changing in Ethereum. We've tried to create a fair framework for consideration on ethereum.org but the listing criteria will change and evolve over time.

## The decision framework {#the-decision-framework}

### Criteria for inclusion: the must-haves {#the-must-haves}

- **A security-tested product** - whether through audit, an internal security team, open sourced coded, or some other method, your wallet's security must be reliable. This reduces the risk to our users and shows us that you take security seriously.
- **A wallet that has been “live” for over six months OR released by a group with a reputable track record** - this is another indication of security. Six months is a good time frame for critical bugs and exploitations to have been found. We ask six months to help filter out forks that are quickly abandoned as projects.
- **Worked on by an active team** - this helps to ensure quality and that a user will get support for their queries.
- **Honest and accurate listing information** - it is expected that any suggested listings from projects come with honest and accurate information. Products that falsify listing information, such as declaring your product is “open source” when it is not, will be removed.
- **Point of contact** - A point of contact for the wallet will greatly help us get accurate information when changes are made. This will keep updating ethereum.org manageable when gathering future information.

### Other criteria: the nice-to-haves {#the-nice-to-haves}

- **Globally accessible** - your wallet doesn’t have geographic limitations or KYC requirements that exclude certain people from accessing your service.
- **Available in multiple languages** - your wallet is translated into multiple languages allowing users around the world to access it.
- **Open source** - your whole project’s codebase (not just modules) should be accessible and you should accept PR’s from the wider community.
- **Non-custodial** - users control their funds. If your product disappears, users can still access and move their funds.
- **Hardware wallet support** - users can connect their hardware wallet to sign transactions.
- **WalletConnect** - users can connect to dapps using WalletConnect.
- **Importing Ethereum RPC endpoints** - users can import node RPC data, allowing them to connect to a node of their choice, or other EVM compatible networks.
- **NFTs** - users are able to view and interact with their NFTs in the wallet.
- **Connect to Ethereum applications** - users are able to connect to and use Ethereum applications.
- **Staking** - users are able to stake directly through the wallet.
- **Swaps** - users are able to swap tokens through the wallet.
- **Multichain networks** - your wallet supports users accessing multiple blockchain networks by default.
- **Customize gas fees** - your wallet allows users to customize their transaction gas fees (base fee, priority fee, max fee).
- **ENS support** - your wallet allows users to send transactions to ENS names.
- **ERC-20 support** - your wallet allows users to import ERC-20 token contracts, or automatically queries and displays ERC-20 tokens.
- **EIP-1559 (type 2) transactions** - your wallet supports EIP-1559 (type 2) transactions.
- **Buy crypto** - your wallet supports users directly purchasing and onboarding to crypto.
- **Withdraw crypto** - your wallet supports users withdrawing directly to card or a bank account.
- **Multisig** - your wallet supports multiple signatures to sign a transaction.
- **Social recovery** - your wallet supports guardians and a user can recover their wallet if they lose their seed phrase using these guardians.
- **Dedicated support team** - your wallet has a dedicated support team where users can go to when experiencing issues.
- **Educational resources/documentation** - your product should have a well-designed onboarding experience to help and educate users. Or evidence of how-to content like articles or videos.

## Adding a wallet {#adding-a-wallet}

If you want to add a wallet to ethereum.org, create an issue on GitHub.

<ButtonLink to="https://github.com/ethereum/ethereum-org-website/blob/dev/.github/ISSUE_TEMPLATE/suggest_wallet.yaml">
Create an issue
</ButtonLink>

## Maintenance {#maintenance}

As is the fluid nature of Ethereum, teams and products come and go and innovation happens daily, so we'll undertake routine checks of our content to:

- ensure that all wallets and dapps listed still fulfil our criteria
- verify there aren't products that have been suggested that meet more of our criteria than the ones currently listed

Ethereum.org is maintained by the open source community & we rely on the community to help keep this up to date. If you notice any information about listed wallets that needs to be updated, please [open an issue](https://github.com/ethereum/ethereum-org-website/blob/dev/.github/ISSUE_TEMPLATE/suggest_wallet.yaml) or [pull request](https://github.com/ethereum/ethereum-org-website/pulls)!

## Terms of use {#terms-of-use}

Please also refer to our [terms of use](/terms-of-use/). Information on ethereum.org is provided solely for general information purposes.
1 change: 1 addition & 0 deletions src/content/contributing/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ The ethereum.org website, like Ethereum more broadly, is an open-source project.
- [Add a layer 2](/contributing/adding-layer-2)
_- Add a layer 2 to a relevant page_
- [Add a staking product or service](/contributing/adding-staking-product/) - _Add a project that helps facilitate solo staking, pooled staking, or staking as a service_
- [Add a wallet](/contributing/adding-wallet/) _- Add a wallet for the [find wallets page](/wallets/find-wallet/)._

_Any questions?_ 🤔 Reach out on our [Discord server](https://discord.gg/CetY6Y4)

Expand Down

0 comments on commit db51793

Please sign in to comment.