RockOrBust

The open-source decentralized residential proxy infrastructure for browser automation.

RockOrBust is an industrial-grade, open-source stealth network designed to help automated browsers bypass advanced anti-bot systems. By leveraging a decentralized pool of residential nodes and sophisticated fingerprint masking, your automation scripts become indistinguishable from real human users.

---

System Architecture

graph TD
    subgraph "1. Client Layer (SDKs)"
        A1["@rockorbust/playwright-plugin"]
        A2["@rockorbust/extra-plugin"]
    end

    subgraph "2. Control Plane (Gateway)"
        B["RockOrBust Gateway"]
        B1["Auth & Key Validation (Supabase)"]
        B2["WebRTC Signaling Orchestrator"]
        B3["Public Dashboard (Web App)"]
        B --> B1
        B --> B2
        B --> B3
    end

    subgraph "3. Network Layer (Residential Nodes)"
        C1["Go CLI (Windows)"]
        C2["Go CLI (Linux)"]
        C3["Go CLI (macOS)"]
    end

    A1 & A2 -- "1. Signaling" --> B2
    B2 -- "2. WS Control" --> C1 & C2 & C3
    
    A1 & A2 -. "3. Direct P2P Mesh-Flow (WebRTC)" .-> C1 & C2 & C3
    C1 & C2 & C3 -- "4. Final Request" --> D["Target Website"]

Loading

---

The Four Pillars

1. The Network (Go CLI)

A high-performance standalone binary that contributes residential connections to the pool.

• Privacy: Traffic is encrypted and tunneled securely.
• Cross-Platform: Native binaries for Windows, Linux, and macOS.
• Background Persistence: Runs as a lightweight daemon with built-in autostart.

2. The Control Plane (Gateway)

The central orchestration layer that handles authentication and P2P signaling.

• Signaling Orchestrator: Manages WebRTC handshakes between SDKs and residential nodes.
• P2P-First Architecture: Traffic flows directly from the SDK to the residential node, bypassing the Gateway.
• ROB Key Auth: Simple, secure key-based authentication with Supabase integration.
• Global Telemetry: Exposes real-time network health and node distribution via a high-performance stats API.

3. The Dashboard (Web)

A premium, brutalist-designed landing page and monitoring interface.

• Live Monitoring: Real-time visibility into active global nodes.
• Unified Installation: One-click downloads and clear usage examples.
• Network Visualization: Visual feedback of the decentralized pool status.

4. The SDKs (Plugins)

Drop-in libraries for Playwright and Puppeteer.

• Native Plugin: Zero-dependency, all-in-one wrapper with built-in stealth scripts.
• Extra Plugin: Modular plugin for the playwright-extra and puppeteer-extra ecosystem.

Quick Start

1. The Network (Go CLI)

Download the binary for your platform and run it with your ROB key:

./rockorbust --key rob_your_key_here

2. Choose Your SDK

Option A: Native Plugin (All-in-One)

Best for clean, zero-dependency setups with built-in stealth scripts.

npm install @rockorbust/playwright-plugin

const { chromium } = require('@rockorbust/playwright-plugin');

(async () => {
  const browser = await chromium.launch({
    rockorbust: { key: 'rob_your_key_here' }
  });
  const page = await browser.newPage();
  await page.goto('https://api.ipify.org?format=json');
  console.log(await page.content());
  await browser.close();
})();

Option B: Extra Plugin (Modular)

Best for existing puppeteer-extra or playwright-extra projects.

npm install @rockorbust/extra-plugin

const { chromium } = require('playwright-extra');
const rockorbust = require('@rockorbust/extra-plugin')({
  key: 'rob_your_key_here',
  fallbackToLocal: true
});

chromium.use(rockorbust);

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://api.ipify.org?format=json');
  console.log(await page.content());
  await browser.close();
})();

---

SDK Comparison

Feature	Native Plugin	Extra Plugin
Best For	High-performance, zero-dependency setups.	Modular setups with other "Extra" plugins.
Installation	@rockorbust/playwright-plugin	@rockorbust/extra-plugin
Stealth	Built-in: Native JS mocks for WebGL, UA, etc.	External: Use with puppeteer-extra-plugin-stealth.
Compatibility	Playwright Only	Playwright-Extra & Puppeteer-Extra
Proxy Method	P2P Mesh-Flow: Direct WebRTC	P2P Mesh-Flow: Direct WebRTC
Relay Fallback	Gateway WebSocket Tunnel	Gateway WebSocket Tunnel
Local Fallback	Supported	Supported

---

Smart Error Handling

Both plugins feature Reactive Error Diagnostics. If a connection fails due to a lack of residential nodes, RockOrBust will identify the cause and provide a helpful troubleshooting tip directly in your console.

---

Project Structure

• apps/gateway: The Node.js hub for routing and auth.
• apps/cli: The Go-based residential node client.
• apps/web: The premium landing page and live network dashboard.
• packages/playwright-plugin: The native Playwright wrapper.
• packages/extra-plugin: The modular Puppeteer/Playwright-Extra plugin.

---

Documentation

• Gateway Configuration
• CLI User Guide
• Web App Details
• SDK Reference

---

MIT © BuildShot