Week 1 HoloFuel UI Call Notes:

NB: The button wording info is near the bottom. :D

Based on the UI https://bitbucket.org/88media/fungi-wallet
Needs Clear license!!!
(license ok)

API Calls:

• get_ledger_state() –> Balance, Limit (This info will be included in the list_transactions call)

• list_pending() – display first

  • Returns all requests, proposals,refunds that may require user interaction.

• list_transactions( … details of filtering, pagination, etc … + Balance, limit info, etc.) :

  • (state as Enum, since as Date, until as Date) –> PagingData (for infinite scroll + the actual data, fitting 64Kb)

• request_payment( Some(Spender), Transaction )

  • Could make the "tx/request" Request not have a Spender hash and not make a Link, and use the QR code w/ commit hash and Transaction to communicate w/ Spender.

TODO
(on transaction detail page )

• receive_payment (Proposal as JSON) –> automatic if the Proposal has a linked Request (from me)

• *reject_payment (Proposal as JSON) –> automatic if the spender is in my Blacklist

• pay_request (Request) –> always manual

• *decline_request (Request) –> automatic if the recipient is in my Blacklist (warrant for being fraudulent, spammer etc.)

Later Functionality:

• Pull down to refresh
• Infinite scroll

Request Fuel

1. Request button -> Request –-> propose_request (Proposal / Pay button) -> Proposal -> receive_payment (automatic)
2. Request button -> Request –-> decline_request (Decline button)

Send Fuel

1. Send button -> Proposal -> receive_payment (Receive button)
2. Send button -> Proposal -> reject_payment (Reject button)

General HF hApp Questions

Q. How to specify which Hash are you using (Deepkey? Holo Vault / Personas?)

Q. Bridging? Think about this on open alpha?

Q. How to display account names?

• get %AGENT_ID from container?
• commit a nickname anchor (easier)
• get from Holo Vault / Personas?

Initial Holo fuel:

• "Generous bob" sender - auto-approve requests?
  • Holo run agent (fixed Hash?)
  • Max 3 requests per day?
  • Works like a bootstrap node
• Credit limits (of zero initially)

Not doing: (for Closed Alpha)

• Service Logs Bridging?
• HOT Swap
• Partial sends
• Fees
• Refunds
• Advanced error scenarios
• Blacklists and Warrants
• Migrating data away from closed alpha

Holofuel UI-View Summary

View Points:

1. Transactor / Transactee > Whomever I'm not
2. Whole transaction row active link to the detail view of transaction
3. Sortable table by column
4. incoming/requested api call to populate tables

Main Table APIS:
1.) Paginate for past tranactions: list_transactions(since_date) that will include the ledger_state (Not first version)

Pending Proposals/Requests Table (Show above the main table - ??)

1. Sorted by most pressing deadline
2. Show expiration date/time

Example calls:

const list_tx = alice.call("transactions", "main", "list_transactions", {})
  console.log("***DEBUG***: list_tx: " + JSON.stringify( list_tx ))
  t.isEquivalent( list_tx.Ok.transactions.length, 1 )
  for ( var i = 0; i < list_tx.Ok.transactions.length; ++i ) {
    t.isEquivalent( list_tx.Ok.transactions[i].state, "outgoing proposed" )
  }

Main UI : Tx Overview

Balance (+ credit limit)

Requiring attention (list):
++ list_requests() –> Accept, Reject
++ list_proposals() –> Accept, Reject (if not tied to a Request by me)
|| Expires in, From / Direction, Value, Human interaction buttons

Transaction history (list):
++ list_transactions()
||Date, From, Direction (in/out), Value, Status

Access to Requesting/Proposing Fuel > Lead to another page?
(Request_button) (Send_button)

Detail Screen

• Date
• Receiver / Sender (whichever is not you) > Counterparty
• Amount
• Notes / Description

Buttons:

• Recipient of funds (incoming):

  • requested –> (Review), (Decline)
  • rejected –> (Review)
  • accepted –> (Return)
  • returned –> (Review)
  • completed –>(Review)
  • refunded –> (Review)
  • error –> (REPORT BUG?)

• Spender of funds (outgoing):

  • approved –> (Propose/Request > determine), (Decline)
  • declined –> (Review)
  • completed –> (Refund)(Review)
  • recovered –> (Review)
  • error –> (REPORT BUG?)

Note: Propose === Pay fuel

NB: Reject, Decline, Return / Refund and Recover are NOT yet created in DNA

(Closed Alpha)