fognode 0.1.0

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 (aiogram-style)

Server

from fognode import App, Cipher

app = App(
    host="0.0.0.0",
    port=9443,
    user="alice",
    password="secret",
    cipher=Cipher.AESGCM,
)

@app.on_message()
async def echo(ctx):
    await ctx.answer(f"echo: {ctx.message.text}")

@app.on_command("ping")
async def ping(ctx):
    await ctx.answer("pong")

@app.on_connect()
async def on_connect(ctx):
    print(f"+ {ctx.user}")

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

Client

from fognode import App, Cipher

app = App.client(
    connect_string="alice@oak-pine-stone-field:9443",
    password="secret",
    cipher=Cipher.AESGCM,
)

@app.on_message()
async def on_message(ctx):
    print(f"{ctx.message.user}: {ctx.message.text}")

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

Classic API

from fognode import start_server, client_connect

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

Structure

src/fognode/
├── app.py          # App class (aiogram-style)
├── cipher.py       # Cipher enum
├── context.py      # Context for handlers
├── message.py      # Message dataclass
├── router.py       # Router for handlers
├── filters/        # Command, Text filters
├── handlers/       # HandlerObject
├── types/          # exceptions, constants, protocol
├── crypto/         # primitives, kdf, cert, channel
├── ciphers/        # aesgcm, chacha20, x25519, hkdf, pbkdf2, hmac
├── wire/           # framing
├── auth/           # handshake
├── core/           # server, client, session, state
├── decorators.py   # retry, rate_limited, timed
├── exceptions.py   # errors
├── utils/          # ipwords, ratelimit, net
└── cli/            # entrypoint

---

_{MIT © reekeer}