Skip to main content

WraithMesh

Distributed deception sensor mesh — Phase 1.

Nodes collapse honeypot noise locally and uplink signed equivalence-class observations. The TIE aggregator corroborates across nodes, scores contributor reputation, and exposes a read API — without raw commands, IPs, or customer identifiers.

Phase 1 additions

  • Canary sensor — watch a JSONL beacon inbox (canary-kit integration path)
  • Reputation engine — per-node trust scoring; canary observations weigh 2×
  • Persistent TIE store — SQLite-backed campaigns + reputation
  • TIE read API — /v1/stats, /v1/campaigns, /v1/nodes/{id}/reputation
  • Sensor metrics — wraithmesh sensor status

Install

cd honeypot-mitre && pip install .
cd ../wraithmesh && pip install .

Cowrie sensor

export WRAITHMESH_KEY="change-me"
wraithmesh init-manifest --output mesh.json --sensor-class cowrie
wraithmesh sensor run --config mesh.json --once

Canary sensor

External systems append beacon events (package + version only — no token, no IP):

{"package_name": "internal-sdk", "version": "2.4.1", "timestamp": "2026-07-12T00:00:00Z"}
wraithmesh init-manifest --output mesh-canary.json --sensor-class canary --beacon-inbox ./beacons.jsonl
wraithmesh sensor run --config mesh-canary.json --once

TIE aggregator

wraithmesh aggregator serve --port 8787 --db .wraithmesh/tie.db
Endpoint Purpose
POST /v1/observations Ingest signed observation batch
GET /v1/equivalence/{key} Corroborated campaign record
GET /v1/campaigns List recent campaigns
GET /v1/stats Exchange stats
GET /v1/nodes/{id}/reputation Contributor trust score

DML → mesh (signed deception document)

pip install ../dml-spec   # or: pip install ".[dml]"
export DML_KEY=... WRAITHMESH_KEY=...
wraithmesh manifest from-dml signed_mesh.yaml cowrie-east-1 --output mesh.json
wraithmesh sensor run --config mesh.json --once

Anti-poisoning trap keys

wraithmesh manifest gen-trap-keys --output trap-keys.json
wraithmesh aggregator serve --trap-keys trap-keys.json

Observations matching a trap key are rejected and the node reputation is penalized.

Multi-node trust

Register node signing keys for the aggregator:

{
  "0f37f3380e0fb940": "node-a-secret",
  "1f20a905d9e47613": "node-b-secret"
}
wraithmesh aggregator serve --trusted-keys trusted-keys.json

Tests

pip install -e ../honeypot-mitre -e ".[dev]"
pytest

MIT — © 2026 Niffyhunt · wraithwall-toolkit

Metadata

Release files for wraithmesh 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wraithmesh 0.2.0
File Size Uploaded Provenance Actions
wraithmesh-0.2.0.tar.gz 20.3 kB Without provenance Details for wraithmesh-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for wraithmesh 0.2.0
File Interpreter ABI Platform Actions
wraithmesh-0.2.0-py3-none-any.whl Python 3 none any Details for wraithmesh-0.2.0-py3-none-any.whl

Total release size: 49.2 kB

Release files / wraithmesh-0.2.0.tar.gz

Download URL wraithmesh-0.2.0.tar.gz
Size 20.3 kB
Tags Source
SHA-256 checksum
How to use checksums
fe9d7a2cce4593b8b8e8e11c55a42eafc821e599a416e651317d1cdf6cb3e4e3
BLAKE2b-256 checksum
How to use checksums
ae12f7b8333e84033091440bd7deccf24860cef07c93d92843e85b549873502a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / wraithmesh-0.2.0-py3-none-any.whl

Download URL wraithmesh-0.2.0-py3-none-any.whl
Size 28.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d39e281d8420153bb1a3f5f051265b1ab7e302a5929d2c15a690d8bc7ae52b55
BLAKE2b-256 checksum
How to use checksums
2a4d9533a7c9a70c68c264d10ebba2fedd2406884ceedf129fc1f717687d4249
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for wraithmesh 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page