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.
Graphical user interface, application, Teams

Description automatically generated
  1. Connect a MyAlgo Wallet by clicking the “CONNECT WALLET” button.
Graphical user interface, application

Description automatically generated
  1. Select the wallet you wish to connect.
Graphical user interface, application

Description automatically generated
  1. Enter the Asset ID of the ASA you wish to send in the “Asset ID” field.
Graphical user interface, application

Description automatically generated
  1. Download the template CSV from our website by clicking the “Download CSV Example” button.
Graphical user interface, application

Description automatically generated
  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. 
Graphical user interface, application, table, Excel

Description automatically generated
  1. Save the CSV file and return to the Algodex Mailbox webpage.
  2. Click the “Upload CSV” button.
Graphical user interface, application

Description automatically generated
  1. Select your saved CSV file.
A picture containing text, screenshot, monitor, indoor

Description automatically generated
  1. Click the “SEND ASSETS” button.
Graphical user interface, application

Description automatically generated

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.
A screenshot of a computer

Description automatically generated
  1. Click the “Redeem Assets” button.
Graphical user interface, application

Description automatically generated
  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.
Graphical user interface, text, application, email

Description automatically generated

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.
Graphical user interface, application

Description automatically generated
  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.
  3. Click the “REFRESH” button.
Graphical user interface, application, Teams

Description automatically generated

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. 
Graphical user interface, application, table, Excel

Description automatically generated
  1. Save the CSV file and return to the Algodex Mailbox webpage.
  2. Click the “Upload CSV” button.
  1. Select your saved CSV file.
A picture containing text, screenshot, monitor, indoor

Description automatically generated
  1. Click the “RETURN ASSETS” button.