Station x Meridian design spec

Context

Each Station has a wallet, where it will receive rewards for work done. The operator can manually transfer out funds to their preferred wallet or exchange.

With Meridian, receiving rewards is not an automatic process however: The operator needs to claim them, through an updated version of Station’s wallet UI.

Needs

There can be 0-many unclaimed rewards per Station.

ℹ️
For now, Station will treat all unclaimed rewards as one (→ the unclaimed reward), and only allow to claim everything. There is no need for UI to claim individual rewards. As suggested by @Patrick Woodhead, we can let future demand drive adding UI for claiming individual rewards.

Claiming the reward is an opt-in process. Station operators might choose never to claim, to claim immediately, or whenever it is good timing for them (e.g. for tax reasons).

The unclaimed reward will have an amount. Optionally we could show the date of late update.

The unclaimed reward will be refreshed as part of the wallet’s data fetching process, no extra UI for refreshing is necessary.

Ability to claim reward

Either for each unclaimed reward, or for all unclaimed rewards accumulated, Station operators need to be able to claim now.

There should be a confirmation, since claiming can’t be undone.

Claiming requires a balance larger or equal to the claiming gas fee, to be present inside the Station’s wallet. If the balance is insufficient, Station needs to explain to the user that they need to send a small amount of FIL to the wallet first.

Show smart contract transactions

The wallet history currently shows transactions “Received X FIL” and “Sent X FIL to Y”. A third type needs to be added: “Claimed X FIL”. There also needs to be an ongoing transfer type: “Claiming X FIL”.

Timeline

According to , Station is expected to be able to ship with this functionality by September 15th.

Next steps

  • Review @Patrick Woodhead @Miroslav Bajtoš
  • Reach out to Subvisual @Patrick Woodhead / Corey / @Julian Gruber?
  • Can we maybe extend scope too?
    • Test framework updates
  • Maybe we don’t need Subvisual lel
    • Re-use Saturn claiming website
    • We could also show that to SV instead
    • The Saturn UI is ETH based
  • DRI: @Patrick Woodhead decide on whether we can re-purpose the Saturn UI