3.8 KiB
IPFS in Plain English (for legal readers)
Host: https://ipfs.kane-il.us · Repository: w3pbs/ipfs.kane-il.us
(Gitea, branch main
) · Version: v1.0 · Generated (UTC): 2025-08-27 19:10:34Z
What IPFS does
- IPFS gives every document a CID (content ID) that is a fingerprint of the exact bytes.
- If anything changes—even one character—the document gets a different CID.
- Example: if a body of text contains
01/01/1978
and that changes to01/01/1987
, the CID changes. The original text keeps its original CID and remains retrievable at that CID.
Why this matters in legal settings
- Integrity: Opening the same
/ipfs/<CID>
always returns the same document. If the bytes were different, the CID would be different. - Stable citations: Every publish is timestamped and logged. CIDs never change, so filings can cite them permanently.
- Audit trail: Each publish has a signed manifest (path ↔ CID) and an entry in the permanent log at
/_log/publish.jsonl
. This log, not transient web pages, is the provenance record. - Court admissibility: The CID itself is the authoritative reference. Filings should cite the CID to guarantee immutability, not just a URL or repository path.
Repository vs. Immutable Retrieval
- Repository (Gitea): The repo at gitea.barternetwork.us holds the structured hierarchy (
/legal
,/civics
,/naics
, etc.). It provides human-readable organization, history, and convenience for operators. - Immutable files: For authentic, court-admissible retrieval, always use the CID. The Gitea repo structures the files, but the CID guarantees their identity forever.
Snapshots and navigation
- There is no mutable “latest” pointer (no IPNS, no DNSLink).
- Each published file is permanent, timestamped in its filename (
YYYYMMDDThhmmssZ_<slug>.md
), and referenced in the manifest/log. - Gateway directory listings under
https://ipfs.kane-il.us
expose these timestamped files directly.
How to verify (no installs needed)
- Open
https://ipfs.kane-il.us/_log/publish.jsonl
(or the manifest for the filing’s date). - Find the file path and note its CID (and, if provided, SHA-256).
- Confirm the CID matches the value on the filing’s cover sheet.
- (Optional) Fetch the same
/ipfs/<CID>
via a second public gateway to cross-check—it will return the same bytes for the same CID.
Scope & privacy
- Only court-public materials are published. Private or sealed content is not placed on IPFS.
Terms (brief)
- CID: Content ID (hash of the exact bytes).
- Manifest: JSON file mapping file paths to their CIDs; cryptographically signed.
- Publish log: Append-only JSONL file at
/_log/publish.jsonl
recording each publish. - Snapshot: Timestamped file committed once, never changed.
- Gitea repo: Source of structure and convenience; not itself proof of immutability.
Email-sized blurbs (pick one)
Ultra-plain (2 sentences): IPFS assigns each document a unique CID that is a fingerprint of its exact text. If anything changes—even one character—the CID changes, so opening the same CID always returns the original document.
With date example: IPFS identifies each document by a CID. If 01/01/1978
is changed to 01/01/1987
, that small change produces a new CID—so the original text keeps its original CID and can always be retrieved.
With “repo vs CID”: The Gitea repo provides the folder structure, but the CID is the legal proof. For citations, always use the CID—because the CID is immutable, permanent, and court-admissible.
Disclaimer: This explainer is informational, not legal advice, and does not represent any government.