https://github.com/writerslogic/witnessd
Cryptographic authorship witnessing for writers and creators
https://github.com/writerslogic/witnessd
chain-of-custody cli-app desktop-app evidence-accumulation proof-of-process verifiable-delay-function
Last synced: 5 months ago
JSON representation
Cryptographic authorship witnessing for writers and creators
- Host: GitHub
- URL: https://github.com/writerslogic/witnessd
- Owner: writerslogic
- License: apache-2.0
- Created: 2026-02-04T11:36:30.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-03T23:57:01.000Z (5 months ago)
- Last Synced: 2026-03-04T03:54:26.016Z (5 months ago)
- Topics: chain-of-custody, cli-app, desktop-app, evidence-accumulation, proof-of-process, verifiable-delay-function
- Language: Rust
- Homepage: https://writerslogic.com
- Size: 79.5 MB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Notice: NOTICE
Awesome Lists containing this project
README
writerslogic-core
Cryptographic authorship witnessing for writers and creators
---
> [!NOTE]
> **Patent Pending:** USPTO Application No. 19/460,364 — *"Falsifiable Process Evidence via Cryptographic Causality Locks and Behavioral Attestation"*
---
## Overview
**writerslogic-core** is the cryptographic core library that produces independently verifiable, tamper-evident process evidence constraining when and how a document could have been created.
This monorepo contains the full WritersLogic ecosystem:
| Component | Path | Description | License |
|:----------|:-----|:------------|:--------|
| **wld_engine** | [`crates/wld_engine`](crates/wld_engine) | Cryptographic engine | AGPL-3.0-only |
| **wld_protocol** | [`crates/wld_protocol`](crates/wld_protocol) | PoP wire format & forensic models | AGPL-3.0-only |
| **wld_jitter** | [`crates/wld_jitter`](crates/wld_jitter) | Hardware timing entropy | AGPL-3.0-only |
| **wld_cli** | [`apps/wld_cli`](apps/wld_cli) | CLI & Linux packaging | AGPL-3.0-only |
| **wld_macos** | [`apps/wld_macos`](apps/wld_macos) | macOS desktop app | Proprietary |
| **wld_windows** | [`apps/wld_windows`](apps/wld_windows) | Windows desktop app | Proprietary |
## Usage
Add to your `Cargo.toml`:
```toml
[dependencies]
writerslogic-core = { git = "https://github.com/writerslogic/writerslogic", branch = "main" }
```
## Features
| Feature | Description |
|:--------|:------------|
| `default` | Core library without optional features |
| `wld_jitter` | Hardware entropy via PhysJitter |
| `secure-enclave` | macOS Secure Enclave support |
| `x11` | X11 focus detection on Linux |
| `ffi` | UniFFI bindings for Swift/Kotlin |
## Architecture
```
writerslogic/
├── crates/
│ ├── wld_engine/ High-performance cryptographic engine
│ │ └── src/
│ │ ├── analysis/ Signal analysis and behavioral metrics
│ │ ├── anchors/ Blockchain and timestamp anchoring
│ │ ├── crypto/ Cryptographic primitives
│ │ ├── evidence/ Evidence export/verify
│ │ ├── forensics/ Authorship analysis
│ │ ├── ipc/ Inter-process communication
│ │ ├── keyhierarchy/ Key derivation and ratcheting
│ │ ├── platform/ OS-specific code (macOS, Linux, Windows)
│ │ ├── sentinel/ Real-time monitoring
│ │ ├── rfc/ RFC implementations
│ │ ├── tpm/ TPM 2.0 integration
│ │ └── vdf/ Verifiable Delay Functions
│ ├── wld_protocol/ PoP wire format (CBOR/COSE)
│ └── wld_jitter/ Hardware timing entropy
├── apps/
│ ├── wld_cli/ Command-line interface
│ ├── wld_macos/ Native macOS app (submodule)
│ └── wld_windows/ Native Windows app (submodule)
├── docs/ Schemas, specs, and user guides
└── wiki/ GitHub Wiki pages
```
## Development
```bash
cargo test --all-features # Run tests
cargo clippy -- -D warnings # Lint
cargo fmt --all # Format
cargo audit && cargo deny check # Security audit
```
## Security & Privacy
> [!IMPORTANT]
> WritersLogic provides **independently verifiable, tamper-evident process evidence**, not absolute proof. The value lies in converting unsubstantiated doubt into testable claims across independent trust boundaries.
### Privacy & External Interactions
WritersLogic is designed with a strictly **offline-first and privacy-preserving** architecture. Core witnessing, keystroke capture, and evidence generation occur entirely on your local machine.
However, the applications interact with the following external domains for specific enhanced features:
* **Verification Portal (`writersproof.com/verify`):** Provides a browser-based tool for verifying `.wpkt` evidence packets. This process runs client-side in your browser; evidence data is never uploaded to our servers.
* **Attestation API (`writerslogic.com/api`):** Used for "Tier 3" and "Tier 4" evidence to request anti-replay nonces and receive cloud-signed attestation certificates.
* **Schema Registry (`protocol.writersproof.com`):** Hosts the JSON schemas and DID (Decentralized Identifier) resolution data used for protocol compliance.
For a detailed breakdown of our privacy model, see the **[Privacy & External Interactions Wiki](https://github.com/writerslogic/writerslogic/wiki/Privacy-&-External-Interactions)**.
See [SECURITY.md](SECURITY.md) for the security policy.
## Citation
```bibtex
@article{condrey2026writerslogic,
title={WritersLogic: Proof-of-process via Adversarial Collapse},
author={Condrey, David},
journal={arXiv preprint arXiv:2602.01663},
year={2026},
doi={10.48550/arXiv.2602.01663}
}
```
> **Abstract:** Digital signatures prove key possession but not authorship. We introduce *proof-of-process* — a mechanism combining jitter seals, Verifiable Delay Functions, timestamp anchors, keystroke validation, and optional hardware attestation.
>
> — [arXiv:2602.01663](https://arxiv.org/abs/2602.01663) [cs.CR]
## License
Licensed under the [Apache License, Version 2.0](LICENSE).