Date Seal: A Peer-to-Peer, Local-First, Self-Verifiable Document Integrity System

By Josh Spooner and contributors DRAFT 6 - August 2024

Satoshi Nakamoto

In the digital realm, a visionary’s spark ignited, Satoshi’s genius, both in code and narrative, united. A chain of trust, decentralized and bright, your legacy forever recited.

Abstract (open Abstract callout to read, or jump to the demo to see it in action markdown)

Abstract

Date Seal is a protocol that provides human-verifiable proof of a content block’s existence at a specific point in time, as easy to use as copy-paste. This local-first, tamper-proof, and self-verifiable document format empowers users with cost-effective, trustworthy, tamper-verifiable record-keeping and dynamic accounting ledgers. By standardizing the deformatting, digestion, time-stamping, and updating of content blocks with canonical, content-addressable links, Date Seal bridges a gap between smart contracts and human-readable, local-first Ricardian contracts and the larger gap between cloud and local-first architectures. ✉️

1. Introduction

Key Concept

Date Seal offers a paradigm shift in establishing trust in digital documents, empowering end-users own their own devices with the tools to verify cryptographic proofs of contents uniqueness and existence in time via a chain of timestamps.

Ina an era where digital content integrity is paramount, Date Seal introduces a revolutionary approach to document verification. This paper presents the core components of the Date Seal system: namely, markdown content blocks with links and the commands to Digest, Seal, and Copy-Check content blocks. These components work in concert to create a robust, decentralized system for content and timestamp verification.

By leveraging the power of cryptographic proofs and decentralized verification, Date Seal aims to revolutionize how we establish trust in digital documents, paving the way for more secure, transparent, and user-controlled data management in the digital age. ✉️

Date Seal

Date Seal is a protocol the empowers anyone on their own device to simply make Content Blocks tamper-verifiable (as easy as copy-paste on a desktop) by using the Digest Command, Seal Command, and Copy-Check Command to create Markdown Links that include the necessary metadata to verify content existed at a point in time and is unaltered.

  1. Granularity: Date Seal allows for verification at various levels of document granularity, from entire sections to individual paragraphs or list items.
  2. Flexibility: The protocol adapts to different content types, making it versatile for various document formats and styles.
  3. Non-intrusive: The seal format is designed to be unobtrusive, preserving document readability while providing cryptographic assurance.
  4. Version Control: By sealing individual blocks, Date Seal facilitates fine-grained version control and change tracking.
  5. Interoperability: The markdown-compatible format ensures that Date Seal can work alongside existing document workflows and tools. ✉️

Content Blocks

A content block is a discrete unit of information in a markdown document or folder that can be individually referenced, linked, sealed, and verified. Key characteristics include:

  1. Structural Boundaries: Delineated by elements such as:
    • Headers (e.g., # Header 1, ## Header 2)
    • Blank lines separating paragraphs
    • List items (bulleted or numbered)
    • Code blocks (fenced or indented)
    • Callouts (toggle-able)
    • Blockquotes
  2. Semantic Unity: Represents a cohesive unit of information.
  3. Deformat-able: Ability to extract core content by removing markdown syntax.
  4. Granularity: Size can vary based on document needs.
  5. Nestability: Can be nested within each other.
  6. Metadata Inclusion: May include its own metadata. ✉️

Date Seal can leverage various types of Markdown links for references and embeds. Although many of this link formats could be used, this Smart Paper implements and demos Date Seal using the Footnote Link and Block ID.

Link TypeSyntaxPurposeExample
Standard Web Link[text](URL)Creates a clickable link to a web page[WikiWe](https://www.wikiwe.org)
Internal Link[[]]Links to another note within the system[[Project Overview]]
Embed![[ ]]Embeds content from another note or media file![[Monthly Report.pdf]]
Block Reference[[\#^]]Links to a specific block or heading in another note[[Meeting Notes\#^action-items]]
Footnote Link[^]Creates a reference to a footnoteThis is a fact[^1]
Block ID^Assigns a unique identifier to a block of contentThis is an important point^key-concept
Image Link![alt text](image URL)Embeds an image from the web![Logo](https://example.com/logo.png)

Digest Command

The Digest Command is the initial step in the Date Seal process, creating a unique cryptographic hash of a content block with a timestamp, called a Digest Link.

Seal Command

The Seal Command adds a layer of timestamped verification to previously digested content by creating a “Seal Link”.

Copy-Check Command

The Copy-Check Command provides a non-destructive way to verify the integrity of digested and sealed content.

Command Comparison

An overview of the similarities and differences between the three commands:

FeatureDigest CommandSeal CommandCopy-Check Command
Modifies contentYesYesNo
Creates cryptographic hashYesYesNo (verifies only)
Requires existing DigestNoYesNo (but uses if present)
Adds/Updates footnoteYesYesNo
Creates separate fileYes (digest)Yes (seal)No
Provides verificationFor existing digestsYesYes
Handles multiple linksYesYesYes
Clipboard interactionNoNoYes (copies content)
Content statisticsYesYesYes
Deformatted content loggingYesYesYes

Implementation Instructions 123

Implementation

Each command is implemented as a script that can be integrated into document editing workflows, using cryptographic functions to ensure content integrity and verifiability. ✉️

Date Seal Syntax

The Date Seal syntax is designed to work within markdown documents:

[^ds/{deformatted-digest}/{YYYY-MM-DD}^] ^ds-{seal-digest}-{YYYY-MM-DD}
ComponentSyntaxExampleExplanation
Digest Link[^ds/...^][^ds/a1b2c3d4e5f6/2024-08-19^]Primary container for Date Seal information
Seal Link^ds-...^ds-g7h8i9j0k1l2-2024-08-19Additional reference for linking to specific blocks
Date Seal IdentifierdsdsPrefix indicating Date Seal information
Deformatted Digest{deformatted-digest}a1b2c3d4e5f612-character hexadecimal SHA-256 hash of the deformatted content block
Seal Digest{seal-digest}g7h8i9j0k1l2Hash digest including both deformatted content and Square Caret Block Link for extra verification
Timestamp{YYYY-MM-DD}2024-08-19Date when the content digested or sealed

This overview combines the markdown elements and Date Seal syntax, providing a comprehensive look at how these components interact within the Date Seal system. ✉️

Incentive ✉️ ^ds-649829878649

Privacy & Security

Date Seal addresses privacy concerns by allowing authors to control or parameterize the inclusion of personal identifiers while separating out formatting contributions from designers, while AI can assists non-technical users in verifying the technical implementation. The security of this system is maintained as long as honest nodes sync periodically and collectively maintain the longest sequence of cross-verified date-sealed blocks, outpacing any potential group of attacker nodes. ✉️

Conclusion

Key Takeaways

The Date Seal system, comprising the Digest, Seal, and Copy-Check Commands, provides a comprehensive solution for content integrity and verification. By leveraging cryptographic proofs and decentralized verification, Date Seal simplifies, localizes, and thus, revolutionizes how we establish trust in digital documents.

The Date Seal system offers a robust mechanism for tracking, verifying, and managing the integrity of content over time:

  • The Digest Command establishes the initial content fingerprint.
  • The Seal Command adds a time-stamped verification layer.
  • The Copy-Check Command allows for non-destructive verification at any point.

Together, these components create a powerful tool for secure, transparent, and user-controlled data management in the digital age. ✉️