𝗖 𝗥 𝗢 𝗦 𝗦 - 𝗛 𝗢 𝗦 𝗧 𝗜 𝗡 𝗚

Ovencord Cross Hosting

The ultimate cross-hosting library for Bun, optimized for ultra-low latency (<2ms) and native performance. Built to work seamlessly with @ovencord/hybrid-sharding.

Features:

• Native Bun Networking: Uses Bun.listen and Bun.connect for maximum performance and minimum overhead.
• Ultra Low Latency: Designed for inter-VPS communication with <2ms latency targets.
• broadcastEval(): Execute code across all machines and clusters with ease.
• Dependency-Free: Zero Node.js networking dependencies (net-ipc, etc. removed).
• Rolling Restarts: Seamlessly update shard counts and machine configurations without downtime.
• Hybrid-Sharding Integration: Specifically tailored for @ovencord/hybrid-sharding.

📦 Comparison: discord-cross-hosting vs @ovencord/cross-hosting

| Feature | discord-cross-hosting | @ovencord/cross-hosting | Result / Advantage | | :--- | :--- | :--- | :--- | | Runtime | Node.js (Legacy) | Bun (Native) | Native execution without emulation | | Unpacked Size | 153 kB | 59 kB | ~61% lighter | | Total Files | 48 | 16 | Streamlined, modern architecture | | TCP Engine | node:net (Emulated) | Bun.listen / Bun.connect | Bypasses Node.js overhead | | Event System | node:events (Sync) | AsyncEventEmitter | Non-blocking asynchronous handling | | Dependencies | net-ipc, lodash, etc. | ZERO (Native) | Instant install, 0 vulnerabilities | | Data Handling | node:buffer | Uint8Array (Zero-copy) | RAM-speed data transfers | | Build Step | dist/ (Transpiled) | Source-Only (.ts) | 0ms Build Time - Executes TS directly | | Node.js Imports | Present in source | ZERO (Grep Zero) | Complete independence from legacy Node |

Result: ~89% savings on total installation weight and zero external networking dependencies!

📦 Installation

bun add @ovencord/cross-hosting
bun add @ovencord/hybrid-sharding

Quick Start Guide:

1. Bridge (Coordinator)

The Bridge handles the coordination of shards across all machines.

import { Bridge } from '@ovencord/cross-hosting';

const bridge = new Bridge({
    port: 4444,
    authToken: 'YOUR_SECURE_TOKEN',
    totalShards: 'auto',
    totalMachines: 2,
    shardsPerCluster: 10,
    token: 'YOUR_BOT_TOKEN',
});

bridge.on('debug', console.log);
bridge.listen();

bridge.on('ready', (addr) => {
    console.log(`Bridge listening on ${addr}`);
});

2. Client (Machine)

The Client runs on each VPS/Machine and connects to the Bridge.

import { Client } from '@ovencord/cross-hosting';
import { Manager } from '@ovencord/hybrid-sharding';

const client = new Client({
    agent: 'bot',
    host: 'bridge-vps-ip',
    port: 4444,
    authToken: 'YOUR_SECURE_TOKEN',
    rollingRestarts: true,
});

const manager = new Manager('./bot.ts', { totalShards: 'auto' });

client.on('debug', console.log);
client.connect();

client.listen(manager);

client.requestShardData().then(data => {
    manager.totalShards = data.totalShards;
    manager.spawn();
});

3. Shard (Bot)

Access cross-hosting features directly from your bot instance.

import { Shard } from '@ovencord/cross-hosting';
import { Client } from '@ovencord/hybrid-sharding';
import { Client as DiscordClient } from 'discord.js';

const client = new DiscordClient({ intents: [1] });
client.cluster = new Client(client);
client.crosshost = new Shard(client.cluster);

client.on('ready', async () => {
    const totalGuilds = await client.crosshost.broadcastEval('this.guilds.cache.size');
    console.log(`Total Guilds across all machines: ${totalGuilds.reduce((a, b) => a + b, 0)}`);
});

client.login('TOKEN');

API References

Refer to the source code for detailed type definitions. The library is written in pure TypeScript and leverages Bun's native types for networking.

Maintained by Luigi Colantuono