WalletConnect Client for the XRP Ledger

walletconnect | joey-wallet | xrp | xrpl

!NPM

---

$3

wc-client is a developer-friendly client designed to streamline interaction with the XRP Ledger (XRPL) via WalletConnect. It abstracts away WalletConnect complexities—such as redirects, deep links, and modal handling—while leveraging the latest package dependencies to ensure a seamless experience with the XRP Ledger and Joey Wallet.

Tailored for developers building decentralized applications (DApps), wc-client accelerates integration, enabling you to focus on creating robust DApps.

> Target Audience: Developers seeking a fast, reliable way to integrate their DApps with the XRP Ledger and Joey Wallet.

Features

wc-client offers two versions to provide flexibility based on your project's needs and desired feature set:

Advanced and Standalone.

$3

A feature-rich, multi-framework version optimized for complex DApps.

- Persisted Historical Data: Stores pending activities, previous requests, and wallet metadata for enhanced user experiences.
- Robust Session Management: Supports multiple, concurrent WalletConnect sessions, ideal for DApps requiring advanced connection handling.
- Framework-Agnostic: Compatible with various JavaScript frameworks, ensuring flexibility across different tech stacks.

$3

A lightweight, React-specific version delivered in a single file for minimal setup.

- Target Use Case: Perfect for developers who need a simple, React-only solution and don't require advanced features like multi-session support or historical data persistence.
- Minimal Footprint: Streamlined for quick integration with basic WalletConnect functionality.

Getting Started

$3

Before using wc-client, ensure you have the following:

- Node.js: Version 16 or higher (LTS recommended).
- A WalletConnect-compatible wallet (e.g., Joey Wallet) that supports XRPL interactions.
- A WalletConnect Project ID from Reown Cloud (formerly WalletConnect Cloud) for initializing the Universal Provider.
- Basic familiarity with the XRP Ledger and WalletConnect for seamless integration.

$3

To integrate wc-client into your decentralized application (DApp), install it using your preferred package manager: pnpm, npm, or yarn. Run one of the following commands in your project directory:

``bash
pnpm add @joey-wallet/wc-client
`

> Note: Ensure your project includes @walletconnect/universal-provider as a dependency, as wc-client builds on it for WalletConnect functionality. If not already included, you can install it alongside wc-client:

#### Next Steps:

After installation, you can initialize wc-client in your DApp to connect to the XRP Ledger via WalletConnect.

- Refer to the Quick Start section for a basic example of setting up the client, or explore the Playground directory for advanced use cases, including session management and transaction handling with Joey Wallet.
- For a more thorough explanation, view here.

Quick Start

After installation, you can import and start using wc-client:

`jsx
// File located at ./src/context/advanced
'use client';

import { advance } from '@joey-wallet/wc-client/react';
import config from '~/common/wc-config'

export const Provider = (props: React.PropsWithChildren) => {props.children};

export const useProvider = wcc.useProvider;
`

Usage Example:

`jsx
// File: ./src/app/page.jsx
import { Provider, useProvider } from '~/context/advanced';

export default function Home() {
return (



);
}

function App() {
const { provider, uri, activeSession, actions} = useProvider();

const handleConnection = async () => {
await actions.connect()
}

return (