Description
During IBC Unshielding, should a failure occur where a Tx succeeds on the Namada chain, but not the destination chain, users will see an error message indicating that the funds have been added to a new refund disposable account in the keychain. Users likely won't immediately understand how to recover or use their funds, so it should be clearly documented what it means when funds are added to a refund target.
- Add docs clarifying what it means to have a "disposable" refund target account
- Update error message to be more clear, perhaps providing a link to the relevant docs
Should docs be added to both https://www.namada.help/ and https://docs.namada.net?
The most basic, TLDR docs should appear at the top, i.e.:
- To recover these funds, simply select the new disposable account in the keychain, and transfer (like any transparent account)
Include the fact that, unless the user copies and backs-up the Private Key for this account in the Keychain, they will not be able to recover refund target accounts from a seed-phrase, so they should be encouraged to transfer them to another account, otherwise store the private key in a safe place.
We might want to explain what is happening on the protocol side at the end, or link to it on docs.namada.net, like why disposable accounts are used for refund targets versus existing transparent keys (so as not to associate previously shielded balances with a user's transparent account, to preserve privacy, etc.)