From 847bc390cb994758cfdb6a72d54ab5ba07e9aa2e Mon Sep 17 00:00:00 2001 From: cturakhia-cb <143233559+cturakhia-cb@users.noreply.github.com> Date: Tue, 28 Jan 2025 20:10:06 -0800 Subject: [PATCH] Update wallet.md (#1661) --- apps/base-docs/docs/tokens/wallet.md | 112 +++++++++++++++++++++------ 1 file changed, 89 insertions(+), 23 deletions(-) diff --git a/apps/base-docs/docs/tokens/wallet.md b/apps/base-docs/docs/tokens/wallet.md index d517cbcebc..452e08dc8a 100644 --- a/apps/base-docs/docs/tokens/wallet.md +++ b/apps/base-docs/docs/tokens/wallet.md @@ -18,7 +18,7 @@ keywords: hide_table_of_contents: true --- -# How to ensure ERC-20 tokens are immediately swappable in Coinbase Wallet +# How to ensure ERC-20 tokens show in Coinbase Wallet as a token issuer This page is intended for developers that will or have recently deployed ERC-20 token contracts on Base Mainnet and would like their token details to display as quickly as possible on Coinbase Wallet. @@ -38,43 +38,109 @@ The steps below explain how to have your token display quickly on Coinbase Walle ### Step 1: Deploy your ERC-20 Token on Base Mainnet -Write and deploy a compliant ERC-20 token smart contract. Test it and then deploy on Base Mainnet. - -Once your ERC-20 contract is deployed, your asset is swappable instantly on Coinbase Wallet in the swap flow. Users can search by contract address or asset name. See below for information on how to show price charts and other metadata. +Write and deploy a compliant ERC-20 token smart contract. Test it and then deploy on Base Mainnet. If you’re not a developer, you can use available token launcher tools in the Base ecosystem. ### Step 2: Prepare your metadata and asset images -Prepare a high-resolution image of your token's logo. Ensure it is clear, identifiable, and representative of your token. +Prepare a high-resolution image of your token’s logo. Ensure it is clear, identifiable, and representative of your token. ### Step 3: List your cryptocurrency on a listing aggregator -##### **Note:** At this time, being listed and verified on CoinMarketCap is the best way to ensure your token’s name, image, price chart all show up on Coinbase Wallet. -You can pay to be listed AND **verified** on CoinMarketCap following these [instructions](https://support.coinmarketcap.com/hc/en-us/articles/360043659351-Listings-Criteria). +You can list for free on CoinGecko following these [instructions](https://support.coingecko.com/hc/en-us/articles/7291312302617-How-to-list-new-cryptocurrencies-on-CoinGecko) -You can list for free on CoinGecko following these [instructions](https://support.coingecko.com/hc/en-us/articles/7291312302617-How-to-list-new-cryptocurrencies-on-CoinGecko). +You can pay to be listed on CoinMarketCap following these [instructions](https://support.coinmarketcap.com/hc/en-us/articles/360043659351-Listings-Criteria). -Once CoinGecko lists your token OR CoinMarketCap lists it as **_verified_**, your asset's image logo and other metadata will flow into Coinbase Wallet and can be seen by users. **It can take 24-48 hours for metadata changes to update.** +Remember, once your ERC-20 contract is deployed, your asset will immediately be available for native swapping in Coinbase Wallet. -## Why does my token display in the “Newer tokens” section? +However, you’ll still need to list your token on Birdeye, CoinGecko, or CoinMarketCap for the asset’s logo and other metadata to flow into Coinbase Wallet and be seen by users. **It can take 24-48 hours for metadata changes to update.** -Tokens that are newly launched and have not had significant trading volume appear in this section. Once your token reaches a market cap of at least $10M on CoinGecko or CoinMarketCap, the **newer token** label inside Coinbase Wallet is removed. +## Why does my token display in the “Newer tokens” section in the swap flow? -## Why is there no price chart for my token? +Tokens that are newly launched and haven’t had significant trading volume appear in the **newer token** section. Once your token reaches a market cap of at least $1M it will no longer be displayed in this section. -Your token must be listed and marked as verified on CoinMarketCap for the price chart to display on Coinbase Wallet. +:::info Disclaimer +New assets with low liquidity may result in failed swaps or may result in a user receiving less of the destination token due to slippage. An important responsibility of the token creator is to communicate to the community these risks. +::: -If the above guidance doesn’t resolve your issue, please submit more information using this [Deform](https://app.deform.cc/form/a331da5a-447b-43e8-b636-ea3b925e115a/). +## How can I update my token logo or description? -# Sharing your token -### Custom trading links -By sharing a unique link to your token’s asset page, your community can more easily interact with your token. +ERC20 metadata can be updated quickly and easily by navigating to the asset’s page on the Coinbase Wallet desktop site ([wallet.coinbase.com](https://wallet.coinbase.com)). Note that any changes you make there will be reflected on Coinbase Wallet only (desktop and mobile). -How to get your custom link: +**Step 1:** Search for your token on wallet.coinbase.com -**Step 1:** Grab your custom link for your token by navigating to the asset page on Coinbase Wallet +**Step 2:** Scroll to the bottom and click “Update here” -**Step 2:** Click the share button +**Step 3:** Select your logo image or enter the description you want to show -:::info Disclaimer -New assets with low liquidity may result in failed swaps or may result in a user receiving less of the destination token due to slippage. An important responsibility of the token creator is to communicate to the community these risks. -::: +**Step 4:** Choose the address you want to submit with and click submit + +**Step 5:** Submissions will be reviewed within 5 business days. To expedite approval, we recommend taking the following steps: + +1. Make a post from your official X or Warpcast account documenting the change. The Coinbase Wallet team may reach out to you if they have questions. + +3. Submit the change with the same deployed address that the token contract was deployed with. + +If the above guidance doesn’t resolve your issue, please submit more information using this [Deform](https://app.deform.cc/form/a331da5a-447b-43e8-b636-ea3b925e115a/). + +# Sharing your token + +## Custom trading links + +By sharing a unique link to your token’s asset page, your community can easily and safely get your token. + +**How to get your custom link:** + +**Step 1:** Grab your custom link for your token by navigating to the asset page on Coinbase Wallet + +**Step 2:** Click the share button + +![][image1] + +![][image2] + +**Step 4:** Share it with your community – either by posting it as an official link on your social accounts or as a CTA on your website. + +## Trending Swaps on Base + +The Trending Swaps on Base module reflects the top tokens traded through the Coinbase Wallet mobile app, browser extension, and website app over the past 24 hours. + +By encouraging your community to use Coinbase Wallet, your token can be appear on Trending Swaps and reach a wider audience. + +## Send via text + +With send via text, you can send crypto as easily as sending a text. The crypto you want to send will be retrievable using a claim link, and the link can be shared over text, Twitter, Farcaster, Telegram – anywhere. + +Recipients will be prompted to make a Coinbase Wallet to claim the crypto. Whether you're onboarding people to crypto or looking to easily reward your community, send via text has you covered. + +**How to send crypto via text:** + +**Step 1:** Go to the **Send** flow in Coinbase Wallet + +**Step 2:** Enter the amount you want to send + +![][image3] + +**Step 3:** Click “Send via text” in the upper right hand corner + +**Step 4:** Enter the amount and type of crypto you wish to send, and click “Create”Copy the link + +![][image4] + +**Step 5:** Copy the link and sShare it on any platform. + +* Clicking the link will prompt the recipient to open Coinbase Wallet or download Coinbase Wallet to claim the crypto +* If the crypto isn’t claimed within 14 weeks, it will be returned to your wallet. + +Send via text currently supports the top 100 tokens on Base. We’re in the process of adding support for all tokens on Base. + +--- + +If you’re encountering an issue with token support on Coinbase Wallet, submit [this form](https://app.deform.cc/form/a331da5a-447b-43e8-b636-ea3b925e115a/?page_number=0) and we’ll aim to resolve your issue within 5 business days. + +[image1]: + +[image2]: + +[image3]: + +[image4]: