feat: integrate WalletConnectPay SDK into WalletKit

[jakubuid]

Summary

• Integrate WalletConnectPay SDK into WalletKit with explicit API approach
• Add WalletKit.Pay.isPaymentLink() utility to detect payment links
• Add WalletKit.Pay.getPaymentOptions() for explicit payment flow initiation
• Sample wallet explicitly routes to payment or WC pairing based on isPaymentLink()

Architecture

sequenceDiagram
    participant App as Sample Wallet
    participant VM as Web3WalletViewModel
    participant WK as WalletKit
    participant Pay as WalletConnectPay
    participant PVM as PaymentViewModel

    App->>VM: pair(uri)
    VM->>WK: Pay.isPaymentLink(uri)
    
    alt Payment Link
        WK-->>VM: true
        VM->>WK: Pay.getPaymentOptions(uri, accounts)
        WK->>Pay: getPaymentOptions()
        Pay-->>WK: PaymentOptionsResponse
        WK-->>VM: Result<PaymentOptionsResponse>
        VM->>VM: emit to paymentOptionsEvent
        VM-->>App: Navigate to PaymentRoute
        PVM->>PVM: collect paymentOptionsEvent
        PVM-->>App: UI State updated
    else WC Pairing
        WK-->>VM: false
        VM->>WK: pair(uri)
        WK-->>VM: Standard WC pairing flow
    end

Loading

Key Changes from Previous Approach

Previous (Callback)	New (Explicit API)
pair() auto-detects payment links	pair() only does WC pairing
accounts param in Wallet.Params.Pair	No accounts in pair()
onPaymentRequest callback in delegate	App explicitly calls getPaymentOptions()
Automatic fallback logic	App uses isPaymentLink() to decide flow

API Usage

// In ViewModel when receiving a URI:
val uri = "..." // from QR or deeplink

if (WalletKit.Pay.isPaymentLink(uri)) {
    // Explicitly call payment API
    val result = WalletKit.Pay.getPaymentOptions(uri, accounts)
    result.fold(
        onSuccess = { response -> /* show payment UI */ },
        onFailure = { error -> /* handle error */ }
    )
} else {
    // Standard WC pairing
    WalletKit.pair(Wallet.Params.Pair(uri))
}

Changes

WalletKit SDK (product/walletkit/)

• Wallet.kt: Simplified Params.Pair (removed accounts param), added payment models
• WalletKit.kt:
  • Added WalletKit.Pay.isPaymentLink() utility function
  • Added WalletKit.Pay.getPaymentOptions() for explicit calls
  • Simplified pair() - now only does standard WC pairing
  • Removed onPaymentRequest callback from WalletDelegate
• PayMapper.kt: Type conversion functions between Pay and Wallet.Model types

Sample Wallet (sample/wallet/)

• Web3WalletViewModel.kt:
  • Updated pair() to use isPaymentLink() for routing
  • Added handlePaymentLink() that explicitly calls getPaymentOptions()
• WalletKitDelegate.kt: Removed onPaymentRequest callback override
• PaymentViewModel.kt: Collects from shared event flow

Test plan

• Scan a WCPay QR code → verify isPaymentLink() returns true
• Verify getPaymentOptions() is called explicitly
• Verify payment options modal appears
• Complete payment flow
• Scan standard WC QR code → verify isPaymentLink() returns false
• Verify standard WC pairing flow works

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
4 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud