feat(walletconnect): walletconnect integration #2223

borngraced · 2024-09-16T19:11:09Z

#1543
This PR introduces the integration of WalletConnect into the Komodo DeFi Framework (KDF), enabling secure wallet connections for Cosmos and EVM-based chains. KDF acts as the DApp(in this PR), allowing users to initiate and manage transactions securely with external wallets e.g via Metamask.
Key changes include:

Implement multi-session handling for concurrent WalletConnect connections across accounts, integrates SQLite/IndexedDB for persistent session storage across devices, enhances relayer disconnection handling for smoother session management
Implemented WalletConnect coin activation for Tendermint and EVM.
Implemented Withdraw and Swap functionalities for Tendermint and EVM

https://specs.walletconnect.com/2.0/specs/clients/sign/
https://specs.walletconnect.com/2.0/specs/clients/core/pairing/
https://specs.walletconnect.com/2.0/specs/clients/core/crypto/
https://specs.walletconnect.com/2.0/specs/servers/relay/
https://docs.reown.com/advanced/multichain/rpc-reference/ethereum-rpc

Additional improvements include cleanup of unused dependencies, minor code refinements, and WASM compatibility

Updated deps:

aead: 0.5.2
aes-gcm: 0.10.3
anyhow: 1.0.89
proc-macro2: 1.0.86
quote: 1.0.37
bip39: 2.1.0
chacha20: 0.9.1
chacha20poly1305: 0.10.1
curve25519-dalek: 4.1.3
ctr: 0.9.2
ghash: 0.5.1
lock_api: 0.4.12
syn: 2.0.77
snow: 0.9.6
signature: 1.6.4
serde_json, serde, serde_derive: 1.0.210

Added deps:

Removed deps:

cipher: 0.4.4 / 0.3.0
aes: 0.8.3
libm: 0.2.7
platforms: 3.0.2

How to test using EVM coin e.g `ETH` (Native && WASM)

Start kdf (cargo run)
Create WalletConnect session connection
- Use the RPC below
- Copy the connection URL and either:
  - Paste directly in your wallet or
  - Generate QR code using QR Code Generator and scan with your wallet (e.g., MetaMask)

{
     "method": "wc_new_connection",
	"userpass": "{{ _.userpass }}",
	"mmrpc": "2.0",
	"params": {
		"required_namespaces": {
			"eip155": {
				"chains": ["eip155:1"],
				"methods": [
					"eth_sendTransaction",
					"eth_signTransaction",
					"personal_sign"
				],
				"events": [
					"accountsChanged",
					"chainChanged"
				]
			}
		}
	}
}

Activate ETH coin (set "priv_key_policy": "WalletConnect", in activation params).
Approve authentication request in your Wallet
Withdraw or trade.

Note: To add more eip155 chains, modify the chains array like this: ["eip155:1", "eip155:250"]

…ubscriptions

mm2src/kdf_walletconnect/src/lib.rs

mariocynicys · 2024-12-12T12:59:23Z

mm2src/kdf_walletconnect/src/lib.rs

        let irn_metadata = param.irn_metadata();
+        let ttl = irn_metadata.ttl;


we can use a timed/expirable map for this case. we do that for electrum and eth also i think. this is to avoid network-induced memory leaks.

#2223 (comment)

mm2src/kdf_walletconnect/src/inbound_message.rs

mm2src/kdf_walletconnect/src/session/rpc/delete.rs

mariocynicys

i mainly went over some of old comments and resolved the ones which i can see have been updated (could use a helping hand in the remaining ones by pointing where the updates are).

my estimation right now is i would need one more all-over iteration for approval (+ old comments), but i don't wanna promise since break my promises :D

Thanks for that huge work!

mm2src/kdf_walletconnect/src/lib.rs

mm2src/kdf_walletconnect/src/session/rpc/settle.rs

mariocynicys · 2024-12-25T16:39:09Z

mm2src/kdf_walletconnect/src/lib.rs

