WalletConnect Integration Guide

I. Required Packages

dotnet add package Reown.Sign
dotnet add package Reown.WalletKit

II. Backend Implementation

1. Initialize Reown Client

using Reown.Sign;

var options = new ClientOptions 
{
    ProjectId = "YOUR_PROJECT_ID",
    OptionalNamespaces = new List<string> { "eip155:1" }, // Ethereum Mainnet
    Metadata = new Metadata 
    {
        Name = "Your App",
        Description = "Umbraco Wallet Integration",
        Url = "https://yourdomain.com",
        Icons = new[] { "https://yourdomain.com/icon.png" }
    }
};

var client = new WalletConnectClient(options);

2. Handle Connections

[Route("api/wallet")]
public class WalletController : ControllerBase
{
    private readonly WalletConnectClient _client;
    
    [HttpPost("connect")]
    public async Task<IActionResult> Connect()
    {
        var session = await _client.Connect();
        return Ok(new { uri = session.Uri });
    }

    [HttpGet("status/{sessionId}")]
    public async Task<IActionResult> GetStatus(string sessionId)
    {
        var session = await _client.GetSession(sessionId);
        return Ok(session);
    }
}

III. Frontend Integration

1. Install Required Packages

npm install @reown/appkit @reown/walletkit

2. Connection Handler

import { AppKit } from '@reown/appkit';
import { WalletKit } from '@reown/walletkit';

const appKit = new AppKit({
  projectId: 'YOUR_PROJECT_ID',
  relayUrl: 'wss://relay.reown.com'
});

document.getElementById('connect-btn').addEventListener('click', async () => {
  const walletKit = new WalletKit(appKit);
  const session = await walletKit.connect();
  
  // Store session data
  localStorage.setItem('walletSession', JSON.stringify(session));
});

 

IV. Key Differences from Deprecated SDKs

V. Migration Checklist

1. Remove all WalletConnect.* NuGet packages
2. Install Reown.Sign and Reown.WalletKit
3. Update namespace handling to use optionalNamespaces
4. Replace frontend Web3Modal with @reown/appkit
5. Test with:
   • Mobile browsers (Chrome/Safari)
   • Smart contract wallets (Safe, Argent)

VI. Resources

• Reown Official Documentation
• Reown GitHub
• CAIP-25 Specification