feat!: store both recurring/one-time grants & spents; add state

[sidvishnoi]

Context

Closes #376

Changes proposed in this pull request

1. Update storage as suggested in Update storage structure to support one-time + recurring grants; balance for each #376, but with following differences:
   • Instead of storing interval and approvedAmount as separate keys in grants, store them as amount: WalletAmount (but within the grant)
   • Instead of storing balances, we'll store spent amounts as API only returns spent amounts.
   • Add GrantDetails.type = "recurring" | "one-time" to make it easier for TypeScript to discriminate between two.
2. Store a Storage.version to help with migrations, keep migrations indexed by this sequential version number.
3. While we're doing a migration here:
   • Add Storage.state. This is also a precursor to Handle scenarios when budget exceeded #144 (out_of_funds state)
   • Replace Storage.hasHostPermissions with Storage.state = "missing_host_permissions"

Also includes some parts of #144 (setting the first available grant, but without switchGrant) and #272.

[raducristianpopa]

Extension builds preview

Name	Link
Latest commit	b0be514
Latest job logs	Run #9757704655
	Download
	Download

[sidvishnoi]

@raducristianpopa @dianafulga In open outgoingPayment, we actually get grantSpentDebitAmount instead of balance. Should we compute balance on each outgoing payment, or just store spentAmount instead and compute as needed?

[dianafulga]

@raducristianpopa @dianafulga In open outgoingPayment, we actually get grantSpentDebitAmount instead of balance. Should we compute balance on each outgoing payment, or just store spentAmount instead and compute as needed?

From what I know, we shouldn't compute anything on our side, it Should come from the API. Wait until it's implemented.

[sidvishnoi]

It appears it was decided in interledger/open-payments#469 that they'd return spent amount only instead of balance (see edit in issue description).

So, now it's upto us how to use it. We already have what amount is approved in grant. Now, we can either subtract it on each storage, or only when we need the balance. I think we don't need to know balance to know if we can make a payment (like before each payment or after, to reach the out_of_founds state), we can store spentAmount and compute balance as needed (for UI only I believe).