CL CreatorLedger
.NET / Ed25519

CreatorLedger, prove who created what, when.

Local-first cryptographic provenance for digital assets. Ed25519 signatures, append-only event chains, self-contained proof bundles, and optional blockchain anchoring — no cloud required.

Install

dotnet tool install --global CreatorLedger

Verify

creatorledger verify proof.json --asset artwork.png

Inspect

creatorledger inspect proof.json

Why CreatorLedger?

Provenance that works offline and verifies anywhere.

Ed25519 Signatures

RFC 8032 compliant signatures tied to creator identity. Official test vectors included.

Append-Only Chain

Events form a hash-linked chain enforced by SQLite triggers. No updates, no deletes, no tampering.

Self-Contained Proofs

Export JSON proof bundles that verify offline without any database or infrastructure.

Derivation Tracking

Know when work is derived from other work. Full provenance chain from original to derivative.

Blockchain Anchoring

Optional timestamping for legal-grade evidence. Pluggable adapter pattern (Polygon planned).

Cross-Platform

Windows (DPAPI), Linux (libsecret), macOS (Keychain) — secure key storage on every platform.

Quick Start

Install & verify

# Install as .NET global tool
dotnet tool install --global CreatorLedger

# Verify a proof bundle
creatorledger verify proof.json

# Verify with asset file
creatorledger verify proof.json --asset artwork.png

# Machine-readable for CI
creatorledger verify proof.json --json

Build from source

git clone https://github.com/mcp-tool-shop-org/CreatorLedger.git
cd CreatorLedger

# Build
dotnet build

# Run 222 tests
dotnet test

# Self-contained CLI
dotnet publish CreatorLedger.Cli -c Release

Trust Levels

Every asset gets a verifiable trust classification.

Level
Meaning
Verified Original
Signed + anchored to blockchain
Signed
Valid signature, not yet anchored
Derived
Signed work derived from another signed work
Unverified
No attestation found
Broken
Signature invalid or content modified

CLI Exit Codes

Designed for scripts and CI pipelines.

Code
Status
Meaning
0
Verified
Signature and chain valid
2
Unverified
Structurally valid, can’t verify
3
Broken
Tamper detected
4
Invalid input
Bad JSON, wrong version
5
Error
Runtime failure

Solution Layout

Clean architecture with five focused projects.

Project
Purpose
CreatorLedger.Cli
Standalone verifier CLI
CreatorLedger.Application
CreateIdentity, AttestAsset, Verify, Export, Anchor
CreatorLedger.Domain
CreatorIdentity, AssetAttestation, LedgerEvent
CreatorLedger.Infrastructure
SQLite (WAL), DPAPI / libsecret / Keychain, NullAnchor
Shared.Crypto
Ed25519, SHA-256, Canonical JSON

Platform Support

Component
Windows
Linux
macOS
CLI Verifier
Core Library
Secure Key Storage
DPAPI
libsecret
Keychain