Wallet v2

[ekzyis]

Description

Close #1495

High level overview

• ✅ refactor vault (Migrate vault entries to new schema #2092)
  • ℹ️ new Vault table no longer contains foreign keys to wallets or users
  • ℹ️ wallets now point to the vault within their config, not separated from it
• ✅ support multiple receive and send protocols per wallet on the backend (Wallet schema v2 #2146)
  • ℹ️ new wallet schema consists of the following tables:
    • WalletTemplate
    • UserWallet
    • ProtocolWallet
    • table for each send and recv protocol (WalletSendNWC, WalletRecvNWC, ...)
• ✅ store send and receive config in separate tables for easier integrity checks (Wallet schema v2 #2146)
• ✅ JSDoc for protocols
  • ✅ wallets/lib (shared by client and server)
  • ✅ wallets/client
  • ✅ wallets/server
• ✅ separate wallets from protocols in frontend for better UX
  • ℹ️ we now show cards of wallets which have protocols inside of them
  • ℹ️ users can easier find a wallet to attach by just looking at their names/logos, instead of having to know if they have a wallet that supports a protocol that we also support
• 🚧 create a list of wallets with the protocols they support
  • ✅ insert wallets with protocol support into static WalletTemplate table
  • 🚧 double-check protocol support per wallet and if I missed any
  • 🚧 add placeholder wallets like Phoenix?
  • 🚧 proper input labels, placeholder, help etc. (compare with master)
• ✅ restructure wallets/ folder
  • ℹ️ client/server wallet imports are now split on the highest level: client only imports stuff from wallets/client/ and server only from wallets/server/
  • ℹ️ everything (exclusively) wallet related, including validation, was moved to the wallets/ folder
• 🚧 wallet I/O
  • ✅ load plaintext wallets
  • ✅ load encrypted wallets
  • ✅ save plaintext wallets
  • ✅ save encrypted wallet
  • ✅ client-side form validation
  • ✅ server-side form validation
  • ✅ wallet network tests
    • ✅ payments (Use test payments with HODL invoices for wallet validation #1287)
    • ✅ invoices
  • 🚧 save LNC (requires generating other fields)
  • ✅ create new wallets from template
  • ✅ fix LND gRPC macaroon transform to invalid value 🤔
• ✅ wallet API
  • ✅ payments
  • ✅ invoices
• ✅ update existing code to use wallet v2 API
  • ✅ payments
  • ✅ invoices
• 🚧 let users search for their wallet
  • ℹ️ (fuzzy) search should have autocomplete for wallet names
• ❓ include wizard / multi-step forms probably not in this PR
• 🚧 wallet encryption
  • ✅ remove the requirement to have device sync enabled for a gun
    • ℹ️ wallets are now always encrypted and saved on server
  • 🚧 generate key by default
  • 🚧 show locked wallets if wrong key and prompt to enter passphrase
  • 🚧 allow exporting passphrase once and then delete from device
• 🚧 wallet status
  • ℹ️ set wallet send/recv status via trigger instead of deriving from logs
• 🚧 wallet logs
  • 🚧 always store all wallet logs on the server
    • ℹ️ no code to manage different sources
    • ℹ️ consistent logs across all devices
  • ❌ show status of wallet network tests on attach in dedicated UI instead of relying on wallet logs
  • ❌ don't show "logs", show wallet events like a wallet
    • ℹ️ this means that there won't be multiple log messages for the same payment. we will just show the current status of a payment, just like a wallet would do.
• 🚧 wallet settings
  • ✅ detach
  • 🚧 enabled
  • 🚧 priority
  • 🚧 (global) limits (dust, fee, balance)
• ✅ create another wallet from a template when there's already one
• ✅ make sure state is updated when a wallet is updated (WALLETS vs WALLET query)
  • ✅ refetch WALLET on save or detach
  • ✅ refetch WALLETS if wallets changed
• 🚧 handle device-dependant wallets like WebLN
  • ℹ️ we exposed isAvailable through the wallet interface before
• 🚧 append and validate domain in lightning address input

Screenshots

we now show wallets instead of protocols:

each wallet can now support multiple protocols for send or receive:

Additional Context

tbd

Checklist

Are your changes backwards compatible? Please answer below:

tbd

On a scale of 1-10 how well and how have you QA'd this change and any features it might affect? Please answer below:

tbd

For frontend changes: Tested on mobile, light and dark mode? Please answer below:

tbd

Did you introduce any new environment variables? If so, call them out explicitly here:

tbd

[gitguardian]

⚠️ GitGuardian has uncovered 1 secret following the scan of your pull request.

Please consider investigating the findings and remediating the incidents. Failure to do so may lead to compromising the associated services or software components.

🔎 Detected hardcoded secret in your pull request

GitGuardian id	GitGuardian status	Secret	Commit	Filename
16991000	Triggered	Generic High Entropy Secret	9d40898	docker/db/wallet-seed.sql	View secret

🛠 Guidelines to remediate hardcoded secrets

1. Understand the implications of revoking this secret by investigating where it is used in your code.
2. Replace and store your secret safely. Learn here the best practices.
3. Revoke and rotate this secret.
4. If possible, rewrite git history. Rewriting git history is not a trivial act. You might completely break other contributing developers' workflow and you risk accidentally deleting legitimate data.

To avoid such incidents in the future consider

• following these best practices for managing and storing secrets including API keys and other credentials
• install secret detection on pre-commit to catch secret before it leaves your machine and ease remediation.

---

^{🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.}