fognode 0.2.3

fognode - headless secure encrypted data transmission. TLS + X25519 + AESGCM + PBKDF2.

fognode

headless secure encrypted data transmission.

---

Encrypted channel library for headless projects. Built for speed and zero-trust networking.

Stack: TLS 1.2+ · X25519 · AESGCM-256 · HMAC-SHA256 · PBKDF2 · HKDF

---

Install

pip install fognode

Quick start

Server

from fognode import Server, MessageEvent

server = Server(host="0.0.0.0", port=9443, password="secret")

@server.on_event(MessageEvent)
async def echo(ctx):
    if ctx.event.text:
        await ctx.answer(f"echo: {ctx.event.text}")

@server.on_event(ConnectEvent)
async def on_connect(ctx):
    print("+ peer connected")

@server.on_event(DisconnectEvent)
async def on_disconnect(ctx):
    print("- peer disconnected")

if __name__ == "__main__":
    server.run()

Client

from fognode import Client, MessageEvent, ClosedEvent

client = Client(connect_string="oak-pine-stone-field:9443", password="secret")

@client.on_event(MessageEvent)
async def on_message(ctx):
    print(f"msg: {ctx.event.text}")

@client.on_event(ClosedEvent)
async def on_closed(ctx):
    print("connection closed")

if __name__ == "__main__":
    client.connect()

Events

Event	Server	Client	Description
StartEvent	✅	✅	Server/client started
ConnectEvent	✅	✅	Peer connected
DisconnectEvent	✅	✅	Peer disconnected
MessageEvent	✅	✅	Message received
ClosedEvent	❌	✅	Connection closed
ErrorEvent	❌	✅	Error occurred

Classic API

from fognode import start_server, client_connect

ip, code, fp = start_server("0.0.0.0", 9443, "secret")
print(f"Connect: {code}:9443")

Structure

src/fognode/
├── app.py          # Server, Client, Context
├── core/
│   ├── events.py   # Event classes
│   ├── server.py   # start_server()
│   ├── client.py   # client_connect()
│   └── probe.py    # probe_server()
├── crypto/         # primitives, kdf, cert, channel
├── ciphers/        # aesgcm, chacha20, x25519, hkdf, pbkdf2, hmac
├── wire/           # framing
├── auth/           # handshake
├── types/          # exceptions, constants, protocol
├── decorators.py   # retry, rate_limited, timed
├── exceptions.py   # errors
├── utils/          # ipwords, ratelimit, net
└── cli/            # entrypoint

---

_{MIT © reekeer}