This repository has been archived by the owner on Oct 11, 2020. It is now read-only.
Payments Interaction Design
In this interaction, a user (payer) makes a Spacemesh coins payment to another user (payee).
Payer initiates the interaction by clicking the Pay button in the main wallet UI. The account currently displayed in the wallet (defaults to the HD wallet key-pair at index 0) will be used as the payer account. Payer needs to specify the payee (coins receiver) Spacemesh account id (public key). There are 3 main ways to specify this address:
- Paste an address copied from another app
- Scan an address QR code (mobile devices only)
- Select an address from
Contacts- The payer wallet's built-in address book - Type an address - JIC as a fallback method
- On desktop step 1 is combined with step 2 on the same screen. On mobile these steps are separated to 2 screens.
-
Payee text field- address can be typed or pasted here. Address automatically filled-in when a QR code is scanned or when a contact payee is specified -
Cancel button- cancel flow and display main wallet UI (missing from the desktop mock) -
Continue button- proceed to step 2. Mobile only. -
Contactsbutton - access address book and specify an address of a contact (see paying to a contact interaction) -
Scanbutton - scan payee address QR code -
Helpbutton - access help topics for this screen
User needs to specify the Spacemesh Coins amount to transfer to the payee as well as the transaction fees he's willing to pay for the transaction.
-
SMC Amount field- specify payment amount inSpacemesh Coins -
Fiat value estimate field- displays the estimated fiat value of the payment in a legacy currency, e.g. USD. User may also input the fiat value and in this case theSMC amount fieldshould be updated based on the fiat value. When user specified an SMC amount in theSMC amount fieldthe estimated USD amount field should be updated to indicate the fiat value -
Fee field- displays the fee inSpacemesh Cents. The fee is auto calculated based on a gas price oracle. The field should also display the estimated fiat value fee. -
Fee Options button- enables the user to specify a custom transaction fee in SMC (or fait) amounts - see below. -
Help button- display help topics for this screen -
Back button- go back to step 1 (mobile only) - Next button - confirm the transaction (proceed to step 3)
- User should be able to specify the fee in Fiat or SMC. This is currently not reflected in the mock
- The
Gas Limitfield is only applicable to smart contract transactions and not to standard coin transfer transaction as they have a fixed gas cost - Remove usage of
gasand usetransaction fee- gas is only applicable to smart contract transactions - The mocks should be updated to reflect these requirements
- User reviews the transaction data (payee address, amount and fee) and clicks on
Executeto execute the transaction orbackto go back to the previous screen (transaction details)
- TODO: missing confirmation screen for desktop
This screen displays the transaction status which can be one of:
- Submitting transaction to the network...
- Submitted to the network
- Error - failed to submit transaction to the network (network error, node error or gateway error)
Once the transaction was submitted, the screen displays an URL to track the pending transaction status.
- TODO: need mocks for these
- A
Copybutton copies the tracking URL. User can get transaction info using the url on the Spacemesh network stats web site -
Save to Contacts- prompt to add payee to contacts if he's not already a contact. Clicking this button prompts user to enter the contact's name and adds the payee address to the wallet's address book -
Donebutton - end the interaction and go back to the main wallet screen - Transaction should be automatically added to the wallet's
transactions logand should be accessible at a later time to the user - After a transaction is executed - the app should display the transactions log screen so user can track transaction progress in a non-modal blocking way.