Differential D9155 Diff 27520 web/docs/docs/overview.mdx

Changeset View

Standalone View

web/docs/docs/overview.mdx

This file was added.

				---
				id: cashtab-overview
				title: Cashtab
				sidebar_label: Overview
				slug: /
				---

				import useBaseUrl from '@docusaurus/useBaseUrl';

				Cashtab is a BCHA web wallet available at https://cashtabapp.com/

				# Getting Started

				## Use Cashtab as a mobile app

				1. Navigate to https://cashtabapp.com/ in your web browser on your mobile device

				:::note
				If you are using an iPhone, Cashtab works best in the Safari browser.
				:::

				2. Click the "Add Cashtab to Homescreen" prompt at the bottom of your screen.

				<img alt="Add Cashtab to Homescreen" width="300px" src={useBaseUrl('img/05_pwa_dl_google-pixel5-sortasage-portrait.png')} />

				3. Cashtab will appear as a mobile app icon on your phone's desktop.

				## Create your first wallet

				1. Navigate to https://cashtabapp.com/ on your desktop or mobile device.

				2. Click or tap the "New Wallet" button.

				<img alt="Create your first wallet" width="300px" src={useBaseUrl('img/00_first_start_google-pixel5-sortasage-portrait.png')} />

				3. Click or tap the "Okay, make me a wallet!" button to create your first wallet.

				<img alt="Confirm wallet creation" width="300px" src={useBaseUrl('img/01_seed_alert_google-pixel5-sortasage-portrait.png')} />

				4. Your wallet is ready to use!

				<img alt="New wallet no balance" width="300px" src={useBaseUrl('img/02_empty_wallet_google-pixel5-sortasage-portrait.png')} />

				## Back up your wallet

				1. Click or tap the "Settings" icon at the bottom right of your screen to navigate to the "Settings" screen.

				<img alt="Settings" width="300px" src={useBaseUrl('img/11_SettingsScreenCollapsed_google-pixel5-sortasage-portrait.png')} />

				2. Click or tap the "Click to reveal seed phrase" button to display your 12-word seed phrase.

				3. Write down your seed phrase using pen and paper and store in a safe place. If you lose your device, you can recover your wallet with this seed phrase.

				:::caution
				Treat this seed phrase like cash. If you have $100 in your Cashtab wallet, this seed phrase is effectively a $100 bill.
				:::

				## Receive Cash

				1. Copy your BCHA address by clicking or tapping the QR code on your home screen.

				<img alt="Copied cash address" width="300px" src={useBaseUrl('img/06_copy_cash_address_google-pixel5-sortasage-portrait.png')} />

				2. Send yourself some BCHA using another wallet, or have a friend send you some BCHA.

				3. When your Cashtab wallet receives BCHA, your balance will update and a notification will appear at the top of your screen.

				<img alt="Received cash" width="300px" src={useBaseUrl('img/07_cash_received_google-pixel5-sortasage-portrait.png')} />

				## Send Cash

				1. Click or tap the "Send" button at the bottom center of your screen to navigate to the "Send" screen.

				<img alt="Send screen with balance" width="300px" src={useBaseUrl('img/10_SendScreenWithBalance_google-pixel5-sortasage-portrait.png')} />

				2. Enter the address where you would like to send BCHA into the top input field labeled "BCHA Address." You may do this by copy pasting an address into the field, or by scanning a QR code. To scan a QR code, click or tap the "QR Code Scan" icon at the right of the "BCHA Address" field to use your phone camera or webcam to scan the QR code of a receiving address.

				:::info
				On Apple mobile devices, only the Safari browser supports scanning QR codes.
				:::

				3. Enter the USD or BCHA amount you would like to send in the "Amount" field. To send the full contents of your wallet, click the "max" button at the far right of the "Amount" field.

				:::info
				Due to transaction fees, the full amount you are able to send is slightly less than your total balance.
				:::

				4. Click "Send" to send cash.


				## Receive Tokens

				1. Copy your token address by clicking or tapping the green SLPA button on your home screen, then clicking or tapping the QR code.

				<img alt="Copied token address" width="300px" src={useBaseUrl('img/08_copy_token_address_google-pixel5-sortasage-portrait.png')} />

				2. Send yourself a token using another wallet, or have a friend send you some tokens.

				3. When your Cashtab wallet receives an SLPA token, it will appear on your Wallet screen below your address QR code.

				<img alt="Token balance" width="300px" src={useBaseUrl('img/09_token_received_google-pixel5-sortasage-portrait.png')} />

				## Send Tokens

				:::info
				In order to send tokens, your wallet must have a BCHA balance.
				:::

				1. Click or tap the token you would like to send. Your tokens are listed in tiles below your address on the "Wallet" screen.

				<img alt="Token balance" width="300px" src={useBaseUrl('img/09_token_received_google-pixel5-sortasage-portrait.png')} />

				<img alt="Send token screen" width="300px" src={useBaseUrl('img/13_SendTokenScreen_google-pixel5-sortasage-portrait.png')} />

				2. Enter the token address where you would like to send your token into the top input field labeled "SLPA Address." You may do this by copy pasting an address into the field, or by scanning a QR code. To scan a QR code, click or tap the "QR Code Scan" icon at the right of the "SLPA Address" field to use your phone camera or webcam to scan the QR code of a receiving address.

				:::info
				On Apple mobile devices, only the Safari browser supports scanning QR codes.
				:::

				3. Enter the token quantity you would like to send in the "Amount" field. To send the full contents of your wallet, click the "max" button at the far right of the "Amount" field.

				4. Click the orange "Send `<TokenName>`" button to send your token.

				## Add a new wallet

				1. Click or tap the "Settings" icon at the bottom right of your screen to navigate to the "Settings" screen.

				<img alt="Settings screen collapsed" width="300px" src={useBaseUrl('img/11_SettingsScreenCollapsed_google-pixel5-sortasage-portrait.png')} />

				2. Click the orange "New Wallet" button.

				3. Your new wallet will be added to the end of your "Saved wallets." Click the "Saved wallets" button, then click "Activate" next to the wallet to begin using your new wallet.

				## Import wallet

				If you have already created a Cashtab wallet on one device, you can use your seed phrase to import this wallet to any other device.

				1. Click or tap the "Settings" icon at the bottom right of your screen to navigate to the "Settings" screen.

				<img alt="Settings screen collapsed" width="300px" src={useBaseUrl('img/11_SettingsScreenCollapsed_google-pixel5-sortasage-portrait.png')} />

				2. Click the grey "Import Wallet" button. A text field labeled "mnemonic (seed phrase) is revealed.

				3. Type or copy paste your 12-word seed phrase into the text field and click the "Import" button.

				:::note
				Cashtab currently only supports importing Cashtab wallets with 12-word seeds.
				:::

				:::caution
				If you import a wallet that was not created with Cashtab, Cashtab may not properly load the balance or transaction history for this wallet.
				:::

				4. Your wallet will be added to the end of your Saved Wallets list. To activate the imported wallet, click the "Activate" button next to your imported wallet.

				## Manage your wallets

				1. Click the "Saved wallets" button to reveal your list of wallets.

				<img alt="Saved wallets list expanded" width="300px" src={useBaseUrl('img/12_SettingsScreen2Wallets_google-pixel5-sortasage-portrait.png')} />

				2. You can rename, delete, or activate your wallets by clicking the appropriate button next to your wallet in the "Saved wallets" list.

				:::note
				Only one wallet at a time is active in Cashtab. To view the seed phrase of a saved wallet, activate the wallet and then click "Reveal seed phrase" on the "Settings" screen.
				:::

				:::danger
				Make sure to back up your wallet before deleting it. If you delete a wallet and do not have its seed phrase, there is no way to recover the wallet.
				:::
				No newline at end of file