+
+        self.validate_chain_id(&session, chain_id)?;
+
+        // TODO: uncomment when WalletConnect wallets start listening to chainChanged event


So nothing happens(I mean wallets don't listen to this event) if we send such request

so what about just sending it for now and when wallets listen to it later we get this feat for free

borngraced · 2024-12-26T09:51:39Z

so what about just sending it for now and when wallets listen to it later we get this feat for free

Two reasons I didn't want to, this will add extra latency and corresponding wallet will return error as they wont't recognize such session request

…oins

…alletconnect

mariocynicys

Thanks for the changes! Here are my last notes.

Will follow up with the changes and approve once we covered/discussed all the important comments.

mm2src/coins/tendermint/wallet_connect.rs

mariocynicys · 2025-01-09T12:45:30Z

mm2src/kdf_walletconnect/src/lib.rs

+        let (topic, url) = self.pairing.create(self.metadata.clone(), None)?;
+
+        info!("[{topic}] Subscribing to topic");


let's leave a todo here about cleaning up expired pairings that were abandoned.

what if we leave deleting expired session to the users? more decentralizations...xd

mariocynicys · 2025-01-09T13:01:12Z

mm2src/kdf_walletconnect/src/session/mod.rs

+
+    pub(crate) fn get_sessions_full(&self) -> impl Iterator<Item = Session> { self.read().clone().into_values() }
+


nit: we can return only the pairs of session topics and controllers

idea, I will come back to this...

update: c697e3c

mm2src/kdf_walletconnect/src/session/rpc/settle.rs

mariocynicys · 2025-01-09T13:40:27Z

mm2src/kdf_walletconnect/src/lib.rs

+    message_id_generator: MessageIdGenerator,
+    pending_requests: Mutex<HashMap<MessageId, oneshot::Sender<SessionMessageType>>>,
+    abortable_system: AbortableQueue,


we should really make pending_requests a timed map.

request handles which we don't get a response for will reside in the map forever

This will required updating structures in WalletConnect rust lib with some trait bounds.. I guess this can be postponed

will it really?
ok let's leave a todo for it then.

mm2src/kdf_walletconnect/src/session/mod.rs

mm2src/coins_activation/src/tendermint_with_assets_activation.rs

mm2src/coins/tendermint/wallet_connect.rs

mariocynicys

Nearly done :)

mariocynicys · 2025-01-17T16:53:07Z

mm2src/coins/tendermint/wallet_connect.rs

-        },
-    )
-    .await
+    Ok(accounts[0].clone())


might panic
let use .first().ok_or_err()

mariocynicys · 2025-01-20T10:20:30Z

mm2src/kdf_walletconnect/Cargo.toml

 mm2_err_handle = { path = "../mm2_err_handle" }
+mm2_test_helpers = { path = "../mm2_test_helpers" }


what's this for?

not needed anymore, removed

mariocynicys · 2025-01-20T10:24:46Z

mm2src/coins/eth/wallet_connect.rs

    let data = wc
-        .send_session_request_and_wait(
-            session_topic,
-            &chain_id,
-            WcRequestMethods::PersonalSign,
-            params,
-            |data: String| {
-                extract_pubkey_from_signature(&data, message, &account_str)
-                    .mm_err(|err| WalletConnectError::SessionError(err.to_string()))
-            },
-        )
+        .send_session_request_and_wait::<String>(session_topic, &chain_id, WcRequestMethods::PersonalSign, params)


