Skip to main content

VSM Stealth Protocol - Invisible P2P encrypted transport

Project description

vsmprotocol (Python SDK)

🔗 GitHub Repository: cezarpena/vsm-protocol

VSM Stealth Protocol — Invisible P2P encrypted transport for Python.

Enable bidirectional encrypted communication without opening a single port. vsmprotocol uses raw packet injection to create stealth tunnels that bypass the standard OS socket table.


🚀 Quick Start

1. Installation

pip install vsmprotocol

Note: Requires sudo (root) permissions to inject and sniff raw packets.

2. Setup Firewalls (Mandatory)

Silence outgoing RST packets on your chosen port:

macOS:

echo "block drop out proto tcp from any to any port 9999" | sudo pfctl -a "com.apple/vsm" -f - && sudo pfctl -e

Linux:

sudo iptables -A OUTPUT -p tcp --tcp-flags RST RST -j DROP

💻 Usage

Start a Stealth Server

import vsmprotocol as vsm
import time

def on_knock(sid, peer):
    print(f" [SRV] Knock from {peer.decode()}")

def on_msg(sid, peer, msg):
    print(f" [SRV] Message: {msg.decode()}")

server_id = vsm.generate_identity()

# KEEP THE RETURN VALUE IN A VARIABLE to prevent Garbage Collection
refs = vsm.start_server(9999, server_id, on_knock, on_msg)

while True:
    time.sleep(1)

Dial a Server

import vsmprotocol as vsm

my_id = vsm.generate_identity()
sid = vsm.dial("lo0", "127.0.0.1", 9999, my_id)

if sid != -1:
    vsm.send_message(sid, "Hello from the ghost network.")

📜 License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vsmprotocol-0.1.1.tar.gz (10.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vsmprotocol-0.1.1-py3-none-any.whl (10.9 MB view details)

Uploaded Python 3

File details

Details for the file vsmprotocol-0.1.1.tar.gz.

File metadata

  • Download URL: vsmprotocol-0.1.1.tar.gz
  • Upload date:
  • Size: 10.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for vsmprotocol-0.1.1.tar.gz
Algorithm Hash digest
SHA256 f0f80d562a56ed9d0200d1a3147835868e8ac01e473fb8f27423d2f3b3133592
MD5 c62a656c7fc831a5a17f0a23e99b86ff
BLAKE2b-256 4c8933186fe4deb3050486986ea7799e29d760ac93b258744e88d3a6bb9a63a8

See more details on using hashes here.

File details

Details for the file vsmprotocol-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: vsmprotocol-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for vsmprotocol-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d5b0fe3c4f77f8da0c26c643ef4c2be6d00a2498c4c9ad135582183b2dbc21a2
MD5 a6f0e93f0929de368c1b30c0a5063e39
BLAKE2b-256 cebc37961ced8a7362b30edde80e9c9e0c518450288b96b742ba5d550bdc9117

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page