Algodex

Algodex Mailbox User Guide

March 28, 2022

Introduction

Algodex Mailbox is a decentralized web application that allows a user to send Algorand Standard Assets (ASA) on the Algorand blockchain to other users. Unlike traditional methods, Algodex Mailbox allows the sender of an ASA to transfer the ASA to the recipient without the recipients needing to already be opted into the ASA in their wallet. Algodex Mailbox achieves this by placing the sent ASA into a smart contract escrow that holds it until it is redeemed by the recipient. To redeem the ASA from the smart contract escrow, the recipient first opts into the ASA then redeems it from our website.

It can be tried out on Testnet here: https://mailbox-testnet.algodex.com

User Guide

Note: Cursor represented by yellow indicator in photos

Sending an ASA

Send an Algorand Standard Asset to a list of Algorand wallet recipients. Tokens will be sent directly to recipients if they have opted in. Otherwise, the tokens will be held in escrow.

  1. Click the “Send Assets” button.
  1. Connect a MyAlgo Wallet by clicking the “CONNECT WALLET” button.
  1. Select the wallet you wish to connect.
  1. Enter the Asset ID of the ASA you wish to send in the “Asset ID” field.
  1. Download the template CSV from our website by clicking the “Download CSV Example” button.
  1. Open the downloaded CSV file.
  2. Replace the sample data with the wallet address of your recipient(s) and the amount you wish to send each recipient in the “ToWallet” field and “Amount” field respectively. 
  1. Select your saved CSV file.
  1. Click the “SEND ASSETS” button.

    ** Please note you will need 0.25 algo per recipient who has not opted in for the minimum escrow balance. 0.2 algo will be returned to you after the recipient redeems the asset, and 0.05 algo will be paid as a fee **

Redeeming an ASA:

Redeem assets that have been sent to you via Algodex Mailbox.

  1. Communicate with the ASA sender and record their wallet address and the Asset ID of the ASA they sent you.
  2. Opt-in to the ASA you wish to redeem in your MyAlgo Wallet.
  1. Click the “Redeem Assets” button.
  1. Enter the Asset ID of the ASA you wish to redeem in the “Asset ID” field.
  2. Enter the Algorand wallet address of the ASA sender in the “Sender Address” field.
  3. Enter your Algorand wallet address in the “Receiver Address” field.
  4. Click the “REDEEM” button.

Please note that currently a 0.05 algo fee is paid during redemption by the sender to the DApp operator. The rest of the algo balance is returned to the sender.

Viewing your ASA mail history:

View the transactions you have sent via Algodex Mailbox.

  1. Click the “Send History” button.
  1. Enter the Asset ID of the ASA you wish to view the transaction history of in the “Asset ID” field.
  2. Enter the Algorand wallet address of the ASA sender in the “Sender Address” field.

Return Assets:

Unsend and return any unredeemed Algorand Standard Assets (ASA) you have sent via Algodex Mailbox. Only the ASA sender can return assets to themselves. ASAs that have been redeemed by the recipient cannot be unsent and returned.

  1. Click the “Return Assets” button.
  1. Connect a MyAlgo Wallet by clicking the “CONNECT WALLET” button.
  1. Select the wallet you wish to connect.
  1. Enter the Asset ID of the ASA you wish to send in the “Asset ID” field.
  1. Download the template CSV from our website by clicking the “Download CSV Example” button.
  1. Open the downloaded CSV file.
  2. Replace the sample data with the wallet address of your recipient(s) and the amount you wish to return from each recipient in the “ToWallet” field and “Amount” field respectively. 
  1. Save the CSV file and return to the Algodex Mailbox webpage.
  2. Click the “Upload CSV” button.
  1. Select your saved CSV file.
  1. Click the “RETURN ASSETS” button.

What are your Feelings