diff --git a/docs/assets/AramidHomepage.png b/docs/assets/AramidHomepage.png new file mode 100644 index 00000000..72a6c56a Binary files /dev/null and b/docs/assets/AramidHomepage.png differ diff --git a/docs/assets/AramidOriginChainSelect.png b/docs/assets/AramidOriginChainSelect.png new file mode 100644 index 00000000..5c7a9074 Binary files /dev/null and b/docs/assets/AramidOriginChainSelect.png differ diff --git a/docs/assets/AramidProcessingConfirmation.png b/docs/assets/AramidProcessingConfirmation.png new file mode 100644 index 00000000..74730340 Binary files /dev/null and b/docs/assets/AramidProcessingConfirmation.png differ diff --git a/docs/assets/AramidReviewTransaction.png b/docs/assets/AramidReviewTransaction.png new file mode 100644 index 00000000..74730340 Binary files /dev/null and b/docs/assets/AramidReviewTransaction.png differ diff --git a/docs/assets/DEXSwapInterface.png b/docs/assets/DEXSwapInterface.png new file mode 100644 index 00000000..55ee95a4 Binary files /dev/null and b/docs/assets/DEXSwapInterface.png differ diff --git a/docs/assets/iBuyDestinationAddress.png b/docs/assets/iBuyDestinationAddress.png new file mode 100644 index 00000000..1296e4c5 Binary files /dev/null and b/docs/assets/iBuyDestinationAddress.png differ diff --git a/docs/assets/iBuyHomepage.png b/docs/assets/iBuyHomepage.png new file mode 100644 index 00000000..e5e91624 Binary files /dev/null and b/docs/assets/iBuyHomepage.png differ diff --git a/docs/guides/acquiring-and-bridging.md b/docs/guides/acquiring-and-bridging.md index 53fafd4a..bbff8500 100644 --- a/docs/guides/acquiring-and-bridging.md +++ b/docs/guides/acquiring-and-bridging.md @@ -1,4 +1,85 @@ -# Acquiring and Bridging VOI +# Acquiring VOI +There are three ways to get VOI tokens onto the Voi blockchain. You can buy directly using fiat or crypto via iBuyVoi, purchase on a centralized exchange if you are located outside the United States, or bridge assets from another blockchain using Aramid Finance. Read through the options below and pick the one that works best for you. -Please refer to this [Guide to Acquiring & Bridging Voi](https://docs.google.com/document/d/1rOLdlhbLGGa9QNcaff8EG3FidOlopTC1JZtzkLsYPn0/edit) to learn how to get VOI tokens onto the Voi blockchain. +--- + +## Before You Start + +You will need a Voi compatible wallet set up before you can receive VOI. If you do not have one yet, set one up first using one of the wallets below. + +- [Kibisis](https://kibis.is/) - Browser extension wallet, most popular in the Voi ecosystem +- [Lute](https://lute.app/) - Web based wallet with strong Ledger hardware support +- [Biatec](https://wallet.biatec.io/) - Web based wallet option + +When setting up your wallet, write down your seed phrase and store it somewhere safe. Anyone with your seed phrase has full access to your funds. Do not share it with anyone. + +--- + +## Option A: Buy Directly via iBuyVoi (Recommended) + +iBuyVoi is the simplest way to get VOI and works for users everywhere including the United States. You can fund your Voi wallet using fiat currency, Algorand or Base chain assets directly without needing a centralized exchange account. + +![iBuyVoi homepage](../assets/iBuyHomepage.png) + +1. Go to [iBuyVoi](https://www.ibuyvoi.com/) +2. Select your funding method, fiat currency, Algorand or Base +3. Enter your Voi wallet address as the destination + +![iBuyVoi destination address field](../assets/iBuyDestinationAddress.png) + +4. Enter the amount you want to acquire +5. Complete the transaction and wait for VOI to arrive in your wallet + +--- + + +## Option B: Bridge from Another Chain + +If you have assets on Algorand, Base or Arbitrum you can bridge them to the Voi blockchain using [Aramid Finance](https://www.aramid.finance/). This is also the recommended route for US based users who cannot use the centralized exchanges above. + +You can bridge two types of assets to Voi: + +- **aVOI (Aramid VOI)** from Algorand, which arrives as VOI directly in your Voi wallet +- **USDC** from Algorand, Base or Arbitrum, which arrives as Aramid USDC on Voi and needs one additional swap step to become VOI + +### Bridging aVOI or USDC to Voi + +1. Make sure you have a Voi compatible wallet ready to receive your tokens (Kibisis, Lute or Biatec) +2. Go to [Aramid Finance](https://www.aramid.finance/) and click Launch Bridge + +![Aramid Finance homepage](../assets/AramidHomepage.png) + +3. Select your origin chain (Algorand, Base or Arbitrum) and the asset you are bridging (aVOI or USDC) +4. Connect your origin chain wallet + +![Aramid bridge with origin chain and asset selected](../assets/AramidOriginChainSelect.png) + +5. Enter your Voi wallet address in the Destination Address field +6. Enter the amount you want to bridge and click Review Transaction + +![Aramid bridge with destination address and amount filled in](../assets/AramidReviewTransaction.png) + +7. Sign the transaction in your origin wallet and wait for the bridge to process. This can take a few minutes. + +![Aramid bridge processing confirmation](../assets/AramidProcessingConfirmation.png) + +### If You Bridged USDC: Swap to VOI + +If you bridged USDC it will arrive as Aramid USDC in your Voi wallet. You need one more step to convert it to VOI using a DEX on the Voi blockchain. + +1. Go to [Humble](https://voi.humble.sh/) or [Nomadex](https://voi.nomadex.app/) and connect your Voi wallet +2. Select Aramid USDC as the input token and VOI as the output token + +![Humble or Nomadex swap interface](../assets/DEXSwapInterface.png) + +3. Enter the amount and complete the swap +4. You now have VOI on the Voi blockchain + +If you bridged aVOI directly it arrives as VOI automatically and no swap is needed. + +--- + +## Getting Help + +If you run into any issues at any step, head to the **#support** channel in the [Voi Discord](https://discord.gg/voi-network) where community members and the core team can help you out. \ No newline at end of file