WalletConnect Adapter

The WalletConnect Adapter package implements a concrete adapter for WalletConnect, enabling Kadena dApps to connect with wallet providers via WalletConnect v2. It extends the core’s BaseWalletAdapter and provides a unified interface for establishing sessions, handling QR code pairing, sending requests, and signing transactions using the standard kadena_* methods.

Features

• Provider Detection:
  Automatically detect WalletConnect support using the built-in provider detection mechanism.

• QR Code Pairing:
  When initiating a connection, the adapter opens a QR code modal so users can easily pair their wallets.

• Unified API:
  The adapter implements the core’s request method by delegating to the underlying WalletConnect client's request, ensuring full compatibility with Kadena’s standard request methods.

• Session Persistence:
  It subscribes to session events (e.g. session updates and deletes) and automatically restores any persisted session.

• Transaction Signing:
  Provides methods for signing transactions and commands in adherence with the Kadena signing specifications.

Installation

npm install @kadena/wallet-adapter-walletconnect
# or
yarn add @kadena/wallet-adapter-walletconnect
# or
pmpm add @kadena/wallet-adapter-walletconnect

Usage with wallet adapter React

import { KadenaWalletProvider } from '@kadena/wallet-adapter-react';
import { createWalletConnectAdapter } from '@kadena/wallet-adapter-walletconnect';
import ReactDOM from 'react-dom/client';
import App from './App';

const adapters = [
  createWalletConnectAdapter(),
];

ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
  <KadenaWalletProvider adapters={adapters}>
    <App />
  </KadenaWalletProvider>
);

Manual Usage of the Adapter or Detection

If you need lower-level access, the following are also exported:

• WalletConnectAdapter: The actual adapter class, in case you want to instantiate it manually without relying on the lazy-loading factory.
• detectWalletConnectProvider: A standalone function that checks whether the WalletConnect is present. It returns the provider if found, or null otherwise.

import {
  WalletConnectAdapter,
  detectWalletConnectProvider,
} from '@kadena/wallet-adapter-walletconnect';

(async () => {
  const provider = await detectWalletConnectProvider();
  if (!provider) {
    console.log('WalletConnect not available.');
    return;
  }
  const adapter = new WalletConnectAdapter({ provider });
  await adapter.connect();
  console.log('Connected to WalletConnect directly!');
})();

Supported methods

| Method | KIP | Supported | Calls wallet with | | --------------------- | ----------- | --------- | --------------------- | | kadena_sign_v1 | [KIP-17][1] | Yes | kadena_sign_v1 | | kadena_quicksign_v1 | [KIP-17][1] | Yes | kadena_quicksign_v1 | | kadena_getAccount_v1 | [KIP-37][2] | Yes | kadena_getAccounts_v1 | | kadena_getAccounts_v2 | [KIP-38][3] | Yes | kadena_getAccounts_v1 | | kadena_getNetwork_v1 | [KIP-39][4] | No | | | kadena_getNetworks_v1 | [KIP-40][5] | No | |