Rondevu Client


WebRTC signaling client with durable connections

TypeScript client for Rondevu, providing WebRTC signaling with automatic reconnection, message buffering, and tags-based discovery.

Features

- Ed25519 Identity: Your public key IS your identity (like Ethereum addresses)
- Tags-Based Discovery: Find peers using tags (e.g., ["chat", "video"])
- Automatic Reconnection: Built-in exponential backoff
- Message Buffering: Queues messages during disconnections

Installation

``bash
npm install @xtr-dev/rondevu-client
`

Quick Start

`typescript
import { Rondevu } from '@xtr-dev/rondevu-client'

// ============================================
// ALICE: Host and wait for connections
// ============================================
const alice = await Rondevu.connect()

alice.on('connection:opened', (offerId, connection) => {
console.log('Connected to', connection.peerPublicKey)
connection.on('message', (data) => console.log('Received:', data))
connection.send('Hello!')
})

const offer = await alice.offer({ tags: ['chat'], maxOffers: 5 })
// Later: offer.cancel() to stop accepting connections

// ============================================
// BOB: Connect to Alice
// ============================================
const bob = await Rondevu.connect()

const peer = await bob.peer({ tags: ['chat'] })

peer.on('open', () => peer.send('Hello Alice!'))
peer.on('message', (data) => console.log('Received:', data))
`

API Reference

$3

`typescript
const rondevu = await Rondevu.connect({
apiUrl?: string, // Default: 'https://api.ronde.vu'
keyPair?: KeyPair, // Reuse existing keypair
iceServers?: IceServerPreset | RTCIceServer[], // Default: 'rondevu'
debug?: boolean
})

rondevu.getPublicKey() // Get public key (your identity)
rondevu.getKeyPair() // Get keypair for persistence
`

ICE Presets: 'rondevu' (default), 'rondevu-relay', 'google-stun', 'public-stun'

$3

`typescript
const peer = await rondevu.peer({
tags: string[],
publicKey?: string, // Connect to specific peer
rtcConfig?: RTCConfiguration
})

// Events
peer.on('open', () => {})
peer.on('close', (reason) => {})
peer.on('message', (data) => {})
peer.on('error', (error) => {})
peer.on('reconnecting', (attempt, max) => {})

// Properties & Methods
peer.state // 'connecting' | 'connected' | 'reconnecting' | ...
peer.peerPublicKey
peer.send(data)
peer.close()
`

$3

`typescript
const offer = await rondevu.offer({
tags: string[],
maxOffers: number,
ttl?: number, // Offer lifetime in ms (default: 300000)
autoStart?: boolean // Auto-start filling (default: true)
})

offer.cancel() // Stop accepting connections

rondevu.on('connection:opened', (offerId, connection) => {
connection.on('message', (data) => {})
connection.send('Hello!')
})
`

$3

`typescript
const result = await rondevu.discover(['chat'], { limit: 20 })
result.offers.forEach(o => console.log(o.publicKey, o.tags))
`

Identity (Ed25519 Keypairs)

Your identity is an Ed25519 public key - no usernames, no registration, no claiming conflicts. Generate a keypair locally and start making requests immediately.

`typescript
// Auto-generated keypair
const rondevu = await Rondevu.connect()
console.log(rondevu.getPublicKey()) // '5a7f3e2d...' (64 hex chars)

// Save and restore keypair for persistent identity
const keyPair = rondevu.getKeyPair()
localStorage.setItem('keypair', JSON.stringify(keyPair))

// Later: restore
const saved = JSON.parse(localStorage.getItem('keypair'))
const rondevu = await Rondevu.connect({ keyPair: saved })
`

Tag Validation

Tags: 1-64 chars, lowercase alphanumeric with dots/dashes.

Valid: chat, video-call, com.example.service`

Links

- Live Demo | Server | API

License

MIT