covert

Covert Suite

The Covert Suite is a test framework and test runner that allows to test and verify implementations of peer-to-peer network services, and the simulation of network behaviours (2G, 3G, 4G).

The idea of its concept is that it can help Developers understand their code, and that Reviews can be executed multiple times in a stateless manner; even in parallel while fixing bugs in an implementation.

All Reviews have been implemented and maintained in a manner so that they can be used as a reference point for future third-party clients.

By default, it uses the stealth/Client which is written for node.js, so no external libraries and no external programs are necessary.

Requirements

Currently, Covert runs officially only on Arch Linux, though it might be possible to run it on MacOS Mojave and later, too.

In order to simulate end-to-end throttled peer-to-peer Networking correctly, Covert requires these external packages on minimalistic Unix/Linux systems:

# Install necessary packages
pacman -S --needed iproute2 kmod net-tools sudo tcpdump

Additionally, the following ports have to be allowed in the Firewall to transmit and receive of both UDP/TCP data:

• 80 (--internet=true) for stealth/connection/HTTP and stealth/connection/WS.
• 443 (--internet=true) for stealth/connection/HTTPS and stealth/connection/WSS.
• 13337 (--internet=true) for stealth/connection/HTTP and stealth/connection/WS.
• 65432 for stealth/Client and stealth/Server.

Quickstart

• Install node.js latest (minimum version 12).

cd /path/to/stealth;

# Build Stealth and Covert
node ./covert/make.mjs;

# Show Help
node ./covert/covert.mjs;

ECMAScript Usage

The Covert Library exports a default export that contains a namespaced Object. Due to otherwise conflicting names, there are no separately named exports available.

// Import Covert Library
import covert from './covert/index.mjs';

NPM Usage

// Import Covert Library
import covert from 'stealth/covert';