nit: let data: String = ... > let data = send_session_request::<String>(...

this only makes a difference if send_session_request has some complex type annotations

mariocynicys · 2025-01-20T10:34:48Z

mm2src/kdf_walletconnect/src/session/rpc/settle.rs

    let all_sessions = ctx.session_manager.get_sessions_full();
    for session in all_sessions {
-        if session.controller == settle.controller && session.topic.as_ref() != topic.as_ref() {
+        if session_controller_exists && session.topic.as_ref() != topic.as_ref() {
            ctx.drop_session(&session.topic).await?;
            debug!("[{}] session deleted", session.topic);
        }


that doens't make sense. if session_controller_exists is true, that will delete all the sessions sessions with other topics.
we should be checking each session's controller.

thanks for the catch!

mariocynicys · 2025-01-20T10:36:39Z

mm2src/coins/tendermint/wallet_connect.rs

-                        if n <= 255 {
+                        if n <= 0xff {


that's more confusing tbh, i would rather revert back to 255 😂

or u8::MAX with casting (.into, as u64, etc..)

it's for aestethics 😆 ..reverted to 255

mariocynicys · 2025-01-20T10:37:32Z

mm2src/coins/tendermint/wallet_connect.rs

+            .session_topic()
+            .expect("TODO: handle after updating tendermint coin init");


it's easy to return an error here? no?
let's not panic.

mariocynicys · 2025-01-20T10:42:24Z

mm2src/coins/tendermint/wallet_connect.rs

            .iter()
-            .enumerate()
-            .map(|(_, (_, value))| {
+            .map(|(_, value)| {


nit: map.value().map(|value| {}) > map.iter().map(|(_unused_key, value)| {})

value.map.iter().map(|(_unused_key, value)| {}) > value.1.map.value().map(|value| {}) :p

mariocynicys · 2025-01-20T10:46:02Z

mm2src/kdf_walletconnect/src/lib.rs

+    message_id_generator: MessageIdGenerator,
+    pending_requests: Mutex<HashMap<MessageId, oneshot::Sender<SessionMessageType>>>,
+    abortable_system: AbortableQueue,


will it really?
ok let's leave a todo for it then.

borngraced added 15 commits September 9, 2024 11:55

init, start walletconnect client impl

9100780

save dev state - walletconnect client impl

ca3f558

save dev state - WalletConnect client impl

c3dc6c6

rough implementations

0eea639

commit lock file

588316f

save dev state - handle connection close, session improvements, etc

60a2fc5

minor changes

fd8797c

fix wasm compilation

437767b

minor changes - create metadata mod

6374da3

minor changes and code organization

1c9cfe0

minor changes + merge session and session_key mod

f7987dd

minor changes to namespaces

1f2adb2

some improvements

658357f

add some session fn doc comments

98026ac

big improvements to session handling

9dddb91

borngraced self-assigned this Sep 16, 2024

borngraced added 14 commits September 17, 2024 11:27

implement session delete and cleaup

52a0f72

improve code and locking

9f5944c

remove unused dep

dff1b42

refactorings and cleanupds

591fbdb

minor changes

f6e7864

make session single

f535f0b

minor changes

3eb8969

save dev state

2d68488

implement coin activation for tendermint and other minor changes

42dd5ba

improve code and minor needed changes

edcb5a7

improve relayer disconnection, remove unneeded changes, track topic s…

e606ca4

…ubscriptions

fix tendermint pubkey derivation from walletconnect

d7b5a17

start persistent session storage implementation

3a85a17

implement sqlite session storage table and insert session method

be98c40

mariocynicys reviewed Dec 12, 2024

View reviewed changes

borngraced added 3 commits December 12, 2024 20:20

nits

a2c7c71

Merge branch 'dev' into wc-integration

bbddec5

fix merge conflict

9db99ac

onur-ozkan added status: pending review and removed under review labels Dec 16, 2024

mariocynicys assigned mariocynicys and unassigned mariocynicys Dec 23, 2024

self review fixes

4739ec3

mariocynicys reviewed Dec 25, 2024

View reviewed changes

nits

414fda5

borngraced added 9 commits December 26, 2024 12:38

bump WalletConnectRust lib

f95e385

save dev state - implement dynamic session management for activated c…

dd1a842

…oins

complete coin with session topic

4dd315a

improve and remove redundancy session_properties call in tendermint w…

3b07397

…alletconnect

minor changes

5b4838d

marge with dev

7124b4f

revert metadata to fn

2243c9d

move u256_to_hex fn to common mod and minor changes

1a8f243

replace EthPrivKeyActivationPolicy name for WC des

020ecb8

mariocynicys reviewed Jan 9, 2025

View reviewed changes

borngraced added 4 commits January 9, 2025 17:18

remove active_session/topic and some other minor changes

432b056

reduce lookup for session in session/settle.rs

bb73b1f

fix review notes

ed7b4d2

Merge branch 'dev' into wc-integration

e5fa7a4

mariocynicys reviewed Jan 20, 2025

View reviewed changes

borngraced added 3 commits January 20, 2025 14:53

fix review notes

45a5961

refactor get_full_sessions to get_sessions_topic_and_controller

c697e3c

use timed_map

e39507b

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(walletconnect): walletconnect integration #2223

feat(walletconnect): walletconnect integration #2223

borngraced commented Sep 16, 2024 •

edited by mariocynicys

Loading

mariocynicys Dec 12, 2024 •

edited

Loading

borngraced Jan 17, 2025

mariocynicys left a comment

mariocynicys Dec 25, 2024

borngraced commented Dec 26, 2024 •

edited

Loading

mariocynicys left a comment

mariocynicys Jan 9, 2025

borngraced Jan 9, 2025 •

edited

Loading

mariocynicys Jan 9, 2025

borngraced Jan 9, 2025 •

edited

Loading

mariocynicys Jan 9, 2025

borngraced Jan 12, 2025

mariocynicys Jan 13, 2025

borngraced Jan 17, 2025

mariocynicys Jan 20, 2025

mariocynicys left a comment

mariocynicys Jan 17, 2025

mariocynicys Jan 20, 2025

borngraced Jan 20, 2025

mariocynicys Jan 20, 2025

borngraced Jan 20, 2025 •

edited

Loading

mariocynicys Jan 20, 2025

borngraced Jan 20, 2025

mariocynicys Jan 20, 2025

borngraced Jan 20, 2025 •

edited

Loading

mariocynicys Jan 20, 2025

mariocynicys Jan 20, 2025

borngraced Jan 20, 2025

mariocynicys Jan 20, 2025

		let irn_metadata = param.irn_metadata();
		let ttl = irn_metadata.ttl;


		self.validate_chain_id(&session, chain_id)?;

		// TODO: uncomment when WalletConnect wallets start listening to chainChanged event

		let (topic, url) = self.pairing.create(self.metadata.clone(), None)?;

		info!("[{topic}] Subscribing to topic");


		pub(crate) fn get_sessions_full(&self) -> impl Iterator<Item = Session> { self.read().clone().into_values() }

		mm2_err_handle = { path = "../mm2_err_handle" }
		mm2_test_helpers = { path = "../mm2_test_helpers" }

		.session_topic()
		.expect("TODO: handle after updating tendermint coin init");

feat(walletconnect): walletconnect integration #2223

Are you sure you want to change the base?

feat(walletconnect): walletconnect integration #2223

Conversation

borngraced commented Sep 16, 2024 • edited by mariocynicys Loading

How to test using EVM coin e.g ETH (Native && WASM)

mariocynicys Dec 12, 2024 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mariocynicys left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced commented Dec 26, 2024 • edited Loading

mariocynicys left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced Jan 9, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced Jan 9, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mariocynicys left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced Jan 20, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced Jan 20, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

borngraced commented Sep 16, 2024 •

edited by mariocynicys

Loading

How to test using EVM coin e.g `ETH` (Native && WASM)

mariocynicys Dec 12, 2024 •

edited

Loading

borngraced commented Dec 26, 2024 •

edited

Loading

borngraced Jan 9, 2025 •

edited

Loading

borngraced Jan 9, 2025 •

edited

Loading

borngraced Jan 20, 2025 •

edited

Loading

borngraced Jan 20, 2025 •

edited

Loading