@hsuite/native-connect-sdk

Core wallet engine providing the unified hsc: channel protocol, multi-transport communication, WalletConnect v2 integration, secure key vault, and production-ready session orchestration for multi-ledger wallet applications.

Installation

npm install @hsuite/native-connect-sdk

Quick Start

import { ChannelClient, encodeChannelInvite } from '@hsuite/native-connect-sdk';

// Create a channel client for dApp-to-wallet communication
const client = new ChannelClient({
  relayUrl: 'wss://relay.hsuite.io',
});

// Connect and generate invite for wallet to scan
const invite = await client.connect({
  type: 'session',
  app: { id: 'my-dapp', name: 'My dApp' },
  context: { ledgerId: 'hedera', networkId: 'hedera:testnet' },
});

// Generate QR code data
const qrData = encodeChannelInvite(invite);
// Result: hsc://invite?key=BASE64&relay=...&app=my-dapp&ledger=hedera&network=testnet

Features

• Channel Protocol - Unified hsc: protocol for dApp-wallet communication via Nostr + P2P
• WalletConnect v2 - Complete wallet-side integration with session bridge and ledger handlers
• Secure Key Vault - Hardware-backed seed storage with BIP-39 mnemonic support
• Multi-Ledger Support - Hedera, XRPL, and extensible ledger adapters
• Transport Layer - TransportMux with automatic Nostr to P2P upgrade and TURN support
• Production Logging - Configurable log levels with scope-based filtering and SOC2 audit trails
• Portfolio Management - Token and NFT tracking with price enrichment
• Session Management - Unified session tracking for native and WalletConnect sessions

Documentation

• Full Documentation
• Channel Protocol
• Transport Architecture
• Session Management

License

PolyForm-Noncommercial-1.0.0 - See LICENSE