[Epic] Wallet Connect MVP

[alexjba]

Content

Story	Priority	Status	Details
Add SIWE to sign-in via Wallet Connect	High	✍️ User Story Review	The connection establishment flow with dApps implementing the sign in is fragile without implementing SIWE. SIWE allows the user to easily authenticate
Ensure Wallet Connect complies with EIP and WC standards in terms of API implementations	High	✍️ User Story Review	Analyse and implement the required APIs based on standards and best practices
Fix transaction issues	High	⌨️ Dev ready	Fix the bugs preventing the user to complete some transactions
Sign and transaction request expiration	High	✍️ User Story Review	Don't allow sign or transaction actions if the request has expired
Session expiration	Low	✍️ User Story Review	Try to extend a session before expiry. Otherwise delete the session
Proposal expiration	Low	✍️ User Story Review	Avoid accepting expired connections
Metrics for Wallet Connect	Low	✍️ User Story Review	Sending analytics messages from critical flows
Release preparations	High	⌨️ Dev ready	Prepare the DB indexes and Enable WC by default

High priority are the tasks needed for the release
Low priority are nice to have in the release

Details

Add SIWE to sign-in via Wallet Connect

UI tasks:

• [WC] Create the Sign-in with SIWE dialog variation from the Sign dialog #16317
• [WC] SIWE verified tag #16319
• [WC] SIWE warnings #16320

Integration tasks:

• Add SIWE to sign in via Wallet Connect #14996

Bugs:

• SIWE auto disconnecting, sign popup not appearing. #15704
• [Wallet Connect] Connection goes to an inconsistent state after personal sign is rejected #16113

Abstract


Sign-In with Ethereum describes how Ethereum accounts authenticate with off-chain services by signing a standard message format parameterized by scope, session details, and security mechanisms (e.g., a nonce). The goals of this specification are to provide a self-custodied alternative to centralized identity providers, improve interoperability across off-chain services for Ethereum-based authentication, and provide wallet vendors a consistent machine-readable message format to achieve improved user experiences and consent management.

Replacing centralised standards:
Replaces eg entering a phone number and receiving a code via text to prove you own/ have access to that phone number. Connecting is similar to entering the phone number. Signing is similar to entering the confirmation code you received on that number. In the sign in case, the way to do it is by generating a cryptographic nonce for you to sign with your private key. That signature proves without a doubt that you are indeed the owner of your wallet. 

Notes


SIWE enables users to easily sign in to dApps by authenticating with their wallet.

The plan is to support SIWE standard message format as specified in ERC-4361. When the dApp prompts a user to sign a message that follows the SIWE format, we should parse the message and give the user this human readable dialog to sign into the dApp.

Not just for Ethereum - work with L2s and other EVM-compatible chains
Spruce leads it’s development 
(🔗 article from Spruce)
SSX enables developers to configure the fields of their SIWE message using the siweConfig option. This option allows you to overwrite the fields found in the SIWE message

Useful links

🔗 Figma
🔗 ERC-4361: Sign-In with Ethereum 
🔗 SIWE (MetaMask article)
🔗 SIWE (MetaMask dev)
🔗 ERC-4361: Sign-In with Ethereum
🔗 Wallet connect One-click authentication

Ensure Wallet Connect complies with EIP and WC standards in terms of API implementations

UI tasks:

Integration tasks:

• [Wallet Connect] Analyse and implement missing APIs #16180
• [WC] Handle session expiry #16316
• Handle proposal expiry
• Handle sign/transaction expiry
• Update Wallet Connect SDK #15916

Bugs:

• dApps - Yearn.fi - user can connect wallet but cannot do transactions #16020
• [Wallet Connect] Signing is allowed after the request expires #16114
• clicking several times on the "Connect" button on the Connection request screen while being offline causes strange behavior when app is back online #15636

Useful links

https://docs.walletconnect.com/walletkit/best-practices

#

Fix transaction issues

Bugs:

• Wallet connect - Sake.lido.fi dApp - Staking transaction gets stuck #16096
• Browser plugin - transaction via Uniswap doesn't go through #16063
• [Wallet Connect] Failed to buy collectible on OpenSea when swap is involved #16117
• dApps - Zapper.fi transactions can be sign approved but cannot be completed #16004

Sign and transaction request expiration

UI tasks:

• [WC] Add countdown pill to sign dialogs #16314

Integration tasks:

• [WC] Automatically remove the sign request request upon expiration #16315

Bugs:

• [Wallet Connect] Signing is allowed after the request expires #16114

Notes

Notes for development

Request expiry parameter recently added by WC to allow dApps to extend the previously hardcoded 5min window:

🔗 WC github feat: optional request expiry #1851
Added an optional expiry parameter to session requests where a number between 300 & 604800 seconds (5 minutes min - 7 days max) can be specified to extend a request timeout

Useful links

🔗 Figma

Release preparations

• [dApps] enable dApps feature flag by default #15673
• Index required wallet connect DB columns before enabling the feature #14975 |