@hsuite/connect-client

Launch-ready simulator, memory transport, and RPC client for validating dApp workflows.

Quick Start

# Install workspace dependencies
pnpm install

# Build package
pnpm --filter @hsuite/connect-client build

# Run tests
pnpm --filter @hsuite/connect-client test

# Run with coverage
pnpm --filter @hsuite/connect-client test -- --coverage

Development

• Source: src/ - RPC client, memory transport, signing harness, query utilities
• Tests: tests/ - Vitest integration tests
• Build: TypeScript compilation to dist/

Key Components

• ReferenceClient - Minimal RPC client with event handling
• MemoryTransport - In-memory transport for testing
• SigningHarness - End-to-end signing flow orchestration
• QueryClient - Wallet state observation utilities

Key Files

• src/reference-client.ts - Main RPC client
• src/memory-transport.ts - Test transport
• src/signing-harness.ts - Integration harness

Scripts

• pnpm build - Build package to dist/
• pnpm test - Run Vitest tests
• pnpm test -- --coverage - Run with coverage
• pnpm docs - Generate Compodoc documentation

Test Statistics

• 38 passing tests
• 73%+ statement coverage
• Full integration test suite

Usage Example

import { ReferenceClient, MemoryTransport } from '@hsuite/connect-client';

const transport = new MemoryTransport({ id: 'test' });
const client = new ReferenceClient({ transport });

client.on('response', (response) => {
  console.log('Received:', response);
});

await client.send({
  jsonrpc: '2.0',
  method: 'session/request',
  params: { /* ... */ }
});

Documentation

📚 Full Documentation: docs/packages/reference-client.md

For comprehensive guides including:

• RPC client usage
• Memory transport for testing
• Signing harness integration
• Partner integration testing
• Protocol validation

Related

• Main README - Project overview
• Documentation Index - All documentation
• Simulator Guide - Simulator details
• Testing Strategy - Testing approach

Status: ✅ Production Ready | Coverage: 73%+ | Tests: 38 passing